michangarrito/orchestration/MAPA-DOCUMENTACION.yml
rckrdmrd e046ba8143 [MICHANGARRITO] feat: Add SaaS documentation structure from template-saas
- Add orchestration/directivas/ with proyecto-triggers
  - TRIGGER-COHERENCIA-CAPAS.md for DDL/Backend coherence
  - TRIGGER-INVENTARIOS.md for inventory synchronization
- Add orchestration/agents/ with perfiles
  - PERFIL-DDL-AGENT.md
  - PERFIL-BACKEND-AGENT.md
  - PERFIL-FRONTEND-AGENT.md
  - PERFIL-MOBILE-AGENT.md (specific to mobile POS)
- Add MAPA-DOCUMENTACION.yml as central reference

Inheritance: INTEGRATES from template-saas

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 19:45:42 -06:00

166 lines
4.2 KiB
YAML

# ===============================================================================
# MAPA DE DOCUMENTACION - MICHANGARRITO
# ===============================================================================
#
# Proposito: Centro de referencias a toda la documentacion del proyecto
# Alias: @MC_MAPA_DOC
# Herencia: INTEGRATES de template-saas
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "michangarrito"
tipo: "INTEGRATES"
hereda_de: "template-saas"
nivel: 1
# -------------------------------------------------------------------------------
# DOCUMENTACION DE USUARIO (docs/)
# -------------------------------------------------------------------------------
docs:
raiz:
README.md:
alias: "@MC_README"
descripcion: "Punto de entrada del proyecto"
vision:
ruta: "docs/00-vision-general/"
archivos:
- VISION-PROYECTO.md
- ARQUITECTURA-TECNICA.md
- REQUERIMIENTOS-FUNCIONALES.md
epicas:
ruta: "docs/01-epicas/"
alias: "@MC_EPICAS"
descripcion: "Epicas del proyecto POS"
especificaciones:
ruta: "docs/02-especificaciones/"
alias: "@MC_SPECS"
transversal:
ruta: "docs/90-transversal/"
alias: "@MC_TRANSVERSAL"
# -------------------------------------------------------------------------------
# DOCUMENTACION OPERACIONAL (orchestration/)
# -------------------------------------------------------------------------------
orchestration:
raiz:
README.md:
alias: "@MC_ORCH_README"
_MAP.md:
alias: "@MC_ORCH_MAP"
PROJECT-STATUS.md:
alias: "@MC_STATUS"
descripcion: "Estado actual del proyecto"
PROXIMA-ACCION.md:
alias: "@MC_NEXT"
descripcion: "Siguiente tarea a ejecutar"
trazabilidad:
CONTEXT-MAP.yml:
alias: "@MC_CONTEXT"
descripcion: "Mapeo de contexto"
_inheritance.yml:
alias: "@MC_INHERITANCE"
descripcion: "Herencia: INTEGRATES template-saas"
inventarios:
ruta: "orchestration/inventarios/"
alias: "@MC_INV"
archivos:
MASTER_INVENTORY.yml:
alias: "@MC_INV_MASTER"
DATABASE_INVENTORY.yml:
alias: "@MC_INV_DB"
BACKEND_INVENTORY.yml:
alias: "@MC_INV_BE"
FRONTEND_INVENTORY.yml:
alias: "@MC_INV_FE"
MOBILE_INVENTORY.yml:
alias: "@MC_INV_MOBILE"
directivas:
ruta: "orchestration/directivas/"
alias: "@MC_DIRECTIVAS"
hereda_de: "@WS_DIRECTIVAS"
archivos:
- README.md
- proyecto-triggers/TRIGGER-COHERENCIA-CAPAS.md
- proyecto-triggers/TRIGGER-INVENTARIOS.md
agentes:
ruta: "orchestration/agents/"
alias: "@MC_AGENTS"
archivos:
perfiles:
- PERFIL-DDL-AGENT.md
- PERFIL-BACKEND-AGENT.md
- PERFIL-FRONTEND-AGENT.md
- PERFIL-MOBILE-AGENT.md
trazas:
- _INDEX.yml
trazas:
ruta: "orchestration/trazas/"
alias: "@MC_TRAZAS"
# -------------------------------------------------------------------------------
# REFERENCIAS AL WORKSPACE
# -------------------------------------------------------------------------------
workspace_refs:
archivo: "orchestration/_refs/WS-REFERENCES.yml"
alias: "@MC_WS_REFS"
contenido:
- "@WS_DIRECTIVAS"
- "@WS_PERFILES"
- "@WS_TEMPLATES"
- "@WS_DEFINITIONS"
# -------------------------------------------------------------------------------
# ESTADISTICAS
# -------------------------------------------------------------------------------
estadisticas:
docs:
total_archivos: "~30"
carpetas: 5
orchestration:
total_archivos: "~20"
inventarios: 5
trazas: 1
total_aliases: 25
cobertura_documentacion: "90%"
ultima_auditoria: "2026-01-16"
# -------------------------------------------------------------------------------
# NAVEGACION RAPIDA POR ROL
# -------------------------------------------------------------------------------
por_rol:
desarrollador_backend:
inicio: "@MC_INV_BE"
api: "@MC_SPECS"
desarrollador_frontend:
inicio: "@MC_INV_FE"
api: "@MC_SPECS"
desarrollador_mobile:
inicio: "@MC_INV_MOBILE"
api: "@MC_SPECS"
dba:
inicio: "@MC_INV_DB"
orquestador:
inicio: "@MC_STATUS"
siguiente: "@MC_NEXT"