chore: Remove obsolete orchestration archive files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-02-05 23:20:15 -06:00
parent 8fa57a4c00
commit 73f509a911
20 changed files with 0 additions and 4219 deletions

View File

@ -1,82 +0,0 @@
# ═══════════════════════════════════════════════════════════════════════════════
# ÍNDICE DE DEFINICIONES CANÓNICAS - CLINICA-DENTAL
# ═══════════════════════════════════════════════════════════════════════════════
version: "1.0.0"
created: "2026-01-18"
updated: "2026-01-18"
maintained_by: "@WS_ORCHESTRATOR"
propagated_from: "erp-clinicas/orchestration/_definitions/"
role: "CONSUMER" # Especialización de erp-clinicas
# ─────────────────────────────────────────────────────────────────────────────────
# PROTOCOLOS
# ─────────────────────────────────────────────────────────────────────────────────
protocols:
CCA-PROTOCOL:
alias: "@DEF_CCA"
path: "protocols/CCA-PROTOCOL.md"
estado: "PROPAGADO"
CAPVED-CYCLE:
alias: "@DEF_CAPVED"
path: "protocols/CAPVED-CYCLE.md"
estado: "PROPAGADO"
validations:
VALIDATION-BACKEND:
alias: "@DEF_VAL_BE"
path: "validations/VALIDATION-BACKEND.md"
estado: "PROPAGADO"
VALIDATION-FRONTEND:
alias: "@DEF_VAL_FE"
path: "validations/VALIDATION-FRONTEND.md"
estado: "PROPAGADO"
VALIDATION-DDL:
alias: "@DEF_VAL_DDL"
path: "validations/VALIDATION-DDL.md"
estado: "PROPAGADO"
checklists:
CHECKLIST-GOBERNANZA-TAREA:
alias: "@DEF_CHK_GOB"
path: "checklists/CHECKLIST-GOBERNANZA-TAREA.md"
estado: "PROPAGADO"
CHECKLIST-POST-TASK:
alias: "@DEF_CHK_POST"
path: "checklists/CHECKLIST-POST-TASK.md"
estado: "PROPAGADO"
CHECKLIST-PRE-CREATE:
alias: "@DEF_CHK_CREATE"
path: "checklists/CHECKLIST-PRE-CREATE.md"
estado: "PROPAGADO"
CHECKLIST-PRE-MODIFY:
alias: "@DEF_CHK_MODIFY"
path: "checklists/CHECKLIST-PRE-MODIFY.md"
estado: "PROPAGADO"
statistics:
total_definitions: 9
propagated: 9
# ─────────────────────────────────────────────────────────────────────────────────
# CONFIGURACIÓN DE HERENCIA (SPECIALIZES)
# ─────────────────────────────────────────────────────────────────────────────────
consumer_config:
role: "CONSUMER"
inherits_from: "erp-clinicas" # Especialización de erp-clinicas
inherits_version: "1.0.0"
tipo_herencia: "SPECIALIZES"
modulos_heredados:
- pacientes (adaptado a odontología)
- citas
- expedientes (adaptado)
modulos_propios:
- odontograma
- ortodoncia
- protesis
propagates_to: []
sync_strategy: "AUTO"
vertical: "clinica-dental"
nota: "Clínica dental especializada - hereda de erp-clinicas"

View File

@ -1,223 +0,0 @@
# CHECKLIST: GOBERNANZA DE TAREA
**Versión:** 1.0.0
**Alias:** @DEF_CHK_GOB
**Fecha:** 2026-01-16
**Sistema:** SIMCO v4.0.0
**Prioridad:** P0 - BLOQUEANTE
---
## PROPÓSITO
Este checklist es **OBLIGATORIO** y **BLOQUEANTE** para toda tarea que se marque como completada.
Debe ejecutarse ANTES de cualquier otra validación post-tarea.
> **REGLA:** Sin gobernanza documentada, la tarea NO está completada.
---
## SECUENCIA DE EJECUCIÓN
```
TAREA FINALIZA EJECUCIÓN
┌─────────────────────────────┐
│ CHECKLIST-GOBERNANZA-TAREA │ ← PRIMERO (este checklist)
│ (BLOQUEANTE) │
└─────────────┬───────────────┘
¿Todos los items pasan?
/ \
Sí No
│ │
▼ ▼
CHECKLIST-POST-TASK BLOQUEAR
(validaciones (no continuar
técnicas) hasta resolver)
```
---
## CHECKLIST (8 Items)
### 1. Carpeta de Tarea
```markdown
[ ] Existe carpeta: orchestration/tareas/TASK-{YYYY-MM-DD}-{NNN}/
```
**Si no existe:**
```bash
# Crear carpeta
mkdir -p orchestration/tareas/TASK-$(date +%Y-%m-%d)-00X
# Copiar templates
cp -r orchestration/tareas/_templates/TASK-TEMPLATE/* orchestration/tareas/TASK-$(date +%Y-%m-%d)-00X/
```
### 2. METADATA.yml
```markdown
[ ] METADATA.yml existe y tiene campos obligatorios:
[ ] task_id
[ ] identificacion.titulo
[ ] identificacion.tipo
[ ] responsabilidad.agente_responsable
[ ] alcance.nivel
[ ] temporalidad.fecha_inicio
[ ] estado.actual = "completada"
[ ] artefactos.archivos_creados (lista)
[ ] artefactos.archivos_modificados (lista)
```
### 3. Fase C - Contexto (OBLIGATORIA)
```markdown
[ ] 01-CONTEXTO.md existe y documenta:
[ ] Qué se solicitó
[ ] Por qué se necesita
[ ] Proyecto/módulo afectado
[ ] Contexto cargado
```
### 4. Fase E - Ejecución (OBLIGATORIA)
```markdown
[ ] 05-EJECUCION.md existe y documenta:
[ ] Subtareas ejecutadas
[ ] Archivos creados/modificados
[ ] Validaciones ejecutadas
[ ] Problemas encontrados y cómo se resolvieron
```
### 5. Fase D - Documentación (OBLIGATORIA)
```markdown
[ ] 06-DOCUMENTACION.md existe y documenta:
[ ] Resumen de cambios
[ ] Inventarios actualizados
[ ] Propagación evaluada
[ ] Referencias actualizadas
```
### 6. Índice de Tareas
```markdown
[ ] orchestration/tareas/_INDEX.yml actualizado:
[ ] Estadísticas actualizadas
[ ] Tarea en historial_por_fecha
[ ] Tarea en por_proyecto
[ ] Tarea en por_agente
[ ] Tarea en por_tipo
```
### 7. Traza de Agente (Recomendado)
```markdown
[ ] orchestration/agents/trazas/TRAZA-AGENTE-{PERFIL}.md actualizada
O
[ ] Excepción documentada en METADATA.yml
```
### 8. Validación Final
```markdown
[ ] Carpeta de tarea contiene mínimo:
- METADATA.yml (completo)
- 01-CONTEXTO.md (documentado)
- 05-EJECUCION.md (documentado)
- 06-DOCUMENTACION.md (documentado)
```
---
## DECISIÓN
```yaml
SI_PASA_TODO:
accion: "Continuar con CHECKLIST-POST-TASK"
nota: "Gobernanza validada"
SI_FALLA_CUALQUIER_ITEM:
accion: "BLOQUEAR"
mensaje: |
❌ GOBERNANZA INCOMPLETA
La tarea NO puede marcarse como completada.
Items faltantes:
- {lista de items faltantes}
Acciones requeridas:
1. Completar items faltantes
2. Re-ejecutar este checklist
3. Continuar con validaciones técnicas
```
---
## TEMPLATE RÁPIDO
Para crear documentación de gobernanza rápidamente:
```bash
# Variables
TASK_ID="TASK-$(date +%Y-%m-%d)-00X"
TASK_DIR="orchestration/tareas/$TASK_ID"
# 1. Crear estructura
mkdir -p $TASK_DIR
cp orchestration/tareas/_templates/TASK-TEMPLATE/* $TASK_DIR/
# 2. Completar METADATA.yml
# 3. Documentar 01-CONTEXTO.md
# 4. Documentar 05-EJECUCION.md
# 5. Documentar 06-DOCUMENTACION.md
# 6. Actualizar _INDEX.yml
```
---
## INTEGRACIÓN CON TODOLIST
Al iniciar cualquier tarea, el TodoList DEBE incluir:
```yaml
todos:
# ... otras tareas ...
# SIEMPRE al final:
- content: "Crear documentación de gobernanza (TASK-{ID})"
status: "pending"
activeForm: "Documentando gobernanza"
```
---
## USO
```yaml
# En cualquier perfil de agente:
al_completar_trabajo_tecnico:
- Cargar: "@DEF_CHK_GOB"
- Ejecutar: "8 items de gobernanza"
- Si pasa: "Continuar con @DEF_CHK_POST"
- Si falla: "Completar gobernanza primero"
```
---
## REFERENCIAS
| Alias | Descripción |
|-------|-------------|
| @DEF_CHK_GOB | Este checklist |
| @DEF_CHK_POST | Checklist post-tarea (validaciones técnicas) |
| @TRIGGER-DOC | Trigger de documentación obligatoria |
| @TAREAS | Directorio de tareas |
---
**Versión:** 1.0.0 | **Sistema:** SIMCO v4.0.0 | **Tipo:** Checklist Bloqueante

View File

