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

203 lines
5.6 KiB
Markdown

# 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*