Sistema comercial · Hermética SAC
Documentación técnica del sistema
Mapa de la infraestructura en producción, de los módulos de código y de los procedimientos de despliegue. Preparado como material de referencia para el traspaso del sistema al equipo técnico de Hermética SAC.
Qué es el sistema
El sistema comercial de Hermética es una sola aplicación, no un conjunto de apps independientes. Está compuesta por dos artefactos desplegables y una base de datos:
Frontend (webapp)
SPA en React + TypeScript + Vite, empaquetada como PWA. Es la única interfaz de usuario.
lu-hermetica-comercial-webappBackend (API)
Django + Django REST Framework. Concentra toda la lógica de negocio, la autenticación y las integraciones externas.
lu-hermetica-comercial-backendBase de datos
PostgreSQL 17 administrado en Cloud SQL. Única fuente de verdad del sistema.
hermetica-comercial-dbEl componente central del que depende todo es el backend. El frontend no habla con la base de datos ni con ningún servicio externo: todo pasa por la API del backend. Si el backend está caído, no funciona nada; si el frontend está caído, la API sigue operativa.
Vista rápida de la infraestructura
| Componente | Proveedor / servicio | Identificador |
|---|---|---|
| Frontend en producción | Cloudflare Workers (static assets) | hermetica.lumini.dev |
| CI/CD frontend | Cloudflare Workers Builds | push a main |
| Backend en producción | Google Cloud Run · us-central1 | lu-hermetica-comercial-backend |
| CI/CD backend | Google Cloud Build | cloudbuild.yaml |
| Imágenes Docker | Google Artifact Registry | lu-hermetica-repo |
| Base de datos | Google Cloud SQL · PostgreSQL 17.9 | hermetica-comercial-db |
| Archivos y fotos | Google Cloud Storage | hermetica_bucket |
| Correo saliente | SMTP Outlook / Microsoft 365 | despacho@hermetica.pe |
| Origen de datos ERP | Datawarehouse Nisira (on-premise) | datawarehouse.hermetica.pe:8050 |
Por dónde empezar
- Arquitectura — diagrama de la nube: qué se despliega dónde, cómo viaja un request y de dónde salen los datos del ERP.
- Módulos — diagrama del código: los módulos del backend, los del frontend y la correspondencia entre ambos.
- Despliegue — cómo se instala, configura y publica cada componente en GCP y en Cloudflare, y cómo se levanta el entorno local.
- Cron — los procesos programados, incluida la migración del cron de importación a un Cloudflare Worker.
- Traspaso — checklist de lo que se entrega, lo que debe aprovisionar Hermética y en qué orden.
Alcance de este sitio. Es documentación de arquitectura y operación:
no contiene credenciales. Las claves y secretos viven en el archivo .env de
cada repositorio y en las variables de entorno del servicio de Cloud Run; se entregan por el
canal que corresponda, no por aquí. Ver Traspaso → Secretos.