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

5.6 KiB

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

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

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

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