Nexus - AI Task Orchestrator

20-release-planning
Procedimiento: Planificaci├│n de Release

Despliegue
1 plugin(s)
Titulo
Descripcion
Contenido Markdown
8125 caracteres
# Procedimiento: Planificaci├│n de Release

## Metadata
- **ID**: PROC-20
- **Frecuencia**: Pre-release (antes de cada deploy a producci├│n)
- **Duraci├│n estimada**: 30-60 min
- **Requiere**: Lista de cambios, acceso a CI/CD, comunicaci├│n con stakeholders
- **Dependencias**: PROC-04 (tests), PROC-05 (security)
- **Bloquea**: Deploy a producci├│n

## Objetivo

Planificar y coordinar releases a producci├│n de forma ordenada, minimizando riesgos y asegurando comunicaci├│n adecuada.

## Tipos de Release

| Tipo | Contenido | Proceso | Comunicaci├│n |
|------|-----------|---------|--------------|
| **Hotfix** | Fix cr├¡tico ├║nico | Fast-track | Post-deploy |
| **Patch** | Bug fixes, mejoras menores | Normal | Changelog |
| **Minor** | Features nuevas, backward compatible | Normal + QA | Anuncio |
| **Major** | Breaking changes | Extended + Migration plan | Amplia |

## Checklist Pre-Release

### 1. Inventario de cambios
```bash
# Commits desde ├║ltimo release
git log --oneline $(git describe --tags --abbrev=0)..HEAD

# Generar changelog
git log --oneline --no-merges $(git describe --tags --abbrev=0)..HEAD \
  | sed 's/^/- /'
```

Documentar cambios:

| Tipo | Descripci├│n | Riesgo | PR |
|------|-------------|--------|-----|
| feat | | Bajo/Medio/Alto | |
| fix | | Bajo/Medio/Alto | |
| chore | | Bajo/Medio/Alto | |

- [ ] Cambios inventariados
- [ ] Ning├║n cambio de alto riesgo sin revisar

### 2. Verificar calidad
```bash
# Tests pasan
cd src && dotnet test

# Sin warnings cr├¡ticos
dotnet build 2>&1 | grep -i "warning"

# Security checks
# (Verificar ├║ltimo resultado de Semgrep en CI)
```

- [ ] Tests pasan (100%)
- [ ] Sin findings Critical/High en Semgrep
- [ ] Code review completado para todos los PRs

### 3. Verificar dependencias

- [ ] ┬┐Requiere migraci├│n de BD? ÔåÆ Ejecutar PROC-10 primero
- [ ] ┬┐Requiere cambio de configuraci├│n? ÔåÆ Preparar antes
- [ ] ┬┐Requiere coordinaci├│n con equipo externo? ÔåÆ Confirmar disponibilidad
- [ ] ┬┐Hay feature flags a activar/desactivar? ÔåÆ Documentar

### 4. Preparar rollback plan

| Escenario | Acci├│n |
|-----------|--------|
| Error cr├¡tico post-deploy | Rollback a tag anterior |
| Error en migraci├│n BD | Ejecutar script de rollback |
| Degradaci├│n de performance | Rollback + investigar |
```bash
# Tag actual (para rollback)
git describe --tags --abbrev=0
# Resultado: ___

# C├│mo hacer rollback
# git tag -f prod <commit-anterior>
# git push origin prod --force
```

- [ ] Rollback plan documentado
- [ ] Tag anterior identificado: ___

### 5. Definir ventana de deploy

| Campo | Valor |
|-------|-------|
| **Fecha/Hora** | |
| **Duraci├│n estimada** | |
| **Responsable del deploy** | |
| **Backup/Soporte** | |

**Ventanas recomendadas:**
- Martes a Jueves, 10:00-12:00 o 15:00-17:00
- Evitar: Lunes (post-weekend issues)
- Evitar: Viernes tarde (sin soporte fin de semana)
- Evitar: V├¡speras de festivos

- [ ] Ventana de deploy definida

### 6. Comunicar plan

**A equipo t├®cnico:**
```
Release [VERSION] programado para [FECHA] [HORA]

Cambios:
- [Lista de cambios principales]

Riesgos identificados:
- [Riesgo 1]: Mitigaci├│n X
- [Riesgo 2]: Mitigaci├│n Y

Rollback plan: Disponible

Responsable: [Nombre]
```

**A stakeholders (si Minor/Major):**
```
Asunto: [Release] Nueva versi├│n [VERSION] - [FECHA]

Resumen de cambios:
- [Feature/Fix 1]
- [Feature/Fix 2]

Impacto esperado:
- [Mejora X]
- [Cambio en comportamiento Y]

Ventana de deploy: [FECHA] [HORA] (duraci├│n estimada: X min)

Contacto: [Email/Slack]
```

- [ ] Equipo t├®cnico notificado
- [ ] Stakeholders notificados (si aplica)

