# Modules Catalog - clinica-dental

**Alias:** @PROJ_DEF_MODULES
**Version:** 1.0.0
**Ultima actualizacion:** 2026-01-16

---

## 1. RESUMEN

| Metrica | Valor |
|---------|-------|
| **Total Modulos Propios** | 6 |
| **Total Modulos Heredados (erp-core)** | 16 |
| **Total Modulos Heredados (erp-clinicas)** | 10 |
| **Documentados** | 6 |
| **En Desarrollo** | 0 |
| **Planificados** | 6 |

---

## 2. INDICE DE MODULOS

### 2.1 Modulos Core (Heredados de erp-core)

| ID | Nombre | Herencia | Estado | Documentacion |
|----|--------|----------|--------|---------------|
| MGN-001 | Authentication | 100% | Heredado | @WS_DEF_CCA |
| MGN-002 | Users | 100% | Heredado | @WS_DEF_CCA |
| MGN-003 | Roles | 100% | Heredado | @WS_DEF_CCA |
| MGN-004 | Tenants | Extendido | Heredado | @WS_DEF_CCA |
| MGN-005 | Catalogs | Extendido | Heredado | @WS_DEF_CCA |
| MGN-007 | Audit | 100% | Heredado | @WS_DEF_CCA |
| MGN-008 | Notifications | 100% | Heredado | @WS_DEF_CCA |
| MGN-009 | Reports | Extendido | Heredado | @WS_DEF_CCA |
| MGN-010 | Financial | Extendido | Heredado | @WS_DEF_CCA |

### 2.2 Modulos SaaS (Heredados - Fase 4)

| ID | Nombre | Estado | Documentacion |
|----|--------|--------|---------------|
| MGN-016 | Billing | Heredado | docs/04-fase-saas/MGN-016-billing/ |
| MGN-017 | Plans | Heredado | docs/04-fase-saas/MGN-017-plans/ |
| MGN-018 | Webhooks | Heredado | docs/04-fase-saas/MGN-018-webhooks/ |
| MGN-019 | Feature Flags | Heredado | docs/04-fase-saas/MGN-019-feature-flags/ |

### 2.3 Modulos IA (Heredados - Fase 5)

| ID | Nombre | Estado | Documentacion |
|----|--------|--------|---------------|
| MGN-020 | AI Integration | Heredado | docs/05-fase-ia/MGN-020-ai-integration/ |
| MGN-021 | WhatsApp Business | Heredado | docs/05-fase-ia/MGN-021-whatsapp-business/ |
| MGN-022 | MCP Server | Heredado | docs/05-fase-ia/MGN-022-mcp-server/ |

### 2.4 Modulos Clinicos (Heredados de erp-clinicas)

| ID | Nombre | Herencia | Adaptacion Dental |
|----|--------|----------|-------------------|
| CL-001 | Fundamentos | 100% | Ninguna |
| CL-002 | Pacientes | Extendido | + odontograma_activo_id, tiene_ortodoncia, tiene_protesis |
| CL-003 | Citas | Extendido | + tipos cita dental |
| CL-004 | Consultas | Extendido | + exploracion dental |
| CL-005 | Recetas | 100% | Ninguna |
| CL-006 | Laboratorio | Parcial | Solo laboratorio dental |
| CL-008 | Facturacion | 100% | Ninguna |
| CL-009 | Reportes | Extendido | + reportes odontologicos |
| CL-011 | Expediente | Extendido | + odontograma |
| CL-012 | Imagenologia | Extendido | + radiografias dentales |

### 2.5 Modulos Propios (Odontologicos)

| ID | Nombre | Estado | Documentacion |
|----|--------|--------|---------------|
| DENTAL-001 | Odontograma | Planificado | docs/01-epicas/DENTAL-001-odontograma.md |
| DENTAL-002 | Tratamientos | Planificado | docs/01-epicas/DENTAL-002-tratamientos.md |
| DENTAL-003 | Ortodoncia | Planificado | docs/01-epicas/DENTAL-003-ortodoncia.md |
| DENTAL-004 | Protesis | Planificado | docs/01-epicas/DENTAL-004-protesis.md |
| DENTAL-005 | Radiografias | Planificado | docs/01-epicas/DENTAL-005-radiografias.md |
| DENTAL-006 | Presupuestos | Planificado | docs/01-epicas/DENTAL-006-presupuestos.md |

---

## 3. DETALLE POR MODULO PROPIO

### DENTAL-001: Odontograma

```yaml
modulo:
  id: "DENTAL-001"
  nombre: "Odontograma"
  estado: "planificado"
  version: "1.0.0"

  documentacion:
    especificacion: "docs/01-epicas/DENTAL-001-odontograma.md"
    requerimientos: []
    historias: []

  descripcion: |
    Registro grafico del estado dental del paciente:
    - Nomenclatura FDI (32 piezas permanentes + 20 temporales)
    - Estados por pieza (sano, caries, obturacion, etc.)
    - Estados por cara (mesial, distal, oclusal, etc.)
    - Historial de cambios

  objetos:
    tablas: ["dental.odontogramas", "dental.odontograma_piezas", "dental.piezas_dentales"]
    entities: ["Odontograma", "OdontogramaPieza", "PiezaDental"]
    services: ["OdontogramaService", "OdontogramaPiezaService"]
    controllers: []

  story_points:
    backend: 21
    frontend: 21
    total: 42

  dependencias:
    modulos: ["CL-002"]
    externos: []
```

### DENTAL-002: Tratamientos