@ -1,244 +0,0 @@
# CHECKLIST: POST-TASK
**Versión:** 1.1.0
**Alias:** @DEF_CHK_POST
**Fecha:** 2026-01-16
**Sistema:** SIMCO v4.0.0
---
## PROPÓSITO
Verificaciones obligatorias DESPUÉS de completar cualquier tarea, antes de marcarla como terminada.
---
## SECUENCIA OBLIGATORIA
```
TAREA FINALIZA EJECUCIÓN
┌─────────────────────────────┐
│ 0. GOBERNANZA │ ← PRIMERO (BLOQUEANTE)
│ (@DEF_CHK_GOB) │
└─────────────┬───────────────┘
¿Pasa?
/ \
No Sí
│ │
BLOQUEAR ▼
┌─────────────────────────────┐
│ 1-7. VALIDACIONES TÉCNICAS │
│ (este checklist) │
└─────────────────────────────┘
```
---
## CHECKLIST
### 0. Gobernanza de Tarea (BLOQUEANTE - EJECUTAR PRIMERO)
> **OBLIGATORIO:** Ejecutar @DEF_CHK_GOB antes de continuar.
```markdown
[ ] CHECKLIST-GOBERNANZA-TAREA.md ejecutado y PASADO
- Carpeta de tarea existe
- METADATA.yml completo
- Fases C, E, D documentadas
- _INDEX.yml actualizado
SI NO PASA: DETENER. Completar gobernanza primero.
```
---
### 1. Validaciones Técnicas
#### Backend (si aplica)
```markdown
[ ] npm run build - PASA
[ ] npm run lint - PASA
[ ] npm run test - PASA (si existen tests)
[ ] Servidor inicia sin errores
```
#### Frontend (si aplica)
```markdown
[ ] npm run build - PASA
[ ] npm run lint - PASA
[ ] npm run typecheck - PASA
[ ] Aplicación renderiza sin errores
```
#### Database (si aplica)
```markdown
[ ] DDL ejecuta sin errores
[ ] Datos de prueba cargan correctamente
[ ] Constraints funcionan como esperado
```
### 2. Coherencia Entre Capas (TRIGGER-COHERENCIA-CAPAS)
```markdown
## DDL ↔ Backend
[ ] Toda tabla DDL tiene entity correspondiente (o excepción documentada)
[ ] Toda entity tiene tabla DDL correspondiente (o es View/Embeddable)
[ ] Campos de entity coinciden exactamente con columnas de tabla
[ ] Tipos TypeScript son compatibles con tipos PostgreSQL
[ ] Todo schema tiene al menos un módulo backend (o está marcado PLANNED)
## Backend ↔ Frontend (si aplica)
[ ] Todo endpoint consumido tiene implementación en backend
[ ] Si hay nuevo endpoint: está documentado en Swagger
[ ] Si hay nuevo componente: está integrado donde corresponde
## Verificación de Excepciones
[ ] Tablas M:N sin entity están documentadas en ENTITIES-CATALOG sección "Relaciones"
[ ] View entities (@ViewEntity) están documentadas como tal
[ ] Schemas PLANNED tienen fecha estimada de implementación
```
### 3. Actualización de Inventarios (TRIGGER-INVENTARIOS-SINCRONIZADOS)
```markdown
## Sincronización Obligatoria
[ ] DATABASE_INVENTORY.yml actualizado (si cambió BD)
- Conteo de schemas correcto
- Conteo de tablas correcto
- Nuevos objetos agregados
[ ] BACKEND_INVENTORY.yml actualizado (si cambió BE)
- Conteo de módulos correcto
- Conteo de entities correcto
- Conteo de services correcto
[ ] FRONTEND_INVENTORY.yml actualizado (si cambió FE)
- Conteo de componentes correcto
- Conteo de páginas correcto
[ ] MASTER_INVENTORY.yml actualizado con totales
## Verificación de Cobertura
[ ] Cobertura de inventarios = 100%
[ ] Timestamp de actualización = fecha de hoy
[ ] sync_status = "SYNCED"
```
### 4. Actualización de Trazas
```markdown
[ ] Traza de tarea actualizada
[ ] Traza de agente actualizada
[ ] PROXIMA-ACCION.md actualizado
[ ] Commits con mensajes descriptivos
```
### 5. Documentación
```markdown
[ ] README actualizado (si cambió significativamente)
[ ] Documentación técnica actualizada (si aplica)
[ ] ADR creado (si fue decisión arquitectural)
[ ] Comentarios en código donde la lógica no es obvia
```
### 6. Sistema de Gobernanza
```markdown
[ ] Carpeta de tarea creada: orchestration/tareas/TASK-{ID}/
[ ] METADATA.yml completado
[ ] Fases mínimas documentadas (C, E, D)
[ ] _INDEX.yml de tareas actualizado
[ ] Traza de agente actualizada
```
### 7. Evaluación de Propagación
```markdown
[ ] ¿Cambio debe propagarse a otros proyectos?
[ ] Si es erp-core: ¿propagar a verticales?
[ ] Si es shared/catalog: ¿notificar proyectos que lo usan?
[ ] Si es security fix: ¿propagar inmediatamente?
```
---
## CRITERIOS DE COMPLETITUD
### Tarea Completada SI:
```yaml
obligatorio:
- Todas las validaciones técnicas pasan
- Inventarios actualizados
- Trazas actualizadas
- Documentación de gobernanza creada
recomendado:
- Documentación técnica actualizada
- Tests agregados/actualizados
- Propagación evaluada
```
### Tarea NO Completada SI:
```yaml
bloqueantes:
- Build falla
- Lint falla
- Tests fallan
- Inventarios no actualizados
- Sin documentación de gobernanza
```
---
## DECISIÓN
```yaml
SI_PASA_TODO:
accion: "Marcar tarea como COMPLETADA"
documentar: "Resumen en METADATA.yml"
actualizar: "_INDEX.yml con estado COMPLETADO"
SI_FALLA_VALIDACION:
accion: "MANTENER como EN_PROGRESO"
corregir: "Resolver validaciones fallidas"
reintentar: "Ejecutar checklist de nuevo"
SI_FALTA_DOCUMENTACION:
accion: "MANTENER como EN_PROGRESO"
completar: "Documentación faltante"
nota: "Tarea no está completa sin documentación"
```
---
## USO
```yaml
# En cualquier perfil de agente:
al_completar_tarea:
- Cargar: "@DEF_CHK_POST"
- Ejecutar: "Checklist completo"
- Si pasa: "Marcar tarea como completada"
- Si falla: "Resolver antes de marcar completada"
```
---
## INTEGRACIÓN CON TRIGGER-DOC
Este checklist se activa junto con `TRIGGER-DOCUMENTACION-OBLIGATORIA.md` al intentar completar una tarea.
```yaml
secuencia:
1: "Agente intenta marcar tarea como completada"
2: "TRIGGER-DOC se activa"
3: "Se ejecuta CHECKLIST-POST-TASK"
4: "Si pasa: tarea se marca completada"
5: "Si falla: tarea permanece en progreso"
```
---
**Versión:** 1.0.0 | **Sistema:** SIMCO v4.0.0 | **Tipo:** Checklist

View File

@ -1,107 +0,0 @@
# CHECKLIST: PRE-CREATE
**Versión:** 1.0.0
**Alias:** @DEF_CHK_CREATE
**Fecha:** 2026-01-16
**Sistema:** SIMCO v4.0.0
---
## PROPÓSITO
Verificaciones obligatorias ANTES de crear cualquier objeto nuevo (tabla, entity, service, componente, etc.).
---
## CHECKLIST
### 1. Verificación Anti-Duplicación
```markdown
[ ] Buscar en catálogo compartido (shared/catalog/CATALOG-INDEX.yml)
[ ] Buscar en inventario del proyecto (orchestration/inventarios/)
[ ] Buscar archivos similares con nombre parecido
[ ] Buscar funcionalidad similar en módulos existentes
[ ] Confirmar que NO existe funcionalidad equivalente
```
### 2. Verificación de Dependencias
```markdown
[ ] Identificar de qué depende el nuevo objeto
[ ] Verificar que las dependencias existen
[ ] Si depende de DDL: tabla existe en base de datos
[ ] Si depende de entity: entity existe en backend
[ ] Si depende de endpoint: endpoint existe y funciona
```
### 3. Verificación de Ubicación
```markdown
[ ] Identificar módulo/carpeta correcta según estándares
[ ] Verificar que la ruta sigue convenciones del proyecto
[ ] Confirmar que no hay conflicto de nombres
[ ] Verificar permisos de escritura en la ubicación
```
### 4. Verificación de Nomenclatura
```markdown
[ ] Nombre sigue convenciones del proyecto
[ ] Nombre es descriptivo y no ambiguo
[ ] Prefijos/sufijos correctos según tipo de archivo
[ ] Formato de archivo correcto (PascalCase, kebab-case, etc.)
```
### 5. Verificación de Coherencia
```markdown
[ ] Nuevo objeto es coherente con arquitectura existente
[ ] No introduce acoplamiento innecesario
[ ] Sigue patrones establecidos del proyecto
[ ] No duplica responsabilidades de otros objetos
```
---
## DECISIÓN
```yaml
SI_PASA_TODO:
accion: "Proceder con creación"
siguiente: "Ejecutar SIMCO-CREAR.md"
SI_FALLA_DUPLICACION:
accion: "DETENER - Evaluar uso del existente"
opciones:
- "Usar objeto existente"
- "Extender objeto existente"
- "Justificar creación de nuevo (documentar razón)"
SI_FALLA_DEPENDENCIA:
accion: "DETENER - Resolver dependencia primero"
opciones:
- "Delegar creación de dependencia"
- "Crear dependencia primero"
- "Replanificar orden de tareas"
SI_FALLA_NOMENCLATURA:
accion: "Corregir nombre antes de crear"
consultar: "@SIMCO/SIMCO-NOMENCLATURA.md"
```
---
## USO
```yaml
# En perfil de agente:
antes_de_crear:
- Cargar: "@DEF_CHK_CREATE"
- Ejecutar: "Checklist completo"
- Documentar: "Resultado en traza"
```
---
**Versión:** 1.0.0 | **Sistema:** SIMCO v4.0.0 | **Tipo:** Checklist

View File

@ -1,149 +0,0 @@
# CHECKLIST: PRE-MODIFY
**Versión:** 1.0.0
**Alias:** @DEF_CHK_MODIFY
**Fecha:** 2026-01-16
**Sistema:** SIMCO v4.0.0
---
## PROPÓSITO
Verificaciones obligatorias ANTES de modificar cualquier archivo existente.
---
## CHECKLIST
### 1. Análisis de Dependientes
```markdown
[ ] Identificar archivos que IMPORTAN el archivo a modificar
[ ] Listar todos los dependientes encontrados
[ ] Evaluar impacto del cambio en cada dependiente
[ ] Clasificar cambio como: aditivo | modificación | breaking
```
### 2. Análisis de Dependencias
```markdown
[ ] Identificar archivos que el archivo IMPORTA
[ ] Verificar que las dependencias siguen siendo válidas post-cambio
[ ] Identificar si el cambio requiere actualizar dependencias
```
### 3. Evaluación de Impacto
```markdown
[ ] Determinar alcance: local | módulo | proyecto | workspace
[ ] Identificar capas afectadas: DDL | BE | FE
[ ] Evaluar si cambio requiere migración de datos
[ ] Evaluar si cambio rompe compatibilidad hacia atrás
```
### 4. Plan de Actualización
```markdown
[ ] Si hay dependientes afectados: incluir en plan de subtareas
[ ] Ordenar actualizaciones por dependencia (de más interno a más externo)
[ ] Identificar tests que deben actualizarse
[ ] Identificar documentación que debe actualizarse
```
### 5. Verificación de Seguridad
```markdown
[ ] Cambio no introduce vulnerabilidades de seguridad
[ ] Cambio no expone datos sensibles
[ ] Cambio mantiene validaciones existentes
[ ] Si es API: cambio no rompe contratos existentes
```
### 6. Estrategia de Rollback
```markdown
[ ] Identificar cómo revertir el cambio si falla
[ ] Confirmar que existe backup o commit previo
[ ] Documentar pasos de rollback si son complejos
```
---
## CLASIFICACIÓN DE CAMBIOS
### Cambio Aditivo (BAJO RIESGO)
```yaml
caracteristicas:
- Agregar campo/método nuevo
- Agregar endpoint nuevo
- No modifica comportamiento existente
acciones:
- Actualizar dependientes que usarán lo nuevo
- Validación estándar
```
### Cambio de Modificación (MEDIO RIESGO)
```yaml
caracteristicas:
- Cambiar implementación interna
- Cambiar tipos de datos
- Renombrar elementos
acciones:
- Actualizar TODOS los dependientes
- Validación exhaustiva
- Pruebas de regresión
```
### Cambio Breaking (ALTO RIESGO)
```yaml
caracteristicas:
- Eliminar campo/método
- Cambiar firma de función/endpoint
- Cambiar comportamiento de API
acciones:
- DETENER y evaluar con Tech-Leader
- Plan de migración obligatorio
- Comunicar a equipos afectados
```
---
## DECISIÓN
```yaml
SI_PASA_TODO:
accion: "Proceder con modificación"
siguiente: "Ejecutar SIMCO-MODIFICAR.md"
incluir: "Actualización de dependientes en plan"
SI_CAMBIO_BREAKING:
accion: "ESCALAR a Tech-Leader"
documentar:
- Razón del cambio breaking
- Alternativas evaluadas
- Plan de migración propuesto
SI_IMPACTO_ALTO:
accion: "Solicitar revisión antes de proceder"
documentar:
- Alcance del impacto
- Dependientes afectados
- Plan de actualización
```
---
## USO
```yaml
# En perfil de agente:
antes_de_modificar:
- Cargar: "@DEF_CHK_MODIFY"
- Ejecutar: "Checklist completo"
- Documentar: "Resultado en traza"
- Si breaking: "Escalar antes de continuar"
```
---
**Versión:** 1.0.0 | **Sistema:** SIMCO v4.0.0 | **Tipo:** Checklist

View File

