# Services Catalog - clinica-dental

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

---

## 1. RESUMEN

| Metrica | Valor |
|---------|-------|
| **Total Services Propios** | 0 (Pendiente implementacion) |
| **Total Services Heredados** | 10+ (de erp-clinicas) |
| **Estado** | Planificado |

---

## 2. SERVICES PLANIFICADOS

### 2.1 Modulo: Odontograma (DENTAL-001)

| Service | Archivo Planificado | Descripcion |
|---------|---------------------|-------------|
| OdontogramaService | `odontograma.service.ts` | CRUD de odontogramas |
| OdontogramaPiezaService | `odontograma-pieza.service.ts` | Gestion de piezas |

### 2.2 Modulo: Tratamientos (DENTAL-002)

| Service | Archivo Planificado | Descripcion |
|---------|---------------------|-------------|
| TratamientoCatalogoService | `tratamiento-catalogo.service.ts` | Catalogo de tratamientos |
| TratamientoPacienteService | `tratamiento-paciente.service.ts` | Tratamientos realizados |

### 2.3 Modulo: Ortodoncia (DENTAL-003)

| Service | Archivo Planificado | Descripcion |
|---------|---------------------|-------------|
| OrtodonciaService | `ortodoncia.service.ts` | Gestion casos ortodoncia |
| OrtodonciaCitaService | `ortodoncia-cita.service.ts` | Seguimiento de citas |

### 2.4 Modulo: Protesis (DENTAL-004)

| Service | Archivo Planificado | Descripcion |
|---------|---------------------|-------------|
| ProtesisService | `protesis.service.ts` | Gestion trabajos protesicos |

### 2.5 Modulo: Radiografias (DENTAL-005)

| Service | Archivo Planificado | Descripcion |
|---------|---------------------|-------------|
| RadiografiaService | `radiografia.service.ts` | Gestion radiografias |

### 2.6 Modulo: Presupuestos (DENTAL-006)

| Service | Archivo Planificado | Descripcion |
|---------|---------------------|-------------|
| PresupuestoService | `presupuesto.service.ts` | Gestion presupuestos |

---

## 3. UBICACION PLANIFICADA

```
backend/src/modules/
├── odontograma/
│   └── services/
│       ├── odontograma.service.ts
│       └── odontograma-pieza.service.ts
├── tratamientos/
│   └── services/
│       ├── tratamiento-catalogo.service.ts
│       └── tratamiento-paciente.service.ts
├── ortodoncia/
│   └── services/
│       ├── ortodoncia.service.ts
│       └── ortodoncia-cita.service.ts
├── protesis/
│   └── services/
│       └── protesis.service.ts
├── radiografias/
│   └── services/
│       └── radiografia.service.ts
└── presupuestos/
    └── services/
        └── presupuesto.service.ts
```

---

## 4. SERVICES HEREDADOS (de erp-clinicas)

| Service | Origen | Uso en clinica-dental |
|---------|--------|----------------------|
| PatientsService | erp-clinicas | Gestion pacientes |
| DoctorsService | erp-clinicas | Gestion odontologos |
| SpecialtiesService | erp-clinicas | Especialidades dentales |
| AppointmentsService | erp-clinicas | Citas dentales |
| AppointmentSlotsService | erp-clinicas | Horarios disponibles |
| AppointmentSchedulerService | erp-clinicas | Programacion de citas |
| ConsultationsService | erp-clinicas | Consultas dentales |
| DiagnosesService | erp-clinicas | Diagnosticos |
| PrescriptionsService | erp-clinicas | Recetas |
| VitalSignsService | erp-clinicas | Signos vitales |

---

## 5. OPERACIONES PRINCIPALES POR SERVICE

### OdontogramaService

```yaml
operaciones:
  crear:
    descripcion: "Crear nuevo odontograma para paciente"
    parametros: [patient_id, notas]
    retorna: Odontograma

  obtenerActivo:
    descripcion: "Obtener odontograma activo del paciente"
    parametros: [patient_id]
    retorna: Odontograma

  actualizarPieza:
    descripcion: "Actualizar estado de pieza dental"
    parametros: [odontograma_id, pieza_id, estado, caras_afectadas]
    retorna: OdontogramaPieza

  obtenerHistorial:
    descripcion: "Historial de odontogramas del paciente"
    parametros: [patient_id]
    retorna: Odontograma[]
```

### TratamientoPacienteService

```yaml
operaciones:
  crear:
    descripcion: "Registrar tratamiento realizado"
    parametros: [patient_id, tratamiento_id, pieza_id, caras_tratadas, precio]
    retorna: TratamientoPaciente

  completar:
    descripcion: "Marcar tratamiento como completado"
    parametros: [tratamiento_id]
    retorna: TratamientoPaciente

  obtenerPorPaciente:
    descripcion: "Listar tratamientos de un paciente"
    parametros: [patient_id, estado?]
    retorna: TratamientoPaciente[]

  obtenerPendientes:
    descripcion: "Listar tratamientos pendientes"
    parametros: [patient_id]
    retorna: TratamientoPaciente[]
```

### PresupuestoService

```yaml
operaciones:
  crear:
    descripcion: "Crear presupuesto de tratamiento"
    parametros: [patient_id, odontologo_id, lineas]
    retorna: Presupuesto

  aprobar:
    descripcion: "Aprobar presupuesto"
    parametros: [presupuesto_id]
    retorna: Presupuesto

  rechazar:
    descripcion: "Rechazar presupuesto"
    parametros: [presupuesto_id, motivo]
    retorna: Presupuesto

  generarPDF:
    descripcion: "Generar PDF del presupuesto"
    parametros: [presupuesto_id]
    retorna: Buffer

  convertirATratamientos:
    descripcion: "Convertir presupuesto aprobado a tratamientos"
    parametros: [presupuesto_id]
    retorna: TratamientoPaciente[]
```

---

## 6. REFERENCIAS

- Entities: @PROJ_DEF_ENTITIES
- Database: @PROJ_DEF_DB
- Ubicacion futura: `backend/src/modules/*/services/`
- Herencia erp-clinicas: `orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md`

---

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