rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
04c2db7bbc
erp-transportistas-v2/orchestration/MAPA-DOCUMENTACION.yml
Adrian Flores Cortes 6ed7f9e2ec [BACKUP] Pre-restructure workspace backup 2026-01-29 
- Updated docs and inventory files
- Added new architecture docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 17:35:54 -06:00

458 lines
16 KiB
YAML
Raw Blame History

# MAPA-DOCUMENTACION.yml - ERP Transportistas
# Indice de documentacion del proyecto
# Sistema SIMCO v4.0.0
# ACTUALIZADO: 2026-01-27 (TASK-007.1 Purga Documental)
version: "2.1.0"
project: "erp-transportistas"
updated: "2026-01-27"
# ═══════════════════════════════════════════════════════════════════════════════
# PATRON DE DOCUMENTACION DE MODULOS
# ═══════════════════════════════════════════════════════════════════════════════
#
# Cada modulo debe tener:
# - README.md: Descripcion tecnica (entidades, API, funcionalidades, dependencias)
# - RESUMEN-EPICA.md: Vision de negocio (objetivos, alcance, metricas, riesgos)
# - REQUERIMIENTOS.md: Requerimientos funcionales detallados
# - historias-usuario/: Directorio con US individuales (US-MAIXX-001.md, etc.)
#
# NOTA: README.md y RESUMEN-EPICA.md son COMPLEMENTARIOS, no duplicados.
# README = perspectiva tecnica | RESUMEN-EPICA = perspectiva de negocio
#
# ═══════════════════════════════════════════════════════════════════════════════
# 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-002-tarifas-sla:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 5
directorio: "historias-usuario/"
MAI-003-ordenes-transporte:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
historias_usuario: 10
directorio: "historias-usuario/"
nota: "README.md incluye notas de epica consolidadas"
MAI-004-planeacion:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-005-despacho:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
pendiente: "Agregar algoritmo de asignacion inteligente (GAP-002)"
MAI-006-tracking:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 10
pendiente: "Agregar GPS multi-provider (GAP-001) y Geofencing avanzado (GAP-006)"
MAI-007-pod-cierre:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-008-incidencias:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-009-facturacion-transporte:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-010-liquidaciones:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-011-gestion-flota:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
pendiente: "Agregar catalogo de motores (GAP-004)"
MAI-012-combustible-gastos:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-013-mantenimiento-flota:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-014-carriers:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAI-015-portal-cliente:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAE-016-carta-porte:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
historias_usuario: 10
directorio: "historias-usuario/"
nota: "README.md incluye notas de epica consolidadas"
MAE-017-hos-bitacora:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
MAE-018-reportes-kpis:
estado: "COMPLETADO"
archivos:
- README.md
- REQUERIMIENTOS.md
- RESUMEN-EPICA.md
historias_usuario: 3
directorio: "historias-usuario/"
modulos_futuros:
- MAA-019 (Optimizacion Rutas - Fase 3)
- MAA-020 (Integraciones EDI - Fase 3)
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: 130
archivos_completados: 115
archivos_parciales: 10
archivos_pendientes: 5
modulos:
total: 20
documentados_completos: 18
documentados_parciales: 0
futuros: 2
user_stories:
existentes: 54
requeridas_estimado: 78
gap: 24
nota: "TASK-007 identifica 15 US adicionales para GPS/Dispatch/Offline"
cobertura_documentacion: "100% (modulos Fase 1 y 2)"
gaps_identificados:
- GAP-001: GPS Multi-Provider (agregar a MAI-006)
- GAP-002: Algoritmo Asignacion Inteligente (agregar a MAI-005)
- GAP-003: Modo Offline para Conductores (nuevo)
- GAP-004: Catalogo de Motores (agregar a MAI-011)
- GAP-005: Templates WhatsApp Transporte (nuevo)
- GAP-006: Geocercas Avanzadas (agregar a MAI-006)
- GAP-007: Multi GPS Providers (agregar a MAI-006)
# ═══════════════════════════════════════════════════════════════════════════════
# 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
- fecha: "2026-01-27"
autor: "TASK-007.1"
cambio: |
Purga y Sincronizacion Documental:
- Estadisticas actualizadas: 18/20 modulos completados
- Patron README + RESUMEN-EPICA documentado
- SERVICES-CATALOG sincronizado con BACKEND_INVENTORY
- 7 gaps identificados con fuente erp-mecanicas-diesel
- Cobertura documentacion actualizada a 100%
# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
created_by: "META-ORQUESTADOR"
created_at: "2026-01-25"
last_audit: "2026-01-27"
auditor: "AUDITOR-FASE-0"
Reference in New Issue View Git Blame Copy Permalink