@ -1,347 +0,0 @@
---
tipo: especificacion-tecnica
nivel: 2-tecnico
ssot: /orchestration/directivas/principios/PRINCIPIO-CAPVED.md
audiencia: agentes IA, sistemas automaticos
proposito: Especificacion tecnica del protocolo CAPVED
actualizado: 2026-01-16
---
# PROTOCOLO: CAPVED-CYCLE
**Versión:** 1.0.0
**Alias:** @DEF_CAPVED
**Fecha:** 2026-01-16
**Sistema:** SIMCO v4.0.0
**SSOT:** [PRINCIPIO-CAPVED.md](/orchestration/directivas/principios/PRINCIPIO-CAPVED.md)
---
## RESUMEN
CAPVED es el ciclo de vida obligatorio para toda tarea en el workspace. Define 6 fases secuenciales que aseguran calidad, trazabilidad y documentación completa.
```
C → A → P → V → E → D
│ │ │ │ │ │
│ │ │ │ │ └─ DOCUMENTACIÓN (Registrar, trazar, propagar)
│ │ │ │ └───── EJECUCIÓN (Implementar cambios)
│ │ │ └───────── VALIDACIÓN (Gate pre-ejecución)
│ │ └───────────── PLANEACIÓN (Desglosar subtareas)
│ └───────────────── ANÁLISIS (Mapear impacto)
└───────────────────── CONTEXTO (Clasificar y vincular)
```
---
## FASES DEL CICLO
### FASE C - CONTEXTO
**Objetivo:** Clasificar tarea y vincular con proyecto/workspace.
```yaml
actividades:
- Identificar tipo de tarea (feature/fix/refactor/analysis)
- Identificar proyecto(s) involucrado(s)
- Identificar nivel (workspace/proyecto/módulo)
- Cargar contexto requerido según perfil
- Vincular con épica/user story si aplica
salidas:
- Tipo de tarea identificado
- Proyecto(s) identificado(s)
- Contexto mínimo viable cargado
- Vinculación establecida
criterios_completitud:
- Proyecto claramente identificado
- Tipo de tarea determinado
- Contexto base cargado
```
### FASE A - ANÁLISIS
**Objetivo:** Mapear impacto, dependencias y riesgos.
```yaml
actividades:
- Ejecutar TRIGGER-ANTI-DUPLICACION si es creación
- Ejecutar TRIGGER-ANALISIS-DEPENDENCIAS si es modificación
- Identificar archivos afectados
- Mapear dependientes (quién usa lo que modifico)
- Mapear dependencias (qué usa lo que modifico)
- Evaluar riesgos y complejidad
salidas:
- Mapa de impacto
- Lista de dependientes
- Lista de dependencias
- Evaluación de riesgos
- Complejidad estimada
criterios_completitud:
- Impacto mapeado
- Dependencias identificadas
- Riesgos evaluados
```
### FASE P - PLANEACIÓN
**Objetivo:** Desglosar en subtareas por dominio.
```yaml
actividades:
- Crear lista de subtareas específicas
- Ordenar por dependencia (DDL → BE → FE)
- Identificar subtareas paralelizables
- Asignar perfil responsable por subtarea
- Definir criterios de aceptación por subtarea
salidas:
- Lista de subtareas (ST-001, ST-002, ...)
- Orden de ejecución
- Asignación de perfiles
- Criterios de aceptación
criterios_completitud:
- Subtareas definidas
- Orden establecido
- Criterios claros
```
### FASE V - VALIDACIÓN (Gate)
**Objetivo:** Verificar antes de ejecutar.
```yaml
actividades:
- Verificar que plan cubre todo el impacto
- Verificar que no hay scope creep
- Verificar que dependencias están resueltas
- Verificar que hay capacidad de rollback
- Confirmar alineación con estándares
salidas:
- Checklist de validación completado
- Decisión GO/NO-GO
criterios_completitud:
- Todas las verificaciones pasadas
- Decisión GO documentada
decision:
GO: "Continuar a Fase E"
NO-GO: "Regresar a Fase A o P según hallazgo"
```
### FASE E - EJECUCIÓN
**Objetivo:** Implementar cambios según plan.
```yaml
actividades:
- Ejecutar subtareas en orden
- Validar cada subtarea (build/lint/test)
- Crear commits atómicos por subtarea
- Documentar problemas encontrados
- Escalar si hay bloqueos
salidas:
- Código implementado
- Commits realizados
- Validaciones pasadas
- Problemas documentados
criterios_completitud:
- Todas las subtareas completadas
- Build pasa
- Lint pasa
- Tests pasan (si existen)
```
### FASE D - DOCUMENTACIÓN
**Objetivo:** Registrar, trazar y propagar.
> **IMPORTANTE:** Esta fase tiene dos sub-fases en orden estricto:
> 1. **D1 - Gobernanza** (BLOQUEANTE)
> 2. **D2 - Técnica** (después de gobernanza)
```yaml
actividades:
# D1 - GOBERNANZA (PRIMERO - BLOQUEANTE)
d1_gobernanza:
- Crear carpeta de tarea: orchestration/tareas/TASK-{ID}/
- Completar METADATA.yml
- Documentar 01-CONTEXTO.md (qué y por qué)
- Documentar 05-EJECUCION.md (cómo y qué problemas)
- Documentar 06-DOCUMENTACION.md (resumen y referencias)
- Actualizar orchestration/tareas/_INDEX.yml
- Actualizar traza de agente (opcional pero recomendado)
# D2 - TÉCNICA (después de gobernanza)
d2_tecnica:
- Actualizar inventarios afectados
- Evaluar propagación (TRIGGER-PROPAGACION-AUTOMATICA)
- Crear/actualizar documentación técnica si aplica
salidas:
# Gobernanza
- Carpeta de tarea con documentación completa
- _INDEX.yml actualizado
# Técnica
- Inventarios actualizados
- Propagación evaluada/ejecutada
criterios_completitud:
# Gobernanza (BLOQUEANTE)
- Carpeta TASK-{ID}/ existe
- METADATA.yml completo
- Fases C, E, D documentadas
- _INDEX.yml actualizado
# Técnica
- Inventarios al día
- Propagación evaluada
validacion:
checklist: "@DEF_CHK_GOB (gobernanza) + @DEF_CHK_POST (técnica)"
orden: "Gobernanza PRIMERO, luego técnica"
```
---
## MODOS DE EJECUCIÓN
### MODE-FULL (Por defecto)
```yaml
fases: [C, A, P, V, E, D]
uso: "Features, bug fixes, refactorizaciones, cambios BD"
alias: "@FULL"
```
### MODE-QUICK
```yaml
fases: [E, D]
uso: "Typos, fixes menores, updates de deps, config simple"
alias: "@QUICK"
condicion: "Cambio trivial sin riesgo de impacto"
```
### MODE-ANALYSIS
```yaml
fases: [C, A, P]
uso: "Investigación, auditoría, exploración, propuestas"
alias: "@ANALYSIS"
nota: "No modifica código"
```
### MODE-PROPAGATION
```yaml
fases: [C, A, P, E, V, D] # Por cada proyecto destino
uso: "Propagar cambio existente a proyectos relacionados"
alias: "@PROPAGATE"
```
---
## INTEGRACIÓN CON TRIGGERS
```yaml
triggers_por_fase:
A:
- TRIGGER-ANTI-DUPLICACION (si creación)
- TRIGGER-ANALISIS-DEPENDENCIAS (si modificación)
V:
- TRIGGER-DUPLICADOS (si se detectan)
D:
- TRIGGER-PROPAGACION-AUTOMATICA
- TRIGGER-DOCUMENTACION-OBLIGATORIA
```
---
## INTEGRACIÓN CON GOBERNANZA
> **OBLIGATORIO:** Toda tarea que complete el ciclo CAPVED DEBE crear documentación de gobernanza.
> **BLOQUEANTE:** Sin gobernanza, la tarea NO está completada.
```yaml
gobernanza:
checklist: "@DEF_CHK_GOB"
pasos:
1_carpeta_tarea:
accion: "Crear orchestration/tareas/TASK-{ID}/"
bloqueante: true
2_metadata:
accion: "Completar METADATA.yml con todos los campos obligatorios"
bloqueante: true
3_fases_minimas:
accion: "Documentar 01-CONTEXTO.md, 05-EJECUCION.md, 06-DOCUMENTACION.md"
bloqueante: true
4_actualizar_indices:
accion: "Actualizar orchestration/tareas/_INDEX.yml"
bloqueante: true
5_traza_agente:
accion: "Actualizar traza del agente ejecutor"
bloqueante: false
nota: "Recomendado pero no bloquea"
si_falta_gobernanza:
mensaje: "❌ TAREA NO COMPLETADA - Falta documentación de gobernanza"
accion: "BLOQUEAR hasta completar"
referencia: "@DEF_CHK_GOB"
recordatorio_todolist: |
Al iniciar cualquier tarea, el TodoList DEBE incluir como último item:
- content: "Crear documentación de gobernanza (TASK-{ID})"
status: "pending"
activeForm: "Documentando gobernanza"
```
---
## VALIDACIONES POR DOMINIO
### Backend (NestJS)
```bash
npm run build # DEBE pasar
npm run lint # DEBE pasar
npm run test # Si existen, DEBEN pasar
```
### Frontend (React)
```bash
npm run build # DEBE pasar
npm run lint # DEBE pasar
npm run typecheck # DEBE pasar
```
### Database (PostgreSQL)
```bash
./scripts/recreate-database.sh # DEBE ejecutar sin errores
```
---
## REFERENCIAS
| Alias | Descripción |
|-------|-------------|
| @DEF_CAPVED | Este protocolo |
| @PRINCIPIOS/PRINCIPIO-CAPVED.md | Principio base |
| @SIMCO/SIMCO-TAREA.md | Punto de entrada |
| @TRIGGER-DOC | Documentación obligatoria |
---
**Versión:** 1.0.0 | **Sistema:** SIMCO v4.0.0 | **Tipo:** Protocolo Base

View File

