workspace-v1/orchestration/templates/scrum/TEMPLATE-TASK-DEVENV.md

TEMPLATE: Tarea DevEnv - Configuracion de Entorno

Version: 1.0.0 Fecha: 2026-01-04 Perfil Asignado: @PERFIL_DEVENV Tipo: Tarea Tecnica

---

INSTRUCCIONES DE USO

Este template se usa para crear tareas de configuracion de entorno de desarrollo. Reemplazar los placeholders {...} con valores reales.

---

TASK-DEVENV-{PROYECTO}-{SPRINT}

Metadata

id: "TASK-DEVENV-{PROYECTO}-{SPRINT}"
tipo: "Tarea Tecnica"
perfil: "@PERFIL_DEVENV"
proyecto: "{PROYECTO}"
sprint: "{SPRINT}"
prioridad: "Alta"
estimacion: "2-4 horas"
bloquea:
  - "Tareas de desarrollo del sprint"
bloqueado_por: []

Descripcion

Configurar y documentar el entorno de desarrollo para el proyecto {PROYECTO}.

Esta tarea incluye:

• Inventariar herramientas y versiones requeridas
• Asignar puertos sin conflictos con otros proyectos
• Definir nombre de base de datos y usuario
• Documentar variables de entorno
• Crear archivos de configuracion

Contexto

proyecto: "{PROYECTO}"
nivel: "{NIVEL_2A | NIVEL_2B | NIVEL_2B.x}"
tipo_proyecto: "{standalone | suite | vertical}"
stack:
  backend: "{NestJS | Express | FastAPI | ...}"
  frontend: "{React | Vue | Next.js | ...}"
  database: "{PostgreSQL | MySQL | MongoDB | ...}"

Entregables

• orchestration/environment/ENVIRONMENT-INVENTORY.yml - Inventario completo
• .env.example - Variables de entorno documentadas
• .env.ports - Puertos asignados
• Registro en orchestration/inventarios/DEVENV-MASTER-INVENTORY.yml (workspace)
• Registro en orchestration/inventarios/DEVENV-PORTS-INVENTORY.yml (workspace)

Criterios de Aceptacion

Inventario Completo

• Herramientas listadas con versiones (Node, Python, etc.)
• Servicios documentados (backend, frontend, workers)
• Base de datos documentada (nombre, usuario, puerto)
• Dependencias de sistema documentadas

Puertos Asignados

• Puerto de frontend asignado del rango correspondiente
• Puerto de backend asignado del rango correspondiente
• Puertos adicionales asignados si aplica
• Sin conflictos con otros proyectos (verificado en DEVENV-PORTS-INVENTORY)

Base de Datos

• Nombre de BD definido segun convencion: {proyecto}_{ambiente}
• Usuario de BD definido segun convencion: {proyecto}_dev
• Schemas documentados si aplica

Variables de Entorno

• .env.example con todas las variables requeridas
• Descripcion de cada variable
• Valores de ejemplo (no secretos reales)
• Variables sensibles marcadas

Configuracion Docker (si aplica)

• docker-compose.yml funcional
• Volumes documentados
• Networks definidos

Documentacion

• Instrucciones de setup en README o docs/
• Pasos para levantar entorno local
• Troubleshooting comun

Pasos de Ejecucion

paso_1:
  nombre: "Cargar contexto"
  acciones:
    - "Leer DEVENV-MASTER-INVENTORY.yml"
    - "Leer DEVENV-PORTS-INVENTORY.yml"
    - "Identificar rango de puertos disponible"

paso_2:
  nombre: "Inventariar herramientas"
  acciones:
    - "Identificar runtime (Node version, Python version)"
    - "Listar frameworks (NestJS, React, etc.)"
    - "Documentar herramientas de build"
    - "Listar testing frameworks"

paso_3:
  nombre: "Asignar puertos"
  acciones:
    - "Seleccionar puertos del rango asignado"
    - "Verificar no hay conflictos"
    - "Documentar en .env.ports"

paso_4:
  nombre: "Configurar base de datos"
  acciones:
    - "Definir nombre: {proyecto}_{ambiente}"
    - "Definir usuario: {proyecto}_dev"
    - "Documentar schemas si aplica"

paso_5:
  nombre: "Crear .env.example"
  acciones:
    - "Listar todas las variables requeridas"
    - "Agregar descripciones"
    - "Incluir valores de ejemplo"

paso_6:
  nombre: "Crear ENVIRONMENT-INVENTORY.yml"
  acciones:
    - "Usar template TEMPLATE-ENVIRONMENT-INVENTORY.yml"
    - "Completar todas las secciones"
    - "Guardar en orchestration/environment/"

paso_7:
  nombre: "Actualizar inventarios de workspace"
  acciones:
    - "Agregar proyecto a DEVENV-MASTER-INVENTORY.yml"
    - "Registrar puertos en DEVENV-PORTS-INVENTORY.yml"

paso_8:
  nombre: "Validar"
  acciones:
    - "Verificar no hay conflictos de puertos"
    - "Verificar nombres de BD unicos"
    - "Probar que entorno levanta correctamente"

Notas

{Agregar notas especificas del proyecto aqui}

---

EJEMPLO COMPLETADO

# Ejemplo para proyecto "gamilit"

id: "TASK-DEVENV-GAMILIT-S0"
proyecto: "gamilit"
sprint: "Sprint 0"

puertos_asignados:
  frontend: 3005
  backend: 3006
  storybook: 3007

base_de_datos:
  nombre: "gamilit_development"
  usuario: "gamilit_dev"
  puerto: 5432

herramientas:
  node: "20.x"
  npm: "10.x"
  postgresql: "15"

entregables_completados:
  - "projects/gamilit/orchestration/environment/ENVIRONMENT-INVENTORY.yml"
  - "projects/gamilit/apps/backend/.env.example"
  - "projects/gamilit/.env.ports"

---

Template creado por: @PERFIL_DEVENV Sistema: NEXUS v3.4 + SIMCO