feat: Create CLAUDE.md with project-specific instructions

- Extend workspace CLAUDE.md with clinica-dental specialization rules
- Document module inheritance from erp-clinicas (SUB-CONSUMER type)
- Define local schema configuration (sub_dental prefix)
- Document 6 dental-specific modules (odontograma, tratamientos, ortodoncia, protesis, radiografias, presupuestos)
- Add regulatory compliance rules (NOM-013-SSA2-2015, NOM-004-SSA3-2012, COFEPRIS)
- Define naming conventions and local aliases
- Document current block from parent project (erp-clinicas < 50%)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-02-02 18:01:24 -06:00
parent fad2e4dd9f
commit 8fa57a4c00

158
CLAUDE.md Normal file
View File

@ -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.<modulo_nombre>`
- 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