workspace-v1/orchestration/templates/TEMPLATE-ANALISIS-IMPACTO.md

# ANALISIS DE IMPACTO: {TAREA-ID}

**Tarea:** {Descripcion breve de la tarea}
**Fecha:** {YYYY-MM-DD}
**Analista:** {Agente que realiza el analisis}
**Fase CAPVED:** A (Analisis)

---

## 1. RESUMEN DE CAMBIO PROPUESTO

```yaml
tipo_cambio: "{CREAR | MODIFICAR | ELIMINAR}"
capa_origen: "{DATABASE | BACKEND | FRONTEND | MULTIPLE}"
descripcion: "{Descripcion del cambio a realizar}"
```

---

## 2. OBJETOS DIRECTAMENTE AFECTADOS

### 2.1 Database (DDL)

| Objeto | Tipo | Accion | Archivo |
|--------|------|--------|---------|
| {schema.tabla} | TABLE | {CREATE/ALTER/DROP} | `ddl/schemas/{schema}/tables/{archivo}.sql` |
| {schema.indice} | INDEX | {CREATE/DROP} | `ddl/schemas/{schema}/indexes/{archivo}.sql` |
| {schema.funcion} | FUNCTION | {CREATE/ALTER} | `ddl/schemas/{schema}/functions/{archivo}.sql` |

**Cambios en columnas (si aplica):**

| Columna | Cambio | Tipo Anterior | Tipo Nuevo | Nullable |
|---------|--------|---------------|------------|----------|
| {columna} | {ADD/MODIFY/DROP} | {tipo} | {tipo} | {YES/NO} |

---

### 2.2 Backend

| Objeto | Tipo | Accion | Archivo |
|--------|------|--------|---------|
| {NombreEntity} | Entity | {CREATE/MODIFY} | `src/modules/{mod}/entities/{archivo}.ts` |
| {NombreDto} | DTO | {CREATE/MODIFY} | `src/modules/{mod}/dto/{archivo}.ts` |
| {NombreService} | Service | {CREATE/MODIFY} | `src/modules/{mod}/services/{archivo}.ts` |
| {NombreController} | Controller | {CREATE/MODIFY} | `src/modules/{mod}/controllers/{archivo}.ts` |

**Endpoints afectados:**

| Metodo | Path | Accion | Cambio |
|--------|------|--------|--------|
| {GET/POST/PUT/DELETE} | `/api/{path}` | {CREATE/MODIFY} | {descripcion} |

---

### 2.3 Frontend

| Objeto | Tipo | Accion | Archivo |
|--------|------|--------|---------|
| {NombreType} | Type/Interface | {CREATE/MODIFY} | `src/types/{archivo}.ts` |
| {NombreSchema} | Zod Schema | {CREATE/MODIFY} | `src/schemas/{archivo}.ts` |
| {NombreHook} | Hook | {CREATE/MODIFY} | `src/hooks/{archivo}.ts` |
| {NombreComponent} | Component | {CREATE/MODIFY} | `src/components/{archivo}.tsx` |

---

## 3. CASCADA DE IMPACTO

### 3.1 Diagrama de Propagacion

```
{OBJETO_ORIGEN}
    |
    +---> {OBJETO_DEPENDIENTE_1}
    |         |
    |         +---> {SUB_DEPENDIENTE_1}
    |         +---> {SUB_DEPENDIENTE_2}
    |
    +---> {OBJETO_DEPENDIENTE_2}
    |
    +---> {OBJETO_DEPENDIENTE_3}
```

### 3.2 Matriz de Dependencias

| Objeto Modificado | Depende de | Es Dependencia de | Requiere Actualizacion |
|-------------------|------------|-------------------|------------------------|
| {objeto_1} | {dependencias} | {dependientes} | SI/NO |
| {objeto_2} | {dependencias} | {dependientes} | SI/NO |

---

## 4. ANALISIS POR CAPA (Consultar IMPACTO-CAMBIOS-*.md)

### 4.1 Si es cambio en DDL

Referencia: `core/orchestration/impactos/IMPACTO-CAMBIOS-DDL.md`

| Capa Dependiente | Requiere Actualizacion | Prioridad |
|------------------|------------------------|-----------|
| Entity | {SI/NO} | 1 |
| CreateDto | {SI/NO} | 2 |
| UpdateDto | {AUTO} | 2 |
| ResponseDto | {SI/NO} | 2 |
| Service | {POSIBLE} | 3 |
| Frontend Types | {SI/NO} | 4 |
| Frontend Schema | {SI/NO} | 4 |
| Tests | {POSIBLE} | 5 |
| DATABASE_INVENTORY | {SI} | 6 |

