# Clinica Dental - Mapa de Documentacion

**Proyecto:** clinica-dental
**Tipo:** ERP Especializado (hereda de erp-clinicas)
**Fecha:** 2026-01-16
**Estado:** Fase 0 - Preparacion + Fases SaaS/IA Propagadas
**Nivel Herencia:** 3 (erp-core -> erp-clinicas -> clinica-dental)

---

## Estructura de Documentacion

```
docs/
+-- _MAP.md                            <- ESTE ARCHIVO
+-- _definitions/                      <- NUEVO: Definiciones canonicas
|   +-- _INDEX.yml                     <- Indice de definiciones
|   +-- DATABASE-SCHEMA.md             <- Schema de base de datos
|   +-- ENTITIES-CATALOG.md            <- Catalogo de entidades
|   +-- SERVICES-CATALOG.md            <- Catalogo de servicios
|   +-- MODULES-CATALOG.md             <- Catalogo de modulos
|
+-- _quick/                            <- NUEVO: Navegacion rapida
|   +-- QUICK-INDEX.yml                <- Indice de accesos rapidos
|   +-- QUICK-MODULES.yml              <- Modulos por estado/categoria
|   +-- QUICK-DATABASE.yml             <- Tablas y schemas
|   +-- QUICK-API.yml                  <- Endpoints planificados
|
+-- 00-vision-general/
|   +-- README.md                      <- Indice de vision
|   +-- VISION.md                      <- Vision estrategica [PENDIENTE]
|
+-- 01-epicas/
|   +-- DENTAL-001-odontograma.md      <- Odontograma digital
|   +-- DENTAL-002-tratamientos.md     <- Tratamientos dentales
|   +-- DENTAL-003-ortodoncia.md       <- Control ortodoncia
|   +-- DENTAL-004-protesis.md         <- Trabajos protesicos
|   +-- DENTAL-005-radiografias.md     <- Radiografias dentales
|   +-- DENTAL-006-presupuestos.md     <- Presupuestos de tratamiento
|
+-- 02-definicion-modulos/
|   +-- _MAP.md                        <- Indice de modulos [PENDIENTE]
|   +-- modulo-odontograma.md          <- Odontograma digital [PENDIENTE]
|
+-- 04-fase-saas/                      <- Capacidades SaaS (Heredado)
|   +-- README.md                      <- Vision de fase SaaS
|   +-- _MAP.md                        <- Indice de modulos SaaS
|   +-- MGN-016-billing/               <- Facturacion y suscripciones
|   +-- MGN-017-plans/                 <- Planes dentales (Consultorio/Clinica/Centro)
|   +-- MGN-018-webhooks/              <- Integraciones externas
|   +-- MGN-019-feature-flags/         <- Control de features odontologicas
|
+-- 05-fase-ia/                        <- Inteligencia Artificial (Heredado)
|   +-- README.md                      <- Vision de fase IA
|   +-- _MAP.md                        <- Indice de modulos IA
|   +-- MGN-020-ai-integration/        <- Gateway LLM dental
|   +-- MGN-021-whatsapp-business/     <- WhatsApp IA para pacientes
|   +-- MGN-022-mcp-server/            <- Herramientas MCP odontologicas
|
+-- 03-especificaciones/
|   +-- ... (futuras especificaciones tecnicas)
|
+-- 04-modelado/
|   +-- trazabilidad/
|       +-- TRACEABILITY-MASTER.yml    <- Trazabilidad de modulos
|
+-- 90-transversal/
    +-- ... (documentacion transversal)
```

---

## Navegacion Rapida

### Definiciones Canonicas (@PROJ_DEF_*)

| Alias | Archivo | Descripcion |
|-------|---------|-------------|
| @PROJ_DEF_DB | [DATABASE-SCHEMA.md](./_definitions/DATABASE-SCHEMA.md) | Schema de base de datos dental |
| @PROJ_DEF_ENTITIES | [ENTITIES-CATALOG.md](./_definitions/ENTITIES-CATALOG.md) | Catalogo de entidades |
| @PROJ_DEF_SERVICES | [SERVICES-CATALOG.md](./_definitions/SERVICES-CATALOG.md) | Catalogo de servicios |
| @PROJ_DEF_MODULES | [MODULES-CATALOG.md](./_definitions/MODULES-CATALOG.md) | Catalogo de modulos |

