chore: Remove obsolete orchestration archive files
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
8fa57a4c00
commit
73f509a911
@ -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"
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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
|
||||
@ -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"
|
||||
@ -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
|
||||
# ===============================================================================
|
||||
@ -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
|
||||
# ===============================================================================
|
||||
@ -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
|
||||
# ===============================================================================
|
||||
@ -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
|
||||
# =============================================================================
|
||||
@ -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"
|
||||
@ -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"
|
||||
@ -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"
|
||||
@ -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/`
|
||||
@ -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
|
||||
Loading…
Reference in New Issue
Block a user