chore: import DH V2 D5.6.4 production baseline

2026-09-05 10:12:35 -03:00
commit 82213e72f5
757 changed files with 84218 additions and 0 deletions
@@ -0,0 +1,46 @@
+# DH Inspección V2 — Fase A1
+
+## Alcance implementado
+
+- entidades TypeORM para usuarios, roles, permisos, sesiones y auditoría;
+- cinco migraciones controladas e independientes de `synchronize`;
+- seed idempotente de roles, permisos y matriz inicial;
+- grants explícitos y default privileges para `dhv2_app`;
+- repositorios base para A2, A4 y A5;
+- servicio Docker temporal para ejecutar migraciones como owner.
+
+No se agregaron endpoints públicos ni autenticación incompleta. El único
+endpoint disponible continúa siendo `/api/v3/health`.
+
+## Migraciones
+
+1. `PhaseAUsersRolesPermissions1786548000000`
+2. `PhaseAAuthSessions1786548001000`
+3. `PhaseAAuditEvents1786548002000`
+4. `PhaseASeedRolesPermissions1786548003000`
+5. `PhaseARuntimeGrants1786548004000`
+
+## Ejecución
+
+```bash
+docker compose --profile tools build api migrate
+docker compose up -d db
+docker compose --profile tools run --rm migrate
+docker compose up -d --no-deps api
+```
+
+## Verificación
+
+```bash
+docker compose --profile tools run --rm migrate npm run migration:show
+docker compose ps
+curl -fsS http://127.0.0.1:3101/api/v3/health
+```
+
+El resultado esperado de `migration:show` es `Pending migrations: no`.
+
+## Reversión inmediata
+
+`migration:revert` revierte una sola migración por ejecución. Sólo debe usarse
+antes de crear usuarios o sesiones reales. Si ya existe actividad, restaurar el
+backup previo en lugar de ejecutar reversiones parciales.