Estructura del proyecto
Árbol de carpetas
sgi-emch/
├── .github/
│ └── workflows/
│ └── ci-cd.yml # Pipeline CI (tests) + CD (deploy SSH) en GitHub Actions
├── backend/ # Aplicación Spring Boot
│ ├── src/main/java/pe/edu/emch/sgi/
│ │ ├── config/ # DataSeeder, SecurityConfig, WebConfig
│ │ ├── controller/ # Controladores REST (Auth, Equipo, Ticket, etc.)
│ │ ├── dto/ # Request/Response DTOs
│ │ ├── entity/ # Entidades JPA (Usuario, Equipo, Ticket, etc.)
│ │ ├── repository/ # Repositorios Spring Data
│ │ ├── scheduler/ # NotificacionScheduler (SLA y stock crítico)
│ │ ├── security/ # JwtFilter, AuditSessionInterceptor
│ │ └── service/ # Lógica de negocio
│ ├── src/main/resources/
│ │ └── application.properties # Configuración del servidor, BD, JWT, Swagger
│ ├── backup/ # Scripts del contenedor de backup
│ │ ├── backup.sh # Script mysqldump + rotación
│ │ └── crontab # Programación: todos los días a las 02:00
│ ├── backups/ # Destino de los .sql.gz generados (en el host)
│ ├── .env # Variables secretas (no en git)
│ ├── .env.example # Plantilla de variables
│ └── Dockerfile # Build multi-stage del backend
├── frontend/ # Aplicación React + Vite
│ ├── src/
│ │ ├── app/
│ │ │ ├── components/ # Páginas y componentes UI
│ │ │ └── App.tsx # Router principal y estado de autenticación
│ │ ├── lib/
│ │ │ └── api.ts # fetchWithAuth — wrapper JWT para todas las llamadas
│ │ └── services/ # Servicios por módulo (equipo, ticket, usuario, etc.)
│ └── Dockerfile # Build multi-stage del frontend
├── docusaurus/ # Documentación (este sitio)
│ ├── docs/ # Archivos Markdown
│ ├── src/css/custom.css # Estilos institucionales
│ ├── docusaurus.config.js
│ ├── sidebars.js
│ └── Dockerfile
├── monitoring/ # Configuraciones del stack de monitoreo (opcional)
│ ├── prometheus/
│ │ └── prometheus.yml # Job sgi-backend: raspa /actuator/prometheus cada 15 s
│ ├── loki/
│ │ └── loki-config.yaml # Almacenamiento de logs (boltdb-shipper, schema v11)
│ ├── promtail/
│ │ └── promtail-config.yaml # Recolecta logs de contenedores sgi-full-*
│ └── grafana/
│ └── provisioning/
│ ├── datasources/
│ │ └── datasources.yaml # Prometheus (UID: prometheus-sgi) y Loki (UID: loki-sgi)
│ └── dashboards/
│ ├── dashboards.yaml # Proveedor de tipo "file"
│ └── sgi-backend.json # Dashboard precargado con 17 paneles
├── db_sgi_emch.sql # Script de inicialización de la BD
├── docker-compose.yml # Orquestación del stack principal
└── docker-compose.monitoring.yml # Orquestación del stack de monitoreo (opcional)
Servicios Docker y redes
Stack principal (docker-compose.yml)
┌──────────────────────────────────────────────────────────────────────────────┐
│ proxy_network │
│ ┌────────────┐ ┌───────────────┐ ┌──────────────────┐ ┌──────────┐ │
│ │ frontend │ │ docs │ │ Nginx Proxy Mgr │ │ grafana† │ │
│ │ (Nginx:80) │ │ (Nginx:80) │ │ (externo) │ │ (:3000) │ │
│ └─────┬──────┘ └───────────────┘ └──────────────────┘ └──────────┘ │
└────────│─────────────────────────────────────────────────────────────────────┘
│ sgi_app
┌────────│──────────────────────────┐
│ │ │
│ ┌─────▼──────────┐ │
│ │ backend │ │
│ │ (Spring:8080) │ │
│ └──────┬─────────┘ │
└─────────│─────────────────────────┘
│ sgi_internal
┌─────────│──────────────────────────┐
│ ┌──────▼──────┐ ┌─────────────┐ │
│ │ db │ │ backup │ │
│ │ (MySQL:3306)│ │ (crond) │ │
│ └─────────────┘ └─────────────┘ │
└────────────────────────────────────┘
† Stack de monitoreo (docker-compose.monitoring.yml) — ver diagrama siguiente
Stack de monitoreo (docker-compose.monitoring.yml, opcional)
monitoring_network
┌──────────────────────────────────────────────────────┐
│ │
contenedores│ logs (push HTTP) │
sgi-full-* ─┼──→ promtail ─────────────────────────→ loki (:3100) │
│ │ │
backend │ métricas (scrape 15 s) │ │
(:8080) ────┼──→ prometheus (:9090) ──────────────────── │ │
[sgi_internal] │ │ │
│ ▼ ▼ │
│ grafana (:3000) │
│ │
└──────────────────────────────────────────────────────┘
│
proxy_network
https://sgi-grafana.escuelamilitar.edu.pe
Redes internas
| Red | Propósito | Servicios |
|---|---|---|
sgi_internal | Comunicación privada backend ↔ BD | db, backend, backup, prometheus |
sgi_app | Frontend proxea requests al backend | backend, frontend |
proxy_network | Red externa de Nginx Proxy Manager | frontend, docs, grafana |
monitoring_network | Red interna del stack de monitoreo | prometheus, loki, promtail, grafana |
Volúmenes persistentes
| Volumen | Contenido |
|---|---|
full_mysql_data | Datos de MySQL (tablas, índices, vistas) |
full_pdf_storage | Actas PDF generadas por el sistema (/app/storage/actas) |
prometheus_data | Series temporales de métricas (retención 15 días) |
loki_data | Índice y chunks de logs de contenedores |
grafana_data | Base de datos de Grafana (dashboards personalizados, usuarios, alertas) |
Flujo de una request
Usuario → Nginx Proxy Manager → frontend (Nginx)
↓ /api/*
backend (Spring Boot)
↓
MySQL (via sgi_internal)
El frontend de Nginx actúa como proxy inverso: sirve la SPA de React para cualquier ruta, y reenvía las llamadas a /api/* al contenedor backend dentro de la red sgi_app.