Contexto del Sistema¶
GexCom opera en el Centro de Servicios Judiciales de Bello como sistema de gestion de comunicaciones judiciales.
Diagrama de Contexto (C4 Level 1)¶
graph TB
subgraph CSJ["Centro de Servicios Judiciales de Bello"]
subgraph GexCom["Sistema GexCom"]
GUI["Streamlit GUI\n:8501"]
API["FastAPI API\n:8000"]
DB[("PostgreSQL 16\n(Docker)")]
GUI --- DB
API --- DB
end
ADMIN["Administrador\n(CRUD completo,\nusuarios, reportes)"]
NOTIF["Notificador\n(procesos, sujetos,\nnotificaciones)"]
ADMIN -->|navega| GUI
NOTIF -->|navega| GUI
end
subgraph External["Sistemas Externos"]
SMTP["Servidor SMTP\n(Email corporativo)"]
META["Meta Graph API\n(WhatsApp Business)"]
INT["Sistema Integrador\n/ Aplicaciones terceras"]
end
subgraph Clients["Destinatarios"]
PARTE["Partes del proceso\n(Demandantes, Demandados,\nTestigos...)"]
end
API -->|REST + JWT| INT
GUI -->|SMTP TLS| SMTP
GUI -->|HTTPS| META
SMTP -->|email| PARTE
META -->|WhatsApp| PARTE
classDef system fill:#1565C0,color:#fff,stroke:#0D47A1
classDef external fill:#455A64,color:#fff,stroke:#263238
classDef user fill:#2E7D32,color:#fff,stroke:#1B5E20
class GUI,API,DB system
class SMTP,META,INT external
class ADMIN,NOTIF,PARTE user
Actores¶
| Actor | Rol | Acceso |
|---|---|---|
| Administrador | Gestiona usuarios, reportes, configuracion completa | GUI (todas las paginas) |
| Notificador | Registra procesos, gestiona sujetos, crea y envia notificaciones | GUI (paginas asignadas) |
| Integrador | Sistemas externos que consumen la API REST | API REST + JWT |
Entornos de Despliegue¶
| Entorno | URL | Base de Datos | Estado |
|---|---|---|---|
| Local desarrollo | localhost:8501 / :8000 | SQLite | Funcional |
| Docker (PG) | localhost:8501 / :8000 / :5050 | PostgreSQL 16 | Funcional |
| Produccion | — | PostgreSQL 16 | Pendiente |
Docker Compose¶
Servicios:
- gexcom-streamlit :8501 (GUI)
- gexcom-api :8000 (API REST — pendiente wiring en Docker)
- postgres :5432 (PostgreSQL 16)
- pgadmin :5050 (Admin PG)
Restricciones Legales¶
- Ley 1581/2012 (Habeas Data): PII de partes procesales enmascarado en UI y excluido de logs
- Inmutabilidad de AuditLog: Los registros de auditoria no pueden ser modificados ni eliminados
- RBAC: Solo usuarios con rol ADMINISTRADOR pueden gestionar usuarios y ver reportes completos