@ -1,245 +0,0 @@
# Protocolo CCA - Carga de Contexto Automática
## Definición Canónica (Fuente Única de Verdad)
**Versión:** 1.0.0
**Fecha:** 2026-01-16
**Alias:** @DEF_CCA
**Tipo:** Definición Canónica
---
## PROPÓSITO
Este documento es la **ÚNICA** fuente de verdad para el Protocolo CCA.
Todos los perfiles de agentes deben **REFERENCIAR** este archivo, no copiar su contenido.
---
## USO EN PERFILES
```markdown
## PROTOCOLO CCA
> Definición: @DEF_CCA
> Variante: {dominio}
### Extensiones Específicas
[Solo contenido específico del dominio]
```
---
## PROTOCOLO BASE
> **ANTES de cualquier acción, ejecutar Carga de Contexto Automática**
```yaml
# Al recibir: "Serás {PERFIL}-Agent en {PROYECTO} para {TAREA}"
# ═══════════════════════════════════════════════════════════════
# PASO 0: IDENTIFICAR NIVEL (OBLIGATORIO PRIMERO)
# ═══════════════════════════════════════════════════════════════
PASO_0_IDENTIFICAR_NIVEL:
leer: "orchestration/directivas/simco/SIMCO-NIVELES.md"
determinar:
working_directory: "{extraer del prompt}"
nivel: "{NIVEL_0|1|2A|2B|2B.1|2B.2|3}"
orchestration_path: "{calcular según nivel}"
propagate_to: ["{niveles superiores si aplica}"]
registrar:
nivel_actual: "{nivel identificado}"
ruta_inventario: "{orchestration_path}/inventarios/"
ruta_traza: "{orchestration_path}/trazas/"
# ═══════════════════════════════════════════════════════════════
# PASO 1: IDENTIFICAR CONTEXTO
# ═══════════════════════════════════════════════════════════════
PASO_1_IDENTIFICAR:
perfil: "{PERFIL}" # Nombre del perfil activo
proyecto: "{PROYECTO}" # Extraer del prompt
tarea: "{TAREA}" # Extraer del prompt
operacion: "CREAR | MODIFICAR | VALIDAR | DOCUMENTAR | BUSCAR"
dominio: "{DOMINIO}" # BACKEND | FRONTEND | DDL | DEVOPS | ML | etc.
# ═══════════════════════════════════════════════════════════════
# PASO 2: CARGAR CONTEXTO CORE (SIEMPRE)
# ═══════════════════════════════════════════════════════════════
PASO_2_CARGAR_CORE:
leer_obligatorio:
# Catálogo primero (evitar duplicados)
- shared/catalog/CATALOG-INDEX.yml
# Principios fundamentales
- orchestration/directivas/principios/PRINCIPIO-CAPVED.md
- orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md
- orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md
- orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md
- orchestration/directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md
# Índices y referencias
- orchestration/directivas/simco/_INDEX.md
- orchestration/directivas/simco/SIMCO-TAREA.md
- orchestration/referencias/ALIASES.yml
# ═══════════════════════════════════════════════════════════════
# PASO 3: CARGAR CONTEXTO DEL PROYECTO
# ═══════════════════════════════════════════════════════════════
PASO_3_CARGAR_PROYECTO:
leer_obligatorio:
- projects/{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
- projects/{PROYECTO}/orchestration/PROXIMA-ACCION.md
leer_segun_dominio:
# Ver sección VARIANTES POR DOMINIO
# ═══════════════════════════════════════════════════════════════
# PASO 4: CARGAR DIRECTIVAS DE OPERACIÓN
# ═══════════════════════════════════════════════════════════════
PASO_4_CARGAR_OPERACION:
verificar_catalogo_primero:
- "grep -i '{funcionalidad}' @CATALOG_INDEX"
- si_existe: "Seguir @REUTILIZAR en lugar de crear"
segun_operacion:
crear: ["SIMCO-CREAR.md", "SIMCO-{DOMINIO}.md"]
modificar: ["SIMCO-MODIFICAR.md", "SIMCO-{DOMINIO}.md"]
validar: ["SIMCO-VALIDAR.md"]
documentar: ["SIMCO-DOCUMENTAR.md"]
buscar: ["SIMCO-BUSCAR.md"]
# ═══════════════════════════════════════════════════════════════
# PASO 5: CARGAR CONTEXTO ESPECÍFICO DE TAREA
# ═══════════════════════════════════════════════════════════════
PASO_5_CARGAR_TAREA:
- "Documentación relevante en docs/"
- "Código existente similar (patrones)"
- "Archivos relacionados con la tarea"
- "Identificar dependencias"
# ═══════════════════════════════════════════════════════════════
# PASO 6: VERIFICAR DEPENDENCIAS
# ═══════════════════════════════════════════════════════════════
PASO_6_VERIFICAR_DEPENDENCIAS:
si_dependencia_no_existe:
accion: "DELEGAR al agente correspondiente"
no_continuar_hasta: "Dependencia resuelta"
dependencias_por_dominio:
backend:
requiere: "Tablas DDL existen"
delegar_a: "@PERFIL_DATABASE"
frontend:
requiere: "Endpoints API existen"
delegar_a: "@PERFIL_BACKEND"
devops:
requiere: "Código funcional existe"
delegar_a: "@PERFIL_BACKEND o @PERFIL_FRONTEND"
# ═══════════════════════════════════════════════════════════════
# RESULTADO
# ═══════════════════════════════════════════════════════════════
RESULTADO: "READY_TO_EXECUTE - Contexto completo cargado"
```
---
## VARIANTES POR DOMINIO
### #backend
```yaml
PASO_3_CARGAR_PROYECTO:
leer_segun_dominio:
- projects/{PROYECTO}/orchestration/inventarios/BACKEND_INVENTORY.yml
- projects/{PROYECTO}/orchestration/inventarios/DATABASE_INVENTORY.yml
PASO_4_CARGAR_OPERACION:
segun_tarea:
crear_entity: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
crear_service: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
crear_controller: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
crear_dto: [SIMCO-CREAR.md, SIMCO-BACKEND.md]
```
### #frontend
```yaml
PASO_3_CARGAR_PROYECTO:
leer_segun_dominio:
- projects/{PROYECTO}/orchestration/inventarios/FRONTEND_INVENTORY.yml
PASO_4_CARGAR_OPERACION:
segun_tarea:
crear_componente: [SIMCO-CREAR.md, SIMCO-FRONTEND.md]
crear_hook: [SIMCO-CREAR.md, SIMCO-FRONTEND.md]
crear_page: [SIMCO-CREAR.md, SIMCO-FRONTEND.md]
```
### #ddl
```yaml
PASO_3_CARGAR_PROYECTO:
leer_segun_dominio:
- projects/{PROYECTO}/orchestration/inventarios/DATABASE_INVENTORY.yml
- projects/{PROYECTO}/ddl/ # Esquemas existentes
PASO_4_CARGAR_OPERACION:
segun_tarea:
crear_tabla: [SIMCO-CREAR.md, SIMCO-DDL.md]
crear_funcion: [SIMCO-CREAR.md, SIMCO-DDL.md]
crear_trigger: [SIMCO-CREAR.md, SIMCO-DDL.md]
crear_rls: [SIMCO-CREAR.md, SIMCO-DDL.md]
```
### #devops
```yaml
PASO_3_CARGAR_PROYECTO:
leer_segun_dominio:
- projects/{PROYECTO}/docker-compose.yml
- projects/{PROYECTO}/.env.example
PASO_4_CARGAR_OPERACION:
segun_tarea:
crear_dockerfile: [SIMCO-CREAR.md, SIMCO-DEVOPS.md]
crear_pipeline: [SIMCO-CREAR.md, SIMCO-DEVOPS.md]
```
### #ml
```yaml
PASO_3_CARGAR_PROYECTO:
leer_segun_dominio:
- projects/{PROYECTO}/orchestration/inventarios/ML_INVENTORY.yml
- projects/{PROYECTO}/models/
PASO_4_CARGAR_OPERACION:
segun_tarea:
crear_modelo: [SIMCO-CREAR.md, SIMCO-ML.md]
crear_pipeline_ml: [SIMCO-CREAR.md, SIMCO-ML.md]
```
---
## VERSIÓN LIGERA (SUBAGENTES)
Para subagentes con tareas específicas, usar versión reducida:
```yaml
# CCA Ligero - Solo para subagentes
CCA_LIGHT:
PASO_1: "Identificar perfil, proyecto, tarea"
PASO_2: "Cargar ALIASES.yml"
PASO_3: "Cargar inventario del dominio"
PASO_4: "Cargar SIMCO de operación"
RESULTADO: "READY_TO_EXECUTE"
```
Ver también: @DEF_CCA_LIGHT
---
## REFERENCIAS
- **Perfiles que usan este protocolo:** Todos los perfiles en agents/perfiles/
- **Directiva relacionada:** SIMCO-INICIALIZACION.md
- **Versión ligera:** @DEF_CCA_LIGHT
---
**Última actualización:** 2026-01-16
**Mantenido por:** @WS_ORCHESTRATOR

View File

@ -1,81 +0,0 @@
# Validación Backend - NestJS/TypeScript
## Definición Canónica
**Alias:** @DEF_VAL_BE
**Dominio:** Backend NestJS/TypeScript
---
## COMANDOS OBLIGATORIOS
```bash
# ANTES de marcar tarea como completada:
npm run build # DEBE pasar sin errores
npm run lint # DEBE pasar sin errores
npm run test # Si existen tests, DEBEN pasar
```
## CRITERIOS DE ACEPTACIÓN
```yaml
build:
resultado: "Compila sin errores"
archivos_generados: "dist/"
sin_warnings_criticos: true
lint:
resultado: "0 errores de ESLint"
warnings_permitidos: "Solo menores"
reglas_obligatorias:
- "@typescript-eslint/no-explicit-any"
- "@typescript-eslint/no-unused-vars"
test:
resultado: "100% tests pasan"
coverage_minimo: "70% (si configurado)"
nuevos_tests: "Crear para código nuevo"
```
## VALIDACIONES ADICIONALES
```yaml
entities:
- "Alineadas con DDL (nombres, tipos)"
- "Relaciones correctamente definidas"
- "Decoradores TypeORM correctos"
services:
- "Inyección de dependencias correcta"
- "Manejo de errores implementado"
- "Transacciones donde aplique"
controllers:
- "Decoradores Swagger completos"
- "Validación de DTOs"
- "Guards aplicados"
dtos:
- "class-validator decoradores"
- "Tipos correctos"
- "Documentación Swagger"
```
## ERRORES COMUNES
```yaml
- error: "Cannot find module"
causa: "Import incorrecto o dependencia faltante"
solucion: "Verificar rutas y npm install"
- error: "Type X is not assignable to type Y"
causa: "Tipos incompatibles"
solucion: "Alinear tipos con DDL/interfaces"
- error: "Circular dependency"
causa: "Módulos se importan mutuamente"
solucion: "Extraer a módulo compartido o forwardRef"
```
---
**Referencia:** @PERFIL_BACKEND, @SIMCO_BACKEND

View File

@ -1,89 +0,0 @@
# Validación DDL - PostgreSQL
## Definición Canónica
**Alias:** @DEF_VAL_DDL
**Dominio:** Database DDL PostgreSQL
---
## COMANDOS OBLIGATORIOS
```bash
# ANTES de marcar tarea como completada:
# 1. Validar sintaxis SQL
psql -h localhost -U postgres -d {DB} -f {archivo}.sql --set ON_ERROR_STOP=1
# 2. Verificar que no hay errores
echo $? # Debe ser 0
# 3. Si existe script de recreación:
./scripts/recreate-database.sh # DEBE ejecutar sin errores
```
## CRITERIOS DE ACEPTACIÓN
```yaml
sintaxis:
resultado: "SQL ejecuta sin errores"
encoding: "UTF-8"
schema_correcto: true
convenciones:
tablas: "snake_case, plural (users, products)"
columnas: "snake_case (created_at, user_id)"
constraints: "{tabla}_{columna}_{tipo} (users_email_unique)"
indices: "idx_{tabla}_{columnas}"
foreign_keys: "fk_{tabla_origen}_{tabla_destino}"
integridad:
- "Primary keys definidas"
- "Foreign keys con ON DELETE/UPDATE"
- "NOT NULL donde aplique"
- "DEFAULT values apropiados"
- "CHECK constraints donde necesario"
```
## VALIDACIONES ADICIONALES
```yaml
tablas:
- "Columnas id, created_at, updated_at presentes"
- "Tipos de datos apropiados"
- "Índices en columnas de búsqueda frecuente"
rls_policies:
- "Habilitado en tablas multi-tenant"
- "Políticas para SELECT, INSERT, UPDATE, DELETE"
- "Usando tenant_id del contexto"
funciones:
- "SECURITY DEFINER/INVOKER correcto"
- "Manejo de errores (EXCEPTION)"
- "Documentación en comentarios"
triggers:
- "Timing correcto (BEFORE/AFTER)"
- "Operaciones correctas (INSERT/UPDATE/DELETE)"
- "Función trigger existe"
```
## ERRORES COMUNES
```yaml
- error: "relation already exists"
causa: "Tabla/objeto ya existe"
solucion: "Usar IF NOT EXISTS o DROP primero"
- error: "foreign key constraint violation"
causa: "Referencia a registro inexistente"
solucion: "Verificar orden de inserción o CASCADE"
- error: "column does not exist"
causa: "Nombre de columna incorrecto"
solucion: "Verificar nombres y comillas"
```
---
**Referencia:** @PERFIL_DATABASE, @SIMCO_DDL

View File

@ -1,81 +0,0 @@
# Validación Frontend - React/TypeScript
## Definición Canónica
**Alias:** @DEF_VAL_FE
**Dominio:** Frontend React/TypeScript
---
## COMANDOS OBLIGATORIOS
```bash
# ANTES de marcar tarea como completada:
npm run build # DEBE pasar sin errores
npm run lint # DEBE pasar sin errores
npm run typecheck # DEBE pasar sin errores (tsc --noEmit)
```
## CRITERIOS DE ACEPTACIÓN
```yaml
build:
resultado: "Build de producción exitoso"
sin_warnings_criticos: true
bundle_size: "Monitorear incrementos grandes"
lint:
resultado: "0 errores de ESLint"
reglas_react:
- "react-hooks/rules-of-hooks"
- "react-hooks/exhaustive-deps"
typecheck:
resultado: "0 errores de TypeScript"
strict_mode: true
no_any_implicito: true
```
## VALIDACIONES ADICIONALES
```yaml
componentes:
- "Props tipadas correctamente"
- "Keys únicas en listas"
- "Manejo de loading/error states"
- "Accesibilidad básica (aria labels)"
hooks:
- "Dependencias completas en useEffect"
- "Cleanup en useEffect si necesario"
- "useMemo/useCallback donde aplique"
estado:
- "Estado mínimo necesario"
- "Derivar datos cuando posible"
- "Zustand/Context correctamente usado"
api:
- "Manejo de errores de red"
- "Estados de carga"
- "Cancelación de requests"
```
## ERRORES COMUNES
```yaml
- error: "React Hook useEffect has missing dependency"
causa: "Dependencia no incluida en array"
solucion: "Agregar dependencia o usar useCallback"
- error: "Cannot read property of undefined"
causa: "Datos async no disponibles"
solucion: "Optional chaining o loading state"
- error: "Each child should have unique key"
causa: "Key faltante o duplicada en map()"
solucion: "Usar ID único como key"
```
---
**Referencia:** @PERFIL_FRONTEND, @SIMCO_FRONTEND

View File

