Saltar a contenido

Sprint 01 — Onboarding + Catálogo de Productos

Instancia de sprint. Tracker activo del Sprint 1.

1. Datos del sprint

Campo Valor
Número 01
Objetivo Que un nuevo tenant pueda completar el wizard de onboarding, ver su suscripción y gestionar su catálogo de productos con stock por sucursal
Estado EN_PROGRESO — T4 cerrada (wizard onboarding), T5 pendiente (catálogo productos)
Tag git sprint-01

2. Tareas planificadas

Antes de pasar una tarea a EN_PROGRESO: completar su instancia en prompts/AGENT_TASK_TEMPLATE.md con contexto, alcance y criterios de aceptación. Sin eso, el agente improvisa.

# Tarea Agente Rama git Depende de Estado
1 app_suscripciones — modelo Suscripcion + FeatureFlag + validación en core_api Backend feat/suscripciones-feature-flags — CERRADA
2 app_empresas — wizard onboarding backend + CRUD Sucursal Backend feat/onboarding-sucursales T1 CERRADA
3 app_inventario — modelos Categoria, PlantillaRubro, AtributoConfig, Producto (JSONB), StockSucursal + APIs CRUD Backend feat/inventario-base T1 CERRADA
4 Frontend — wizard de onboarding (pantallas de configuración inicial del tenant) Frontend feat/frontend-onboarding T2 CERRADA
5 Frontend — catálogo de productos (listar, crear, editar, ver stock por sucursal) Frontend feat/frontend-catalogo T3 PENDIENTE

3. Agentes involucrados

  • Backend — T1, T2, T3
  • Frontend — T4, T5

4. Definition of Done — proceso

El sprint está completo cuando:

  • [ ] Todas las ramas mergeadas a main.
  • [ ] Todos los PRs aprobados con PR_CHECKLIST.md.
  • [ ] Tests ejecutados y sin regresiones.
  • [ ] Documentación actualizada: ARCHITECTURE.md, FOLDER_STRUCTURE.md, WORKFLOW.md según aplique.
  • [ ] Tag sprint-01 creado en main.
  • [ ] docs/PROJECT_STATUS.md actualizado.
  • [ ] docs/NEXT_ACTION.md actualizado.
  • [ ] Esta instancia marcada como CERRADO en SPRINT_INDEX.md.

5. Definition of Done — técnico

  • [ ] GET /api/suscripciones/mi-plan/ retorna el plan activo del tenant con JWT válido.
  • [ ] Un endpoint con feature flag bloqueado retorna 403 si el plan no lo habilita.
  • [ ] POST /api/empresas/onboarding/ completa el wizard y transiciona Empresa a WIZARD_COMPLETADO.
  • [ ] GET /api/empresas/sucursales/ lista solo las sucursales del tenant activo (aislamiento multi-tenant verificado).
  • [ ] POST /api/inventario/productos/ crea un producto con especificaciones JSONB validado contra PlantillaRubro.
  • [ ] GET /api/inventario/productos/ retorna productos con stock de la sucursal activa.
  • [ ] GET /api/inventario/stock/?sucursal=X filtra por sucursal y respeta el scope del rol.
  • [ ] Usuario de otro tenant no puede ver productos ni stock de este tenant (403 o 404).
  • [ ] Tests de permisos: sin login 401, rol insuficiente 403, tenant ajeno 403/404.
  • [ ] Frontend onboarding: el wizard completa el flujo sin errores y redirige al dashboard.
  • [ ] Frontend catálogo: se pueden listar, crear y editar productos desde la UI.

6. Resumen de cierre

Completar solo al cerrar el sprint.

Completado

  • (pendiente)

Pendiente / movido al backlog

  • (pendiente)

Decisiones tomadas

  • (pendiente)

Estado de salida

SPRINT_01_STATUS: EN_PROGRESO