Module Base – Plan de tareas

Convención: tareas trazables a requisitos y diseño. Alcance: entregar contratos/servicios/infra mínima con pruebas y docs.

Desglose de trabajo (WBS)

Épica: Fundamentos de Module Base

• T-001 Contratos y modelos

  • Desc: Definir BrowserModuleContract, ModuleManifest, modelos básicos y eventos/estados.
  • Cobertura: R-001, R-008; US-001. Diseño: contratos, secc. “Contratos y modelos”.
  • Dependencias: ninguna.
  • DoD: tipos exportados desde src/lib/contracts/*, tests unit; build y lint verdes.
  • Estimación: M. Rol: FE core.

• T-002 Decorador y auto‑registro

  • Desc: Implementar @ModuleDecorator y ModuleDiscoveryService para auto‑registro en ModuleRegistryService.
  • Cobertura: R-002, R-004; US-001. Diseño: Registry/Discovery.
  • Dependencias: T-001.
  • DoD: módulo de ejemplo de prueba aparece en el registry al inicializar test; eventos/logs emitidos.
  • Estimación: M. Rol: FE core.

• T-003 Configuración directa y servicios de configuración

  • Desc: Agregar método configure(config) y ModuleConfigurationService/ModuleConfigService para obtener config por tenant.
  • Cobertura: R-003, R-004, R-005; US-002. Diseño: Configuration services.
  • Dependencias: T-001, T-002.
  • DoD: test integra security stub; enabled activa módulo; permisos validados.
  • Estimación: M. Rol: FE core.

• T-004 Estado base y acciones

  • Desc: BaseModuleState, ModuleStateService, selectores base, integración con Action Registry.
  • Cobertura: R-006; US-003. Diseño: estado/acciones.
  • Dependencias: T-001.
  • DoD: tests unit; señales funcionando; NGXS opcional con guardas para tree‑shaking.
  • Estimación: M. Rol: FE core.

• T-005 Componentes base standalone

  • Desc: BaseModuleComponent, ModuleLayoutComponent, ModuleRouterOutlet, ComponentBase.
  • Cobertura: R-007. Diseño: componentes base.
  • Dependencias: T-001, T-004.
  • DoD: build ok, tests mínimos (render/snapshot), sin estilos complejos.
  • Estimación: S. Rol: FE core.

• T-006 Observabilidad de ciclo de vida

  • Desc: Integrar @libs-core/event-system y @libs-core/log-system para eventos y logs.
  • Cobertura: R-008; US-001/US-002/US-003. Diseño: EventBus + Logger.
  • Dependencias: T-002, T-003.
  • DoD: eventos ModuleRegistered/Activated/Failed; logs con metadata tenant.
  • Estimación: S. Rol: FE core.

• T-007 Pruebas y calidad (NFR)

  • Desc: suite unitaria e integración; coverage thresholds; lint/format/CI config.
  • Cobertura: NFR-01..05 y todos los R asociados.
  • Dependencias: T-001..T-006.
  • DoD: ≥90% unit y ≥85% integración; checks CI verdes.
  • Estimación: M. Rol: QA/FE core.

• T-008 Documentación y ejemplos mínimos

  • Desc: actualizar README y ejemplos de uso básicos (sin implementar negocio).
  • Cobertura: todos; referencia cruzada a requirements/design/tasks.
  • Dependencias: T-001..T-006.
  • DoD: docs actualizadas y enlazadas; nx build/lint/test verdes.
  • Estimación: S. Rol: FE core.

Secuenciación y hitos

• Milestone 1 (Fundamentos): T-001, T-002, T-003.
• Milestone 2 (Estado/Acciones/Componentes): T-004, T-005.
• Milestone 3 (Observabilidad + Calidad + Docs): T-006, T-007, T-008.

Quality gates

• Lint (eslint), Build (nx build), Tests (unit+integration), e2e mínimo, docs enlazadas.

Riesgos operativos y rollback

• Si falla Discovery o Config, deshabilitar auto‑registro (flag) y activar registro manual temporal.
• Rollback: revertir versión de librería; feature flags por tenant en configuración.

Enlaces: requirements.md · design.md