@ -1,197 +0,0 @@
# Referencias a Workspace
# Proyecto: clinica-dental
# Nivel de Herencia: 3 (erp-core -> erp-clinicas -> clinica-dental)
version: "1.0.0"
proyecto: "clinica-dental"
fecha_creacion: "2026-01-16"
# ============================================================================
# REFERENCIAS A DEFINICIONES GLOBALES
# ============================================================================
definiciones_workspace:
protocolos:
CCA:
alias: "@WS_DEF_CCA"
archivo: "orchestration/_definitions/protocols/CCA-PROTOCOL.md"
uso: "Protocolo de Carga de Contexto Automatica"
CCA_LIGHT:
alias: "@WS_DEF_CCA_LIGHT"
archivo: "orchestration/_definitions/protocols/CCA-LIGHT.md"
uso: "Version ligera para subagentes"
validaciones:
backend:
alias: "@WS_DEF_VAL_BE"
archivo: "orchestration/_definitions/validations/VALIDATION-BACKEND.md"
comandos: ["npm run build", "npm run lint", "npm run test"]
frontend:
alias: "@WS_DEF_VAL_FE"
archivo: "orchestration/_definitions/validations/VALIDATION-FRONTEND.md"
comandos: ["npm run build", "npm run lint", "npm run typecheck"]
ddl:
alias: "@WS_DEF_VAL_DDL"
archivo: "orchestration/_definitions/validations/VALIDATION-DDL.md"
devops:
alias: "@WS_DEF_VAL_DEVOPS"
archivo: "orchestration/_definitions/validations/VALIDATION-DEVOPS.md"
# ============================================================================
# REFERENCIAS A NAVEGACION RAPIDA GLOBAL
# ============================================================================
navegacion_workspace:
indice:
alias: "@WS_QUICK_INDEX"
archivo: "orchestration/_quick/QUICK-INDEX.yml"
perfiles:
alias: "@WS_QUICK_PERFILES"
archivo: "orchestration/_quick/QUICK-PERFILES.yml"
directivas:
alias: "@WS_QUICK_DIRECTIVAS"
archivo: "orchestration/_quick/QUICK-DIRECTIVAS.yml"
# ============================================================================
# REFERENCIAS A CATALOGO COMPARTIDO
# ============================================================================
catalogo_compartido:
indice:
alias: "@WS_CATALOG"
archivo: "shared/catalog/CATALOG-INDEX.yml"
funcionalidades:
auth: "shared/catalog/auth/"
notifications: "shared/catalog/notifications/"
payments: "shared/catalog/payments/"
multi_tenancy: "shared/catalog/multi-tenancy/"
# ============================================================================
# HERENCIA DE PROYECTO (Nivel 3)
# ============================================================================
herencia:
padre: "erp-clinicas"
nivel: 3
cadena_completa:
- proyecto: "erp-core"
nivel: 1
tipo: "core"
hereda: "definiciones + codigo base"
- proyecto: "erp-clinicas"
nivel: 2
tipo: "vertical"
hereda: "definiciones + codigo clinico"
- proyecto: "clinica-dental"
nivel: 3
tipo: "sub-vertical"
hereda: "especializacion dental"
hereda_de:
- proyecto: "erp-clinicas"
tipo: "definiciones + codigo"
modulos:
- CL-001 # Fundamentos
- CL-002 # Pacientes
- CL-003 # Citas
- CL-004 # Consultas
- CL-005 # Recetas
- CL-006 # Laboratorio (parcial)
- CL-008 # Facturacion
- CL-009 # Reportes
- CL-011 # Expediente
- CL-012 # Imagenologia
- proyecto: "erp-core"
tipo: "definiciones base + codigo core"
modulos:
- MGN-001 # Authentication
- MGN-002 # Users
- MGN-003 # Roles
- MGN-004 # Tenants
- MGN-005 # Catalogs
- MGN-007 # Audit
- MGN-008 # Notifications
- MGN-009 # Reports
- MGN-010 # Financial
- MGN-016 # Billing (SaaS)
- MGN-017 # Plans (SaaS)
- MGN-018 # Webhooks (SaaS)
- MGN-019 # Feature Flags (SaaS)
- MGN-020 # AI Integration (IA)
- MGN-021 # WhatsApp Business (IA)
- MGN-022 # MCP Server (IA)
# ============================================================================
# PROPAGACION
# ============================================================================
propagacion:
mirror: "shared/mirrors/clinica-dental/"
status: "shared/mirrors/clinica-dental/PROPAGATION-STATUS.yml"
consumidores: [] # Sin sub-proyectos actualmente
proveedores:
- proyecto: "erp-clinicas"
tipo: "padre"
- proyecto: "erp-core"
tipo: "abuelo"
# ============================================================================
# DEFINICIONES LOCALES
# ============================================================================
definiciones_locales:
database:
alias: "@PROJ_DEF_DB"
archivo: "docs/_definitions/DATABASE-SCHEMA.md"
entities:
alias: "@PROJ_DEF_ENTITIES"
archivo: "docs/_definitions/ENTITIES-CATALOG.md"
services:
alias: "@PROJ_DEF_SERVICES"
archivo: "docs/_definitions/SERVICES-CATALOG.md"
modules:
alias: "@PROJ_DEF_MODULES"
archivo: "docs/_definitions/MODULES-CATALOG.md"
# ============================================================================
# GOBERNANZA DE DOCUMENTACION (2026-01-16)
# ============================================================================
gobernanza_ws:
tareas:
ruta: "orchestration/tareas/"
alias: "@WS_TAREAS"
descripcion: "Sistema de tracking de tareas"
template: "orchestration/tareas/_templates/TASK-TEMPLATE/"
mapa_documentacion:
ruta: "orchestration/MAPA-DOCUMENTACION.yml"
alias: "@WS_MAPA_DOC"
descripcion: "Mapa central de documentacion del workspace"
trazas_agentes:
ruta: "orchestration/agents/trazas/"
alias: "@WS_TRAZA_AGENTE"
descripcion: "Tracking de actividad por agente"
trigger_documentacion:
ruta: "orchestration/directivas/triggers/TRIGGER-DOCUMENTACION-OBLIGATORIA.md"
alias: "@WS_TRIGGER_DOC"
descripcion: "Directiva obligatoria de documentacion"
# ============================================================================
# NAVEGACION RAPIDA LOCAL
# ============================================================================
navegacion_local:
indice:
alias: "@PROJ_QUICK_INDEX"
archivo: "docs/_quick/QUICK-INDEX.yml"
modulos:
alias: "@PROJ_QUICK_MODULES"
archivo: "docs/_quick/QUICK-MODULES.yml"
database:
alias: "@PROJ_QUICK_DB"
archivo: "docs/_quick/QUICK-DATABASE.yml"
api:
alias: "@PROJ_QUICK_API"
archivo: "docs/_quick/QUICK-API.yml"

View File

@ -1,202 +0,0 @@
# ===============================================================================
# PERFIL DE AGENTE - DDL DENTAL
# ===============================================================================
#
# Proyecto: clinica-dental
# Rol: Agente especializado en base de datos para clinica dental
# Alias: @DENTAL_AGENT_DDL
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "clinica-dental"
# -------------------------------------------------------------------------------
# IDENTIFICACION
# -------------------------------------------------------------------------------
perfil:
id: "DENTAL-AGENT-002"
nombre: "DDL Dental Agent"
alias: "@DENTAL_AGENT_DDL"
descripcion: "Agente especializado en esquema de BD para dominio dental"
tipo: "DATABASE_SPECIALIST"
# -------------------------------------------------------------------------------
# CADENA DE HERENCIA
# -------------------------------------------------------------------------------
herencia:
cadena: "template-saas -> erp-core -> erp-clinicas -> clinica-dental"
perfiles_padre:
- "@ERP_AGENT_DDL"
- "@CLINICAS_AGENT_DDL"
especializacion: "Schema sub_dental"
# -------------------------------------------------------------------------------
# COMPETENCIAS
# -------------------------------------------------------------------------------
competencias:
postgresql:
nivel: "experto"
areas:
- "Diseño de schemas multi-tenant"
- "Indices para busquedas clinicas"
- "JSONB para odontogramas"
- "Triggers de auditoria medica"
- "Row Level Security (RLS)"
dominio_dental:
nivel: "avanzado"
conocimientos:
- "Modelado de odontogramas (32/20 piezas)"
- "Estados de piezas dentales (5 superficies)"
- "Tratamientos y procedimientos"
- "Historial radiografico"
- "Planes de tratamiento"
normativa_datos:
nivel: "experto"
conocimientos:
- "NOM-024-SSA3: Expediente clinico electronico"
- "Ley Federal de Proteccion de Datos Personales"
- "Retencion de expedientes (5 años minimo)"
# -------------------------------------------------------------------------------
# RESPONSABILIDADES
# -------------------------------------------------------------------------------
responsabilidades:
principales:
- "Diseñar y mantener schema sub_dental"
- "Crear migraciones para tablas dentales"
- "Optimizar queries de odontograma"
- "Asegurar integridad referencial"
- "Implementar auditoria de expedientes"
validaciones:
- validacion: "Schema correcto"
regla: "Todas las tablas dentales en sub_dental.*"
bloquea: true
- validacion: "Auditoria"
regla: "Tablas clinicas deben tener triggers de auditoria"
bloquea: true
- validacion: "RLS"
regla: "Datos de paciente protegidos por tenant_id"
bloquea: true
- validacion: "Constraints FK"
regla: "Referencias cruzadas validadas"
bloquea: true
# -------------------------------------------------------------------------------
# SCHEMA SUB_DENTAL
# -------------------------------------------------------------------------------
schema:
nombre: "sub_dental"
descripcion: "Schema exclusivo para clinica dental"
tablas_core:
- nombre: "odontograms"
descripcion: "Odontograma digital del paciente"
campos_clave:
- "id UUID PK"
- "patient_id FK"
- "teeth_data JSONB"
- "type ENUM (adult, child)"
- "exam_date TIMESTAMP"
- nombre: "tooth_conditions"
descripcion: "Condiciones por pieza dental"
campos_clave:
- "odontogram_id FK"
- "tooth_number INT"
- "surface VARCHAR(5)"
- "condition_code VARCHAR(10)"
- nombre: "dental_treatments"
descripcion: "Catalogo de tratamientos dentales"
campos_clave:
- "id UUID PK"
- "code VARCHAR(20)"
- "name VARCHAR(100)"
- "category VARCHAR(50)"
- "default_price DECIMAL"
- nombre: "treatment_plans"
descripcion: "Planes de tratamiento por paciente"
campos_clave:
- "id UUID PK"
- "patient_id FK"
- "odontogram_id FK"
- "status ENUM"
- "total_cost DECIMAL"
- nombre: "dental_xrays"
descripcion: "Radiografias dentales"
campos_clave:
- "id UUID PK"
- "patient_id FK"
- "type ENUM (panoramic, periapical, occlusal)"
- "image_url VARCHAR"
- "taken_at TIMESTAMP"
# -------------------------------------------------------------------------------
# DIRECTIVAS ACTIVAS
# -------------------------------------------------------------------------------
directivas:
obligatorias:
- "@DENTAL_TRIGGER_COHERENCIA"
- "@DENTAL_TRIGGER_INVENTARIOS"
- "@ERP_DIRECTIVA_DDL"
- "@WS_TRIGGER_COHERENCIA"
opcionales:
- "@WS_TRIGGER_ANTI_DUPLICACION"
# -------------------------------------------------------------------------------
# MIGRACIONES
# -------------------------------------------------------------------------------
migraciones:
convencion: "YYYYMMDD_HHMMSS_descripcion.sql"
ubicacion: "database/migrations/"
pendientes:
- "20260116_000001_create_schema_sub_dental.sql"
- "20260116_000002_create_odontograms_table.sql"
- "20260116_000003_create_tooth_conditions_table.sql"
- "20260116_000004_create_dental_treatments_table.sql"
- "20260116_000005_create_treatment_plans_table.sql"
- "20260116_000006_create_dental_xrays_table.sql"
# -------------------------------------------------------------------------------
# REFERENCIAS
# -------------------------------------------------------------------------------
referencias:
documentacion:
- "@DENTAL_DEF_DB"
- "@DENTAL_INV_DB"
- "@DENTAL_MAPA_DOC"
schemas_relacionados:
- "clinicas.* (expedientes, citas, pacientes)"
- "core.* (usuarios, tenants)"
- "audit.* (trazas)"
workspace:
- "@ERP_DEF_DB"
- "@CLINICAS_DEF_DB"
- "@TS_DEF_DB"
# ===============================================================================
# FIN DEL PERFIL
# ===============================================================================

View File

