clinica-dental/docs/_MAP.md
2026-01-16 04:14:26 -06:00

9.7 KiB

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 Schema de base de datos dental
@PROJ_DEF_ENTITIES ENTITIES-CATALOG.md Catalogo de entidades
@PROJ_DEF_SERVICES SERVICES-CATALOG.md Catalogo de servicios
@PROJ_DEF_MODULES MODULES-CATALOG.md Catalogo de modulos

Accesos Rapidos (@PROJ_QUICK_*)

Alias Archivo Descripcion
@PROJ_QUICK_INDEX QUICK-INDEX.yml Punto de entrada rapido
@PROJ_QUICK_MODULES QUICK-MODULES.yml Modulos por estado
@PROJ_QUICK_DB QUICK-DATABASE.yml Tablas y schemas
@PROJ_QUICK_API 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 Facturacion y suscripciones con Stripe Propagado
MGN-017-plans Planes: Consultorio, Clinica, Centro Dental Propagado
MGN-018-webhooks Webhooks para integraciones externas Propagado
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 Gateway LLM con system prompt dental Propagado
MGN-021-whatsapp-business WhatsApp IA para comunicacion con pacientes Propagado
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


Orchestration

Referencias y Trazabilidad

Archivo Descripcion
WS-REFERENCES.yml Referencias a workspace (nivel=3)
DEPENDENCY-GRAPH.yml Grafo de dependencias
TRACEABILITY.yml Trazabilidad modulo-objetos
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)