clinica-dental/orchestration/MAPA-DOCUMENTACION.yml
rckrdmrd ebdab354e8 [clinica-dental] feat: Add SaaS documentation from erp-clinicas chain
- Add orchestration/directivas/ with TRIGGER-COHERENCIA-CAPAS.md and
  TRIGGER-INVENTARIOS.md adapted for dental domain
- Add orchestration/agents/perfiles/ with specialized agents:
  - PERFIL-ODONTOLOGO-AGENT.yml (domain expert)
  - PERFIL-DDL-DENTAL-AGENT.yml (database specialist)
  - _INDEX.yml (agents catalog)
- Add MAPA-DOCUMENTACION.yml with full heritage chain references:
  - template-saas (origin/PROVIDER)
  - erp-core (abuelo/INTERMEDIATE)
  - erp-clinicas (padre/CONSUMER)
- Include normative references: NOM-013-SSA2-2015, NOM-004-SSA3-2012, COFEPRIS
- Define @DENTAL_ prefixed aliases for project navigation

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

357 lines
9.7 KiB
YAML

# ===============================================================================
# MAPA DE DOCUMENTACION - CLINICA DENTAL
# ===============================================================================
#
# Proposito: Centro de referencias a toda la documentacion del proyecto
# Alias: @DENTAL_MAPA_DOC
# Tipo: SUB-VERTICAL (hereda de erp-clinicas)
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "clinica-dental"
tipo: "SUB-VERTICAL"
nivel: 3
# -------------------------------------------------------------------------------
# CADENA DE HERENCIA COMPLETA
# -------------------------------------------------------------------------------
cadena_herencia:
origen:
proyecto: "template-saas"
tipo: "PROVIDER"
nivel: 0
alias: "@TS_MAPA_DOC"
ubicacion: "projects/template-saas/orchestration/MAPA-DOCUMENTACION.yml"
abuelo:
proyecto: "erp-core"
tipo: "INTERMEDIATE"
nivel: 1
alias: "@ERP_MAPA_DOC"
ubicacion: "projects/erp-core/orchestration/MAPA-DOCUMENTACION.yml"
padre:
proyecto: "erp-clinicas"
tipo: "CONSUMER"
nivel: 2
alias: "@CLINICAS_MAPA_DOC"
ubicacion: "projects/erp-clinicas/orchestration/MAPA-DOCUMENTACION.yml"
actual:
proyecto: "clinica-dental"
tipo: "SUB-VERTICAL"
nivel: 3
alias: "@DENTAL_MAPA_DOC"
especializacion: "Odontologia"
# -------------------------------------------------------------------------------
# DOCUMENTACION DE USUARIO (docs/)
# -------------------------------------------------------------------------------
docs:
raiz:
README.md:
alias: "@DENTAL_README"
descripcion: "Punto de entrada del proyecto"
_MAP.md:
alias: "@DENTAL_MAP"
descripcion: "Mapa maestro de navegacion"
vision:
ruta: "docs/00-vision-general/"
alias: "@DENTAL_VISION"
archivos:
- VISION-CLINICA-DENTAL.md
- ARQUITECTURA-ODONTOLOGICA.md
modulos:
ruta: "docs/01-modulos/"
alias: "@DENTAL_MODULOS"
patron: "CDT-{NNN}-{nombre}.md"
archivos:
- CDT-001-Odontograma.md
- CDT-002-Tratamientos-Dentales.md
- CDT-003-Ortodoncia.md
- CDT-004-Protesis.md
- CDT-005-Radiografias-Dentales.md
- CDT-006-Presupuestos-Dentales.md
normativa:
ruta: "docs/02-normativa/"
alias: "@DENTAL_NORMATIVA"
archivos:
- NOM-013-SSA2-2015-Implementacion.md
- NOM-004-SSA3-2012-Expediente.md
- COFEPRIS-Consultorios.md
definitions:
ruta: "docs/_definitions/"
alias: "@DENTAL_DEF"
archivos:
_INDEX.yml:
alias: "@DENTAL_DEF_INDEX"
DATABASE-SCHEMA.md:
alias: "@DENTAL_DEF_DB"
descripcion: "Schema sub_dental (15+ tablas)"
ENTITIES-CATALOG.md:
alias: "@DENTAL_DEF_ENTITIES"
descripcion: "Catalogo de entities dentales"
SERVICES-CATALOG.md:
alias: "@DENTAL_DEF_SERVICES"
descripcion: "Catalogo de services dentales"
MODULES-CATALOG.md:
alias: "@DENTAL_DEF_MODULES"
descripcion: "Catalogo de 6 modulos CDT"
quick:
ruta: "docs/_quick/"
alias: "@DENTAL_QUICK"
archivos:
QUICK-INDEX.yml:
alias: "@DENTAL_QUICK_INDEX"
QUICK-MODULES.yml:
alias: "@DENTAL_QUICK_MODULES"
QUICK-DATABASE.yml:
alias: "@DENTAL_QUICK_DATABASE"
QUICK-API.yml:
alias: "@DENTAL_QUICK_API"
# -------------------------------------------------------------------------------
# DOCUMENTACION OPERACIONAL (orchestration/)
# -------------------------------------------------------------------------------
orchestration:
raiz:
_MAP.md:
alias: "@DENTAL_ORCH_MAP"
PROJECT-STATUS.md:
alias: "@DENTAL_STATUS"
descripcion: "Estado actual del proyecto"
PROXIMA-ACCION.md:
alias: "@DENTAL_NEXT"
descripcion: "Siguiente tarea a ejecutar"
trazabilidad:
TRACEABILITY.yml:
alias: "@DENTAL_TRACEABILITY"
descripcion: "Trazabilidad de 6 modulos CDT"
DEPENDENCY-GRAPH.yml:
alias: "@DENTAL_DEP_GRAPH"
descripcion: "Grafo de dependencias"
CONTEXT-MAP.yml:
alias: "@DENTAL_CONTEXT"
descripcion: "Mapeo de contexto"
_inheritance.yml:
alias: "@DENTAL_INHERITANCE"
descripcion: "Herencia: SUB-VERTICAL nivel 3"
MAPA-DOCUMENTACION.yml:
alias: "@DENTAL_MAPA_DOC"
descripcion: "Este archivo"
inventarios:
ruta: "orchestration/inventarios/"
alias: "@DENTAL_INV"
archivos:
MASTER_INVENTORY.yml:
alias: "@DENTAL_INV_MASTER"
DATABASE_INVENTORY.yml:
alias: "@DENTAL_INV_DB"
BACKEND_INVENTORY.yml:
alias: "@DENTAL_INV_BE"
FRONTEND_INVENTORY.yml:
alias: "@DENTAL_INV_FE"
directivas:
ruta: "orchestration/directivas/"
alias: "@DENTAL_DIRECTIVAS"
hereda_de: "@CLINICAS_DIRECTIVAS"
archivos:
- TRIGGER-COHERENCIA-CAPAS.md
- TRIGGER-INVENTARIOS.md
agentes:
ruta: "orchestration/agents/"
alias: "@DENTAL_AGENTS"
archivos:
perfiles:
_INDEX.yml:
alias: "@DENTAL_AGENTS_INDEX"
PERFIL-ODONTOLOGO-AGENT.yml:
alias: "@DENTAL_AGENT_ODONTOLOGO"
PERFIL-DDL-DENTAL-AGENT.yml:
alias: "@DENTAL_AGENT_DDL"
trazas:
ruta: "orchestration/agents/trazas/"
referencias:
ruta: "orchestration/referencias/"
alias: "@DENTAL_REFS"
environment:
ruta: "orchestration/environment/"
alias: "@DENTAL_ENV"
# -------------------------------------------------------------------------------
# REFERENCIAS AL WORKSPACE Y CADENA
# -------------------------------------------------------------------------------
referencias_cadena:
template_saas:
mapa: "@TS_MAPA_DOC"
ubicacion: "projects/template-saas/orchestration/MAPA-DOCUMENTACION.yml"
hereda:
- "Directivas base"
- "Estructura de inventarios"
- "Perfiles de agentes base"
erp_core:
mapa: "@ERP_MAPA_DOC"
ubicacion: "projects/erp-core/orchestration/MAPA-DOCUMENTACION.yml"
hereda:
- "23 modulos MGN"
- "Triggers de coherencia"
- "Modelo multi-tenant"
erp_clinicas:
mapa: "@CLINICAS_MAPA_DOC"
ubicacion: "projects/erp-clinicas/orchestration/MAPA-DOCUMENTACION.yml"
hereda:
- "Modulos de pacientes, citas, expedientes"
- "Directivas clinicas"
- "Normativa salud base"
workspace:
archivo: "orchestration/_refs/WS-REFERENCES.yml"
alias: "@DENTAL_WS_REFS"
contenido:
- "@WS_DIRECTIVAS"
- "@WS_PERFILES"
- "@WS_TEMPLATES"
- "@WS_DEFINITIONS"
# -------------------------------------------------------------------------------
# MODULOS CDT (CLINICA DENTAL)
# -------------------------------------------------------------------------------
modulos_cdt:
CDT-001:
nombre: "Odontograma"
estado: "30%"
alias: "@DENTAL_MOD_ODONTOGRAMA"
normativa: "NOM-013-SSA2-2015"
CDT-002:
nombre: "Tratamientos Dentales"
estado: "25%"
alias: "@DENTAL_MOD_TRATAMIENTOS"
normativa: "NOM-013-SSA2-2015"
CDT-003:
nombre: "Ortodoncia"
estado: "20%"
alias: "@DENTAL_MOD_ORTODONCIA"
CDT-004:
nombre: "Protesis"
estado: "15%"
alias: "@DENTAL_MOD_PROTESIS"
CDT-005:
nombre: "Radiografias Dentales"
estado: "20%"
alias: "@DENTAL_MOD_RADIOGRAFIAS"
CDT-006:
nombre: "Presupuestos Dentales"
estado: "25%"
alias: "@DENTAL_MOD_PRESUPUESTOS"
# -------------------------------------------------------------------------------
# NORMATIVA APLICABLE
# -------------------------------------------------------------------------------
normativa:
obligatoria:
- codigo: "NOM-013-SSA2-2015"
nombre: "Prevencion y control de enfermedades bucales"
aplica_a: ["CDT-001", "CDT-002"]
alias: "@DENTAL_NOM_013"
- codigo: "NOM-004-SSA3-2012"
nombre: "Del expediente clinico"
aplica_a: ["expedientes", "consentimientos"]
alias: "@DENTAL_NOM_004"
- codigo: "COFEPRIS"
nombre: "Regulacion de consultorios dentales"
aplica_a: ["todos"]
alias: "@DENTAL_COFEPRIS"
complementaria:
- codigo: "NOM-087-SEMARNAT-SSA1-2002"
nombre: "Residuos peligrosos biologico-infecciosos"
aplica_a: ["inventario-materiales"]
# -------------------------------------------------------------------------------
# ESTADISTICAS
# -------------------------------------------------------------------------------
estadisticas:
docs:
total_archivos: TBD
carpetas: 8
modulos_documentados: 6
orchestration:
total_archivos: 15
inventarios: 4
trazas: 1
perfiles_agentes: 2
triggers: 2
total_aliases: 50+
cobertura_documentacion: "80%"
ultima_auditoria: "2026-01-16"
# -------------------------------------------------------------------------------
# NAVEGACION RAPIDA POR ROL
# -------------------------------------------------------------------------------
por_rol:
odontologo:
inicio: "@DENTAL_NORMATIVA"
modulos: "@DENTAL_MODULOS"
odontograma: "@DENTAL_MOD_ODONTOGRAMA"
desarrollador_backend:
inicio: "@DENTAL_DEF_ENTITIES"
api: "@DENTAL_QUICK_API"
inventario: "@DENTAL_INV_BE"
desarrollador_frontend:
inicio: "@DENTAL_QUICK_MODULES"
api: "@DENTAL_QUICK_API"
inventario: "@DENTAL_INV_FE"
dba:
inicio: "@DENTAL_DEF_DB"
inventario: "@DENTAL_INV_DB"
quick: "@DENTAL_QUICK_DATABASE"
arquitecto:
inicio: "@DENTAL_VISION"
dependencias: "@DENTAL_DEP_GRAPH"
herencia: "@DENTAL_INHERITANCE"
cadena: "Ver seccion cadena_herencia"
orquestador:
inicio: "@DENTAL_STATUS"
siguiente: "@DENTAL_NEXT"
trazabilidad: "@DENTAL_TRACEABILITY"
# ===============================================================================
# FIN DEL MAPA DE DOCUMENTACION
# ===============================================================================