### 4.2 Si es cambio en Entity

Referencia: `core/orchestration/impactos/IMPACTO-CAMBIOS-ENTITY.md`

| Capa Dependiente | Requiere Actualizacion | Prioridad |
|------------------|------------------------|-----------|
| DTOs | {SI/NO} | 1 |
| Service | {POSIBLE} | 2 |
| Controller | {POSIBLE} | 3 |
| Frontend Types | {SI/NO} | 4 |
| Tests | {POSIBLE} | 5 |
| BACKEND_INVENTORY | {SI} | 6 |

### 4.3 Si es cambio en API

Referencia: `core/orchestration/impactos/IMPACTO-CAMBIOS-API.md`

| Capa Dependiente | Requiere Actualizacion | Prioridad |
|------------------|------------------------|-----------|
| Swagger/OpenAPI | {AUTO} | - |
| Frontend Types | {SI/NO} | 1 |
| Frontend API Service | {SI/NO} | 2 |
| Frontend Components | {POSIBLE} | 3 |
| Tests E2E | {POSIBLE} | 4 |

---

## 5. RIESGOS IDENTIFICADOS

| ID | Riesgo | Probabilidad | Impacto | Mitigacion |
|----|--------|--------------|---------|------------|
| R1 | {descripcion} | {ALTA/MEDIA/BAJA} | {ALTO/MEDIO/BAJO} | {accion} |
| R2 | {descripcion} | {ALTA/MEDIA/BAJA} | {ALTO/MEDIO/BAJO} | {accion} |

---

## 6. DEPENDENCIAS CON OTRAS TAREAS/HUs

### 6.1 Esta tarea BLOQUEA:

| Tarea | Descripcion | Razon |
|-------|-------------|-------|
| {TAREA-XXX} | {descripcion} | {por que bloquea} |

### 6.2 Esta tarea ES BLOQUEADA POR:

| Tarea | Descripcion | Estado |
|-------|-------------|--------|
| {TAREA-YYY} | {descripcion} | {COMPLETADA/EN_PROGRESO/PENDIENTE} |

---

## 7. VERIFICACION DE CATALOGO

Referencia: `shared/catalog/CATALOG-INDEX.yml`

| Funcionalidad Requerida | Existe en Catalogo | Accion |
|-------------------------|-------------------|--------|
| {auth/session/etc} | {SI/NO} | {REUTILIZAR / IMPLEMENTAR} |

---

## 8. SCOPE CREEP DETECTADO

| Item | En Alcance Original | Accion |
|------|---------------------|--------|
| {item_1} | {SI/NO} | {INCLUIR / HU_DERIVADA} |
| {item_2} | {SI/NO} | {INCLUIR / HU_DERIVADA} |

**HUs Derivadas a Crear:**

```yaml
- id: "DERIVED-{TAREA-ID}-001"
  descripcion: "{descripcion}"
  prioridad: "{P0/P1/P2/P3}"
  razon: "{por que se genera}"
```

---

## 9. ORDEN DE EJECUCION RECOMENDADO

```
1. [ ] {CAPA} - {accion} - {objeto}
2. [ ] {CAPA} - {accion} - {objeto}
3. [ ] {CAPA} - {accion} - {objeto}
...
N. [ ] Actualizar inventarios y trazas
```

---

## 10. CHECKLIST DE VALIDACION (Fase V)

```yaml
Analisis_completo:
  - [ ] Todos los objetos afectados identificados
  - [ ] Cascada de impacto documentada
  - [ ] Riesgos identificados y mitigados
  - [ ] Dependencias con otras tareas verificadas
  - [ ] Catalogo consultado
  - [ ] Scope creep detectado y registrado
  - [ ] Orden de ejecucion definido

Listo_para_Fase_P:
  - [ ] Este analisis esta completo
  - [ ] Puede procederse a planificacion
```

---

## 11. APROBACION

| Rol | Nombre/Agente | Fecha | Estado |
|-----|---------------|-------|--------|
| Analista | {agente} | {fecha} | COMPLETADO |
| Revisor (si aplica) | {Architecture-Analyst} | {fecha} | {APROBADO/OBSERVACIONES} |

---

**Template Version:** 1.0.0 | **Sistema:** SIMCO + CAPVED