erp-transportistas-v2/orchestration/MAPA-DOCUMENTACION.yml
Adrian Flores Cortes 4bbace6345 docs(auditoria): Fase 0 - Purga y correccion de documentacion
CORRECCION CRITICA:
- Porcentaje backend corregido de 40% a 15%
- Entities: 153 total (109 heredadas + 44 propias)
- Entities especializadas disenadas sin implementar: ~58

Cambios:
- BACKEND_INVENTORY.yml: Reescrito con estado real
- ENTITIES-CATALOG.md: Separacion IMPLEMENTADAS vs DISENADAS
- PROXIMA-ACCION.md: Porcentajes corregidos, gaps identificados
- MAPA-DOCUMENTACION.yml: Estructura actualizada
- MASTER_INVENTORY.yml: Nuevo inventario consolidado

Carpetas vacias eliminadas:
- docs/01-analisis-referencias/
- docs/10-modelado/
- docs/20-user-stories/
- docs/30-integraciones/
- docs/90-transversal/
- docs/97-adr/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 01:22:27 -06:00

327 lines
11 KiB
YAML

# MAPA-DOCUMENTACION.yml - ERP Transportistas
# Indice de documentacion del proyecto
# Sistema SIMCO v4.0.0
# ACTUALIZADO: 2026-01-27 (Auditoria Fase 0)
version: "2.0.0"
project: "erp-transportistas"
updated: "2026-01-27"
# ═══════════════════════════════════════════════════════════════════════════════
# ESTRUCTURA DE DOCUMENTACION (ACTUAL)
# ═══════════════════════════════════════════════════════════════════════════════
estructura:
raiz:
- archivo: "CLAUDE.md"
tipo: "configuracion"
descripcion: "Instrucciones para Claude Code"
estado: "completado"
- archivo: "README.md"
tipo: "documentacion"
descripcion: "Documentacion general del proyecto"
estado: "completado"
- archivo: "PROJECT-STATUS.md"
tipo: "estado"
descripcion: "Estado actual del proyecto"
estado: "requiere_actualizacion"
- archivo: "INVENTARIO.yml"
tipo: "inventario"
descripcion: "Inventario SIMCO del proyecto"
estado: "completado"
docs:
_definitions:
descripcion: "Definiciones centralizadas"
archivos:
- archivo: "_INDEX.yml"
estado: "completado"
- archivo: "MODULES-CATALOG.md"
estado: "completado"
- archivo: "ENTITIES-CATALOG.md"
estado: "corregido_2026-01-27"
- archivo: "SERVICES-CATALOG.md"
estado: "pendiente"
- archivo: "DATABASE-SCHEMA.md"
estado: "completado"
_quick:
descripcion: "Referencias rapidas"
archivos:
- archivo: "QUICK-INDEX.yml"
estado: "completado"
- archivo: "QUICK-MODULES.yml"
estado: "completado"
- archivo: "QUICK-DATABASE.yml"
estado: "completado"
- archivo: "QUICK-API.yml"
estado: "completado"
00-vision-general:
descripcion: "Vision del producto"
archivos:
- archivo: "VISION-ERP-TRANSPORTISTAS.md"
estado: "completado"
02-definicion-modulos:
descripcion: "Definicion funcional de modulos"
estado_general: "parcial"
modulos_documentados:
MAI-003-ordenes-transporte:
estado: "80%"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 10
directorio: "historias-usuario/"
MAI-006-tracking:
estado: "60%"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 0
MAI-011-gestion-flota:
estado: "60%"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 0
MAI-012-combustible-gastos:
estado: "30%"
archivos:
- ENTITIES.md
historias_usuario: 0
MAI-009-facturacion-transporte:
estado: "10%"
archivos:
- ENTITIES.md
historias_usuario: 0
MAE-016-carta-porte:
estado: "80%"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 10
directorio: "historias-usuario/"
modulos_sin_documentacion:
- MAI-002
- MAI-004
- MAI-005
- MAI-007
- MAI-008
- MAI-010
- MAI-013
- MAI-014
- MAI-015
- MAE-017
- MAE-018
- MAA-019
- MAA-020
03-requerimientos:
descripcion: "Requerimientos del giro"
archivos:
- archivo: "REQ-GIRO-TRANSPORTISTA.md"
estado: "completado"
rf_definidos: 68
procesos: 13
orchestration:
raiz:
- archivo: "BOOTLOADER.md"
tipo: "configuracion"
estado: "completado"
- archivo: "PROJECT-PROFILE.yml"
tipo: "perfil"
estado: "completado"
- archivo: "CONTEXT-MAP.yml"
tipo: "mapa"
estado: "completado"
- archivo: "DEPENDENCY-GRAPH.yml"
tipo: "dependencias"
estado: "completado"
- archivo: "MAPA-DOCUMENTACION.yml"
tipo: "indice"
estado: "actualizado_2026-01-27"
- archivo: "PROXIMA-ACCION.md"
tipo: "planificacion"
estado: "actualizado_2026-01-27"
inventarios:
descripcion: "Inventarios sincronizados"
archivos:
- archivo: "DATABASE_INVENTORY.yml"
estado: "completado"
- archivo: "BACKEND_INVENTORY.yml"
estado: "corregido_2026-01-27"
- archivo: "MASTER_INVENTORY.yml"
estado: "nuevo_2026-01-27"
tareas:
descripcion: "Historial de tareas"
estructura: "TASK-YYYY-MM-DD-{nombre}/"
tareas_existentes:
- TASK-2026-01-25-001-CREAR-PROYECTO
- TASK-2026-01-25-DOCUMENTACION-MODULOS
# ═══════════════════════════════════════════════════════════════════════════════
# CARPETAS ELIMINADAS (2026-01-27)
# ═══════════════════════════════════════════════════════════════════════════════
eliminadas_auditoria:
fecha: "2026-01-27"
razon: "Carpetas vacias sin contenido"
carpetas:
- "docs/01-analisis-referencias/"
- "docs/10-modelado/"
- "docs/20-user-stories/"
- "docs/30-integraciones/"
- "docs/90-transversal/"
- "docs/97-adr/"
# ═══════════════════════════════════════════════════════════════════════════════
# DOCUMENTOS PENDIENTES (PRIORIZADOS)
# ═══════════════════════════════════════════════════════════════════════════════
pendientes:
P0_inmediato:
- path: "docs/02-definicion-modulos/MAI-007-pod-cierre/"
descripcion: "Modulo critico - bloquea facturacion"
archivos_requeridos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
- historias-usuario/ (5-10 US)
- path: "docs/02-definicion-modulos/MAI-004-planeacion/"
descripcion: "Workflow critico"
archivos_requeridos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
- historias-usuario/ (5-10 US)
- path: "docs/02-definicion-modulos/MAI-005-despacho/"
descripcion: "Workflow + NOM-068"
archivos_requeridos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
- historias-usuario/ (5-10 US)
- path: "docs/02-definicion-modulos/MAI-002-tarifas-sla/"
descripcion: "Base comercial"
archivos_requeridos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
- historias-usuario/ (5-10 US)
P1_corto_plazo:
- path: "docs/02-definicion-modulos/MAI-009-facturacion-transporte/"
descripcion: "Completar documentacion (tiene ENTITIES.md)"
archivos_faltantes:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
- path: "docs/02-definicion-modulos/MAI-010-liquidaciones/"
descripcion: "Pago operadores"
- path: "docs/02-definicion-modulos/MAI-008-incidencias/"
descripcion: "Soporte operativo"
- path: "docs/02-definicion-modulos/MAI-006-tracking/historias-usuario/"
descripcion: "Agregar 5-10 user stories"
- path: "docs/02-definicion-modulos/MAI-011-gestion-flota/historias-usuario/"
descripcion: "Agregar 5-10 user stories"
P2_mediano_plazo:
- path: "docs/02-definicion-modulos/MAI-012-combustible-gastos/"
descripcion: "Completar (tiene ENTITIES.md)"
- path: "docs/02-definicion-modulos/MAI-013-mantenimiento/"
descripcion: "Mantenimiento flota"
- path: "docs/02-definicion-modulos/MAI-014-carriers/"
descripcion: "Terceros"
- path: "docs/02-definicion-modulos/MAE-017-hos-bitacora/"
descripcion: "Compliance HOS"
- path: "docs/02-definicion-modulos/MAE-018-reportes-kpis/"
descripcion: "Analytics"
# ═══════════════════════════════════════════════════════════════════════════════
# ESTADISTICAS (CORREGIDAS)
# ═══════════════════════════════════════════════════════════════════════════════
estadisticas:
total_archivos_docs: 45
archivos_completados: 32
archivos_parciales: 8
archivos_pendientes: "~40 (modulos sin documentar)"
modulos:
total: 20
documentados_completos: 2
documentados_parciales: 4
sin_documentar: 14
user_stories:
existentes: 30
requeridas_estimado: 180
gap: 150
cobertura_documentacion: "25%"
# ═══════════════════════════════════════════════════════════════════════════════
# HISTORIAL
# ═══════════════════════════════════════════════════════════════════════════════
historial:
- fecha: "2026-01-25"
autor: "META-ORQUESTADOR"
cambio: "Creacion inicial"
- fecha: "2026-01-27"
autor: "AUDITOR"
cambio: |
Auditoria Fase 0:
- Eliminadas 6 carpetas vacias
- Estadisticas corregidas
- Pendientes priorizados
- Estructura actualizada
# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
created_by: "META-ORQUESTADOR"
created_at: "2026-01-25"
last_audit: "2026-01-27"
auditor: "AUDITOR-FASE-0"