```yaml
modulo:
  id: "DENTAL-002"
  nombre: "Tratamientos"
  estado: "planificado"
  version: "1.0.0"

  documentacion:
    especificacion: "docs/01-epicas/DENTAL-002-tratamientos.md"

  descripcion: |
    Gestion de tratamientos dentales:
    - Catalogo de tratamientos por tenant
    - Registro de tratamientos realizados
    - Vinculacion con odontograma y piezas
    - Seguimiento de estado

  objetos:
    tablas: ["dental.tratamientos_catalogo", "dental.tratamientos_paciente"]
    entities: ["TratamientoCatalogo", "TratamientoPaciente"]
    services: ["TratamientoCatalogoService", "TratamientoPacienteService"]

  story_points:
    backend: 21
    frontend: 13
    total: 34

  dependencias:
    modulos: ["DENTAL-001", "CL-002", "CL-004"]
```

### DENTAL-003: Ortodoncia

```yaml
modulo:
  id: "DENTAL-003"
  nombre: "Ortodoncia"
  estado: "planificado"
  version: "1.0.0"

  documentacion:
    especificacion: "docs/01-epicas/DENTAL-003-ortodoncia.md"

  descripcion: |
    Control de tratamientos de ortodoncia:
    - Registro de casos (brackets, alineadores, etc.)
    - Seguimiento de citas de ajuste
    - Control de pagos mensuales
    - Estimacion de duracion

  objetos:
    tablas: ["dental.ortodoncia", "dental.ortodoncia_citas"]
    entities: ["Ortodoncia", "OrtodonciaCita"]
    services: ["OrtodonciaService", "OrtodonciaCitaService"]

  story_points:
    backend: 21
    frontend: 21
    total: 42

  dependencias:
    modulos: ["CL-002", "CL-003"]
```

### DENTAL-004: Protesis

```yaml
modulo:
  id: "DENTAL-004"
  nombre: "Protesis"
  estado: "planificado"
  version: "1.0.0"

  documentacion:
    especificacion: "docs/01-epicas/DENTAL-004-protesis.md"

  descripcion: |
    Gestion de trabajos protesicos:
    - Coronas, puentes, parciales, totales
    - Seguimiento con laboratorio
    - Control de materiales y colores
    - Garantias

  objetos:
    tablas: ["dental.protesis"]
    entities: ["Protesis"]
    services: ["ProtesisService"]

  story_points:
    backend: 13
    frontend: 13
    total: 26

  dependencias:
    modulos: ["CL-002", "DENTAL-001"]
```

### DENTAL-005: Radiografias

```yaml
modulo:
  id: "DENTAL-005"
  nombre: "Radiografias"
  estado: "planificado"
  version: "1.0.0"

  documentacion:
    especificacion: "docs/01-epicas/DENTAL-005-radiografias.md"

  descripcion: |
    Gestion de radiografias dentales:
    - Periapicales, panoramicas, cefalometricas
    - Almacenamiento de imagenes
    - Interpretacion y notas

  objetos:
    tablas: ["dental.radiografias"]
    entities: ["Radiografia"]
    services: ["RadiografiaService"]

  story_points:
    backend: 13
    frontend: 13
    total: 26

  dependencias:
    modulos: ["CL-002", "CL-004", "CL-012"]
```

### DENTAL-006: Presupuestos

```yaml
modulo:
  id: "DENTAL-006"
  nombre: "Presupuestos"
  estado: "planificado"
  version: "1.0.0"

  documentacion:
    especificacion: "docs/01-epicas/DENTAL-006-presupuestos.md"

  descripcion: |
    Presupuestos de tratamiento dental:
    - Lineas de tratamiento con precios
    - Descuentos y financiamiento
    - Generacion de PDF
    - Conversion a tratamientos

  objetos:
    tablas: ["dental.presupuestos", "dental.presupuesto_lineas"]
    entities: ["Presupuesto", "PresupuestoLinea"]
    services: ["PresupuestoService"]

  story_points:
    backend: 21
    frontend: 13
    total: 34

  dependencias:
    modulos: ["CL-002", "DENTAL-002"]
```

---

## 4. MATRIZ DE DEPENDENCIAS

```
┌────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
│            │ DENTAL-1 │ DENTAL-2 │ DENTAL-3 │ DENTAL-4 │ DENTAL-5 │ DENTAL-6 │
├────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
│ DENTAL-001 │    -     │          │          │          │          │          │
│ DENTAL-002 │    X     │    -     │          │          │          │          │
│ DENTAL-003 │          │          │    -     │          │          │          │
│ DENTAL-004 │    X     │          │          │    -     │          │          │
│ DENTAL-005 │          │          │          │          │    -     │          │
│ DENTAL-006 │          │    X     │          │          │          │    -     │
└────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘

X = depende de
```

---

## 5. STORY POINTS TOTALES

| Modulo | SP Backend | SP Frontend | SP Total |
|--------|-----------|-------------|----------|
| DENTAL-001 | 21 | 21 | 42 |
| DENTAL-002 | 21 | 13 | 34 |
| DENTAL-003 | 21 | 21 | 42 |
| DENTAL-004 | 13 | 13 | 26 |
| DENTAL-005 | 13 | 13 | 26 |
| DENTAL-006 | 21 | 13 | 34 |
| **Total** | **110** | **94** | **204** |

---

## 6. REFERENCIAS

- Database: @PROJ_DEF_DB
- Entities: @PROJ_DEF_ENTITIES
- Services: @PROJ_DEF_SERVICES
- Navegacion rapida: docs/_quick/QUICK-MODULES.yml
- Herencia: orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md

---

*Modules Catalog | clinica-dental | v1.0.0*
*Ultima actualizacion: 2026-01-16*