### Accesos Rapidos (@PROJ_QUICK_*)

| Alias | Archivo | Descripcion |
|-------|---------|-------------|
| @PROJ_QUICK_INDEX | [QUICK-INDEX.yml](./_quick/QUICK-INDEX.yml) | Punto de entrada rapido |
| @PROJ_QUICK_MODULES | [QUICK-MODULES.yml](./_quick/QUICK-MODULES.yml) | Modulos por estado |
| @PROJ_QUICK_DB | [QUICK-DATABASE.yml](./_quick/QUICK-DATABASE.yml) | Tablas y schemas |
| @PROJ_QUICK_API | [QUICK-API.yml](./_quick/QUICK-API.yml) | Endpoints planificados |

---

## Modulos Especializados (Odontologia)

### Modulos Core

| Modulo | Prioridad | Estado | Descripcion |
|--------|-----------|--------|-------------|
| Odontograma | P1 | Pendiente | Registro grafico del estado dental |
| Tratamientos | P1 | Pendiente | Gestion de procedimientos dentales |
| Prevencion | P1 | Pendiente | Limpiezas, selladores, fluor |
| Restauracion | P1 | Pendiente | Resinas, amalgamas, incrustaciones |

### Modulos Especializados

| Modulo | Prioridad | Estado | Descripcion |
|--------|-----------|--------|-------------|
| Ortodoncia | P2 | Pendiente | Brackets, alineadores, retenedores |
| Protesis | P2 | Pendiente | Coronas, puentes, dentaduras |
| Endodoncia | P2 | Pendiente | Tratamientos de conductos |
| Periodoncia | P2 | Pendiente | Raspados, cirugia periodontal |
| Estetica | P2 | Pendiente | Blanqueamiento, carillas |

---

## Modulos Heredados (de erp-clinicas)

| Modulo | Fuente | Adaptacion Requerida |
|--------|--------|----------------------|
| Pacientes | erp-clinicas | Ninguna |
| Expedientes | erp-clinicas | Agregar odontograma |
| Citas | erp-clinicas | Ninguna |
| Consultas | erp-clinicas | Agregar exploracion dental |
| Recetas | erp-clinicas | Ninguna |
| Facturacion | erp-core | Ninguna |
| Inventario | erp-core | Materiales dentales |

---

## Entidades Especificas

### Odontograma
Registro grafico del estado dental del paciente.

```
Nomenclatura FDI:
- Cuadrante 1: Superior derecho (11-18)
- Cuadrante 2: Superior izquierdo (21-28)
- Cuadrante 3: Inferior izquierdo (31-38)
- Cuadrante 4: Inferior derecho (41-48)
- Deciduos: 51-55, 61-65, 71-75, 81-85
```

### Estados de Piezas
- Sano
- Caries
- Obturacion (resina/amalgama)
- Endodoncia
- Corona
- Puente
- Implante
- Ausente
- Extraccion indicada

### Caras Dentales
- Mesial (M)
- Distal (D)
- Oclusal/Incisal (O/I)
- Vestibular/Bucal (V/B)
- Lingual/Palatino (L/P)

---

## Navegacion Rapida

### Por Rol de Usuario
- **Odontologo:** Consultas, diagnosticos, tratamientos
- **Auxiliar dental:** Apoyo en procedimientos
- **Recepcionista:** Citas, cobros
- **Higienista:** Limpiezas, profilaxis
- **Tecnico dental:** Elaboracion de protesis
- **Administrador:** Gestion general

### Por Componente Tecnico
- **Database:** Ver orchestration/inventarios/DATABASE_INVENTORY.yml
- **Backend:** Ver orchestration/inventarios/BACKEND_INVENTORY.yml
- **Frontend:** Ver orchestration/inventarios/FRONTEND_INVENTORY.yml

---

## Fase 04: Capacidades SaaS (Propagada desde erp-core)

Modulos de monetizacion y suscripciones adaptados al dominio odontologico.

