269 lines
9.7 KiB
Markdown
269 lines
9.7 KiB
Markdown
# 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)
|