@ -1,193 +0,0 @@
# ===============================================================================
# PERFIL DE AGENTE - ODONTOLOGO DIGITAL
# ===============================================================================
#
# Proyecto: clinica-dental
# Rol: Agente especializado en dominio odontologico
# Alias: @DENTAL_AGENT_ODONTOLOGO
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "clinica-dental"
# -------------------------------------------------------------------------------
# IDENTIFICACION
# -------------------------------------------------------------------------------
perfil:
id: "DENTAL-AGENT-001"
nombre: "Odontologo Digital"
alias: "@DENTAL_AGENT_ODONTOLOGO"
descripcion: "Agente especializado en logica de negocio odontologica"
tipo: "DOMAIN_EXPERT"
# -------------------------------------------------------------------------------
# CADENA DE HERENCIA
# -------------------------------------------------------------------------------
herencia:
cadena: "template-saas -> erp-core -> erp-clinicas -> clinica-dental"
perfiles_padre:
- "@CLINICAS_AGENT_MEDICO"
- "@ERP_AGENT_BACKEND"
especializacion: "Dominio odontologico"
# -------------------------------------------------------------------------------
# COMPETENCIAS
# -------------------------------------------------------------------------------
competencias:
dominio_clinico:
nivel: "experto"
areas:
- "Anatomia dental (32 piezas permanentes, 20 deciduos)"
- "Nomenclatura FDI/Palmer/Universal"
- "Patologias dentales (caries, periodontal, endodontica)"
- "Tratamientos restauradores"
- "Ortodoncia y brackets"
- "Protesis fija y removible"
- "Radiografia dental (panoramica, periapical, oclusal)"
normativa:
nivel: "experto"
conocimientos:
- nom_013_ssa2_2015:
descripcion: "Prevencion y control enfermedades bucales"
aplicacion: "Estructura de expediente, odontograma"
- nom_004_ssa3_2012:
descripcion: "Del expediente clinico"
aplicacion: "Historia clinica, consentimiento informado"
- cofepris:
descripcion: "Regulacion consultorios"
aplicacion: "Licencias, registro"
tecnico:
nivel: "avanzado"
areas:
- "Modelado de odontogramas digitales"
- "Codigos CIE-10 dentales"
- "Integracion con imagenologia"
- "Presupuestos y planes de tratamiento"
# -------------------------------------------------------------------------------
# RESPONSABILIDADES
# -------------------------------------------------------------------------------
responsabilidades:
principales:
- "Validar logica de negocio odontologica"
- "Asegurar cumplimiento normativo NOM-013"
- "Disenar flujos de tratamiento dental"
- "Verificar integridad de odontogramas"
- "Revisar codificacion de diagnosticos"
validaciones:
- validacion: "Odontograma completo"
regla: "32 piezas para adulto, 20 para nino"
bloquea: true
- validacion: "Consentimiento informado"
regla: "Obligatorio antes de tratamiento invasivo"
bloquea: true
- validacion: "Plan de tratamiento"
regla: "Debe incluir diagnostico, procedimientos, costos"
bloquea: false
- validacion: "Historial radiografico"
regla: "Justificacion clinica requerida"
bloquea: true
# -------------------------------------------------------------------------------
# DIRECTIVAS ACTIVAS
# -------------------------------------------------------------------------------
directivas:
obligatorias:
- "@DENTAL_TRIGGER_COHERENCIA"
- "@DENTAL_TRIGGER_INVENTARIOS"
- "@CLINICAS_DIRECTIVA_EXPEDIENTE"
- "@ERP_DIRECTIVA_MULTI_TENANT"
opcionales:
- "@WS_TRIGGER_ANTI_DUPLICACION"
- "@WS_TRIGGER_DEPENDENCIAS"
# -------------------------------------------------------------------------------
# FLUJOS DE TRABAJO
# -------------------------------------------------------------------------------
flujos:
nueva_consulta:
pasos:
1: "Verificar paciente existente o crear nuevo"
2: "Cargar odontograma vigente"
3: "Registrar hallazgos del examen"
4: "Actualizar odontograma"
5: "Generar plan de tratamiento"
6: "Presupuesto si aplica"
tratamiento:
pasos:
1: "Validar consentimiento informado"
2: "Verificar historial alergias"
3: "Registrar procedimiento"
4: "Actualizar odontograma post-tratamiento"
5: "Generar receta si aplica"
6: "Agendar seguimiento"
radiografia:
pasos:
1: "Verificar justificacion clinica"
2: "Seleccionar tipo (panoramica/periapical/oclusal)"
3: "Registrar dosis estimada"
4: "Almacenar imagen DICOM"
5: "Vincular a expediente"
# -------------------------------------------------------------------------------
# INTEGRACIONES
# -------------------------------------------------------------------------------
integraciones:
modulos_CDT:
- "CDT-001: Odontograma"
- "CDT-002: Tratamientos dentales"
- "CDT-003: Ortodoncia"
- "CDT-004: Protesis"
- "CDT-005: Radiografias"
- "CDT-006: Presupuestos"
modulos_heredados:
- "Pacientes (de erp-clinicas)"
- "Citas (de erp-clinicas)"
- "Expedientes (de erp-clinicas)"
- "Prescripciones (de erp-clinicas)"
# -------------------------------------------------------------------------------
# REFERENCIAS
# -------------------------------------------------------------------------------
referencias:
documentacion:
- "@DENTAL_MAPA_DOC"
- "@DENTAL_CONTEXT_MAP"
- "@DENTAL_INHERITANCE"
inventarios:
- "@DENTAL_INV_MASTER"
- "@DENTAL_INV_DB"
- "@DENTAL_INV_BE"
workspace:
- "@WS_DIRECTIVAS"
- "@WS_PERFILES"
- "@CLINICAS_MAPA_DOC"
- "@ERP_MAPA_DOC"
- "@TS_MAPA_DOC"
# ===============================================================================
# FIN DEL PERFIL
# ===============================================================================

View File

@ -1,146 +0,0 @@
# ===============================================================================
# INDICE DE PERFILES DE AGENTES - CLINICA DENTAL
# ===============================================================================
#
# Proyecto: clinica-dental
# Descripcion: Catalogo de agentes especializados para el dominio odontologico
# Alias: @DENTAL_AGENTS_INDEX
#
# ===============================================================================
version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "clinica-dental"
# -------------------------------------------------------------------------------
# CADENA DE HERENCIA DE PERFILES
# -------------------------------------------------------------------------------
herencia:
cadena: "template-saas -> erp-core -> erp-clinicas -> clinica-dental"
perfiles_heredados:
desde_template_saas:
- "@TS_AGENT_DDL"
- "@TS_AGENT_BACKEND"
- "@TS_AGENT_FRONTEND"
desde_erp_core:
- "@ERP_AGENT_DDL"
- "@ERP_AGENT_BACKEND"
- "@ERP_AGENT_FRONTEND"
desde_erp_clinicas:
- "@CLINICAS_AGENT_MEDICO"
- "@CLINICAS_AGENT_DDL"
# -------------------------------------------------------------------------------
# PERFILES PROPIOS
# -------------------------------------------------------------------------------
perfiles:
dominio:
- id: "DENTAL-AGENT-001"
archivo: "PERFIL-ODONTOLOGO-AGENT.yml"
alias: "@DENTAL_AGENT_ODONTOLOGO"
tipo: "DOMAIN_EXPERT"
descripcion: "Agente experto en logica de negocio odontologica"
competencias_clave:
- "Anatomia y patologia dental"
- "Normativa NOM-013-SSA2"
- "Flujos clinicos dentales"
tecnico:
- id: "DENTAL-AGENT-002"
archivo: "PERFIL-DDL-DENTAL-AGENT.yml"
alias: "@DENTAL_AGENT_DDL"
tipo: "DATABASE_SPECIALIST"
descripcion: "Agente especializado en schema sub_dental"
competencias_clave:
- "PostgreSQL avanzado"
- "Modelado odontograma"
- "Auditoria medica"
# -------------------------------------------------------------------------------
# MATRIZ DE COMPETENCIAS
# -------------------------------------------------------------------------------
matriz_competencias:
por_area:
dominio_dental:
principal: "@DENTAL_AGENT_ODONTOLOGO"
soporte: "@CLINICAS_AGENT_MEDICO"
base_de_datos:
principal: "@DENTAL_AGENT_DDL"
soporte: "@CLINICAS_AGENT_DDL"
backend:
principal: "@ERP_AGENT_BACKEND"
especializacion: "@DENTAL_AGENT_ODONTOLOGO"
frontend:
principal: "@ERP_AGENT_FRONTEND"
especializacion: null # Por definir
normativa:
principal: "@DENTAL_AGENT_ODONTOLOGO"
referencias:
- "NOM-013-SSA2-2015"
- "NOM-004-SSA3-2012"
# -------------------------------------------------------------------------------
# ASIGNACION POR TAREA
# -------------------------------------------------------------------------------
asignacion_tareas:
crear_tabla_dental:
agente_principal: "@DENTAL_AGENT_DDL"
validadores:
- "@DENTAL_AGENT_ODONTOLOGO"
crear_entity_dental:
agente_principal: "@ERP_AGENT_BACKEND"
validadores:
- "@DENTAL_AGENT_DDL"
- "@DENTAL_AGENT_ODONTOLOGO"
implementar_odontograma:
agente_principal: "@DENTAL_AGENT_ODONTOLOGO"
validadores:
- "@DENTAL_AGENT_DDL"
validar_normativa:
agente_principal: "@DENTAL_AGENT_ODONTOLOGO"
validadores: []
# -------------------------------------------------------------------------------
# ESTADISTICAS
# -------------------------------------------------------------------------------
estadisticas:
total_perfiles_propios: 2
total_perfiles_heredados: 8
cobertura_areas:
dominio: "100%"
ddl: "100%"
backend: "heredado"
frontend: "heredado"
ultima_actualizacion: "2026-01-16"
# -------------------------------------------------------------------------------
# REFERENCIAS
# -------------------------------------------------------------------------------
referencias:
documentacion:
- "@DENTAL_MAPA_DOC"
- "@DENTAL_TRIGGER_COHERENCIA"
- "@DENTAL_TRIGGER_INVENTARIOS"
workspace:
- "@WS_PERFILES"
- "@CLINICAS_AGENTS_INDEX"
- "@ERP_AGENTS"
# ===============================================================================
# FIN DEL INDICE
# ===============================================================================

View File

@ -1,804 +0,0 @@
# =============================================================================
# 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
# =============================================================================

View File

@ -1,133 +0,0 @@
# DEPENDENCIAS-ERP-CORE.yml - Clínica Dental
# Dependencias técnicas heredadas de erp-core via erp-clinicas
# Versión: 1.0.0
# Fecha: 2026-01-13
version: "1.0.0"
updated: "2026-01-13"
project: "clinica-dental"
inheritance_chain:
- source: "template-saas"
version: "1.2.1"
relation: "PROVIDES_TO"
- source: "erp-core"
version: "1.3.0"
relation: "DEPENDS_ON"
- source: "erp-clinicas"
version: "1.0.0"
relation: "EXTENDS"
- target: "clinica-dental"
version: "1.0.0"
relation: "SPECIALIZES"
# Módulos heredados de ERP-CORE
modules_from_erp_core:
fase_03_core:
total: 15
inherited:
- MGN-001-auth
- MGN-002-users
- MGN-003-roles
- MGN-004-tenants
- MGN-005-branches
- MGN-006-geo
- MGN-007-mobile
- MGN-008-terminals
- MGN-010-catalog
- MGN-011-products
- MGN-012-inventory
- MGN-013-customers
- MGN-014-sales
- MGN-015-invoicing
partial:
- MGN-009-biometrics # Solo si la clínica lo requiere
fase_04_saas:
total: 4
inherited:
- MGN-016-billing
- MGN-017-plans
- MGN-018-webhooks
- MGN-019-feature-flags
propagation_date: "2026-01-13"
propagation_id: "PROP-CORE-002"
fase_05_ia:
total: 3
inherited:
- MGN-020-ai-integration
- MGN-021-whatsapp-business
- MGN-022-mcp-server
propagation_date: "2026-01-13"
propagation_id: "PROP-CORE-002"
# Dependencias técnicas (DDL)
ddl_dependencies:
from_erp_core:
reused:
- "01-extensions.sql"
- "02-core-schema.sql"
- "10-billing.sql"
- "15-ai-agents.sql"
- "16-messaging.sql"
created_fase_04_05:
- "19-webhooks.sql"
- "20-feature-flags.sql"
from_erp_clinicas:
- "03-clinical-tables.sql"
- "04-financial-ext-schema-ddl.sql"
- "05-hr-ext-fase8-schema-ddl.sql"
- "06-inventory-ext-fase8-schema-ddl.sql"
- "07-purchase-ext-fase8-schema-ddl.sql"
- "08-clinica-ext-fase8-schema-ddl.sql"
specific_dental:
- "01-dental-schema-ddl.sql"
# Adaptaciones específicas dental
adaptations:
terminology:
Paciente: "Paciente odontológico"
Consulta: "Consulta dental"
Prescripción: "Receta dental"
Médico: "Odontólogo"
ai_tools:
- name: "crear_cita_dental"
description: "Crear cita en agenda odontológica"
- name: "consultar_odontograma"
description: "Consultar estado dental del paciente"
- name: "presupuesto_tratamiento"
description: "Generar presupuesto de tratamiento dental"
- name: "historial_tratamientos"
description: "Consultar historial de tratamientos"
whatsapp_templates:
- "recordatorio_cita_dental"
- "confirmacion_cita"
- "seguimiento_tratamiento"
- "promocion_limpieza"
# Normativa
compliance:
- code: "NOM-013-SSA2-2015"
name: "Prevención y control enfermedades bucales"
- code: "NOM-004-SSA3-2012"
name: "Expediente clínico"
- code: "NOM-024-SSA3-2012"
name: "Sistemas de información"
- code: "LFPDPPP"
name: "Ley Federal de Protección de Datos Personales"
- code: "COFEPRIS"
name: "Registro de establecimientos"
metadata:
created_by: "CLAUDE-CAPVED"
created_at: "2026-01-13"
propagation_ref: "PROP-CORE-002"
related_documents:
- "../00-guidelines/HERENCIA-ERP-CORE.md"
- "../00-guidelines/HERENCIA-ERP-CLINICAS.md"
- "shared/mirrors/erp-core/PROPAGATION-STATUS.yml"

