Saltar al contenido principal

Guía de Operación y Mantenimiento

Introducción​

Este documento describe los procedimientos necesarios para mantener operativa la plataforma MAMB.

Inicio del Sistema​

Backend​

cd backend
npm install
npm run dev

Servidor:

https://api.mambapp.online

Frontend​

cd frontend
npm install
npm run dev

Aplicación:

https://mambapp.online

Gestión de Base de Datos​

Ejecutar migraciones​

npx prisma migrate dev

Abrir Prisma Studio​

npm run prisma:studio

Gestión de Administradores​

Después del registro de un usuario:

UPDATE users
SET role = 'ADMIN'
WHERE email = 'correo@ejemplo.com';

Monitoreo Recomendado​

Verificar periódicamente:

  • Disponibilidad de la API.
  • Espacio de almacenamiento.
  • Conectividad con PostgreSQL.
  • Uso de Cloudflare Workers AI.
  • Logs de errores.

Gestión de Imágenes​

La carpeta:

backend/uploads/

debe existir siempre en producción.

Si es eliminada:

mkdir uploads

Respaldo de Base de Datos​

Backup​

pg_dump -U postgres mamb_db > backup.sql

Restauración​

psql -U postgres mamb_db < backup.sql

Problemas Frecuentes​

Error de conexión a PostgreSQL​

Verificar:

  • Servicio PostgreSQL iniciado.
  • Credenciales correctas.
  • Puerto 5432 disponible.

Error JWT​

Verificar:

JWT_SECRET

Error Prisma​

Ejecutar:

npx prisma generate

Error al subir imágenes​

Verificar existencia de:

backend/uploads/

Buenas Prácticas​

  • Realizar respaldos periódicos.
  • Mantener dependencias actualizadas.
  • Revisar logs semanalmente.
  • Proteger variables de entorno.
  • Utilizar HTTPS en producción.
  • Limitar acceso administrativo.