### 7. Ejecutar deploy
```bash
# Verificar estado de CI
# (Pipeline debe estar verde en develop/main)

# Tag para producci├│n
git checkout main
git pull origin main
git tag -a v1.X.Y -m "Release v1.X.Y: [descripci├│n breve]"
git push origin v1.X.Y

# O tag para Portainer webhook
git tag -f prod
git push origin prod --force
```

- [ ] Tag creado
- [ ] Pipeline CI ejecutando
- [ ] Webhook de Portainer triggered

### 8. Verificaci├│n post-deploy
```bash
# Esperar a que el contenedor reinicie (~60s)
sleep 60

# Health check
curl https://bigcapi.dmi.es/health

# Smoke test MCP
curl -X POST https://bigcapi.dmi.es/mcp \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  | jq '.result.tools | length'

# Verificar versi├│n (si hay endpoint)
curl https://bigcapi.dmi.es/version
```

- [ ] Health check OK
- [ ] Smoke test OK
- [ ] N├║mero de tools correcto: ___

### 9. Monitoreo post-deploy (2h)
```bash
# Verificar Sentry cada 15-30 min
sentry-cli issues list --org dmi-hl --project apibigcommerce-mcp \
  --query "is:unresolved firstSeen:-2h"
```

| Tiempo | Errores nuevos | Acci├│n |
|--------|---------------|--------|
| +15min | | |
| +30min | | |
| +1h | | |
| +2h | | |

- [ ] 2h sin errores cr├¡ticos nuevos

### 10. Cerrar release

- [ ] Changelog actualizado en repo
- [ ] Release notes publicadas (si Minor/Major)
- [ ] Comunicaci├│n de ├®xito enviada
```
Release [VERSION] completado exitosamente

Deploy: [FECHA] [HORA]
Duraci├│n: X minutos
Errores: 0

Cambios deployados:
- [Lista]
```

## Checklist R├ípido para Hotfix

Para fixes cr├¡ticos, proceso abreviado:

- [ ] Fix en branch, PR aprobado
- [ ] Tests pasan
- [ ] Tag y deploy
- [ ] Verificaci├│n (health + smoke)
- [ ] Monitoreo 30min
- [ ] Comunicaci├│n post-deploy

## Troubleshooting

| S├¡ntoma | Causa | Acci├│n |
|---------|-------|--------|
| Pipeline falla | Test roto / build error | Fix y re-run |
| Webhook no responde | Portainer down | Deploy manual o contactar infra |
| Errores post-deploy | Bug en c├│digo nuevo | Evaluar rollback |
| Performance degradada | Query lenta / leak | Rollback + investigar |

## Resultado

- **├ëxito**: Deploy completado, 2h sin errores, comunicaci├│n enviada
- **Parcial**: Deploy completado con issues menores resueltos
- **Fallo**: Rollback ejecutado ÔåÆ Crear incidente (PROC-07)

## Mensaje de Finalizaci├│n

**IMPORTANTE - ACCI├ôN REQUERIDA AL FINALIZAR:**

Cuando hayas completado todos los pasos de este procedimiento, DEBES ejecutar el siguiente comando usando la herramienta Bash:

Ejecuta: `echo "====== PROCESO TERMINADO [$(date +%H%M%S)] ======" && echo "RESULTADO: Release vX.Y.Z planificado, X cambios, ventana definida"`

Sustituye vX.Y.Z y X por los valores reales.


---

## Output Estructurado (Nexus)

Al finalizar, el agente DEBE generar un bloque JSON con el siguiente formato para que Nexus pueda procesarlo automaticamente:

```json
{
  "result": "success",
  "summary": "Ejecucion de PROC-20 completada. [Descripcion breve de resultados]",
  "metrics": {
    "issues_found": 0,
    "issues_resolved": 0,
    "features_planned": 5, "bugs_fixed": 3,
    "custom": {
      "procedure_specific_metric": "value"
    }
  },
  "backlog_items": [
    {
      "title": "Titulo del item de seguimiento",
      "description": "Descripcion detallada si se requiere accion futura",
      "priority": "medium",
      "type": "improvement",
      "tags": ["proc-20"]
    }
  ],
  "next_steps": [
    "Accion recomendada 1",
    "Accion recomendada 2"
  ],
  "warnings": [
    "Advertencias encontradas durante la ejecucion"
  ]
}
```

**Campos requeridos:**
- `result`: `"success"` | `"partial"` | `"failed"`
- `summary`: Resumen ejecutivo en 1-3 lineas

**Metricas especificas de este procedure:**
- features_planned, bugs_fixed, breaking_changes

**Criterios de resultado:**
- `success`: Procedimiento completado sin errores criticos
- `partial`: Completado con algunos problemas menores o items pendientes
- `failed`: Error critico o no se pudo completar

## Historial de Releases

| Fecha | Versi├│n | Tipo | Cambios | Duraci├│n | Issues | Resultado |
|-------|---------|------|---------|----------|--------|-----------|
| | | | | | | |