View File

@ -1,184 +0,0 @@
# LESSONS-LEARNED.yml - Lecciones Aprendidas de la Tarea
# Version: 1.0.0
# Actualizado: 2026-01-18
#
# Proposito: Documentar aprendizajes para mejorar futuras tareas
# =============================================================================
# METADATA
# =============================================================================
metadata:
task_id: "TASK-YYYY-MM-DD-NNN"
task_title: "Titulo de la tarea"
completed_date: "YYYY-MM-DD"
author: "Agente"
# =============================================================================
# RESUMEN EJECUTIVO
# =============================================================================
summary:
outcome: "success" # success | partial | failed
key_achievement: "Descripcion breve del logro principal"
main_challenge: "Descripcion breve del desafio principal"
time_deviation: "+2h" # vs estimado (ej: +2h, -1h, on-time)
# =============================================================================
# QUE FUNCIONO BIEN
# =============================================================================
what_worked:
- id: WW-001
category: "process" # process | technical | communication | tooling
description: "Descripcion de lo que funciono bien"
impact: "high" # high | medium | low
replicable: true
details: |
Contexto adicional sobre por que funciono
y como replicarlo en futuras tareas.
- id: WW-002
category: "technical"
description: "Descripcion de solucion tecnica efectiva"
impact: "medium"
replicable: true
code_example: |
// Ejemplo de codigo si aplica
const solution = ...
# =============================================================================
# QUE NO FUNCIONO / PROBLEMAS
# =============================================================================
what_didnt_work:
- id: WD-001
category: "process"
description: "Descripcion del problema encontrado"
impact: "high"
root_cause: "Causa raiz del problema"
resolution: "Como se resolvio o mitigó"
prevention: "Como prevenir en el futuro"
- id: WD-002
category: "technical"
description: "Problema tecnico encontrado"
impact: "medium"
root_cause: "Causa raiz"
resolution: "Solucion aplicada"
prevention: "Medida preventiva"
related_docs:
- "Link a ADR o documentacion relacionada"
# =============================================================================
# SORPRESAS / DESCUBRIMIENTOS
# =============================================================================
surprises:
- id: SU-001
type: "positive" # positive | negative | neutral
description: "Algo inesperado que se descubrio"
impact: "medium"
action_taken: "Que se hizo al respecto"
follow_up: "Acciones futuras si aplica"
# =============================================================================
# RECOMENDACIONES PARA FUTURAS TAREAS
# =============================================================================
recommendations:
immediate:
- id: REC-I-001
description: "Accion inmediata recomendada"
priority: "high"
owner: "Quien debe ejecutar"
short_term:
- id: REC-S-001
description: "Mejora para proximas tareas similares"
priority: "medium"
estimated_effort: "1h"
long_term:
- id: REC-L-001
description: "Mejora sistemica para el proyecto"
priority: "low"
requires_approval: true
# =============================================================================
# ACTUALIZACIONES A PROCESOS/DOCS
# =============================================================================
process_updates:
triggers:
- file: "orchestration/directivas/triggers/TRIGGER-XXX.md"
action: "update" # create | update | deprecate
description: "Actualizacion sugerida al trigger"
checklists:
- file: "orchestration/directivas/checklists/CHECKLIST-XXX.md"
action: "update"
description: "Item a agregar al checklist"
templates:
- file: "orchestration/templates/TEMPLATE-XXX.md"
action: "update"
description: "Mejora al template"
# =============================================================================
# METRICAS DE LA TAREA
# =============================================================================
task_metrics:
time:
estimated: "Xh"
actual: "Yh"
variance: "+/-Zh"
scope:
planned_items: 10
completed_items: 10
added_items: 2
removed_items: 0
quality:
bugs_found: 0
rework_required: false
first_time_right: true
complexity:
estimated: "medium" # low | medium | high
actual: "high"
reason_for_variance: "Razon si cambio"
# =============================================================================
# TAGS PARA BUSQUEDA
# =============================================================================
tags:
domains: [database, backend, frontend]
topics: [performance, security, refactoring]
technologies: [typescript, postgresql, react]
patterns: [repository, factory, observer]
# =============================================================================
# PROPAGACION
# =============================================================================
propagation:
should_propagate: true
target_index: "workspace-v2/orchestration/retrospectivas/LECCIONES-INDEX.yml"
propagated: false
propagated_date: null
# =============================================================================
# REFERENCIAS
# =============================================================================
references:
metadata: "./METADATA.yml"
subtasks: "./SUBTASKS.yml"
related_tasks:
- "TASK-YYYY-MM-DD-XXX: Tarea relacionada"
external_docs:
- "Link a documentacion externa relevante"

View File

@ -1,230 +0,0 @@
# METADATA.yml - Template Unificado de Tarea
# Version: 2.0.0
# Actualizado: 2026-01-18
# =============================================================================
# IDENTIFICACION
# =============================================================================
task:
id: "TASK-YYYY-MM-DD-NNN"
title: "Titulo descriptivo de la tarea"
created: "YYYY-MM-DD"
updated: "YYYY-MM-DD"
# =============================================================================
# CLASIFICACION
# =============================================================================
classification:
type: "feature" # feature | bug | refactor | audit | migration | documentation
priority: "P1" # P0 (critico) | P1 (alto) | P2 (medio) | P3 (bajo)
mode: "FULL" # FULL | QUICK | ANALYSIS | PROPAGATION
epic: "EAI-003" # Epica relacionada (si aplica)
sprint: "Sprint-XX" # Sprint actual (si aplica)
# =============================================================================
# ESTADO
# =============================================================================
status:
current: "pending" # pending | in_progress | blocked | completed
blocked_by: null # ID de tarea/issue bloqueante
completion: 0%
last_phase: null # C | A | P | V | E | D
# =============================================================================
# DOMINIOS AFECTADOS
# =============================================================================
domains:
- name: "database"
affected: true
details: "Descripcion de cambios en BD"
- name: "backend"
affected: true
details: "Descripcion de cambios en backend"
- name: "frontend"
affected: false
details: null
- name: "documentation"
affected: true
details: "Actualizacion de inventarios"
# =============================================================================
# REQUERIMIENTOS Y DEPENDENCIAS
# =============================================================================
requirements:
functional:
- "RF-XXX-001: Descripcion"
technical:
- "ET-XXX-001: Descripcion"
user_stories:
- "US-XXX-001: Como usuario quiero..."
dependencies:
tasks_required:
- "TASK-YYYY-MM-DD-NNN: Tarea previa necesaria"
tasks_blocked:
- "TASK-YYYY-MM-DD-NNN: Tarea que espera esta"
epics_related:
- "EAI-003: Gamificacion"
# =============================================================================
# FASES CAPVED
# =============================================================================
phases:
contexto:
status: "pending" # pending | in_progress | completed | skipped
started: null
completed: null
file: "01-CONTEXTO.md"
checklist: "CHECKLIST-FASE-C.md"
analisis:
status: "pending"
started: null
completed: null
file: "02-ANALISIS.md"
checklist: "CHECKLIST-FASE-A.md"
plan:
status: "pending"
started: null
completed: null
file: "03-PLAN.md"
checklist: "CHECKLIST-FASE-P.md"
validacion:
status: "pending"
started: null
completed: null
file: "04-VALIDACION.md"
checklist: "CHECKLIST-FASE-V.md"
ejecucion:
status: "pending"
started: null
completed: null
file: "05-EJECUCION.md"
checklist: "CHECKLIST-FASE-E.md"
checkpoints:
CP1_database: "pending"
CP2_backend: "pending"
CP3_frontend: "pending"
CP4_coherencia: "pending"
documentacion:
status: "pending"
started: null
completed: null
file: "06-DOCUMENTACION.md"
checklist: "CHECKLIST-FASE-D.md"
# =============================================================================
# SUBTAREAS
# =============================================================================
subtasks_file: "SUBTASKS.yml"
subtasks_summary:
total: 0
completed: 0
in_progress: 0
pending: 0
blocked: 0
# =============================================================================
# ENTREGABLES
# =============================================================================
deliverables:
code:
- path: "apps/backend/src/..."
type: "new" # new | modified | deleted
description: "Descripcion del cambio"
documentation:
- path: "docs/..."
type: "modified"
description: "Actualizacion de documentacion"
reports:
- name: "REPORT-XXX.md"
description: "Reporte generado"
# =============================================================================
# VALIDACIONES
# =============================================================================
validations:
build:
backend: null # pass | fail | pending
frontend: null
database: null
lint:
backend: null
frontend: null
tests:
backend: null
frontend: null
coherence:
ddl_backend: null
backend_frontend: null
# =============================================================================
# METRICAS
# =============================================================================
metrics:
time:
estimated_hours: null
actual_hours: null
changes:
files_created: 0
files_modified: 0
files_deleted: 0
lines_added: 0
lines_removed: 0
issues:
found: 0
fixed: 0
deferred: 0
# =============================================================================
# AGENTE
# =============================================================================
agent:
id: "agente-principal"
session: "session-id"
workspace: "workspace-v2"
# =============================================================================
# HISTORIAL
# =============================================================================
changelog:
- date: "YYYY-MM-DD"
author: "Agente"
action: "created"
details: "Tarea creada"
# =============================================================================
# REFERENCIAS
# =============================================================================
references:
subtasks: "./SUBTASKS.yml"
lessons: "./LESSONS-LEARNED.yml"
ssot: "docs/_SSOT/"
epic_manifest: "docs/XX-fase-*/EPIC-XXX/EPIC-MANIFEST.yml"
checklist_cierre: "orchestration/directivas/checklists/CHECKLIST-CIERRE.md"

View File

