Saltar a contenido

Introduccion a GexCom

GexCom es el sistema de gestion de comunicaciones judiciales del Centro de Servicios Judiciales de Bello (Rama Judicial de Colombia). Permite registrar, gestionar y despachar notificaciones judiciales a las partes procesales por multiples canales.

Que hace GexCom?

graph LR
    A[Ingreso de Proceso] --> B[Registro de Sujetos]
    B --> C[Creacion de Notificacion]
    C --> D{Canal}
    D -->|Email| E[Despacho automatico SMTP]
    D -->|WhatsApp| F[Despacho automatico Meta API]
    D -->|Presencial / Telefono / Correo fisico| G[Gestion manual]
    E --> H[Confirmacion / Fallo]
    F --> H
    G --> H
    H --> I[Audit Trail inmutable]

Acceso al Sistema

GUI Streamlit

Disponible en http://localhost:8501 (local) o la URL de produccion asignada.

Credenciales por defecto (desarrollo):

Usuario Contrasena Rol
admin@csj.gov.co Admin2026! ADMINISTRADOR

Produccion

Cambiar las credenciales antes de desplegar en produccion. La clave secreta JWT debe configurarse como variable de entorno SECRET_KEY.

API REST

Disponible en http://localhost:8000. Documentacion interactiva en /docs (Swagger UI).

Para autenticarse: 

curl -X POST http://localhost:8000/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "admin@csj.gov.co", "password": "Admin2026!"}'

Roles de Usuario

ADMINISTRADOR

Acceso completo al sistema:

  • Gestion de usuarios (crear, editar, activar/desactivar)
  • CRUD de juzgados y procesos
  • Gestion de sujetos y vinculos proceso-sujeto
  • Creacion y seguimiento de notificaciones
  • Programacion y gestion de audiencias
  • Directorio de contactos (vista completa)
  • Reportes completos con exportacion Excel
  • Configuracion del sistema

NOTIFICADOR

Acceso operativo:

  • Registro y consulta de procesos
  • Gestion de sujetos y vinculos
  • Creacion y envio de notificaciones
  • Programacion de audiencias
  • Directorio de contactos (vista enmascarada segun RBAC)
  • Reportes basicos

Paginas de la GUI

Pagina Descripcion Roles
Dashboard Metricas generales del sistema ADMIN, NOTIF
Procesos CRUD de casos judiciales ADMIN, NOTIF
Sujetos Gestion de partes procesales ADMIN, NOTIF
Notificaciones Crear y gestionar notificaciones ADMIN, NOTIF
Notificar Flujo guiado de envio de notificacion ADMIN, NOTIF
Audiencias Programacion y seguimiento de diligencias ADMIN, NOTIF
Directorio Contactos de partes procesales (PII enmascarado) ADMIN, NOTIF
Reportes Estadisticas con exportacion Excel ADMIN
Usuarios Gestion de cuentas del sistema ADMIN
Configuracion Ajustes del sistema ADMIN

Inicio Rapido

# 1. Clonar e instalar
pip install -e ".[dev]"

# 2. Iniciar GUI (SQLite local)
make run
# → http://localhost:8501

# 3. Iniciar con Docker (PostgreSQL)
make docker-up
# → GUI: http://localhost:8501
# → pgAdmin: http://localhost:5050

# 4. Iniciar API REST
uvicorn gexcom.interfaces.api.main:app --reload --port 8000
# → http://localhost:8000/docs