ALMA

Aplicación web para administrar, supervisar y medir la gestión de la Oficina de Talento Humano y su División de Seguridad y Salud en el Trabajo.

Estado

Las fases 1, 2 y 3 están completadas. La versión actual incluye la fundación técnica, matriz RACI, planeación por periodos, seguimiento versionado, evidencias protegidas y decisiones de jefatura con trazabilidad. La siguiente fase incorporará las fichas y cálculos de indicadores.

El alcance público y el avance por fases se mantienen en docs/CONTEXTO_PUBLICO.md. El contexto institucional detallado se conserva únicamente fuera del control de versiones.

Requisitos

• Python 3.12
• PostgreSQL 18 para entornos compartidos o productivos
• SQLite únicamente para desarrollo local y pruebas rápidas

Puesta en marcha local

En PowerShell:

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
Copy-Item .env.example .env
.\.venv\Scripts\python.exe manage.py migrate
.\.venv\Scripts\python.exe manage.py runserver

La aplicación quedará disponible en http://127.0.0.1:8000/ y la comprobación de salud en http://127.0.0.1:8000/health/.

Después de crear un superusuario, la interfaz funcional está disponible en:

• /cuenta/login/: acceso;
• /panel/: seguimientos propios o vista consolidada de jefatura;
• /planeacion/: ciclos, periodos y programación desde la matriz RACI;
• /admin/: parametrización técnica.

Los archivos cargados no se publican como contenido estático. Su descarga exige autenticación y acceso al seguimiento correspondiente.

Importación de la matriz maestra

La fase 2 incorpora un importador seguro. Sin --commit siempre ejecuta una simulación y revierte todos los cambios:

.\.venv\Scripts\python.exe manage.py import_responsibility_matrix `
  "..\outputs\matriz_responsabilidad_contractual_2026\Matriz_Responsabilidades_TH_Contratistas_R_Final_2026.xlsx" `
  --year 2026

Después de revisar el reporte, la confirmación explícita es:

.\.venv\Scripts\python.exe manage.py import_responsibility_matrix `
  "..\outputs\matriz_responsabilidad_contractual_2026\Matriz_Responsabilidades_TH_Contratistas_R_Final_2026.xlsx" `
  --year 2026 `
  --commit

La importación es idempotente para actividades, fuentes, responsables y asignaciones. Cada ejecución confirmada conserva su propio registro de auditoría e incidencias.

Comprobaciones

.\.venv\Scripts\python.exe manage.py check
.\.venv\Scripts\python.exe -m pytest
.\.venv\Scripts\python.exe -m ruff check .

Contenedores

Para levantar la aplicación y PostgreSQL:

Copy-Item .env.example .env
docker compose up --build

Estructura inicial

alma/
├── docs/                 Contexto, propuesta y decisiones
├── src/
│   ├── alma/             Configuración principal de Django
│   ├── apps/             Módulos funcionales
│   ├── static/           Estilos y recursos
│   └── templates/        Interfaces del servidor
├── tests/                Pruebas automatizadas
├── compose.yaml
├── Dockerfile
├── manage.py
└── pyproject.toml