b9098ca91c
Comprehensive analysis of 101 DDL tables across 11 schemas: - Phase 1-2: Schema validation, 37 gaps cataloged (3 resolved) - Phase 3: Integrity audit (80 FKs, 89 CHECKs, 17 issues: 2 CRIT/5 HIGH) - Phase 4: DDL-Backend mapping (84% interfaces, 75% services, 61% controllers) - Phase 5: Documentation purge catalog (201 files analyzed) - Phase 6: Remediation plan (4 sprints, 204h) Key finding: Backend uses raw SQL + pg Pool (NOT TypeORM). 13 deliverables + updated inventories to v2.0.0. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
397 lines
20 KiB
YAML
397 lines
20 KiB
YAML
# ═══════════════════════════════════════════════════════════════════
|
|
# PURGA-DOCUMENTAL.yml - Analisis de Purga Documental
|
|
# Trading Platform - orchestration/tareas/ y directorios relacionados
|
|
# ═══════════════════════════════════════════════════════════════════
|
|
|
|
version: "1.0.0"
|
|
fecha: "2026-02-05"
|
|
tarea: "TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD"
|
|
agente: "Claude Code (Opus 4.6)"
|
|
proyecto: "trading-platform"
|
|
|
|
# ─────────────────────────────────────────────────────────────────
|
|
# RESUMEN
|
|
# ─────────────────────────────────────────────────────────────────
|
|
|
|
resumen:
|
|
total_archivos_analizados: 201
|
|
archivos_a_archivar: 30
|
|
archivos_a_eliminar: 0
|
|
archivos_a_conservar: 171
|
|
directorios_analizados:
|
|
- "orchestration/tareas/2026-01-25/ (22 archivos)"
|
|
- "orchestration/tareas/2026-01-27/ (8 archivos)"
|
|
- "orchestration/tareas/2026-01-28/ (0 archivos - VACIO)"
|
|
- "orchestration/tareas/2026-01-30/ (9 archivos)"
|
|
- "orchestration/tareas/2026-02-03/ (2 archivos)"
|
|
- "orchestration/tareas/TASK-2026-02-03-ANALISIS-DDL-MODELADO/ (11 archivos)"
|
|
- "orchestration/tareas/TASK-2026-02-03-ANALISIS-FRONTEND-UXUI/ (4 archivos)"
|
|
- "orchestration/tareas/TASK-2026-02-03-BACKEND-ENTITIES-SYNC/ (1 archivo)"
|
|
- "orchestration/tareas/TASK-2026-02-04-ANALISIS-PLANIFICACION-INTEGRAL/ (7 archivos)"
|
|
- "orchestration/tareas/TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD/ (5 archivos)"
|
|
- "orchestration/tareas/_archive/ (112 archivos)"
|
|
- "docs/_archive/ (3 archivos)"
|
|
- "orchestration/analisis/coherencia/ (11 archivos)"
|
|
- "orchestration/analisis/_archive/ (6 archivos)"
|
|
|
|
# ─────────────────────────────────────────────────────────────────
|
|
# ACCIONES
|
|
# ─────────────────────────────────────────────────────────────────
|
|
|
|
acciones:
|
|
|
|
# ═════════════════════════════════════════════════════════════
|
|
# ELIMINAR
|
|
# ═════════════════════════════════════════════════════════════
|
|
eliminar:
|
|
- path: "orchestration/tareas/2026-01-28/"
|
|
razon: |
|
|
Directorio COMPLETAMENTE VACIO (0 archivos, 0 subdirectorios).
|
|
No contiene ninguna tarea ni metadata. Fue creado pero nunca utilizado.
|
|
Eliminar para evitar confusion en la estructura de tareas.
|
|
|
|
# ═════════════════════════════════════════════════════════════
|
|
# ARCHIVAR
|
|
# ═════════════════════════════════════════════════════════════
|
|
archivar:
|
|
# --- 2026-01-25: Tareas completadas/canceladas ---
|
|
- path: "orchestration/tareas/2026-01-25/TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT/"
|
|
destino: "orchestration/tareas/_archive/2026-01/TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT/"
|
|
archivos: 16
|
|
razon: |
|
|
Tarea COMPLETADA (100%) con fecha_fin 2026-01-30. Estado: completada.
|
|
7+ entregables generados (COMPONENTS-MASTER-MATRIX.md, API-CONTRACTS-MASTER-MATRIX.md,
|
|
MULTIMEDIA-MASTER-MATRIX.md, PURGE-PLAN.md, INTEGRATION-PLAN.md, DEPENDENCY-GRAPH.md,
|
|
RECOMMENDATIONS.md). Los hallazgos ya fueron incorporados en tareas posteriores
|
|
(TASK-2026-01-30-ANALISIS-INTEGRACION y TASK-2026-02-03-ANALISIS-FRONTEND-UXUI).
|
|
Candidata a archivo historico.
|
|
|
|
- path: "orchestration/tareas/2026-01-25/TASK-2026-01-25-FRONTEND-MODULE-DOCS/"
|
|
destino: "orchestration/tareas/_archive/2026-01/TASK-2026-01-25-FRONTEND-MODULE-DOCS/"
|
|
archivos: 6
|
|
razon: |
|
|
Tarea CANCELADA el 2026-01-30 con 0% de progreso. Prioridad P3.
|
|
Razon de cancelacion: dependia de TASK-002 que ya fue completada.
|
|
Los modulos ya tienen documentacion base en sus carpetas.
|
|
No tiene valor operativo; archivar como registro historico.
|
|
|
|
# --- 2026-01-27: Tarea supersedida ---
|
|
- path: "orchestration/tareas/2026-01-27/TASK-2026-01-27-MASTER-ANALYSIS-PLAN/"
|
|
destino: "orchestration/tareas/_archive/2026-01/TASK-2026-01-27-MASTER-ANALYSIS-PLAN/"
|
|
archivos: 4
|
|
razon: |
|
|
Tarea explicitamente marcada como SUPERSEDIDA por TASK-2026-01-30-ANALISIS-INTEGRACION.
|
|
Sus hallazgos (DDL completeness, backend-frontend coherence, ML pipeline analysis)
|
|
fueron incorporados en la tarea sucesora. METADATA.yml confirma:
|
|
"supersedida_por: TASK-2026-01-30-ANALISIS-INTEGRACION".
|
|
Archivar como registro historico de decision.
|
|
|
|
# --- 2026-02-03 date directory: Supersedida ---
|
|
- path: "orchestration/tareas/2026-02-03/TASK-2026-02-03-DDL-VALIDATION/"
|
|
destino: "orchestration/tareas/_archive/2026-02/TASK-2026-02-03-DDL-VALIDATION/"
|
|
archivos: 2
|
|
razon: |
|
|
Tarea de validacion DDL con status "in_progress" pero SUPERSEDIDA de facto por
|
|
TASK-2026-02-03-ANALISIS-DDL-MODELADO (11 archivos, 88% progreso) y posteriormente
|
|
por TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD (tarea actual).
|
|
TASK-2026-02-04-ANALISIS-PLANIFICACION-INTEGRAL la lista explicitamente en
|
|
"documentacion_a_purgar". Sus analisis de conflictos C1-C5 y gaps GAP-EDU/TRD/PAY/INV
|
|
estan cubiertos con mayor detalle en las tareas sucesoras.
|
|
|
|
# --- Coherencia: Baselines supersedidos ---
|
|
- path: "orchestration/analisis/coherencia/COHERENCE-BASELINE-2026-01-28.md"
|
|
destino: "orchestration/analisis/_archive/2026-01/COHERENCE-BASELINE-2026-01-28.md"
|
|
archivos: 1
|
|
razon: |
|
|
Baseline de coherencia del 2026-01-28 con metricas obsoletas:
|
|
DDL-Backend 31%, Frontend Tests 5%, Global 39.6%.
|
|
Supersedido por metricas actuales en TASK-2026-02-05 (DDL-Backend 85%,
|
|
Global 81.25%) y COHERENCE-MASTER-REPORT.md (Global 81.25%).
|
|
Las metricas baseline ya no reflejan el estado del proyecto.
|
|
Archivar como referencia historica de progreso.
|
|
|
|
- path: "orchestration/analisis/coherencia/COHERENCE-FINAL-2026-01-28.md"
|
|
destino: "orchestration/analisis/_archive/2026-01/COHERENCE-FINAL-2026-01-28.md"
|
|
archivos: 1
|
|
razon: |
|
|
Reporte "final" del 2026-01-28 que reportaba Global ~75%. Fue un checkpoint
|
|
intermedio, no un reporte final real. Las metricas han sido actualizadas
|
|
multiples veces desde entonces (ahora Global 81.25%+).
|
|
COHERENCE-MASTER-REPORT.md y los analisis de Feb 2026 lo reemplazan.
|
|
Archivar como referencia historica de progreso.
|
|
|
|
# ═════════════════════════════════════════════════════════════
|
|
# CONSERVAR
|
|
# ═════════════════════════════════════════════════════════════
|
|
conservar:
|
|
# --- 2026-01-27: Tarea postergada pero potencialmente reactivable ---
|
|
- path: "orchestration/tareas/2026-01-27/TASK-2026-01-27-BLOCKER-001-TOKEN-REFRESH/"
|
|
archivos: 4
|
|
razon: |
|
|
Tarea POSTERGADA (no cancelada ni supersedida) con estado explicito "postergada".
|
|
0% de progreso pero contiene contexto y plan detallado para mejoras de seguridad
|
|
(rate limiting, token rotation, session validation, proactive refresh).
|
|
Auto-refresh funciona al 90%; estas son mejoras pendientes reactivables.
|
|
CONSERVAR en ubicacion actual para futura reactivacion.
|
|
|
|
# --- 2026-01-30: Tarea completada con valor de referencia vigente ---
|
|
- path: "orchestration/tareas/2026-01-30/TASK-2026-01-30-ANALISIS-INTEGRACION/"
|
|
archivos: 9
|
|
razon: |
|
|
Tarea COMPLETADA el 2026-01-30 con todos los sprints ejecutados (1-4).
|
|
Contiene entregables con valor de referencia vigente:
|
|
- COHERENCE-INVENTARIOS-WORKSPACE-PROYECTO.md (coherencia workspace-proyecto)
|
|
- TEMPLATE-SAAS-INTEGRATION-MATRIX.md (matriz reutilizacion modulos)
|
|
- GAPS-MATRIX-CONSOLIDATED.md (gaps consolidados)
|
|
- EXECUTION-PLAN-HIERARCHICAL.md (plan ejecucion)
|
|
Referenciada activamente por tareas posteriores. CONSERVAR.
|
|
|
|
# --- 2026-02-03: Tareas recientes con valor operativo activo ---
|
|
- path: "orchestration/tareas/TASK-2026-02-03-ANALISIS-DDL-MODELADO/"
|
|
archivos: 11
|
|
razon: |
|
|
Tarea reciente (2026-02-03), 88% completada. Contiene inventarios DDL activos:
|
|
DDL-VALIDATION-MATRIX.yml, DDL-CONFLICTS-REGISTRY.yml, DDL-GAPS-REGISTRY.yml.
|
|
Referenciada por TASK-2026-02-04 y TASK-2026-02-05 como input. CONSERVAR.
|
|
|
|
- path: "orchestration/tareas/TASK-2026-02-03-ANALISIS-FRONTEND-UXUI/"
|
|
archivos: 4
|
|
razon: |
|
|
Tarea reciente COMPLETADA (100%). Define 12 subtareas frontend pendientes
|
|
de ejecucion (SUBTASK-001 a SUBTASK-012). Plan activo de implementacion.
|
|
Referenciada como input por TASK-2026-02-04. CONSERVAR.
|
|
|
|
- path: "orchestration/tareas/TASK-2026-02-03-BACKEND-ENTITIES-SYNC/"
|
|
archivos: 1
|
|
razon: |
|
|
Tarea reciente COMPLETADA (100%) el 2026-02-04.
|
|
Documenta 5 servicios backend creados (instructor, tag, drawing,
|
|
prediction-overlay, refund). Registro de commits incluido.
|
|
Valor como referencia de lo implementado. CONSERVAR.
|
|
|
|
- path: "orchestration/tareas/TASK-2026-02-04-ANALISIS-PLANIFICACION-INTEGRAL/"
|
|
archivos: 7
|
|
razon: |
|
|
Tarea reciente EN PROGRESO (25%). Contiene CONSOLIDADO-GAPS.yml y
|
|
planes de delegacion activos. 35 subtareas definidas, 558 story points mapeados.
|
|
Bloquea ejecucion de Sprint 1 Frontend y FASE_1 DDL. CONSERVAR.
|
|
|
|
- path: "orchestration/tareas/TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD/"
|
|
archivos: 5
|
|
razon: |
|
|
Tarea ACTUAL en ejecucion. CONSERVAR obligatoriamente.
|
|
|
|
# --- _archive tareas: Registro historico consolidado ---
|
|
- path: "orchestration/tareas/_archive/"
|
|
archivos: 112
|
|
razon: |
|
|
Archivo historico consolidado con 21+ tareas de enero 2026.
|
|
Ya fue curado en TASK-2026-01-30-ANALISIS-INTEGRACION (Sprint 3).
|
|
Contiene 19 subdirectorios con tareas archivadas correctamente.
|
|
Politica establece: NO eliminar archivos de _archive. CONSERVAR.
|
|
|
|
# --- docs/_archive: Registro historico documentacion ---
|
|
- path: "docs/_archive/"
|
|
archivos: 3
|
|
razon: |
|
|
Archivo historico de documentacion con README indice propio.
|
|
Contiene:
|
|
- NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md (resuelta 2026-01-07)
|
|
- 04-fase-backlog/README.md (deprecado por referencias rotas)
|
|
- README.md (indice del archivo)
|
|
Politica establece: "NO deben ser eliminados, sirven como registro historico".
|
|
CONSERVAR.
|
|
|
|
# --- Coherencia: Documentos activos ---
|
|
- path: "orchestration/analisis/coherencia/COHERENCE-MASTER-REPORT.md"
|
|
archivos: 1
|
|
razon: |
|
|
Reporte maestro de coherencia con metricas globales vigentes (81.25%).
|
|
Referenciado por TASK-2026-02-05 como fuente de referencia. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/DDL-COMPLETE-MATRIX.yml"
|
|
archivos: 1
|
|
razon: |
|
|
Matriz completa DDL con 89+ tablas documentadas, enums, funciones, triggers.
|
|
Referenciado activamente por multiples tareas de analisis. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/DDL-BACKEND-COHERENCE.yml"
|
|
archivos: 1
|
|
razon: |
|
|
Analisis detallado de coherencia DDL-Backend por schema. 36 servicios evaluados.
|
|
18 gaps identificados y priorizados. Referencia activa. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/GAPS-TRACKING.yml"
|
|
archivos: 1
|
|
razon: |
|
|
Tracking activo de gaps pendientes. Documento operativo. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/RESUMEN-EJECUTIVO.md"
|
|
archivos: 1
|
|
razon: |
|
|
Overview ejecutivo para stakeholders. Documento vigente. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/_INDEX.md"
|
|
archivos: 1
|
|
razon: |
|
|
Indice del directorio de coherencia. Documento estructural. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/README.md"
|
|
archivos: 1
|
|
razon: |
|
|
README del directorio. Documento estructural. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/AUDIT-DDL-BACKEND.md"
|
|
archivos: 1
|
|
razon: |
|
|
Auditoria DDL-Backend del 2026-01-28. Metricas de coherencia 31% (baseline)
|
|
que contrastan con valores actuales (85%). Sin embargo, contiene mapeo
|
|
detallado de tablas orphan que sigue siendo referencia util.
|
|
Metricas desactualizadas pero mapeo de detalle aun relevante. CONSERVAR.
|
|
|
|
- path: "orchestration/analisis/coherencia/AUDIT-BACKEND-FRONTEND.md"
|
|
archivos: 1
|
|
razon: |
|
|
Auditoria Backend-Frontend del 2026-01-28. 208 endpoints mapeados,
|
|
147 con consumidor, 11 services frontend faltantes. Referencia
|
|
detallada aun util para implementacion. CONSERVAR.
|
|
|
|
# --- analisis/_archive: Historico de analisis ---
|
|
- path: "orchestration/analisis/_archive/"
|
|
archivos: 6
|
|
razon: |
|
|
Archivo historico de analisis OQI-001 del 2026-01-25 (5 archivos) + indice.
|
|
Ya fue movido a _archive correctamente. CONSERVAR como registro historico.
|
|
|
|
# ─────────────────────────────────────────────────────────────────
|
|
# RESUMEN POR DIRECTORIO
|
|
# ─────────────────────────────────────────────────────────────────
|
|
|
|
resumen_por_directorio:
|
|
|
|
"orchestration/tareas/2026-01-25/":
|
|
total_archivos: 22
|
|
decision: ARCHIVAR
|
|
detalle: |
|
|
2 tareas: 1 completada (FRONTEND-COMPREHENSIVE-AUDIT, 16 archivos)
|
|
y 1 cancelada (FRONTEND-MODULE-DOCS, 6 archivos).
|
|
Ambas sin valor operativo actual. Hallazgos ya absorbidos
|
|
por tareas posteriores. Mover completo a _archive/2026-01/.
|
|
|
|
"orchestration/tareas/2026-01-27/":
|
|
total_archivos: 8
|
|
decision: MIXTO
|
|
detalle: |
|
|
2 tareas: MASTER-ANALYSIS-PLAN (SUPERSEDIDA, 4 archivos) -> ARCHIVAR
|
|
y BLOCKER-001-TOKEN-REFRESH (POSTERGADA, 4 archivos) -> CONSERVAR.
|
|
La tarea postergada tiene potencial de reactivacion.
|
|
|
|
"orchestration/tareas/2026-01-28/":
|
|
total_archivos: 0
|
|
decision: ELIMINAR
|
|
detalle: |
|
|
Directorio completamente vacio. Sin archivos, sin subdirectorios.
|
|
Creado pero nunca utilizado. Eliminar directorio vacio.
|
|
|
|
"orchestration/tareas/2026-01-30/":
|
|
total_archivos: 9
|
|
decision: CONSERVAR
|
|
detalle: |
|
|
1 tarea COMPLETADA (ANALISIS-INTEGRACION) con 9 entregables de referencia
|
|
activa. Referenciada por tareas actuales. Conservar integramente.
|
|
|
|
"orchestration/tareas/2026-02-03/":
|
|
total_archivos: 2
|
|
decision: ARCHIVAR
|
|
detalle: |
|
|
1 tarea (DDL-VALIDATION) supersedida de facto por TASK-2026-02-03-ANALISIS-DDL-MODELADO
|
|
y TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD.
|
|
TASK-2026-02-04 la lista como "documentacion_a_purgar".
|
|
|
|
"orchestration/tareas/TASK-2026-02-03-*":
|
|
total_archivos: 16
|
|
decision: CONSERVAR
|
|
detalle: |
|
|
3 tareas recientes (DDL-MODELADO 88%, FRONTEND-UXUI 100%, BACKEND-SYNC 100%).
|
|
Todas con valor operativo activo y referenciadas como input por tareas
|
|
en progreso. Conservar integramente.
|
|
|
|
"orchestration/tareas/TASK-2026-02-04-*":
|
|
total_archivos: 7
|
|
decision: CONSERVAR
|
|
detalle: |
|
|
1 tarea EN PROGRESO (25%). Plan integral con 35 subtareas y 558 SP.
|
|
Bloquea ejecucion de sprints. Conservar obligatoriamente.
|
|
|
|
"orchestration/tareas/TASK-2026-02-05-*":
|
|
total_archivos: 5
|
|
decision: CONSERVAR
|
|
detalle: "Tarea actual en ejecucion. Conservar obligatoriamente."
|
|
|
|
"orchestration/tareas/_archive/":
|
|
total_archivos: 112
|
|
decision: CONSERVAR
|
|
detalle: |
|
|
Archivo historico consolidado. 21+ tareas archivadas en 19 subdirectorios.
|
|
Politica de archivo establece que NO se eliminan. Ya fue curado en Sprint 3
|
|
de TASK-2026-01-30-ANALISIS-INTEGRACION.
|
|
|
|
"docs/_archive/":
|
|
total_archivos: 3
|
|
decision: CONSERVAR
|
|
detalle: |
|
|
Archivo historico con indice propio. 2 documentos archivados + README.
|
|
Politica establece: "NO deben ser eliminados". Conservar.
|
|
|
|
"orchestration/analisis/coherencia/":
|
|
total_archivos: 11
|
|
decision: MIXTO
|
|
detalle: |
|
|
9 archivos CONSERVAR (documentos activos y de referencia vigente).
|
|
2 archivos ARCHIVAR (COHERENCE-BASELINE-2026-01-28.md y
|
|
COHERENCE-FINAL-2026-01-28.md con metricas obsoletas).
|
|
|
|
"orchestration/analisis/_archive/":
|
|
total_archivos: 6
|
|
decision: CONSERVAR
|
|
detalle: "Archivo historico ya consolidado. Conservar como registro."
|
|
|
|
# ─────────────────────────────────────────────────────────────────
|
|
# NOTAS
|
|
# ─────────────────────────────────────────────────────────────────
|
|
|
|
notas: |
|
|
1. DIRECTORIO VACIO: orchestration/tareas/2026-01-28/ es el unico directorio
|
|
completamente vacio encontrado. Se marca para eliminacion (no hay datos que perder).
|
|
|
|
2. PATRON DE SUPERSESION: Se detecta un patron de tareas de analisis que se
|
|
superseden entre si: MASTER-ANALYSIS-PLAN -> ANALISIS-INTEGRACION -> DDL-VALIDATION
|
|
-> ANALISIS-DDL-MODELADO -> ANALISIS-VALIDACION-MODELADO-BD (actual).
|
|
Las tareas supersedidas deben archivarse para no generar confusion.
|
|
|
|
3. CONVENCION DE NAMING: Se observan dos convenciones de directorios de tareas:
|
|
- Por fecha: 2026-01-25/, 2026-01-27/, etc. (contienen subdirectorios TASK-*)
|
|
- Por ID: TASK-2026-02-03-*, TASK-2026-02-04-*, etc. (directamente en tareas/)
|
|
Recomendacion: estandarizar en una sola convencion para futuras tareas.
|
|
|
|
4. VOLUMEN DE ARCHIVO: _archive/ contiene 112 archivos en 19 subdirectorios.
|
|
Considerar una revision periodica (trimestral) para comprimir o consolidar
|
|
tareas muy antiguas en un solo reporte resumen.
|
|
|
|
5. METRICAS DESACTUALIZADAS: Los reportes de coherencia de 2026-01-28 muestran
|
|
metricas significativamente diferentes a las actuales (31% vs 85% DDL-Backend).
|
|
Esto valida la necesidad de archivar los baselines obsoletos y mantener solo
|
|
el COHERENCE-MASTER-REPORT.md actualizado.
|
|
|
|
6. IMPACTO ESTIMADO: Las acciones de archivado propuestas reduciran 30 archivos
|
|
de los directorios activos, manteniendo solo contenido operativamente relevante.
|
|
El directorio vacio eliminado no impacta datos.
|
|
|
|
7. PREREQUISITO: Antes de ejecutar estas acciones, actualizar _INDEX.yml del
|
|
directorio tareas/ para reflejar los movimientos. Verificar que las referencias
|
|
cruzadas en METADATA.yml de tareas activas no se rompen.
|
|
|
|
# ═══════════════════════════════════════════════════════════════════
|
|
# FIN DE PURGA-DOCUMENTAL.yml
|
|
# ═══════════════════════════════════════════════════════════════════
|