@ -1,129 +0,0 @@
# TASK-TEMPLATE-UNIFIED
**Version:** 2.0.0
**Actualizado:** 2026-01-18
## Proposito
Template unificado para tareas que integra:
- Metadata estructurada (METADATA.yml)
- Sistema recursivo de subtareas N niveles (SUBTASKS.yml)
- Registro de lecciones aprendidas (LESSONS-LEARNED.yml)
## Archivos
| Archivo | Proposito |
|---------|-----------|
| `METADATA.yml` | Identificacion, clasificacion, estado, fases CAPVED |
| `SUBTASKS.yml` | Desglose recursivo hasta 5 niveles |
| `LESSONS-LEARNED.yml` | Documentacion de aprendizajes post-tarea |
| `README.md` | Este archivo |
## Como Usar
### 1. Crear nueva tarea
```bash
# Crear carpeta con ID de tarea
mkdir orchestration/tareas/TASK-2026-01-18-001
# Copiar template
cp -r orchestration/tareas/_templates/TASK-TEMPLATE-UNIFIED/* orchestration/tareas/TASK-2026-01-18-001/
```
### 2. Actualizar METADATA.yml
```yaml
task:
id: "TASK-2026-01-18-001"
title: "Titulo real de la tarea"
created: "2026-01-18"
```
### 3. Definir subtareas en SUBTASKS.yml
Adaptar las subtareas segun los dominios afectados:
- Eliminar grupos no necesarios (ej: E.FE si no hay cambios frontend)
- Agregar subtareas especificas
- Definir criterios de aceptacion
### 4. Ejecutar tarea siguiendo CAPVED
1. **C** - Contexto: Vincular con RF/ET/US
2. **A** - Analisis: Mapear dependencias e impacto
3. **P** - Plan: Detallar subtareas en SUBTASKS.yml
4. **V** - Validacion: Gate de aprobacion
5. **E** - Ejecucion: Implementar por checkpoints (CP1-CP4)
6. **D** - Documentacion: Actualizar inventarios, trazas, lecciones
### 5. Completar LESSONS-LEARNED.yml
Al finalizar la tarea:
- Documentar que funciono bien
- Documentar problemas y resoluciones
- Agregar recomendaciones
## Estructura de Niveles (SUBTASKS.yml)
```
NIVEL 1: FASE
├── C (Contexto)
├── A (Analisis)
├── P (Plan)
├── V (Validacion)
├── E (Ejecucion) ← NIVEL 2: GRUPO
│ ├── E.DB (Database)
│ ├── E.BE (Backend) ← NIVEL 3: SUBTAREA
│ │ ├── E.BE.01
│ │ │ ├── E.BE.01.AC1 ← NIVEL 4: CRITERIO
│ │ │ │ └── AC1.1 ← NIVEL 5: SUB-CRITERIO
│ │ │ └── E.BE.01.AC2
│ │ └── E.BE.02
│ ├── E.FE (Frontend)
│ └── E.COH (Coherencia)
└── D (Documentacion)
```
## Checkpoints de Ejecucion
| Checkpoint | Validaciones |
|------------|--------------|
| CP1: Post-Database | DDL ejecuta, recreate-database.sh exitoso |
| CP2: Post-Backend | npm run build, lint, test - PASAN |
| CP3: Post-Frontend | npm run build, typecheck - PASAN |
| CP4: Coherencia | Entity↔DDL, DTO↔Entity, FE↔BE alineados |
## Estados de Subtareas
| Estado | Descripcion |
|--------|-------------|
| `pending` | No iniciado |
| `in_progress` | En ejecucion |
| `completed` | Terminado exitosamente |
| `blocked` | Bloqueado por dependencia |
| `skipped` | Omitido (documentar razon) |
## Integracion con Sistema
### Actualizar _INDEX.yml al completar
```yaml
tasks:
- id: TASK-2026-01-18-001
title: "Titulo de la tarea"
date: "2026-01-18"
status: completed
path: "orchestration/tareas/TASK-2026-01-18-001/"
```
### Propagar lecciones al workspace
Si `propagation.should_propagate: true` en LESSONS-LEARNED.yml:
1. Copiar entrada relevante a `workspace-v2/orchestration/retrospectivas/LECCIONES-INDEX.yml`
2. Marcar `propagated: true`
## Referencias
- SSOT: `docs/_SSOT/`
- Checklists CAPVED: `orchestration/directivas/checklists/`
- Template anterior: `workspace-v2/orchestration/tareas/_templates/TASK-TEMPLATE/`

View File

@ -1,353 +0,0 @@
# SUBTASKS.yml - Sistema Recursivo de Subtareas (N Niveles)
# Version: 1.0.0
# Actualizado: 2026-01-18
#
# ESTRUCTURA DE NIVELES:
# Nivel 1: FASE (C, A, P, V, E, D)
# Nivel 2: GRUPO/DOMINIO (E.DB, E.BE, E.FE)
# Nivel 3: SUBTAREA
# Nivel 4: CRITERIO DE ACEPTACION
# Nivel 5: SUB-CRITERIO (si necesario)
# =============================================================================
# METADATA
# =============================================================================
metadata:
task_id: "TASK-YYYY-MM-DD-NNN"
version: "1.0.0"
max_depth: 5
total_items: 0
completed_items: 0
# =============================================================================
# RESUMEN POR FASE
# =============================================================================
summary:
C:
total: 0
completed: 0
percentage: 0%
A:
total: 0
completed: 0
percentage: 0%
P:
total: 0
completed: 0
percentage: 0%
V:
total: 0
completed: 0
percentage: 0%
E:
total: 0
completed: 0
percentage: 0%
D:
total: 0
completed: 0
percentage: 0%
# =============================================================================
# SUBTAREAS - NIVEL 1: FASES
# =============================================================================
subtasks:
# -------------------------------------------------------------------------
# FASE C: CONTEXTO
# -------------------------------------------------------------------------
- id: "C"
tipo: "fase"
nombre: "Contexto"
status: "pending" # pending | in_progress | completed | blocked | skipped
descripcion: "Clasificar y vincular tarea con objetivos del proyecto"
children:
- id: "C.01"
tipo: "subtarea"
titulo: "Identificar requerimientos relacionados"
status: "pending"
acceptance_criteria:
- id: "C.01.AC1"
descripcion: "RF/ET/US vinculados en METADATA.yml"
status: "pending"
- id: "C.02"
tipo: "subtarea"
titulo: "Verificar catalogo de funcionalidades"
status: "pending"
acceptance_criteria:
- id: "C.02.AC1"
descripcion: "No hay duplicacion con funcionalidades existentes"
status: "pending"
# -------------------------------------------------------------------------
# FASE A: ANALISIS
# -------------------------------------------------------------------------
- id: "A"
tipo: "fase"
nombre: "Analisis"
status: "pending"
descripcion: "Mapear impacto, dependencias y riesgos"
children:
- id: "A.01"
tipo: "subtarea"
titulo: "Analizar dependencias de codigo"
status: "pending"
acceptance_criteria:
- id: "A.01.AC1"
descripcion: "Archivos dependientes identificados"
status: "pending"
- id: "A.01.AC2"
descripcion: "Impacto de cambios evaluado"
status: "pending"
- id: "A.02"
tipo: "subtarea"
titulo: "Identificar riesgos"
status: "pending"
acceptance_criteria:
- id: "A.02.AC1"
descripcion: "Riesgos documentados con mitigacion"
status: "pending"
# -------------------------------------------------------------------------
# FASE P: PLAN
# -------------------------------------------------------------------------
- id: "P"
tipo: "fase"
nombre: "Plan"
status: "pending"
descripcion: "Desglosar subtareas por dominio"
children:
- id: "P.01"
tipo: "subtarea"
titulo: "Definir subtareas de ejecucion"
status: "pending"
acceptance_criteria:
- id: "P.01.AC1"
descripcion: "Subtareas E.DB, E.BE, E.FE definidas"
status: "pending"
- id: "P.02"
tipo: "subtarea"
titulo: "Establecer orden de ejecucion"
status: "pending"
acceptance_criteria:
- id: "P.02.AC1"
descripcion: "Dependencias entre subtareas claras"
status: "pending"
# -------------------------------------------------------------------------
# FASE V: VALIDACION (Gate)
# -------------------------------------------------------------------------
- id: "V"
tipo: "fase"
nombre: "Validacion Pre-Ejecucion"
status: "pending"
descripcion: "Gate de validacion antes de ejecutar"
children:
- id: "V.01"
tipo: "subtarea"
titulo: "Validar alineacion con requerimientos"
status: "pending"
acceptance_criteria:
- id: "V.01.AC1"
descripcion: "Plan alineado con RF/ET"
status: "pending"
- id: "V.02"
tipo: "subtarea"
titulo: "Aprobar plan de ejecucion"
status: "pending"
acceptance_criteria:
- id: "V.02.AC1"
descripcion: "Plan aprobado para continuar"
status: "pending"
# -------------------------------------------------------------------------
# FASE E: EJECUCION (Nivel 2: Grupos por Dominio)
# -------------------------------------------------------------------------
- id: "E"
tipo: "fase"
nombre: "Ejecucion"
status: "pending"
descripcion: "Implementar cambios por dominio"
children:
# --- GRUPO E.DB: Database ---
- id: "E.DB"
tipo: "grupo"
dominio: "database"
nombre: "Cambios en Base de Datos"
status: "pending"
checkpoint: "CP1"
children:
- id: "E.DB.01"
tipo: "subtarea"
titulo: "[Descripcion de cambio DDL]"
status: "pending"
dependencias: []
acceptance_criteria:
- id: "E.DB.01.AC1"
descripcion: "DDL ejecuta sin errores"
status: "pending"
- id: "E.DB.01.AC2"
descripcion: "recreate-database.sh exitoso"
status: "pending"
# --- GRUPO E.BE: Backend ---
- id: "E.BE"
tipo: "grupo"
dominio: "backend"
nombre: "Cambios en Backend"
status: "pending"
checkpoint: "CP2"
dependencias: ["E.DB"] # Depende de que BD este lista
children:
- id: "E.BE.01"
tipo: "subtarea"
titulo: "[Descripcion de cambio backend]"
status: "pending"
acceptance_criteria:
- id: "E.BE.01.AC1"
descripcion: "Entity creada/modificada"
status: "pending"
- id: "E.BE.01.AC2"
descripcion: "npm run build - PASA"
status: "pending"
- id: "E.BE.01.AC3"
descripcion: "npm run lint - PASA"
status: "pending"
- id: "E.BE.01.AC4"
descripcion: "npm run test - PASA"
status: "pending"
# --- GRUPO E.FE: Frontend ---
- id: "E.FE"
tipo: "grupo"
dominio: "frontend"
nombre: "Cambios en Frontend"
status: "pending"
checkpoint: "CP3"
dependencias: ["E.BE"] # Depende de que backend este listo
children:
- id: "E.FE.01"
tipo: "subtarea"
titulo: "[Descripcion de cambio frontend]"
status: "pending"
acceptance_criteria:
- id: "E.FE.01.AC1"
descripcion: "Componente creado/modificado"
status: "pending"
- id: "E.FE.01.AC2"
descripcion: "npm run build - PASA"
status: "pending"
- id: "E.FE.01.AC3"
descripcion: "npm run typecheck - PASA"
status: "pending"
# --- GRUPO E.COH: Coherencia ---
- id: "E.COH"
tipo: "grupo"
dominio: "coherencia"
nombre: "Validacion de Coherencia"
status: "pending"
checkpoint: "CP4"
dependencias: ["E.DB", "E.BE", "E.FE"]
children:
- id: "E.COH.01"
tipo: "subtarea"
titulo: "Verificar coherencia entre capas"
status: "pending"
acceptance_criteria:
- id: "E.COH.01.AC1"
descripcion: "Entity alineada con DDL"
status: "pending"
- id: "E.COH.01.AC2"
descripcion: "DTO alineado con Entity"
status: "pending"
- id: "E.COH.01.AC3"
descripcion: "Frontend consume endpoints correctos"
status: "pending"
# -------------------------------------------------------------------------
# FASE D: DOCUMENTACION
# -------------------------------------------------------------------------
- id: "D"
tipo: "fase"
nombre: "Documentacion"
status: "pending"
descripcion: "Actualizar inventarios, trazas y propagar"
children:
- id: "D.01"
tipo: "subtarea"
titulo: "Actualizar inventarios"
status: "pending"
acceptance_criteria:
- id: "D.01.AC1"
descripcion: "DATABASE_INVENTORY.yml actualizado (si aplica)"
status: "pending"
- id: "D.01.AC2"
descripcion: "BACKEND_INVENTORY.yml actualizado (si aplica)"
status: "pending"
- id: "D.01.AC3"
descripcion: "FRONTEND_INVENTORY.yml actualizado (si aplica)"
status: "pending"
- id: "D.01.AC4"
descripcion: "MASTER_INVENTORY.yml actualizado"
status: "pending"
- id: "D.02"
tipo: "subtarea"
titulo: "Actualizar trazas"
status: "pending"
acceptance_criteria:
- id: "D.02.AC1"
descripcion: "TRAZA-TAREAS-*.md actualizado"
status: "pending"
- id: "D.02.AC2"
descripcion: "_INDEX.yml actualizado"
status: "pending"
- id: "D.03"
tipo: "subtarea"
titulo: "Registrar lecciones aprendidas"
status: "pending"
acceptance_criteria:
- id: "D.03.AC1"
descripcion: "LESSONS-LEARNED.yml completado"
status: "pending"
- id: "D.04"
tipo: "subtarea"
titulo: "Ejecutar CHECKLIST-CIERRE.md"
status: "pending"
acceptance_criteria:
- id: "D.04.AC1"
descripcion: "Todos los items del checklist pasan"
status: "pending"
# =============================================================================
# INSTRUCCIONES DE USO
# =============================================================================
#
# 1. Copiar este archivo a la carpeta de la tarea
# 2. Actualizar metadata.task_id
# 3. Completar/eliminar subtareas segun necesidad
# 4. Para agregar niveles adicionales, usar children recursivamente
# 5. Actualizar status conforme avanza la ejecucion
# 6. Mantener summary actualizado
#
# ESTADOS:
# pending - No iniciado
# in_progress - En ejecucion
# completed - Terminado exitosamente
# blocked - Bloqueado por dependencia
# skipped - Omitido (documentar razon)
#
# CHECKPOINTS (en Fase E):
# CP1 - Post-Database: DDL ejecuta, recreate exitoso
# CP2 - Post-Backend: build, lint, test pasan
# CP3 - Post-Frontend: build, typecheck pasan
# CP4 - Coherencia: Capas alineadas