Milton Gonzalez
103 lines
5.0 KiB
Markdown
103 lines
5.0 KiB
Markdown
# Produccion - project.linkedcorp.net
|
|
|
|
## Estado actual
|
|
|
|
- Version actual: `1.2.0`
|
|
- Estado: `operativo`
|
|
- Ultima validacion: `2026-09-06`
|
|
|
|
## Servidor
|
|
|
|
- Host: `192.168.222.3`
|
|
- SSH: `deploy@192.168.222.3 -p 2203` (llave `~/.ssh/id_ed25519`, sudo NOPASSWD)
|
|
- Ruta base: `/opt/apps/project.linkedcorp.net/`
|
|
|
|
## Runtime
|
|
|
|
- Frontend: `/opt/apps/project.linkedcorp.net/frontend/` (dist/ + node_modules propio con `serve`)
|
|
- Backend: `/opt/apps/project.linkedcorp.net/backend/` (node_modules + `.env` de produccion)
|
|
- Source (checkout de Gitea, WorkingDirectory de ambos servicios): `/opt/apps/project.linkedcorp.net/source/`
|
|
- Storage: `/opt/apps/project.linkedcorp.net/storage/` (adjuntos — `STORAGE_ROOT` en `.env`)
|
|
- Logs: `/opt/apps/project.linkedcorp.net/logs/`
|
|
- APKs Android publicados: no aplica
|
|
|
|
## Servicios
|
|
|
|
- Frontend: `project-linkedcorp-frontend` (`node node_modules/.bin/serve -s dist -l 5196`, WorkingDirectory `source/frontend`... revisar nota abajo)
|
|
- Backend: `project-linkedcorp-backend` (`node src/server.js`, WorkingDirectory `source/backend`, `EnvironmentFile=backend/.env`)
|
|
|
|
> Nota real: el servicio frontend corre con `WorkingDirectory=/opt/apps/project.linkedcorp.net/frontend`
|
|
> (no `source/frontend`) sirviendo `frontend/dist/` con el `serve` instalado ahi mismo (node_modules
|
|
> minimo, solo el paquete `serve`). El `dist/` se copia desde `source/frontend/dist` en cada deploy.
|
|
|
|
## Puertos internos
|
|
|
|
- Frontend: `127.0.0.1:5196`
|
|
- Backend: `127.0.0.1:4019`
|
|
|
|
## Base de datos
|
|
|
|
- Host pruebas/desarrollo: `192.168.222.20`
|
|
- Host produccion real: `192.168.222.32`
|
|
- Base: `project_linkedcorp`
|
|
- Usuario app: `project_linkedcorp` (permitido solo desde `192.168.222.3`)
|
|
- Regla dura: produccion web siempre usa `192.168.222.32`
|
|
- Regla dura: pruebas y desarrollo siempre usan `192.168.222.20`
|
|
- Antes de cada deploy, validar el `DB_HOST` activo en runtime (`backend/.env` de produccion)
|
|
|
|
## NPM (Nginx Proxy Manager)
|
|
|
|
- Dominio: `project.linkedcorp.net`, SSL Let's Encrypt (auto-renovacion), Force SSL activo.
|
|
- Proxy Host (id 77) -> `192.168.222.3:5196` (frontend).
|
|
- Custom Location `/api` -> `192.168.222.3:4019` (backend).
|
|
|
|
## Estado confirmado (2026-09-06)
|
|
|
|
- Migraciones aplicadas (`001_initial.sql`) sobre `project_linkedcorp` en `.32`.
|
|
- Catalogos base sembrados (roles, prioridades, estados de proyecto/actividad, tipos de proyecto).
|
|
Sin datos de ejemplo (departamentos/usuario dev) — produccion arranca limpia.
|
|
- Usuario Administrador inicial creado con `create-admin.js` (clave fuerte generada, entregada
|
|
una sola vez fuera de este repo). El admin debe crear ahi mismo los demas usuarios/departamentos.
|
|
- Login, dashboard y flujo proyecto->actividad verificados via curl contra
|
|
`https://project.linkedcorp.net` (backend + frontend + SSL + BD produccion, todo real).
|
|
- Pendiente (no bloqueante): limpiar archivos `.md` de `/opt/apps/project.linkedcorp.net/source`
|
|
(paso de higiene del checklist de `DEPLOY_WEB.md`, no se ejecuto por restriccion del entorno
|
|
del agente — pendiente de accion manual o autorizacion explicita).
|
|
|
|
## Actualizacion v1.1.0 (2026-09-06) — autorregistro/aprobacion/superadmin/SMTP
|
|
|
|
- Migracion `002_registration_and_smtp.sql` aplicada sobre `.32`: rol `superadmin`, columnas de
|
|
ciclo de vida en `users`, tabla `system_settings`. `mgonzalez@linkedcorp.net` (id=1) quedo
|
|
promovido a `superadmin` automaticamente.
|
|
- `ENCRYPTION_KEY` generado y agregado al `.env` de produccion (cifra la clave SMTP en BD).
|
|
- Ambos servicios reconstruidos (backend con `nodemailer` nuevo, frontend recompilado) y
|
|
reiniciados; PID confirmado distinto en los dos.
|
|
- Verificado end-to-end contra `https://project.linkedcorp.net`: login reporta `roleCode:
|
|
superadmin`, `GET /api/settings/smtp` responde `configured:false` (sin SMTP real todavia).
|
|
- **Pendiente**: el superadmin debe cargar el SMTP real desde Configuracion → Correo (SMTP) cuando
|
|
lo tenga. Hasta entonces, un registro/recuperacion de clave real en produccion queda logueado en
|
|
`journalctl -u project-linkedcorp-backend` en vez de enviarse por correo — nadie externo puede
|
|
completar el autorregistro sin que un admin le pase el enlace manualmente desde el log.
|
|
|
|
## Actualizacion v1.2.0 (2026-09-06) — cambiar clave desde la app
|
|
|
|
- `PUT /api/auth/change-password` (exige clave actual) + opcion "Cambiar clave" en el menu de
|
|
usuario. Redeploy sin cambios de dependencias ni de esquema; PID confirmado en ambos servicios.
|
|
- Verificado en produccion via curl (rechaza clave actual incorrecta con 400; no se cambio la
|
|
clave real del superadmin durante la prueba).
|
|
|
|
## Comandos utiles
|
|
|
|
```bash
|
|
sudo systemctl status project-linkedcorp-backend
|
|
sudo systemctl status project-linkedcorp-frontend
|
|
sudo journalctl -u project-linkedcorp-backend -n 100 --no-pager
|
|
sudo journalctl -u project-linkedcorp-frontend -n 100 --no-pager
|
|
```
|
|
|
|
## Notas
|
|
|
|
- No dejar secretos en el repo (`.env` de produccion vive solo en `backend/.env` del servidor).
|
|
- No reemplazar `storage/` ni `logs/` durante un deploy.
|
|
- Documentar cambios de version y estado real en este archivo y en `CHANGELOG.md`.
|