feat: Initial commit - clinica-dental

ERP especializado para clínicas dentales. Estructura inicial: - database/ (PostgreSQL DDL) - docs/ (Documentación) - orchestration/ (Sistema NEXUS) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 04:41:50 -06:00 · 2026-01-07 04:41:50 -06:00 · 7ffcdf597c
commit 7ffcdf597c
12 changed files with 2321 additions and 0 deletions
--- a/.env.example
+++ b/.env.example
@ -0,0 +1,307 @@
+# =============================================================================
+# .env.example - CLINICA DENTAL
+# =============================================================================
+# Copia este archivo a .env y configura los valores
+# Generado por: @PERFIL_DEVENV
+# Referencia: orchestration/environment/ENVIRONMENT-INVENTORY.yml
+# =============================================================================
+
+# =============================================================================
+# APLICACION
+# =============================================================================
+NODE_ENV=development
+APP_NAME=clinica-dental
+APP_VERSION=1.0.0
+
+# =============================================================================
+# PUERTOS - Asignados por DEVENV-PORTS-INVENTORY.yml
+# =============================================================================
+FRONTEND_PORT=3130
+BACKEND_PORT=3131
+
+# Alias para compatibilidad
+PORT=3131
+
+# =============================================================================
+# BASE DE DATOS - PostgreSQL
+# =============================================================================
+# Desarrollo: Puerto 5441 (asignado en DEVENV-PORTS-INVENTORY.yml)
+# Produccion: Puerto 5432 (estandar)
+# =============================================================================
+
+DB_HOST=localhost
+DB_PORT=5441
+DB_NAME=clinica_dental_dev
+DB_USER=dental_dev
+
+# IMPORTANTE: Generar password seguro con: openssl rand -base64 32
+DB_PASSWORD=CAMBIAR_POR_PASSWORD_SEGURO
+
+# Connection string completo (calculado de las variables anteriores)
+DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}
+
+# Pool de conexiones
+DB_POOL_SIZE=10
+DB_CONNECTION_TIMEOUT=5000
+
+# SSL (false para desarrollo, true para produccion)
+DB_SSL=false
+
+# =============================================================================
+# BASE DE DATOS - Ambientes adicionales
+# =============================================================================
+# Test (mismo servidor, diferente BD)
+# DB_NAME_TEST=clinica_dental_test
+
+# Staging (servidor externo)
+# DB_HOST_STAGING=staging-db.example.com
+# DB_NAME_STAGING=clinica_dental_staging
+# DB_USER_STAGING=dental_staging
+
+# Produccion (servidor externo)
+# DB_HOST_PROD=prod-db.example.com
+# DB_NAME_PROD=clinica_dental_prod
+# DB_USER_PROD=dental_prod
+
+# =============================================================================
+# REDIS - Cache y Sesiones
+# =============================================================================
+# Desarrollo: Puerto 6388 (asignado en DEVENV-PORTS-INVENTORY.yml)
+# Produccion: Puerto 6379 (estandar)
+# =============================================================================
+
+REDIS_HOST=localhost
+REDIS_PORT=6388
+REDIS_DB=0
+
+# Password (vacio para desarrollo, requerido en produccion)
+REDIS_PASSWORD=
+
+# Connection string
+REDIS_URL=redis://${REDIS_HOST}:${REDIS_PORT}/${REDIS_DB}
+
+# Configuracion de cache
+REDIS_CACHE_TTL=3600
+REDIS_MAX_MEMORY=256mb
+
+# =============================================================================
+# AUTENTICACION - JWT
+# =============================================================================
+# IMPORTANTE: Generar secreto seguro con: openssl rand -base64 64
+# Minimo 32 caracteres requeridos
+# =============================================================================
+
+JWT_SECRET=CAMBIAR_POR_SECRETO_SEGURO_DE_AL_MENOS_32_CARACTERES
+
+# Tiempos de expiracion
+JWT_EXPIRES_IN=24h
+JWT_REFRESH_EXPIRES_IN=7d
+
+# Algoritmo (default: HS256)
+JWT_ALGORITHM=HS256
+
+# =============================================================================
+# CORS - Cross-Origin Resource Sharing
+# =============================================================================
+
+FRONTEND_URL=http://localhost:3130
+
+# Multiples origenes separados por coma
+ALLOWED_ORIGINS=http://localhost:3130,http://localhost:3131
+
+# Metodos permitidos
+CORS_METHODS=GET,POST,PUT,PATCH,DELETE,OPTIONS
+
+# Headers permitidos
+CORS_HEADERS=Content-Type,Authorization,X-Requested-With
+
+# =============================================================================
+# LOGGING
+# =============================================================================
+
+# Niveles: debug, info, warn, error
+LOG_LEVEL=debug
+
+# Formatos: pretty (desarrollo), json (produccion)
+LOG_FORMAT=pretty
+
+# Archivo de logs (opcional)
+# LOG_FILE=./logs/app.log
+
+# Rotacion de logs
+# LOG_MAX_SIZE=10m
+# LOG_MAX_FILES=5
+
+# =============================================================================
+# ALMACENAMIENTO DE ARCHIVOS (Radiografias y documentos)
+# =============================================================================
+
+# Tipo: local, s3, minio
+STORAGE_TYPE=local
+
+# Path local (para desarrollo)
+STORAGE_PATH=./uploads
+
+# Tamano maximo de archivo (20MB en bytes - para radiografias)
+MAX_FILE_SIZE=20971520
+
+# Tipos permitidos (incluye DICOM para imagenes medicas)
+ALLOWED_FILE_TYPES=image/jpeg,image/png,image/dicom,application/pdf,application/dicom
+
+# Directorio para radiografias
+XRAY_STORAGE_PATH=./uploads/radiografias
+
+# =============================================================================
+# AWS S3 (para produccion)
+# =============================================================================
+
+# AWS_ACCESS_KEY_ID=
+# AWS_SECRET_ACCESS_KEY=
+# AWS_REGION=us-east-1
+# AWS_S3_BUCKET=clinica-dental-uploads
+# AWS_S3_XRAY_BUCKET=clinica-dental-radiografias
+
+# =============================================================================
+# EMAIL - SMTP
+# =============================================================================
+# MailHog para desarrollo: puerto 1025
+# Servidor real para produccion
+# =============================================================================
+
+SMTP_HOST=localhost
+SMTP_PORT=1025
+SMTP_SECURE=false
+
+# Credenciales (para produccion)
+# SMTP_USER=
+# SMTP_PASSWORD=
+
+# Remitente por defecto
+SMTP_FROM_NAME=Clinica Dental
+SMTP_FROM_EMAIL=noreply@clinica-dental.local
+
+# =============================================================================
+# SEGURIDAD ADICIONAL
+# =============================================================================
+
+# Rate limiting
+RATE_LIMIT_WINDOW=900000
+RATE_LIMIT_MAX=100
+
+# Helmet (headers de seguridad)
+HELMET_ENABLED=true
+
+# CSRF Protection
+CSRF_ENABLED=false
+
+# Throttle por IP
+THROTTLE_TTL=60
+THROTTLE_LIMIT=10
+
+# =============================================================================
+# MONITOREO Y METRICAS
+# =============================================================================
+
+# Health check endpoint
+HEALTH_CHECK_ENABLED=true
+
+# Metricas Prometheus (opcional)
+# METRICS_ENABLED=false
+# METRICS_PORT=9090
+
+# Sentry (opcional)
+# SENTRY_DSN=
+
+# =============================================================================
+# CONFIGURACION ESPECIFICA DENTAL
+# =============================================================================
+
+# Nomenclatura dental (FDI por defecto)
+DENTAL_FDI_NOTATION=true
+
+# Version del formato de odontograma
+ODONTOGRAM_VERSION=2.0
+
+# Recordatorios de citas (dias antes)
+APPOINTMENT_REMINDER_DAYS=2
+
+# Validez de presupuestos (dias)
+BUDGET_VALIDITY_DAYS=30
+
+# Tipos de radiografias habilitados
+XRAY_TYPES=periapical,panoramica,oclusal,bitewing,cefalometrica
+
+# =============================================================================
+# CUMPLIMIENTO NORMATIVO (NOM-024-SSA3-2012)
+# =============================================================================
+
+# Habilitar auditoria (obligatorio en produccion)
+AUDIT_ENABLED=true
+
+# Retencion de logs de auditoria (dias)
+AUDIT_RETENTION_DAYS=1825
+
+# Encriptacion de datos sensibles
+DATA_ENCRYPTION=false
+
+# Firma electronica de expedientes
+ELECTRONIC_SIGNATURE=false
+
+# =============================================================================
+# DESARROLLO Y DEBUG
+# =============================================================================
+
+# Habilitar debug de TypeORM
+# TYPEORM_LOGGING=true
+
+# Swagger UI
+SWAGGER_ENABLED=true
+SWAGGER_TITLE=Clinica Dental API
+SWAGGER_VERSION=1.0.0
+
+# Hot reload
+HOT_RELOAD=true
+
+# =============================================================================
+# PRODUCCION
+# =============================================================================
+# Estas variables deben configurarse via secrets manager en produccion:
+#
+# - DB_PASSWORD (secreto)
+# - JWT_SECRET (secreto)
+# - REDIS_PASSWORD (secreto)
+# - AWS_ACCESS_KEY_ID (si usa S3)
+# - AWS_SECRET_ACCESS_KEY (si usa S3)
+# - SMTP_USER (si usa email)
+# - SMTP_PASSWORD (si usa email)
+# - SENTRY_DSN (si usa Sentry)
+# - ENCRYPTION_KEY (para datos sensibles)
+#
+# Diferencias de configuracion en produccion:
+# - NODE_ENV=production
+# - LOG_LEVEL=info
+# - LOG_FORMAT=json
+# - DB_PORT=5432 (estandar)
+# - DB_SSL=true
+# - REDIS_PORT=6379 (estandar)
+# - STORAGE_TYPE=s3
+# - SWAGGER_ENABLED=false
+# - HOT_RELOAD=false
+# - AUDIT_ENABLED=true
+# - DATA_ENCRYPTION=true
+# - ELECTRONIC_SIGNATURE=true
+#
+# IMPORTANTE: Cumplimiento NOM-024-SSA3-2012
+# - Logs de auditoria inmutables
+# - Retencion minima 5 anos
+# - Backups diarios
+# =============================================================================
+
+# =============================================================================
+# REFERENCIAS
+# =============================================================================
+# Inventario de entorno: orchestration/environment/ENVIRONMENT-INVENTORY.yml
+# Inventario de puertos: orchestration/inventarios/DEVENV-PORTS-INVENTORY.yml
+# Perfil DevEnv: orchestration/agents/perfiles/PERFIL-DEVENV.md
+# Nomenclatura FDI: https://www.fdiworlddental.org/tooth-numbering-system
+# =============================================================================
--- a/.env.ports
+++ b/.env.ports
@ -0,0 +1,20 @@
+# =============================================================================
+# .env.ports - CLINICA DENTAL
+# =============================================================================
+# Archivo de referencia de puertos asignados
+# Generado por: @PERFIL_DEVENV
+# =============================================================================
+
+# Servicios principales
+FRONTEND_PORT=3130
+BACKEND_PORT=3131
+
+# Base de datos
+DB_PORT=5441
+
+# Redis
+REDIS_PORT=6388
+
+# =============================================================================
+# Referencia: DEVENV-PORTS-INVENTORY.yml
+# =============================================================================
--- a/README.md
+++ b/README.md
@ -0,0 +1,81 @@
+# Clinica Dental - ERP Especializado
+
+**Version:** 0.1.0
+**Estado:** Desarrollo
+**Tipo:** VERTICAL (erp-clinicas)
+**Sistema:** SIMCO + NEXUS v3.4
+
+---
+
+## Descripcion
+
+Sistema de gestion integral para clinicas dentales. Vertical especializada basada en erp-clinicas.
+
+### Funcionalidades Principales
+
+- Gestion de pacientes con expedientes y odontograma digital
+- Consultas dentales: diagnostico y tratamientos
+- Control de ortodoncia y protesis
+- Presupuestos y planes de tratamiento
+- Inventario de materiales dentales
+- Facturacion de servicios
+
+---
+
+## Stack Tecnologico
+
+| Capa | Tecnologia |
+|------|------------|
+| Database | PostgreSQL 16+ con RLS |
+| Backend | (pendiente) Express.js / NestJS |
+| Frontend | (pendiente) React + Vite |
+
+---
+
+## Estructura del Proyecto
+
+```
+clinica-dental/
+├── database/
+│   ├── schemas/       # DDL especifico dental
+│   └── seeds/         # Datos iniciales
+├── docs/
+│   └── 00-vision-general/
+├── orchestration/
+│   ├── 00-guidelines/
+│   ├── environment/
+│   ├── inventarios/
+│   └── trazas/
+└── README.md
+```
+
+---
+
+## Herencia
+
+Este proyecto hereda de:
+- **erp-clinicas** (modulos base de clinicas)
+- **erp-core** (modulos genericos ERP)
+
+---
+
+## Inicio Rapido
+
+```bash
+# Database (requiere PostgreSQL y erp-clinicas cargado)
+psql -d erp_clinicas -f database/schemas/01-dental-schema-ddl.sql
+psql -d erp_clinicas -f database/seeds/fase8/01-dental-catalogos.sql
+```
+
+---
+
+## Referencias
+
+- Contexto: `orchestration/00-guidelines/CONTEXTO-PROYECTO.md`
+- Herencia: `orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md`
+- Inventario: `orchestration/inventarios/MASTER_INVENTORY.yml`
+
+---
+
+**Creado:** 2026-01-04
+**Actualizado:** 2026-01-07
--- a/database/schemas/01-dental-schema-ddl.sql
+++ b/database/schemas/01-dental-schema-ddl.sql
@ -0,0 +1,502 @@
+-- ============================================================================
+-- DENTAL SCHEMA - Especialización de ERP-Clínicas
+-- Clínica Dental
+-- ============================================================================
+-- Fecha: 2026-01-04
+-- Versión: 1.0
+-- Hereda de: erp-clinicas FASE-8
+-- ============================================================================
+
+-- Schema
+CREATE SCHEMA IF NOT EXISTS dental;
+
+-- ============================================================================
+-- ENUMS
+-- ============================================================================
+
+DO $$ BEGIN
+    CREATE TYPE dental.estado_pieza AS ENUM (
+        'sano', 'caries', 'obturacion', 'endodoncia', 'corona',
+        'puente', 'implante', 'ausente', 'extraccion_indicada',
+        'diente_temporal', 'fractura', 'movilidad'
+    );
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+    CREATE TYPE dental.cara_dental AS ENUM (
+        'mesial', 'distal', 'oclusal', 'incisal',
+        'vestibular', 'bucal', 'lingual', 'palatino'
+    );
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+    CREATE TYPE dental.estado_tratamiento AS ENUM (
+        'pendiente', 'en_proceso', 'completado', 'cancelado'
+    );
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+    CREATE TYPE dental.tipo_ortodoncia AS ENUM (
+        'brackets_metalicos', 'brackets_esteticos', 'brackets_linguales',
+        'alineadores', 'removible', 'retenedor'
+    );
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+-- ============================================================================
+-- CATÁLOGOS
+-- ============================================================================
+
+-- Piezas dentales
+CREATE TABLE IF NOT EXISTS dental.piezas_dentales (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    numero VARCHAR(10) NOT NULL UNIQUE, -- '11', '12', ... '48', '51'...'85'
+    nombre VARCHAR(50) NOT NULL,
+    cuadrante INTEGER NOT NULL CHECK (cuadrante BETWEEN 1 AND 8),
+    es_temporal BOOLEAN DEFAULT false,
+    descripcion TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.piezas_dentales IS 'Catálogo de piezas dentales (nomenclatura FDI)';
+
+-- Tratamientos dentales
+CREATE TABLE IF NOT EXISTS dental.tratamientos_catalogo (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    codigo VARCHAR(20) NOT NULL,
+    nombre VARCHAR(100) NOT NULL,
+    categoria VARCHAR(50), -- 'prevencion', 'restauracion', 'endodoncia', etc.
+    descripcion TEXT,
+    duracion_minutos INTEGER DEFAULT 30,
+    precio_base NUMERIC(10,2),
+    requiere_rx BOOLEAN DEFAULT false,
+    requiere_anestesia BOOLEAN DEFAULT false,
+    active BOOLEAN DEFAULT true,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    CONSTRAINT uq_tratamientos_tenant_codigo UNIQUE(tenant_id, codigo)
+);
+
+COMMENT ON TABLE dental.tratamientos_catalogo IS 'Catálogo de tratamientos dentales';
+
+-- ============================================================================
+-- TABLAS PRINCIPALES
+-- ============================================================================
+
+-- Odontograma
+CREATE TABLE IF NOT EXISTS dental.odontogramas (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    patient_id UUID NOT NULL, -- Referencia a clinica.patients
+    fecha_creacion DATE NOT NULL DEFAULT CURRENT_DATE,
+    fecha_actualizacion DATE,
+    notas TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.odontogramas IS 'Odontogramas de pacientes';
+
+-- Estado de piezas dentales por odontograma
+CREATE TABLE IF NOT EXISTS dental.odontograma_piezas (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    odontograma_id UUID NOT NULL REFERENCES dental.odontogramas(id) ON DELETE CASCADE,
+    pieza_id UUID NOT NULL REFERENCES dental.piezas_dentales(id),
+    -- Estado general
+    estado dental.estado_pieza DEFAULT 'sano',
+    -- Estados por cara (JSONB para flexibilidad)
+    caras_afectadas JSONB, -- {"mesial": "caries", "oclusal": "obturacion"}
+    -- Notas
+    observaciones TEXT,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    CONSTRAINT uq_odontograma_pieza UNIQUE(odontograma_id, pieza_id)
+);
+
+COMMENT ON TABLE dental.odontograma_piezas IS 'Estado de cada pieza dental en el odontograma';
+
+-- Tratamientos de paciente
+CREATE TABLE IF NOT EXISTS dental.tratamientos_paciente (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    patient_id UUID NOT NULL,
+    odontograma_id UUID REFERENCES dental.odontogramas(id),
+    tratamiento_id UUID REFERENCES dental.tratamientos_catalogo(id),
+    odontologo_id UUID, -- Referencia a clinica.doctors
+    consultation_id UUID, -- Referencia a clinica.consultations
+    -- Pieza(s) tratada(s)
+    pieza_id UUID REFERENCES dental.piezas_dentales(id),
+    caras_tratadas dental.cara_dental[],
+    -- Datos del tratamiento
+    fecha_inicio DATE NOT NULL DEFAULT CURRENT_DATE,
+    fecha_fin DATE,
+    estado dental.estado_tratamiento DEFAULT 'pendiente',
+    -- Costo
+    precio NUMERIC(10,2),
+    descuento NUMERIC(5,2) DEFAULT 0,
+    precio_final NUMERIC(10,2),
+    -- Notas
+    notas TEXT,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.tratamientos_paciente IS 'Tratamientos realizados a pacientes';
+
+-- Ortodoncia
+CREATE TABLE IF NOT EXISTS dental.ortodoncia (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    patient_id UUID NOT NULL,
+    odontologo_id UUID,
+    -- Tipo de tratamiento
+    tipo dental.tipo_ortodoncia NOT NULL,
+    marca VARCHAR(100),
+    -- Fechas
+    fecha_inicio DATE NOT NULL,
+    fecha_estimada_fin DATE,
+    fecha_real_fin DATE,
+    -- Estado
+    estado dental.estado_tratamiento DEFAULT 'en_proceso',
+    meses_estimados INTEGER,
+    -- Costo
+    costo_total NUMERIC(10,2),
+    enganche NUMERIC(10,2),
+    mensualidad NUMERIC(10,2),
+    -- Notas
+    notas TEXT,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.ortodoncia IS 'Tratamientos de ortodoncia';
+
+-- Citas de ortodoncia (seguimiento)
+CREATE TABLE IF NOT EXISTS dental.ortodoncia_citas (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    ortodoncia_id UUID NOT NULL REFERENCES dental.ortodoncia(id) ON DELETE CASCADE,
+    appointment_id UUID, -- Referencia a clinica.appointments
+    -- Datos de la cita
+    fecha DATE NOT NULL,
+    numero_cita INTEGER,
+    -- Procedimiento
+    procedimiento TEXT,
+    arco_superior VARCHAR(50),
+    arco_inferior VARCHAR(50),
+    ligas VARCHAR(50),
+    -- Observaciones
+    observaciones TEXT,
+    proxima_cita DATE,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.ortodoncia_citas IS 'Citas de seguimiento de ortodoncia';
+
+-- Prótesis
+CREATE TABLE IF NOT EXISTS dental.protesis (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    patient_id UUID NOT NULL,
+    odontologo_id UUID,
+    -- Tipo
+    tipo VARCHAR(50) NOT NULL, -- 'corona', 'puente', 'parcial', 'total', 'implante'
+    -- Piezas involucradas
+    piezas_involucradas TEXT[], -- ['11', '12', '13']
+    -- Laboratorio
+    laboratorio_id UUID, -- Referencia a proveedor
+    fecha_envio_lab DATE,
+    fecha_recepcion_lab DATE,
+    -- Material
+    material VARCHAR(100),
+    color VARCHAR(50),
+    -- Estado
+    estado dental.estado_tratamiento DEFAULT 'en_proceso',
+    fecha_colocacion DATE,
+    -- Garantía
+    tiene_garantia BOOLEAN DEFAULT false,
+    meses_garantia INTEGER,
+    -- Costo
+    costo_laboratorio NUMERIC(10,2),
+    precio_paciente NUMERIC(10,2),
+    -- Notas
+    notas TEXT,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.protesis IS 'Registro de prótesis dentales';
+
+-- Radiografías
+CREATE TABLE IF NOT EXISTS dental.radiografias (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    patient_id UUID NOT NULL,
+    consultation_id UUID,
+    -- Tipo
+    tipo VARCHAR(50) NOT NULL, -- 'periapical', 'panoramica', 'cefalometrica', 'oclusal'
+    pieza_id UUID REFERENCES dental.piezas_dentales(id),
+    -- Archivo
+    fecha DATE NOT NULL DEFAULT CURRENT_DATE,
+    url_imagen VARCHAR(255),
+    -- Interpretación
+    interpretacion TEXT,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.radiografias IS 'Registro de radiografías dentales';
+
+-- Presupuestos
+CREATE TABLE IF NOT EXISTS dental.presupuestos (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    patient_id UUID NOT NULL,
+    odontologo_id UUID,
+    -- Datos
+    numero VARCHAR(20),
+    fecha DATE NOT NULL DEFAULT CURRENT_DATE,
+    fecha_vencimiento DATE,
+    -- Estado
+    estado VARCHAR(20) DEFAULT 'pendiente', -- 'pendiente', 'aprobado', 'rechazado', 'vencido'
+    -- Totales
+    subtotal NUMERIC(12,2) DEFAULT 0,
+    descuento_porcentaje NUMERIC(5,2) DEFAULT 0,
+    descuento_monto NUMERIC(12,2) DEFAULT 0,
+    total NUMERIC(12,2) DEFAULT 0,
+    -- Plan de pago
+    requiere_financiamiento BOOLEAN DEFAULT false,
+    enganche NUMERIC(12,2),
+    numero_pagos INTEGER,
+    monto_pago NUMERIC(12,2),
+    -- Notas
+    notas TEXT,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.presupuestos IS 'Presupuestos de tratamiento';
+
+-- Líneas de presupuesto
+CREATE TABLE IF NOT EXISTS dental.presupuesto_lineas (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id UUID NOT NULL,
+    presupuesto_id UUID NOT NULL REFERENCES dental.presupuestos(id) ON DELETE CASCADE,
+    tratamiento_id UUID REFERENCES dental.tratamientos_catalogo(id),
+    -- Pieza
+    pieza_id UUID REFERENCES dental.piezas_dentales(id),
+    descripcion TEXT,
+    -- Cantidades
+    cantidad INTEGER DEFAULT 1,
+    precio_unitario NUMERIC(10,2),
+    descuento NUMERIC(5,2) DEFAULT 0,
+    subtotal NUMERIC(10,2),
+    -- Secuencia
+    sequence INTEGER DEFAULT 10,
+    -- Control
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+COMMENT ON TABLE dental.presupuesto_lineas IS 'Líneas de presupuesto';
+
+-- ============================================================================
+-- EXTENSIONES A TABLAS DE ERP-CLINICAS
+-- ============================================================================
+
+DO $$
+BEGIN
+    -- Extensión a clinica.patients
+    IF EXISTS (SELECT 1 FROM information_schema.tables
+               WHERE table_schema = 'clinica' AND table_name = 'patients') THEN
+
+        IF NOT EXISTS (SELECT 1 FROM information_schema.columns
+                       WHERE table_schema = 'clinica' AND table_name = 'patients'
+                       AND column_name = 'odontograma_activo_id') THEN
+            ALTER TABLE clinica.patients ADD COLUMN odontograma_activo_id UUID;
+        END IF;
+
+        IF NOT EXISTS (SELECT 1 FROM information_schema.columns
+                       WHERE table_schema = 'clinica' AND table_name = 'patients'
+                       AND column_name = 'tiene_ortodoncia') THEN
+            ALTER TABLE clinica.patients ADD COLUMN tiene_ortodoncia BOOLEAN DEFAULT false;
+        END IF;
+
+        IF NOT EXISTS (SELECT 1 FROM information_schema.columns
+                       WHERE table_schema = 'clinica' AND table_name = 'patients'
+                       AND column_name = 'tiene_protesis') THEN
+            ALTER TABLE clinica.patients ADD COLUMN tiene_protesis BOOLEAN DEFAULT false;
+        END IF;
+
+    END IF;
+END $$;
+
+-- ============================================================================
+-- SEED: Piezas dentales (catálogo global)
+-- ============================================================================
+
+INSERT INTO dental.piezas_dentales (numero, nombre, cuadrante, es_temporal) VALUES
+-- Cuadrante 1 - Superior derecho (permanentes)
+('18', 'Tercer molar superior derecho', 1, false),
+('17', 'Segundo molar superior derecho', 1, false),
+('16', 'Primer molar superior derecho', 1, false),
+('15', 'Segundo premolar superior derecho', 1, false),
+('14', 'Primer premolar superior derecho', 1, false),
+('13', 'Canino superior derecho', 1, false),
+('12', 'Incisivo lateral superior derecho', 1, false),
+('11', 'Incisivo central superior derecho', 1, false),
+-- Cuadrante 2 - Superior izquierdo (permanentes)
+('21', 'Incisivo central superior izquierdo', 2, false),
+('22', 'Incisivo lateral superior izquierdo', 2, false),
+('23', 'Canino superior izquierdo', 2, false),
+('24', 'Primer premolar superior izquierdo', 2, false),
+('25', 'Segundo premolar superior izquierdo', 2, false),
+('26', 'Primer molar superior izquierdo', 2, false),
+('27', 'Segundo molar superior izquierdo', 2, false),
+('28', 'Tercer molar superior izquierdo', 2, false),
+-- Cuadrante 3 - Inferior izquierdo (permanentes)
+('31', 'Incisivo central inferior izquierdo', 3, false),
+('32', 'Incisivo lateral inferior izquierdo', 3, false),
+('33', 'Canino inferior izquierdo', 3, false),
+('34', 'Primer premolar inferior izquierdo', 3, false),
+('35', 'Segundo premolar inferior izquierdo', 3, false),
+('36', 'Primer molar inferior izquierdo', 3, false),
+('37', 'Segundo molar inferior izquierdo', 3, false),
+('38', 'Tercer molar inferior izquierdo', 3, false),
+-- Cuadrante 4 - Inferior derecho (permanentes)
+('41', 'Incisivo central inferior derecho', 4, false),
+('42', 'Incisivo lateral inferior derecho', 4, false),
+('43', 'Canino inferior derecho', 4, false),
+('44', 'Primer premolar inferior derecho', 4, false),
+('45', 'Segundo premolar inferior derecho', 4, false),
+('46', 'Primer molar inferior derecho', 4, false),
+('47', 'Segundo molar inferior derecho', 4, false),
+('48', 'Tercer molar inferior derecho', 4, false),
+-- Cuadrante 5 - Superior derecho (temporales)
+('55', 'Segundo molar temporal superior derecho', 5, true),
+('54', 'Primer molar temporal superior derecho', 5, true),
+('53', 'Canino temporal superior derecho', 5, true),
+('52', 'Incisivo lateral temporal superior derecho', 5, true),
+('51', 'Incisivo central temporal superior derecho', 5, true),
+-- Cuadrante 6 - Superior izquierdo (temporales)
+('61', 'Incisivo central temporal superior izquierdo', 6, true),
+('62', 'Incisivo lateral temporal superior izquierdo', 6, true),
+('63', 'Canino temporal superior izquierdo', 6, true),
+('64', 'Primer molar temporal superior izquierdo', 6, true),
+('65', 'Segundo molar temporal superior izquierdo', 6, true),
+-- Cuadrante 7 - Inferior izquierdo (temporales)
+('71', 'Incisivo central temporal inferior izquierdo', 7, true),
+('72', 'Incisivo lateral temporal inferior izquierdo', 7, true),
+('73', 'Canino temporal inferior izquierdo', 7, true),
+('74', 'Primer molar temporal inferior izquierdo', 7, true),
+('75', 'Segundo molar temporal inferior izquierdo', 7, true),
+-- Cuadrante 8 - Inferior derecho (temporales)
+('81', 'Incisivo central temporal inferior derecho', 8, true),
+('82', 'Incisivo lateral temporal inferior derecho', 8, true),
+('83', 'Canino temporal inferior derecho', 8, true),
+('84', 'Primer molar temporal inferior derecho', 8, true),
+('85', 'Segundo molar temporal inferior derecho', 8, true)
+ON CONFLICT (numero) DO NOTHING;
+
+-- ============================================================================
+-- ÍNDICES
+-- ============================================================================
+
+CREATE INDEX IF NOT EXISTS idx_tratamientos_catalogo_tenant ON dental.tratamientos_catalogo(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_tratamientos_catalogo_categoria ON dental.tratamientos_catalogo(tenant_id, categoria);
+
+CREATE INDEX IF NOT EXISTS idx_odontogramas_tenant ON dental.odontogramas(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_odontogramas_patient ON dental.odontogramas(patient_id);
+
+CREATE INDEX IF NOT EXISTS idx_odontograma_piezas_odontograma ON dental.odontograma_piezas(odontograma_id);
+CREATE INDEX IF NOT EXISTS idx_odontograma_piezas_pieza ON dental.odontograma_piezas(pieza_id);
+
+CREATE INDEX IF NOT EXISTS idx_tratamientos_paciente_tenant ON dental.tratamientos_paciente(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_tratamientos_paciente_patient ON dental.tratamientos_paciente(patient_id);
+CREATE INDEX IF NOT EXISTS idx_tratamientos_paciente_estado ON dental.tratamientos_paciente(tenant_id, estado);
+
+CREATE INDEX IF NOT EXISTS idx_ortodoncia_tenant ON dental.ortodoncia(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_ortodoncia_patient ON dental.ortodoncia(patient_id);
+CREATE INDEX IF NOT EXISTS idx_ortodoncia_estado ON dental.ortodoncia(tenant_id, estado);
+
+CREATE INDEX IF NOT EXISTS idx_ortodoncia_citas_ortodoncia ON dental.ortodoncia_citas(ortodoncia_id);
+
+CREATE INDEX IF NOT EXISTS idx_protesis_tenant ON dental.protesis(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_protesis_patient ON dental.protesis(patient_id);
+
+CREATE INDEX IF NOT EXISTS idx_radiografias_tenant ON dental.radiografias(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_radiografias_patient ON dental.radiografias(patient_id);
+
+CREATE INDEX IF NOT EXISTS idx_presupuestos_tenant ON dental.presupuestos(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_presupuestos_patient ON dental.presupuestos(patient_id);
+CREATE INDEX IF NOT EXISTS idx_presupuestos_estado ON dental.presupuestos(tenant_id, estado);
+
+CREATE INDEX IF NOT EXISTS idx_presupuesto_lineas_presupuesto ON dental.presupuesto_lineas(presupuesto_id);
+
+-- ============================================================================
+-- RLS
+-- ============================================================================
+
+ALTER TABLE dental.tratamientos_catalogo ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.odontogramas ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.odontograma_piezas ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.tratamientos_paciente ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.ortodoncia ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.ortodoncia_citas ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.protesis ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.radiografias ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.presupuestos ENABLE ROW LEVEL SECURITY;
+ALTER TABLE dental.presupuesto_lineas ENABLE ROW LEVEL SECURITY;
+
+DROP POLICY IF EXISTS tenant_isolation_tratamientos_cat ON dental.tratamientos_catalogo;
+CREATE POLICY tenant_isolation_tratamientos_cat ON dental.tratamientos_catalogo
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_odontogramas ON dental.odontogramas;
+CREATE POLICY tenant_isolation_odontogramas ON dental.odontogramas
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_odontograma_piezas ON dental.odontograma_piezas;
+CREATE POLICY tenant_isolation_odontograma_piezas ON dental.odontograma_piezas
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_tratamientos_pac ON dental.tratamientos_paciente;
+CREATE POLICY tenant_isolation_tratamientos_pac ON dental.tratamientos_paciente
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_ortodoncia ON dental.ortodoncia;
+CREATE POLICY tenant_isolation_ortodoncia ON dental.ortodoncia
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_ortodoncia_citas ON dental.ortodoncia_citas;
+CREATE POLICY tenant_isolation_ortodoncia_citas ON dental.ortodoncia_citas
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_protesis ON dental.protesis;
+CREATE POLICY tenant_isolation_protesis ON dental.protesis
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_radiografias ON dental.radiografias;
+CREATE POLICY tenant_isolation_radiografias ON dental.radiografias
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_presupuestos ON dental.presupuestos;
+CREATE POLICY tenant_isolation_presupuestos ON dental.presupuestos
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+DROP POLICY IF EXISTS tenant_isolation_presupuesto_lineas ON dental.presupuesto_lineas;
+CREATE POLICY tenant_isolation_presupuesto_lineas ON dental.presupuesto_lineas
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::UUID);
+
+-- ============================================================================
+-- FIN DENTAL SCHEMA
+-- ============================================================================
--- a/database/seeds/fase8/01-dental-catalogos.sql
+++ b/database/seeds/fase8/01-dental-catalogos.sql
@ -0,0 +1,101 @@
+-- ============================================================================
+-- SEED DATA: Catálogos de Clínica Dental
+-- Especialización de ERP-Clínicas
+-- ============================================================================
+-- NOTA: Ejecutar después de SET app.current_tenant_id = 'UUID-DEL-TENANT';
+-- ============================================================================
+
+-- Tratamientos dentales
+INSERT INTO dental.tratamientos_catalogo (tenant_id, codigo, nombre, categoria, duracion_minutos, precio_base, requiere_rx, requiere_anestesia)
+SELECT current_setting('app.current_tenant_id', true)::UUID, codigo, nombre, categoria, duracion, precio, rx, anestesia
+FROM (VALUES
+    -- Prevención
+    ('PREV-001', 'Limpieza dental básica', 'prevencion', 45, 600.00, false, false),
+    ('PREV-002', 'Limpieza dental profunda', 'prevencion', 60, 1200.00, false, true),
+    ('PREV-003', 'Aplicación de flúor', 'prevencion', 15, 300.00, false, false),
+    ('PREV-004', 'Sellador de fosetas', 'prevencion', 20, 400.00, false, false),
+    -- Restauración
+    ('REST-001', 'Resina simple (1 cara)', 'restauracion', 30, 800.00, true, true),
+    ('REST-002', 'Resina compuesta (2 caras)', 'restauracion', 45, 1000.00, true, true),
+    ('REST-003', 'Resina compleja (3+ caras)', 'restauracion', 60, 1300.00, true, true),
+    ('REST-004', 'Incrustación de resina', 'restauracion', 90, 2500.00, true, true),
+    ('REST-005', 'Incrustación de porcelana', 'restauracion', 90, 4000.00, true, true),
+    -- Endodoncia
+    ('ENDO-001', 'Endodoncia unirradicular', 'endodoncia', 60, 3000.00, true, true),
+    ('ENDO-002', 'Endodoncia birradicular', 'endodoncia', 90, 4000.00, true, true),
+    ('ENDO-003', 'Endodoncia multirradicular', 'endodoncia', 120, 5000.00, true, true),
+    ('ENDO-004', 'Retratamiento endodóntico', 'endodoncia', 120, 5500.00, true, true),
+    -- Periodoncia
+    ('PERIO-001', 'Raspado y alisado radicular (cuadrante)', 'periodoncia', 60, 1500.00, true, true),
+    ('PERIO-002', 'Cirugía periodontal', 'periodoncia', 120, 6000.00, true, true),
+    -- Cirugía
+    ('CIRUG-001', 'Extracción simple', 'cirugia', 30, 800.00, true, true),
+    ('CIRUG-002', 'Extracción de tercer molar', 'cirugia', 60, 3500.00, true, true),
+    ('CIRUG-003', 'Extracción quirúrgica compleja', 'cirugia', 90, 5000.00, true, true),
+    -- Prótesis
+    ('PROT-001', 'Corona de porcelana', 'protesis', 60, 6000.00, true, true),
+    ('PROT-002', 'Corona de zirconia', 'protesis', 60, 8000.00, true, true),
+    ('PROT-003', 'Puente fijo (3 unidades)', 'protesis', 120, 18000.00, true, true),
+    ('PROT-004', 'Prótesis parcial removible', 'protesis', 120, 8000.00, true, false),
+    ('PROT-005', 'Prótesis total', 'protesis', 180, 12000.00, true, false),
+    -- Implantes
+    ('IMPL-001', 'Implante dental (sin corona)', 'implantes', 90, 15000.00, true, true),
+    ('IMPL-002', 'Corona sobre implante', 'implantes', 60, 8000.00, false, false),
+    -- Ortodoncia
+    ('ORTO-001', 'Brackets metálicos (tratamiento completo)', 'ortodoncia', 60, 35000.00, true, false),
+    ('ORTO-002', 'Brackets estéticos (tratamiento completo)', 'ortodoncia', 60, 45000.00, true, false),
+    ('ORTO-003', 'Alineadores invisibles', 'ortodoncia', 45, 60000.00, true, false),
+    ('ORTO-004', 'Control mensual ortodoncia', 'ortodoncia', 30, 800.00, false, false),
+    ('ORTO-005', 'Retenedor fijo', 'ortodoncia', 45, 3000.00, false, false),
+    -- Estética
+    ('ESTE-001', 'Blanqueamiento en consultorio', 'estetica', 90, 5000.00, false, false),
+    ('ESTE-002', 'Blanqueamiento casero', 'estetica', 30, 3000.00, false, false),
+    ('ESTE-003', 'Carilla de resina', 'estetica', 60, 3500.00, false, false),
+    ('ESTE-004', 'Carilla de porcelana', 'estetica', 60, 8000.00, false, false),
+    -- Diagnóstico
+    ('DIAG-001', 'Radiografía periapical', 'diagnostico', 5, 100.00, false, false),
+    ('DIAG-002', 'Radiografía panorámica', 'diagnostico', 10, 500.00, false, false),
+    ('DIAG-003', 'Radiografía cefalométrica', 'diagnostico', 10, 400.00, false, false),
+    ('DIAG-004', 'Tomografía dental', 'diagnostico', 15, 1500.00, false, false)
+) AS t(codigo, nombre, categoria, duracion, precio, rx, anestesia)
+WHERE current_setting('app.current_tenant_id', true) IS NOT NULL
+  AND current_setting('app.current_tenant_id', true) != ''
+ON CONFLICT (tenant_id, codigo) DO NOTHING;
+
+-- Skills específicos dentales
+INSERT INTO hr.skills (tenant_id, skill_type_id, name, requiere_cedula)
+SELECT
+    current_setting('app.current_tenant_id', true)::UUID,
+    st.id,
+    unnest(ARRAY[
+        'Odontología General',
+        'Ortodoncia',
+        'Endodoncia',
+        'Periodoncia',
+        'Cirugía Maxilofacial',
+        'Odontopediatría',
+        'Prostodoncia',
+        'Implantología',
+        'Estética Dental',
+        'Rehabilitación Oral'
+    ]),
+    true
+FROM hr.skill_types st
+WHERE st.name = 'Especialidad Médica'
+  AND st.tenant_id = current_setting('app.current_tenant_id', true)::UUID
+ON CONFLICT DO NOTHING;
+
+-- Ubicaciones (unidades dentales)
+INSERT INTO hr.work_locations (tenant_id, name, tipo_consultorio, capacidad, equipamiento)
+SELECT current_setting('app.current_tenant_id', true)::UUID, name, tipo, capacidad, equipamiento::TEXT[]
+FROM (VALUES
+    ('Unidad Dental 1', 'especialidad', 1, ARRAY['sillon', 'rayos_x', 'ultrasonido']),
+    ('Unidad Dental 2', 'especialidad', 1, ARRAY['sillon', 'rayos_x', 'ultrasonido']),
+    ('Unidad Dental 3', 'especialidad', 1, ARRAY['sillon', 'rayos_x']),
+    ('Quirófano Dental', 'quirofano', 1, ARRAY['sillon', 'rayos_x', 'equipo_cirugia']),
+    ('Sala de Rayos X', 'laboratorio', 2, ARRAY['panoramico', 'cefalometrico']),
+    ('Laboratorio Dental', 'laboratorio', 2, ARRAY['modelos', 'protesis'])
+) AS t(name, tipo, capacidad, equipamiento)
+WHERE current_setting('app.current_tenant_id', true) IS NOT NULL
+  AND current_setting('app.current_tenant_id', true) != ''
+ON CONFLICT DO NOTHING;
--- a/docs/00-vision-general/README.md
+++ b/docs/00-vision-general/README.md
@ -0,0 +1,44 @@
+# Vision General - Clinica Dental
+
+## Proposito
+
+Sistema de gestion integral para clinicas dentales que permite:
+
+1. **Gestion de Pacientes**
+   - Expedientes con historial completo
+   - Odontograma digital interactivo
+   - Historial de tratamientos
+
+2. **Consultas Dentales**
+   - Registro de diagnosticos
+   - Planes de tratamiento
+   - Presupuestos detallados
+
+3. **Especialidades**
+   - Ortodoncia (brackets, alineadores)
+   - Endodoncia (tratamientos de conductos)
+   - Protesis (coronas, puentes, dentaduras)
+   - Cirugia (extracciones, implantes)
+
+4. **Operaciones**
+   - Inventario de materiales
+   - Facturacion de servicios
+   - Agenda de citas
+
+## Usuarios
+
+| Rol | Acceso |
+|-----|--------|
+| Odontologo | Consultas, diagnosticos, tratamientos |
+| Auxiliar dental | Apoyo en procedimientos |
+| Recepcionista | Citas, cobros |
+| Administrador | Gestion completa |
+
+## Alcance
+
+- **Incluido:** Gestion clinica, odontograma, tratamientos, facturacion
+- **Excluido:** Contabilidad avanzada (usa erp-core), nomina
+
+## Referencias
+
+Ver `orchestration/00-guidelines/CONTEXTO-PROYECTO.md` para detalles completos del negocio.
--- a/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
+++ b/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
@ -0,0 +1,162 @@
+# Contexto del Proyecto - Clínica Dental
+
+## 1. Información General
+
+| Campo | Valor |
+|-------|-------|
+| **Nombre:** | Clínica Dental |
+| **Tipo:** | ERP Especializado |
+| **Giro:** | Servicios Odontológicos |
+| **Base:** | erp-clinicas |
+| **Fecha creación:** | 2026-01-04 |
+
+---
+
+## 2. Descripción del Negocio
+
+Sistema de gestión integral para clínicas dentales que incluye:
+
+- **Gestión de pacientes:** Expedientes con odontograma
+- **Consultas dentales:** Diagnóstico, tratamientos
+- **Odontograma digital:** Estado de cada pieza dental
+- **Tratamientos:** Seguimiento de procedimientos
+- **Ortodoncia:** Control de tratamientos ortodónticos
+- **Prótesis:** Registro de trabajos protésicos
+- **Presupuestos:** Planes de tratamiento con costos
+- **Inventario:** Materiales dentales
+- **Facturación:** Cobro de servicios
+
+## 3. Usuarios del Sistema
+
+| Rol | Funciones |
+|-----|-----------|
+| Odontólogo | Consultas, diagnósticos, tratamientos |
+| Auxiliar dental | Apoyo en procedimientos |
+| Recepcionista | Citas, cobros |
+| Higienista | Limpiezas, profilaxis |
+| Técnico dental | Elaboración de prótesis |
+| Administrador | Gestión general |
+
+## 4. Procesos Principales
+
+### 4.1 Flujo de Consulta Dental
+
+```
+1. Paciente llega / se verifica cita
+2. Recepción registra llegada
+3. Revisión de odontograma previo
+4. Odontólogo realiza exploración
+5. Actualización de odontograma
+6. Diagnóstico y plan de tratamiento
+7. Presupuesto (si es necesario)
+8. Procedimiento (si aplica)
+9. Próxima cita
+10. Cobro en recepción
+```
+
+### 4.2 Flujo de Ortodoncia
+
+```
+1. Consulta de valoración
+2. Estudios (Rx, fotos, modelos)
+3. Plan de tratamiento
+4. Presupuesto y financiamiento
+5. Colocación de aparatología
+6. Citas de control (mensual)
+7. Retiro de aparatología
+8. Colocación de retenedores
+9. Citas de revisión
+```
+
+## 5. Entidades Principales
+
+### 5.1 Odontograma
+
+El odontograma es el registro gráfico del estado dental:
+
+| Campo | Descripción |
+|-------|-------------|
+| Pieza | Número de diente (1-32 o deciduos) |
+| Estado | Sano, caries, extracción, etc. |
+| Caras afectadas | Mesial, Distal, Oclusal, etc. |
+| Tratamientos | Historial de procedimientos |
+
+### 5.2 Nomenclatura Dental
+
+**Sistema FDI (dos dígitos):**
+- Cuadrante 1: Superior derecho (11-18)
+- Cuadrante 2: Superior izquierdo (21-28)
+- Cuadrante 3: Inferior izquierdo (31-38)
+- Cuadrante 4: Inferior derecho (41-48)
+
+**Dientes deciduos:**
+- Cuadrantes 5-8 (51-55, 61-65, 71-75, 81-85)
+
+### 5.3 Tratamientos Comunes
+
+| Categoría | Tratamientos |
+|-----------|-------------|
+| Prevención | Limpieza, selladores, fluoruro |
+| Restauración | Resinas, amalgamas, incrustaciones |
+| Endodoncia | Tratamiento de conductos |
+| Periodoncia | Raspados, cirugía periodontal |
+| Cirugía | Extracciones, implantes |
+| Prótesis | Coronas, puentes, dentaduras |
+| Ortodoncia | Brackets, alineadores |
+| Estética | Blanqueamiento, carillas |
+
+## 6. Catálogos Específicos
+
+### 6.1 Especialidades Odontológicas
+
+- Odontología General
+- Ortodoncia
+- Endodoncia
+- Periodoncia
+- Cirugía Maxilofacial
+- Odontopediatría
+- Prostodoncia
+- Estética Dental
+- Implantología
+
+### 6.2 Estados de Piezas Dentales
+
+- Sano
+- Caries
+- Obturación (resina/amalgama)
+- Endodoncia
+- Corona
+- Puente
+- Implante
+- Ausente
+- Extracción indicada
+
+### 6.3 Caras Dentales
+
+- Mesial (M)
+- Distal (D)
+- Oclusal/Incisal (O/I)
+- Vestibular/Bucal (V/B)
+- Lingual/Palatino (L/P)
+
+## 7. Integraciones
+
+| Sistema | Propósito |
+|---------|-----------|
+| Radiografías digitales | Captura de Rx periapicales, panorámicas |
+| Laboratorio dental | Pedidos de prótesis |
+| Proveedores | Materiales dentales |
+
+## 8. Métricas Clave
+
+| Métrica | Descripción |
+|---------|-------------|
+| Consultas/día | Número de pacientes atendidos |
+| Tratamientos completados | Planes terminados |
+| Tasa retención ortodoncia | Pacientes que completan tratamiento |
+| Ticket promedio | Ingreso por paciente |
+| Ocupación unidades | Uso de sillones dentales |
+
+---
+
+**Última actualización:** 2026-01-04
--- a/orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md
+++ b/orchestration/00-guidelines/HERENCIA-ERP-CLINICAS.md
@ -0,0 +1,116 @@
+# Herencia ERP-Clínicas - Clínica Dental
+
+## Información del Proyecto
+
+| Campo | Valor |
+|-------|-------|
+| **Proyecto:** | clinica-dental |
+| **Hereda de:** | erp-clinicas |
+| **Fecha creación:** | 2026-01-04 |
+| **Versión ERP-Clínicas:** | 1.0 FASE-8 |
+
+---
+
+## 1. Relación de Herencia
+
+```
+erp-core (FASE-8)
+    └── erp-clinicas (Base Genérica)
+        └── clinica-dental (Especialización)
+```
+
+## 2. Qué Se Hereda de ERP-Clínicas
+
+### 2.1 Schemas y Tablas
+
+| Schema | Tablas | Heredadas |
+|--------|--------|-----------|
+| clinica | 13 tablas base | ✅ |
+| financial | 4 tablas FASE-8 | ✅ |
+| hr | 11 tablas FASE-8 | ✅ |
+| inventory | 5 tablas FASE-8 | ✅ |
+| purchase | 1 tabla FASE-8 | ✅ |
+
+### 2.2 Funcionalidades Heredadas
+
+- Sistema de citas y consultas
+- Expedientes clínicos
+- Gestión de pacientes
+- Sistema de prescripciones
+- Gestión de personal (odontólogos)
+- Inventario de materiales
+- Pagos y facturación
+
+## 3. Especializaciones Dentales
+
+### 3.1 Adaptaciones de Terminología
+
+| ERP-Clínicas | Dental |
+|--------------|--------|
+| Médico | Odontólogo |
+| Especialidad Médica | Especialidad Odontológica |
+| Consulta | Consulta Dental |
+| Receta | Receta Dental |
+| Consultorio | Consultorio Dental/Unidad |
+
+### 3.2 Tablas Adicionales
+
+| Tabla | Propósito |
+|-------|-----------|
+| dental.odontograma | Estado dental del paciente |
+| dental.piezas_dentales | Catálogo de piezas dentales |
+| dental.tratamientos | Catálogo de tratamientos dentales |
+| dental.tratamientos_paciente | Tratamientos realizados |
+| dental.ortodoncia | Seguimiento de ortodoncia |
+| dental.protesis | Registro de prótesis |
+| dental.radiografias | Registro de radiografías |
+| dental.presupuestos | Presupuestos de tratamiento |
+
+### 3.3 Campos Adicionales
+
+| Tabla Base | Campos Dental |
+|------------|---------------|
+| patients | odontograma_id, tiene_ortodoncia, tiene_protesis |
+| consultations | tratamiento_id, pieza_dental, procedimiento |
+| prescriptions | uso_dental, indicaciones_especiales |
+
+## 4. Normativa Aplicable
+
+| Normativa | Descripción |
+|-----------|-------------|
+| NOM-013-SSA2-2015 | Prevención y control enfermedades bucales |
+| NOM-004-SSA3-2012 | Expediente clínico |
+| COFEPRIS | Registro de establecimientos |
+
+## 5. Instalación
+
+### 5.1 Orden de Ejecución
+
+```bash
+# 1. Base ERP-Clínicas (heredado)
+psql -f erp-clinicas/database/init/01-extensions.sql
+psql -f erp-clinicas/database/init/02-core-schema.sql
+psql -f erp-clinicas/database/init/03-clinical-tables.sql
+psql -f erp-clinicas/database/schemas/04-financial-ext-schema-ddl.sql
+psql -f erp-clinicas/database/schemas/05-hr-ext-fase8-schema-ddl.sql
+psql -f erp-clinicas/database/schemas/06-inventory-ext-fase8-schema-ddl.sql
+psql -f erp-clinicas/database/schemas/07-purchase-ext-fase8-schema-ddl.sql
+psql -f erp-clinicas/database/schemas/08-clinica-ext-fase8-schema-ddl.sql
+
+# 2. Especialización Dental
+psql -f clinica-dental/database/schemas/01-dental-schema-ddl.sql
+
+# 3. Seeds
+psql -f erp-clinicas/database/seeds/fase8/*.sql
+psql -f clinica-dental/database/seeds/fase8/*.sql
+```
+
+## 6. Versionado
+
+| Versión | Fecha | Cambios |
+|---------|-------|---------|
+| 1.0 | 2026-01-04 | Creación inicial, herencia de erp-clinicas FASE-8 |
+
+---
+
+**Última actualización:** 2026-01-04
--- a/orchestration/PROJECT-STATUS.md
+++ b/orchestration/PROJECT-STATUS.md
@ -0,0 +1,56 @@
+# PROJECT STATUS - Clinica Dental
+
+**Fecha:** 2026-01-07
+**Estado:** En Desarrollo
+**Fase:** Database
+
+---
+
+## Resumen
+
+| Aspecto | Estado | Notas |
+|---------|--------|-------|
+| Database | Completado | DDL y seeds listos |
+| Backend | Pendiente | - |
+| Frontend | Pendiente | - |
+| Tests | Pendiente | - |
+| Documentacion | Parcial | Contexto completo, falta epicas |
+
+---
+
+## Progreso por Modulo
+
+| Modulo | DDL | Backend | Frontend | Tests |
+|--------|-----|---------|----------|-------|
+| Odontograma | OK | - | - | - |
+| Tratamientos | OK | - | - | - |
+| Ortodoncia | OK | - | - | - |
+| Protesis | OK | - | - | - |
+
+---
+
+## Dependencias
+
+- **erp-clinicas:** Modulos base de gestion clinica
+- **erp-core:** Auth, users, tenants, billing
+
+---
+
+## Proximas Acciones
+
+1. Implementar backend para modulo odontograma
+2. Crear componente visual de odontograma
+3. Integrar con sistema de citas de erp-clinicas
+
+---
+
+## Riesgos
+
+| Riesgo | Probabilidad | Impacto | Mitigacion |
+|--------|--------------|---------|------------|
+| Complejidad odontograma UI | Media | Alto | Usar librerias SVG |
+| Integracion con erp-clinicas | Baja | Medio | Seguir patrones existentes |
+
+---
+
+**Ultima actualizacion:** 2026-01-07
--- a/orchestration/environment/ENVIRONMENT-INVENTORY.yml
+++ b/orchestration/environment/ENVIRONMENT-INVENTORY.yml
@ -0,0 +1,804 @@
+# =============================================================================
+# ENVIRONMENT-INVENTORY.yml - CLINICA-DENTAL
+# =============================================================================
+# Inventario Completo de Entorno de Desarrollo y Produccion
+# Generado por: @PERFIL_DEVENV
+# Basado en: orchestration/templates/TEMPLATE-ENVIRONMENT-INVENTORY.yml
+# =============================================================================
+
+version: "1.1.0"
+fecha_creacion: "2026-01-04"
+fecha_actualizacion: "2026-01-04"
+responsable: "@PERFIL_DEVENV"
+
+# -----------------------------------------------------------------------------
+# IDENTIFICACION DEL PROYECTO
+# -----------------------------------------------------------------------------
+
+proyecto:
+  nombre: "Clinica Dental"
+  alias: "clinica-dental"
+  codigo: "CD"
+  nivel: "NIVEL_2B.3"
+  tipo: "vertical-especializada"
+  estado: "desarrollo"
+  descripcion: "Sistema de gestion para clinicas dentales y odontologicas"
+  parent: "erp-clinicas"
+  herencia:
+    - erp-core
+    - erp-clinicas
+  normativas:
+    - "NOM-024-SSA3-2012 (Expediente clinico electronico)"
+    - "NOM-013-SSA2-2015 (Prevencion y control enfermedades bucales)"
+
+# -----------------------------------------------------------------------------
+# HERRAMIENTAS Y RUNTIME
+# -----------------------------------------------------------------------------
+
+herramientas:
+  runtime:
+    node:
+      version: "20.x"
+      version_minima: "18.x"
+      requerido: true
+      notas: "LTS recomendado para NestJS y React"
+    python:
+      version: ""
+      requerido: false
+      notas: "No requerido para este proyecto"
+
+  package_managers:
+    npm:
+      version: "10.x"
+      requerido: true
+    pnpm:
+      version: "8.x"
+      requerido: false
+      notas: "Alternativa opcional"
+
+  build_tools:
+    - nombre: "Vite"
+      version: "5.x"
+      uso: "Frontend build y dev server"
+    - nombre: "TypeScript"
+      version: "5.x"
+      uso: "Compilacion de codigo"
+    - nombre: "NestJS CLI"
+      version: "10.x"
+      uso: "Backend scaffolding y build"
+
+  linters:
+    - nombre: "ESLint"
+      version: "8.x"
+      config: ".eslintrc.js"
+    - nombre: "Prettier"
+      version: "3.x"
+      config: ".prettierrc"
+
+  testing:
+    - nombre: "Jest"
+      version: "29.x"
+      tipo: "unit backend"
+      config: "jest.config.js"
+    - nombre: "Vitest"
+      version: "1.x"
+      tipo: "unit frontend"
+      config: "vitest.config.ts"
+    - nombre: "Supertest"
+      version: "6.x"
+      tipo: "e2e"
+      config: "jest-e2e.config.js"
+
+# -----------------------------------------------------------------------------
+# SERVICIOS Y PUERTOS
+# -----------------------------------------------------------------------------
+
+servicios:
+  frontend:
+    nombre: "clinica-dental-frontend"
+    framework: "React"
+    version: "18.x"
+    puerto: 3130
+    comando_dev: "npm run dev"
+    comando_build: "npm run build"
+    comando_preview: "npm run preview"
+    ubicacion: "apps/frontend/"
+    url_local: "http://localhost:3130"
+    build_output: "dist/"
+
+  backend:
+    nombre: "clinica-dental-backend"
+    framework: "NestJS"
+    version: "10.x"
+    puerto: 3131
+    comando_dev: "npm run start:dev"
+    comando_build: "npm run build"
+    comando_prod: "npm run start:prod"
+    ubicacion: "apps/backend/"
+    url_local: "http://localhost:3131"
+    api_prefix: "/api/v1"
+    swagger_url: "http://localhost:3131/api/docs"
+
+# -----------------------------------------------------------------------------
+# BASE DE DATOS - CONFIGURACION COMPLETA
+# -----------------------------------------------------------------------------
+
+base_de_datos:
+  principal:
+    engine: "PostgreSQL"
+    version: "15"
+    host_variable: "DB_HOST"
+    puerto_variable: "DB_PORT"
+
+    ambientes:
+      development:
+        host: "localhost"
+        puerto: 5441
+        nombre: "clinica_dental_dev"
+        usuario: "dental_dev"
+        password_ref: "DB_PASSWORD en .env"
+        ssl: false
+        pool_size: 10
+        conexion: "postgresql://dental_dev:{password}@localhost:5441/clinica_dental_dev"
+
+      test:
+        host: "localhost"
+        puerto: 5441
+        nombre: "clinica_dental_test"
+        usuario: "dental_dev"
+        password_ref: "DB_PASSWORD en .env"
+        ssl: false
+        pool_size: 5
+        conexion: "postgresql://dental_dev:{password}@localhost:5441/clinica_dental_test"
+
+      staging:
+        host: "${DB_HOST}"
+        puerto: 5432
+        nombre: "clinica_dental_staging"
+        usuario: "dental_staging"
+        password_ref: "DB_PASSWORD en variables de CI/CD"
+        ssl: true
+        pool_size: 20
+        conexion: "postgresql://dental_staging:{password}@${DB_HOST}:5432/clinica_dental_staging?sslmode=require"
+
+      production:
+        host: "${DB_HOST}"
+        puerto: 5432
+        nombre: "clinica_dental_prod"
+        usuario: "dental_prod"
+        password_ref: "DB_PASSWORD en secrets manager"
+        ssl: true
+        pool_size: 50
+        conexion: "postgresql://dental_prod:{password}@${DB_HOST}:5432/clinica_dental_prod?sslmode=require"
+
+    schemas:
+      - nombre: "public"
+        descripcion: "Schema principal PostgreSQL"
+      - nombre: "dental"
+        descripcion: "Entidades odontologicas (odontograma, piezas, tratamientos, ortodoncia)"
+      - nombre: "clinical"
+        descripcion: "Heredado de erp-clinicas (consultorios, citas, historiales)"
+      - nombre: "financial"
+        descripcion: "Heredado de erp-core (pagos, facturacion, presupuestos)"
+      - nombre: "hr"
+        descripcion: "Heredado de erp-core (empleados, especialidades)"
+      - nombre: "inventory"
+        descripcion: "Heredado de erp-core (materiales, insumos dentales)"
+
+    scripts_inicializacion:
+      orden:
+        - "database/init/00-extensions.sql"
+        - "database/init/01-schemas.sql"
+        - "database/schemas/01-dental-schema-ddl.sql"
+        - "database/seeds/fase8/01-dental-catalogos.sql"
+        - "database/seeds/fase8/02-piezas-dentales-fdi.sql"
+
+    datos_iniciales:
+      piezas_dentales:
+        total: 52
+        nomenclatura: "FDI (Federation Dentaire Internationale)"
+        cuadrantes:
+          - id: 1
+            nombre: "Superior derecho"
+            piezas: "18-11"
+            tipo: "permanente"
+          - id: 2
+            nombre: "Superior izquierdo"
+            piezas: "21-28"
+            tipo: "permanente"
+          - id: 3
+            nombre: "Inferior izquierdo"
+            piezas: "31-38"
+            tipo: "permanente"
+          - id: 4
+            nombre: "Inferior derecho"
+            piezas: "41-48"
+            tipo: "permanente"
+          - id: 5
+            nombre: "Superior derecho temporal"
+            piezas: "55-51"
+            tipo: "temporal"
+          - id: 6
+            nombre: "Superior izquierdo temporal"
+            piezas: "61-65"
+            tipo: "temporal"
+          - id: 7
+            nombre: "Inferior izquierdo temporal"
+            piezas: "71-75"
+            tipo: "temporal"
+          - id: 8
+            nombre: "Inferior derecho temporal"
+            piezas: "81-85"
+            tipo: "temporal"
+
+  redis:
+    host_variable: "REDIS_HOST"
+    puerto_variable: "REDIS_PORT"
+
+    ambientes:
+      development:
+        host: "localhost"
+        puerto: 6388
+        database: 0
+        password: ""
+        conexion: "redis://localhost:6388/0"
+
+      production:
+        host: "${REDIS_HOST}"
+        puerto: 6379
+        database: 0
+        password_ref: "REDIS_PASSWORD en secrets"
+        conexion: "redis://:${REDIS_PASSWORD}@${REDIS_HOST}:6379/0"
+
+    uso:
+      - "Cache de sesiones"
+      - "Cache de odontogramas"
+      - "Rate limiting"
+      - "Queue de tareas (Bull)"
+
+# -----------------------------------------------------------------------------
+# VARIABLES DE ENTORNO - DESARROLLO
+# -----------------------------------------------------------------------------
+
+variables_entorno:
+  archivos:
+    ejemplo: ".env.example"
+    desarrollo: ".env"
+    test: ".env.test"
+    produccion: ".env.production"
+
+  development:
+    - nombre: "NODE_ENV"
+      valor: "development"
+      descripcion: "Ambiente de ejecucion"
+      requerido: true
+      sensible: false
+
+    - nombre: "APP_NAME"
+      valor: "clinica-dental"
+      descripcion: "Nombre de la aplicacion"
+      requerido: true
+      sensible: false
+
+    - nombre: "APP_VERSION"
+      valor: "1.0.0"
+      descripcion: "Version de la aplicacion"
+      requerido: false
+      sensible: false
+
+    # Puertos
+    - nombre: "FRONTEND_PORT"
+      valor: "3130"
+      descripcion: "Puerto del frontend React"
+      requerido: true
+      sensible: false
+
+    - nombre: "BACKEND_PORT"
+      valor: "3131"
+      descripcion: "Puerto del backend NestJS"
+      requerido: true
+      sensible: false
+
+    # Base de datos
+    - nombre: "DB_HOST"
+      valor: "localhost"
+      descripcion: "Host de PostgreSQL"
+      requerido: true
+      sensible: false
+
+    - nombre: "DB_PORT"
+      valor: "5441"
+      descripcion: "Puerto de PostgreSQL"
+      requerido: true
+      sensible: false
+
+    - nombre: "DB_NAME"
+      valor: "clinica_dental_dev"
+      descripcion: "Nombre de la base de datos"
+      requerido: true
+      sensible: false
+
+    - nombre: "DB_USER"
+      valor: "dental_dev"
+      descripcion: "Usuario de PostgreSQL"
+      requerido: true
+      sensible: false
+
+    - nombre: "DB_PASSWORD"
+      valor: ""
+      descripcion: "Password de PostgreSQL"
+      requerido: true
+      sensible: true
+      generacion: "openssl rand -base64 32"
+
+    - nombre: "DATABASE_URL"
+      valor: "postgresql://dental_dev:${DB_PASSWORD}@localhost:5441/clinica_dental_dev"
+      descripcion: "Connection string completo"
+      requerido: true
+      sensible: true
+
+    # Redis
+    - nombre: "REDIS_HOST"
+      valor: "localhost"
+      descripcion: "Host de Redis"
+      requerido: true
+      sensible: false
+
+    - nombre: "REDIS_PORT"
+      valor: "6388"
+      descripcion: "Puerto de Redis"
+      requerido: true
+      sensible: false
+
+    - nombre: "REDIS_URL"
+      valor: "redis://localhost:6388/0"
+      descripcion: "Connection string de Redis"
+      requerido: true
+      sensible: false
+
+    # Autenticacion
+    - nombre: "JWT_SECRET"
+      valor: ""
+      descripcion: "Secreto para firmar JWT (min 32 caracteres)"
+      requerido: true
+      sensible: true
+      generacion: "openssl rand -base64 64"
+
+    - nombre: "JWT_EXPIRES_IN"
+      valor: "24h"
+      descripcion: "Tiempo de expiracion del access token"
+      requerido: true
+      sensible: false
+
+    - nombre: "JWT_REFRESH_EXPIRES_IN"
+      valor: "7d"
+      descripcion: "Tiempo de expiracion del refresh token"
+      requerido: true
+      sensible: false
+
+    # CORS
+    - nombre: "FRONTEND_URL"
+      valor: "http://localhost:3130"
+      descripcion: "URL del frontend para CORS"
+      requerido: true
+      sensible: false
+
+    - nombre: "ALLOWED_ORIGINS"
+      valor: "http://localhost:3130,http://localhost:3131"
+      descripcion: "Origenes permitidos (comma separated)"
+      requerido: true
+      sensible: false
+
+    # Logging
+    - nombre: "LOG_LEVEL"
+      valor: "debug"
+      descripcion: "Nivel de logging (debug, info, warn, error)"
+      requerido: false
+      sensible: false
+
+    - nombre: "LOG_FORMAT"
+      valor: "pretty"
+      descripcion: "Formato de logs (pretty, json)"
+      requerido: false
+      sensible: false
+
+    # File Storage (radiografias, documentos)
+    - nombre: "STORAGE_TYPE"
+      valor: "local"
+      descripcion: "Tipo de storage (local, s3, minio)"
+      requerido: false
+      sensible: false
+
+    - nombre: "STORAGE_PATH"
+      valor: "./uploads"
+      descripcion: "Path para almacenamiento local"
+      requerido: false
+      sensible: false
+
+    - nombre: "MAX_FILE_SIZE"
+      valor: "20971520"
+      descripcion: "Tamano maximo de archivo en bytes (20MB para radiografias)"
+      requerido: false
+      sensible: false
+
+    - nombre: "ALLOWED_FILE_TYPES"
+      valor: "image/jpeg,image/png,image/dicom,application/pdf"
+      descripcion: "Tipos de archivo permitidos"
+      requerido: false
+      sensible: false
+
+    # Email (opcional)
+    - nombre: "SMTP_HOST"
+      valor: "localhost"
+      descripcion: "Host SMTP para emails"
+      requerido: false
+      sensible: false
+
+    - nombre: "SMTP_PORT"
+      valor: "1025"
+      descripcion: "Puerto SMTP (1025 para MailHog)"
+      requerido: false
+      sensible: false
+
+    # Configuracion Dental Especifica
+    - nombre: "DENTAL_FDI_NOTATION"
+      valor: "true"
+      descripcion: "Usar notacion FDI para piezas dentales"
+      requerido: false
+      sensible: false
+
+    - nombre: "ODONTOGRAM_VERSION"
+      valor: "2.0"
+      descripcion: "Version del formato de odontograma"
+      requerido: false
+      sensible: false
+
+  production:
+    notas: |
+      En produccion, las siguientes variables deben configurarse
+      via secrets manager o variables de CI/CD:
+      - DB_PASSWORD (secreto)
+      - JWT_SECRET (secreto)
+      - REDIS_PASSWORD (secreto)
+      - AWS_ACCESS_KEY_ID (si usa S3)
+      - AWS_SECRET_ACCESS_KEY (si usa S3)
+
+      IMPORTANTE - Cumplimiento Normativo:
+      - NOM-024-SSA3-2012: Logs de auditoria obligatorios
+      - Encriptacion de datos sensibles (historiales)
+      - Backups diarios con retencion minima 5 anos
+
+    diferencias:
+      - nombre: "NODE_ENV"
+        valor: "production"
+      - nombre: "LOG_LEVEL"
+        valor: "info"
+      - nombre: "LOG_FORMAT"
+        valor: "json"
+      - nombre: "DB_PORT"
+        valor: "5432"
+      - nombre: "REDIS_PORT"
+        valor: "6379"
+      - nombre: "STORAGE_TYPE"
+        valor: "s3"
+      - nombre: "AUDIT_ENABLED"
+        valor: "true"
+      - nombre: "DATA_ENCRYPTION"
+        valor: "true"
+
+# -----------------------------------------------------------------------------
+# CONTENEDORES DOCKER
+# -----------------------------------------------------------------------------
+
+docker:
+  compose_file: "docker-compose.yml"
+  compose_dev: "docker-compose.dev.yml"
+  compose_prod: "docker-compose.prod.yml"
+
+  services:
+    - nombre: "db"
+      imagen: "postgres:15-alpine"
+      puerto_host: 5441
+      puerto_container: 5432
+      variables:
+        POSTGRES_DB: "clinica_dental_dev"
+        POSTGRES_USER: "dental_dev"
+        POSTGRES_PASSWORD: "${DB_PASSWORD}"
+      volumes:
+        - "postgres_data:/var/lib/postgresql/data"
+      healthcheck: "pg_isready -U dental_dev"
+
+    - nombre: "redis"
+      imagen: "redis:7-alpine"
+      puerto_host: 6388
+      puerto_container: 6379
+      volumes:
+        - "redis_data:/data"
+      healthcheck: "redis-cli ping"
+
+    - nombre: "mailhog"
+      imagen: "mailhog/mailhog"
+      puerto_smtp: 1025
+      puerto_web: 8025
+      uso: "Testing de emails en desarrollo"
+
+  volumes:
+    - nombre: "postgres_data"
+      descripcion: "Datos persistentes de PostgreSQL"
+    - nombre: "redis_data"
+      descripcion: "Datos persistentes de Redis"
+    - nombre: "uploads_data"
+      descripcion: "Radiografias y documentos"
+
+  networks:
+    - nombre: "clinica_dental_network"
+      driver: "bridge"
+
+# -----------------------------------------------------------------------------
+# MIGRACIONES Y SEEDS
+# -----------------------------------------------------------------------------
+
+migraciones:
+  herramienta: "TypeORM"
+  directorio: "apps/backend/src/database/migrations"
+
+  comandos:
+    generar: "npm run migration:generate -- -n NombreMigracion"
+    ejecutar: "npm run migration:run"
+    revertir: "npm run migration:revert"
+    mostrar: "npm run migration:show"
+
+seeds:
+  directorio: "database/seeds"
+  orden:
+    - "fase8/01-dental-catalogos.sql"
+    - "fase8/02-piezas-dentales-fdi.sql"
+
+  comandos:
+    ejecutar: "npm run seed"
+    desarrollo: "npm run seed:dev"
+
+# -----------------------------------------------------------------------------
+# SCRIPTS DE DESARROLLO
+# -----------------------------------------------------------------------------
+
+scripts:
+  setup:
+    descripcion: "Configurar entorno desde cero"
+    pasos:
+      - comando: "npm install"
+        descripcion: "Instalar dependencias"
+      - comando: "cp .env.example .env"
+        descripcion: "Crear archivo de configuracion"
+      - comando: "docker-compose up -d db redis"
+        descripcion: "Levantar servicios de infraestructura"
+      - comando: "npm run db:create"
+        descripcion: "Crear base de datos"
+      - comando: "npm run migration:run"
+        descripcion: "Ejecutar migraciones"
+      - comando: "npm run seed"
+        descripcion: "Cargar datos iniciales (incluye 52 piezas FDI)"
+
+  desarrollo:
+    frontend: "cd apps/frontend && npm run dev"
+    backend: "cd apps/backend && npm run start:dev"
+    ambos: "npm run dev:all"
+    docker: "docker-compose up -d"
+
+  testing:
+    unit: "npm run test"
+    unit_watch: "npm run test:watch"
+    e2e: "npm run test:e2e"
+    coverage: "npm run test:cov"
+
+  build:
+    frontend: "cd apps/frontend && npm run build"
+    backend: "cd apps/backend && npm run build"
+    docker: "docker-compose -f docker-compose.prod.yml build"
+
+  database:
+    create: "npm run db:create"
+    drop: "npm run db:drop"
+    reset: "npm run db:reset"
+    migrations_run: "npm run migration:run"
+    migrations_revert: "npm run migration:revert"
+    seed: "npm run seed"
+
+  linting:
+    lint: "npm run lint"
+    lint_fix: "npm run lint:fix"
+    format: "npm run format"
+
+# -----------------------------------------------------------------------------
+# INSTRUCCIONES DE SETUP
+# -----------------------------------------------------------------------------
+
+setup_instrucciones: |
+  ## Setup del Entorno de Desarrollo - Clinica Dental
+
+  ### Prerequisitos
+  - Node.js 20.x (LTS)
+  - PostgreSQL 15 (o Docker)
+  - Redis 7 (o Docker)
+  - npm 10.x
+  - Git
+
+  ### Opcion 1: Setup con Docker (Recomendado)
+
+  ```bash
+  # 1. Clonar repositorio
+  git clone <url_repo>
+  cd clinica-dental
+
+  # 2. Instalar dependencias
+  npm install
+
+  # 3. Configurar variables de entorno
+  cp .env.example .env
+  # Editar .env - generar passwords seguros:
+  # openssl rand -base64 32  # para DB_PASSWORD
+  # openssl rand -base64 64  # para JWT_SECRET
+
+  # 4. Levantar infraestructura
+  docker-compose up -d db redis
+
+  # 5. Crear base de datos y ejecutar migraciones
+  npm run db:create
+  npm run migration:run
+  npm run seed  # Carga 52 piezas dentales FDI
+
+  # 6. Iniciar desarrollo
+  npm run dev:all
+  ```
+
+  ### Opcion 2: Setup con PostgreSQL Local
+
+  ```bash
+  # 1-3. Igual que arriba
+
+  # 4. Crear usuario y base de datos en PostgreSQL
+  sudo -u postgres psql
+  CREATE USER dental_dev WITH PASSWORD 'tu_password';
+  CREATE DATABASE clinica_dental_dev OWNER dental_dev;
+  GRANT ALL PRIVILEGES ON DATABASE clinica_dental_dev TO dental_dev;
+  \q
+
+  # 5. Configurar Redis local o Docker
+  docker run -d --name redis-dental -p 6388:6379 redis:7-alpine
+
+  # 6-7. Continuar con migraciones y seeds
+  ```
+
+  ### Verificar Instalacion
+  - Frontend: http://localhost:3130
+  - Backend API: http://localhost:3131/api/v1
+  - Swagger Docs: http://localhost:3131/api/docs
+  - Health Check: http://localhost:3131/health
+
+  ### Usuarios de Prueba (despues de seed)
+  - Admin: admin@clinica-dental.local / Admin123!
+  - Odontologo: doctor@clinica-dental.local / Doctor123!
+  - Recepcion: recepcion@clinica-dental.local / Recep123!
+
+  ### Nomenclatura Dental FDI
+  El sistema usa la nomenclatura FDI (Federation Dentaire Internationale):
+  - Cuadrante 1: Superior derecho (18-11)
+  - Cuadrante 2: Superior izquierdo (21-28)
+  - Cuadrante 3: Inferior izquierdo (31-38)
+  - Cuadrante 4: Inferior derecho (41-48)
+  - Cuadrantes 5-8: Denticion temporal
+
+# -----------------------------------------------------------------------------
+# TROUBLESHOOTING
+# -----------------------------------------------------------------------------
+
+troubleshooting:
+  - problema: "Puerto 3130 o 3131 en uso"
+    solucion: |
+      Verificar con: lsof -i :3130
+      Terminar proceso: kill -9 <PID>
+      O cambiar puertos en .env
+
+  - problema: "Error de conexion a PostgreSQL"
+    solucion: |
+      1. Verificar que PostgreSQL esta corriendo:
+         docker-compose ps
+         # o: systemctl status postgresql
+      2. Verificar credenciales en .env
+      3. Verificar que la BD existe:
+         psql -h localhost -p 5441 -U dental_dev -l
+
+  - problema: "Error de conexion a Redis"
+    solucion: |
+      1. Verificar que Redis esta corriendo:
+         docker-compose ps
+         # o: redis-cli -p 6388 ping
+      2. Verificar puerto en .env
+
+  - problema: "Migraciones fallan"
+    solucion: |
+      1. Verificar que la BD existe
+      2. Verificar permisos del usuario
+      3. Revisar logs: npm run migration:run --verbose
+      4. Si es necesario, resetear: npm run db:reset
+
+  - problema: "Piezas dentales no cargadas"
+    solucion: |
+      Ejecutar seeds manualmente:
+      npm run seed
+      Verificar: SELECT COUNT(*) FROM dental.piezas_dentales;
+      Debe retornar 52 (32 permanentes + 20 temporales)
+
+  - problema: "Radiografias no se suben"
+    solucion: |
+      1. Verificar STORAGE_PATH existe y tiene permisos
+      2. Verificar MAX_FILE_SIZE en .env (default 20MB)
+      3. Verificar ALLOWED_FILE_TYPES incluye el tipo de archivo
+
+  - problema: "JWT errors"
+    solucion: |
+      Verificar que JWT_SECRET esta configurado (min 32 caracteres)
+      Generar nuevo: openssl rand -base64 64
+
+  - problema: "CORS errors en frontend"
+    solucion: |
+      Verificar FRONTEND_URL y ALLOWED_ORIGINS en .env
+      Deben coincidir con la URL del frontend
+
+# -----------------------------------------------------------------------------
+# CONFIGURACION DE PRODUCCION
+# -----------------------------------------------------------------------------
+
+produccion:
+  checklist:
+    - item: "Variables de entorno configuradas via secrets manager"
+    - item: "SSL/TLS habilitado para BD y Redis"
+    - item: "Backups automaticos configurados (retencion 5 anos)"
+    - item: "Monitoreo y alertas activas"
+    - item: "Rate limiting configurado"
+    - item: "CORS restringido a dominios autorizados"
+    - item: "Logs en formato JSON para agregacion"
+    - item: "Audit logging habilitado (NOM-024-SSA3-2012)"
+    - item: "Encriptacion de datos sensibles"
+
+  infraestructura_recomendada:
+    base_de_datos: "AWS RDS PostgreSQL 15 o equivalente"
+    cache: "AWS ElastiCache Redis o equivalente"
+    storage: "AWS S3 o equivalente (para radiografias)"
+    cdn: "CloudFront o equivalente"
+    ci_cd: "GitHub Actions / GitLab CI"
+
+  escalado:
+    backend_replicas: 2
+    pool_db_size: 50
+    redis_maxmemory: "512mb"
+    storage_bucket_region: "us-east-1"
+
+  cumplimiento:
+    nom_024_ssa3:
+      descripcion: "Expediente clinico electronico"
+      requisitos:
+        - "Logs de auditoria inmutables"
+        - "Firma electronica de expedientes"
+        - "Control de versiones de historiales"
+    retencion_datos:
+      expedientes: "5 anos minimo"
+      radiografias: "5 anos minimo"
+      logs_auditoria: "5 anos"
+
+# -----------------------------------------------------------------------------
+# REFERENCIAS
+# -----------------------------------------------------------------------------
+
+referencias:
+  perfil_devenv: "orchestration/agents/perfiles/PERFIL-DEVENV.md"
+  inventario_master: "orchestration/inventarios/DEVENV-MASTER-INVENTORY.yml"
+  inventario_puertos: "orchestration/inventarios/DEVENV-PORTS-INVENTORY.yml"
+  contexto_proyecto: "orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
+  parent_clinicas: "../erp-clinicas/orchestration/environment/ENVIRONMENT-INVENTORY.yml"
+  schema_dental: "database/schemas/01-dental-schema-ddl.sql"
+  nomenclatura_fdi: "https://www.fdiworlddental.org/tooth-numbering-system"
+
+# =============================================================================
+# FIN DE INVENTARIO
+# =============================================================================
--- a/orchestration/inventarios/MASTER_INVENTORY.yml
+++ b/orchestration/inventarios/MASTER_INVENTORY.yml
@ -0,0 +1,76 @@
+---
+# MASTER INVENTORY - Clinica Dental
+# Version: 1.0.0
+# Ultima actualizacion: 2026-01-07
+
+proyecto: "clinica-dental"
+descripcion: "ERP especializado para clinicas dentales"
+version: "0.1.0"
+estado: "desarrollo"
+tipo: "vertical"
+base: "erp-clinicas"
+
+progreso:
+  fase_actual: "Database"
+  porcentaje: 15
+  database_completado: true
+  backend_completado: false
+  frontend_completado: false
+
+herencia:
+  vertical_padre: "erp-clinicas"
+  suite_core: "erp-core"
+  modulos_heredados:
+    - "auth"
+    - "users"
+    - "tenants"
+    - "roles"
+    - "patients"
+    - "appointments"
+    - "billing"
+
+modulos_especificos:
+  - id: "DENTAL-001"
+    nombre: "odontograma"
+    descripcion: "Registro grafico del estado dental"
+    estado: "ddl_completado"
+
+  - id: "DENTAL-002"
+    nombre: "tratamientos-dentales"
+    descripcion: "Procedimientos odontologicos"
+    estado: "ddl_completado"
+
+  - id: "DENTAL-003"
+    nombre: "ortodoncia"
+    descripcion: "Control de tratamientos ortodonticos"
+    estado: "ddl_completado"
+
+  - id: "DENTAL-004"
+    nombre: "protesis"
+    descripcion: "Registro de trabajos protesicos"
+    estado: "ddl_completado"
+
+database:
+  schema: "dental"
+  archivo_ddl: "database/schemas/01-dental-schema-ddl.sql"
+  archivo_seeds: "database/seeds/fase8/01-dental-catalogos.sql"
+  tablas_especificas:
+    - "dental_pieces"
+    - "dental_charts"
+    - "dental_treatments"
+    - "orthodontic_cases"
+    - "prosthetics"
+
+catalogos:
+  - "especialidades_odontologicas"
+  - "estados_piezas_dentales"
+  - "caras_dentales"
+  - "tipos_tratamiento_dental"
+
+proximas_tareas:
+  - "Implementar backend modulo odontograma"
+  - "Crear frontend para odontograma digital"
+  - "Integracion con erp-clinicas"
+
+ultima_actualizacion: "2026-01-07"
+actualizado_por: "Orquestador"
--- a/orchestration/trazas/TRAZA-TAREAS-DATABASE.md
+++ b/orchestration/trazas/TRAZA-TAREAS-DATABASE.md
@ -0,0 +1,52 @@
+# TRAZA DE TAREAS - DATABASE
+
+**Proyecto:** clinica-dental
+**Capa:** Database
+**Version:** 1.0.0
+
+---
+
+## HISTORIAL
+
+### [2026-01-04] DENTAL-DDL-001
+**Estado:** completado
+**Agente:** Database-Agent
+**Duracion:** ~2h
+
+#### Descripcion
+Creacion del schema dental con tablas especificas para odontologia.
+
+#### Archivos Creados
+- `database/schemas/01-dental-schema-ddl.sql`
+
+#### Resultado
+Schema dental creado con tablas para odontograma, tratamientos, ortodoncia y protesis.
+
+---
+
+### [2026-01-04] DENTAL-SEEDS-001
+**Estado:** completado
+**Agente:** Database-Agent
+**Duracion:** ~1h
+
+#### Descripcion
+Seeds iniciales con catalogos odontologicos.
+
+#### Archivos Creados
+- `database/seeds/fase8/01-dental-catalogos.sql`
+
+#### Resultado
+Catalogos cargados: especialidades, estados de piezas, caras dentales.
+
+---
+
+## TAREAS PENDIENTES
+
+| ID | Tarea | Prioridad | Dependencias |
+|----|-------|-----------|--------------|
+| DENTAL-DDL-002 | RLS policies para tablas dental | P1 | - |
+| DENTAL-DDL-003 | Funciones de validacion odontograma | P2 | - |
+
+---
+
+**Ultima actualizacion:** 2026-01-07