erp-core/docs/01-fase-foundation/README.md

120 lines
3.1 KiB
Markdown

# Fase 01: Foundation
**Proyecto:** ERP Core
**Fecha:** 2025-12-05
**Story Points Total:** 150 SP
**Estado:** Migrado GAMILIT
---
## Descripcion
La Fase Foundation establece los cimientos del sistema ERP. Incluye los modulos criticos de autenticacion, usuarios, roles/permisos y multi-tenancy que son requeridos por todos los demas modulos del sistema.
---
## Modulos de esta Fase
| ID | Nombre | SP | Prioridad | Estado | Descripcion |
|----|--------|---:|-----------|--------|-------------|
| [MGN-001](./MGN-001-auth/) | Autenticacion | 40 | P0 | Migrado | JWT, OAuth, sessions, password recovery |
| [MGN-002](./MGN-002-users/) | Usuarios | 35 | P0 | Migrado | CRUD usuarios, perfiles, preferencias |
| [MGN-003](./MGN-003-roles/) | Roles/RBAC | 40 | P0 | Migrado | Roles, permisos, guards, decoradores |
| [MGN-004](./MGN-004-tenants/) | Multi-tenant | 35 | P0 | Migrado | Tenants, RLS, planes, suscripciones |
**Total:** 150 SP
---
## Metricas Consolidadas
| Metrica | Valor |
|---------|-------|
| Modulos | 4 |
| Requerimientos (RF) | 18 |
| Especificaciones (ET) | 9 |
| Historias de Usuario (US) | 16 |
| Tablas Database | 24 |
| Endpoints API | 56 |
---
## Estructura GAMILIT por Modulo
```
MGN-XXX-{nombre}/
├── _MAP.md # Indice del modulo
├── README.md # Descripcion
├── requerimientos/ # RF migrados
├── especificaciones/ # ET migradas
├── historias-usuario/ # US migradas
└── implementacion/
└── TRACEABILITY.yml # Trazabilidad RF->Codigo
```
---
## Orden de Implementacion
```
MGN-001 (Auth)
MGN-002 (Users)
MGN-003 (Roles)
MGN-004 (Tenants)
```
Los modulos deben implementarse en este orden debido a las dependencias entre ellos.
---
## Criterios de Completitud de Fase
- [ ] MGN-001 Auth: Implementado y testeado (>80% coverage)
- [ ] MGN-002 Users: Implementado y testeado (>80% coverage)
- [ ] MGN-003 Roles: Implementado y testeado (>80% coverage)
- [ ] MGN-004 Tenants: Implementado y testeado (>80% coverage)
- [ ] Integracion entre modulos verificada
- [ ] E2E tests de flujos criticos pasando
- [ ] Documentacion actualizada
---
## Metricas Objetivo
| Metrica | Objetivo |
|---------|----------|
| Unit Test Coverage | > 80% |
| Integration Tests | Todos pasando |
| E2E Tests | Flujos criticos cubiertos |
| Documentacion | 100% actualizada |
| Code Review | 100% revisado |
---
## Riesgos
| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Complejidad JWT | Media | Alto | Usar librerias probadas |
| Multi-tenancy bugs | Media | Alto | Tests exhaustivos de RLS |
| Performance auth | Baja | Alto | Caching de tokens |
---
## Documentos Relacionados
- [MASTER_INVENTORY.yml](../../orchestration/inventarios/MASTER_INVENTORY.yml)
- [DEPENDENCY_GRAPH.yml](../../orchestration/inventarios/DEPENDENCY_GRAPH.yml)
- [TRACEABILITY_MATRIX.yml](../../orchestration/inventarios/TRACEABILITY_MATRIX.yml)
---
**Generado por:** Requirements-Analyst
**Fecha:** 2025-12-05