diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..7505b63 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,158 @@ +# CLAUDE.md - Clínica Dental + +**Hereda de:** workspace-v2/CLAUDE.md, erp-clinicas/CLAUDE.md +**Sistema:** SIMCO v4.0.0 + NEXUS v4.0 +**Proyecto:** clinica-dental +**Tipo:** SUB-CONSUMER (hereda de erp-clinicas) +**Especialización:** Odontología +**Versión:** 0.1.0 +**Actualizado:** 2026-02-02 + +--- + +## EXTENSIONES LOCALES + +Este archivo EXTIENDE (no reemplaza) las reglas del workspace y de erp-clinicas. + +Para reglas base, ver: `../../CLAUDE.md` +Para reglas de ERP Clínicas, ver: `../erp-clinicas/CLAUDE.md` + +--- + +## DESCRIPCIÓN DEL PROYECTO + +Sistema ERP especializado para clínicas dentales. Hereda funcionalidades base de erp-clinicas y extiende con módulos odontológicos específicos. + +**Cadena de herencia:** +``` +template-saas → erp-core → erp-clinicas → clinica-dental +``` + +--- + +## STACK TECNOLÓGICO + +- **Backend:** NestJS (heredado de erp-clinicas) +- **Frontend:** React (heredado) +- **Database:** PostgreSQL con schema `sub_dental` +- **Arquitectura:** Microservicios + +--- + +## MÓDULOS DEL PROYECTO + +### Módulos Heredados de erp-clinicas +- `pacientes` - Gestión de pacientes odontológicos +- `citas` - Agenda dental +- `expedientes` - Historia clínica odontológica +- `prescripciones` - Recetas dentales + +### Módulos Heredados de erp-core +- `catalogs` - Catálogos generales +- `inventory` - Inventario de materiales dentales + +### Módulos Heredados de template-saas +- `auth` - Autenticación +- `tenants` - Gestión de tenants +- `billing` - Facturación +- `notifications` - Notificaciones + +### Módulos Propios (Sub-Dental) + +| Módulo | ID | Estado | Descripción | Tablas | +|--------|-----|--------|-------------|--------| +| odontograma | CDT-001 | 30% | Odontograma digital interactivo | odontograms, tooth_conditions, tooth_treatments | +| tratamientos-dentales | CDT-002 | 25% | Catálogo de tratamientos dentales | dental_treatments, treatment_plans, treatment_progress | +| ortodoncia | CDT-003 | 20% | Módulo de ortodoncia y brackets | orthodontic_cases, bracket_types, orthodontic_progress | +| protesis | CDT-004 | 15% | Prótesis dentales y laboratorio | prosthetics, lab_orders | +| radiografias-dentales | CDT-005 | 20% | Radiografías panorámicas y periapicales | dental_xrays, xray_analysis | +| presupuestos-dentales | CDT-006 | 25% | Presupuestos de tratamiento dental | dental_quotes, quote_items | + +--- + +## CONFIGURACIÓN LOCAL + +### Schema de Base de Datos +```yaml +schema_prefix: "sub_dental" +schemas_propios: + - "sub_dental" +``` + +### Normativa Aplicable + +| Norma | Descripción | Aplica a | +|-------|-------------|----------| +| NOM-013-SSA2-2015 | Prevención y control de enfermedades bucales | odontograma, tratamientos-dentales | +| NOM-004-SSA3-2012 | Del expediente clínico | expedientes | +| COFEPRIS | Regulación de consultorios dentales | Todos los módulos | + +--- + +## REGLAS LOCALES ESPECÍFICAS + +### R1: Convención de Nombres +- Tablas: `sub_dental.` +- Entidades: `DentalXXX` (ej: DentalTreatment, OdontogramEntry) +- Servicios: `XXXDentalService` +- Controllers: `XXXDentalController` + +### R2: Campos Especializados en Pacientes +Extensión heredada de erp-clinicas, con campos dentales: +- `tipo_denticion` - Temporal, permanente, mixta +- `historial_fluorosis` - Control de fluorosis +- `sensibilidad_dental` - Registro de sensibilidad + +### R3: Integridad de Odontograma +- Todo paciente debe tener odontograma inicial +- Los 32 dientes deben estar registrados +- Cambios en odontograma generan auditoría automática + +### R4: Planes de Tratamiento +- Vinculados obligatoriamente a paciente +- Requieren presupuesto aprobado +- Generan cronograma de citas automáticamente + +--- + +## ALIAS LOCALES + +| Alias | Ruta | +|-------|------| +| @LOCAL-ORCHESTRATION | orchestration/ | +| @INHERITANCE | orchestration/_inheritance.yml | +| @DENTAL-MODULES | Módulos en sub_dental schema | +| @CODIGOS-TRATAMIENTOS | Catálogo de códigos dentales | + +--- + +## BLOQUEOS ACTUALES + +**REGLA BLOCK-002:** No puede avanzar más allá de documentación si `erp-clinicas < 50%` + +Estado actual: `erp-clinicas al 10%` + +Acción: Solo documentación hasta que erp-clinicas llegue a 50% + +--- + +## VALIDACIÓN + +- Última validación: 2026-01-16 +- Parent compatible: ✓ +- erp-clinicas v1.0.0: ✓ +- Módulos clínica disponibles: ⏳ Pendiente + +--- + +## RELACIONADOS + +- `orchestration/_inheritance.yml` - Declaración de herencia completa +- `orchestration/DEPENDENCY-GRAPH.yml` - Grafo de dependencias +- `orchestration/TRACEABILITY.yml` - Trazabilidad +- `../erp-clinicas/CLAUDE.md` - Reglas de ERP Clínicas +- `../../CLAUDE.md` - Reglas del workspace + +--- + +**Sistema:** SIMCO v4.0.0 | **Tipo:** Instrucciones de Proyecto | **Última actualización:** 2026-02-02