| Modulo | Descripcion | Estado |
|--------|-------------|--------|
| [MGN-016-billing](./04-fase-saas/MGN-016-billing/) | Facturacion y suscripciones con Stripe | Propagado |
| [MGN-017-plans](./04-fase-saas/MGN-017-plans/) | Planes: Consultorio, Clinica, Centro Dental | Propagado |
| [MGN-018-webhooks](./04-fase-saas/MGN-018-webhooks/) | Webhooks para integraciones externas | Propagado |
| [MGN-019-feature-flags](./04-fase-saas/MGN-019-feature-flags/) | Feature flags odontologicos | Propagado |

### Planes Dentales

| Plan | Precio/mes | Sillones | Features Clave |
|------|------------|----------|----------------|
| Consultorio | $499 MXN | 1 | Odontograma basico |
| Clinica | $1,499 MXN | 5 | + Ortodoncia, Radiografias |
| Centro Dental | $3,999 MXN | Ilimitado | + IA, WhatsApp, Multi-sucursal |

---

## Fase 05: Inteligencia Artificial (Propagada desde erp-core)

Modulos de IA especializados en odontologia con herramientas MCP dentales.

| Modulo | Descripcion | Estado |
|--------|-------------|--------|
| [MGN-020-ai-integration](./05-fase-ia/MGN-020-ai-integration/) | Gateway LLM con system prompt dental | Propagado |
| [MGN-021-whatsapp-business](./05-fase-ia/MGN-021-whatsapp-business/) | WhatsApp IA para comunicacion con pacientes | Propagado |
| [MGN-022-mcp-server](./05-fase-ia/MGN-022-mcp-server/) | Herramientas MCP: odontograma, citas, tratamientos | Propagado |

### Herramientas MCP Odontologicas

- `consultar_odontograma` - Ver estado de piezas dentales
- `registrar_tratamiento` - Documentar procedimiento
- `agendar_cita_dental` - Programar cita
- `consultar_historial_dental` - Historial del paciente
- `generar_presupuesto_dental` - Cotizacion de tratamiento

### Templates WhatsApp Dentales

- `recordatorio_cita_dental` - 24h antes de cita
- `confirmacion_tratamiento` - Post-procedimiento
- `instrucciones_postoperatorio` - Cuidados especiales

---

## Normativas Aplicables

| Normativa | Descripcion | Estado |
|-----------|-------------|--------|
| NOM-013-SSA2-2015 | Prevencion y control enfermedades bucales | Pendiente |
| NOM-004-SSA3-2012 | Expediente clinico | Pendiente |
| COFEPRIS | Regulacion sanitaria | Pendiente |
| LFPDPPP | Proteccion de datos personales | Pendiente |

---

## Referencias

- [CONTEXTO-PROYECTO.md](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)
- [HERENCIA-ERP-CLINICAS.md](../orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md)
- [PROXIMA-ACCION.md](../orchestration/PROXIMA-ACCION.md)
- [CONTEXT-MAP.yml](../orchestration/CONTEXT-MAP.yml)
- [04-fase-saas/README.md](./04-fase-saas/README.md) - Vision SaaS
- [05-fase-ia/README.md](./05-fase-ia/README.md) - Vision IA
- [PROPAGATION-STATUS.yml](../../shared/mirrors/clinica-dental/PROPAGATION-STATUS.yml) - Estado de propagacion

---

## Orchestration

### Referencias y Trazabilidad

| Archivo | Descripcion |
|---------|-------------|
| [WS-REFERENCES.yml](../orchestration/_refs/WS-REFERENCES.yml) | Referencias a workspace (nivel=3) |
| [DEPENDENCY-GRAPH.yml](../orchestration/DEPENDENCY-GRAPH.yml) | Grafo de dependencias |
| [TRACEABILITY.yml](../orchestration/TRACEABILITY.yml) | Trazabilidad modulo-objetos |
| [CONTEXT-MAP.yml](../orchestration/CONTEXT-MAP.yml) | Contexto del proyecto |

---

**Ultima actualizacion:** 2026-01-16
**Version:** 1.2.0
**Propagacion:** PROP-CDT-002 (Fases SaaS + IA desde erp-core via erp-clinicas)