erp-core/docs/02-fase-core-business

Fase 02: Core Business

Proyecto: ERP Core Fecha: 2025-12-05 Story Points Total: 192 SP Estado: US Documentadas

---

Descripcion

La Fase Core Business contiene los modulos de negocio genericos reutilizables por todas las verticales del ERP. Incluye catalogos, configuraciones, auditoria, notificaciones, reportes y la base financiera.

---

Modulos de esta Fase

ID	Nombre	SP	RF	ET	US	Estado	Descripcion
MGN-005	Catalogs	29	5	3	5	US Ready	Catalogos maestros genericos
MGN-006	Settings	26	4	3	4	US Ready	Configuraciones del sistema
MGN-007	Audit	30	4	3	4	US Ready	Auditoria y logs
MGN-008	Notifications	25	4	3	4	US Ready	Sistema de notificaciones
MGN-009	Reports	36	4	3	4	US Ready	Reportes y dashboards
MGN-010	Financial	46	4	3	4	US Ready	Base financiera

Total: 192 SP | 25 RF | 18 ET | 25 US

---

Metricas Consolidadas

Metrica	Valor
Modulos	6
Requerimientos (RF)	25
Especificaciones (ET)	18
- Database	6
- Backend	6
- Frontend	6
Historias de Usuario (US)	25
Story Points	192
Tablas Database	42
Endpoints API	95+
Sprints Estimados	4 (Sprint 4-7)

---

Resumen de User Stories por Modulo

MGN-005: Catalogs (5 US, 29 SP)

US	Titulo	SP	Sprint
US-MGN005-001	Gestionar Contactos	8	Sprint 4
US-MGN005-002	Consultar Paises y Estados	3	Sprint 4
US-MGN005-003	Gestionar Monedas y TC	8	Sprint 4
US-MGN005-004	Gestionar Unidades de Medida	5	Sprint 4
US-MGN005-005	Gestionar Categorias Jerarquicas	5	Sprint 4

MGN-006: Settings (4 US, 26 SP)

US	Titulo	SP	Sprint
US-MGN006-001	Configuraciones del Sistema	5	Sprint 4
US-MGN006-002	Configuraciones del Tenant	8	Sprint 4
US-MGN006-003	Preferencias de Usuario	5	Sprint 4
US-MGN006-004	Feature Flags	8	Sprint 4

MGN-007: Audit (4 US, 30 SP)

US	Titulo	SP	Sprint
US-MGN007-001	Audit Trail de Entidades	8	Sprint 5
US-MGN007-002	Logs de Acceso	8	Sprint 5
US-MGN007-003	Eventos de Seguridad	8	Sprint 5
US-MGN007-004	Reportes de Auditoria	6	Sprint 5

MGN-008: Notifications (4 US, 25 SP)

US	Titulo	SP	Sprint
US-MGN008-001	Notificaciones In-App	8	Sprint 5
US-MGN008-002	Notificaciones por Email	8	Sprint 5
US-MGN008-003	Push Notifications	5	Sprint 5
US-MGN008-004	Preferencias de Notificacion	4	Sprint 5

MGN-009: Reports (4 US, 36 SP)

US	Titulo	SP	Sprint
US-MGN009-001	Reportes Predefinidos	10	Sprint 6
US-MGN009-002	Dashboards y Widgets	13	Sprint 6
US-MGN009-003	Report Builder	8	Sprint 6
US-MGN009-004	Reportes Programados	5	Sprint 6

MGN-010: Financial (4 US, 46 SP)

US	Titulo	SP	Sprint
US-MGN010-001	Plan de Cuentas	13	Sprint 7
US-MGN010-002	Monedas y Tipos de Cambio	10	Sprint 7
US-MGN010-003	Periodos Contables	10	Sprint 7
US-MGN010-004	Asientos Contables	13	Sprint 7

---

Especificaciones Tecnicas por Modulo

MGN-005: Catalogs

ET	Archivo	Descripcion
Database	ET-CATALOG-database.md	7 tablas: contacts, addresses, countries, currencies, etc.
Backend	ET-CATALOG-backend.md	5 servicios, 25+ endpoints
Frontend	ET-CATALOG-frontend.md	Componentes UI

MGN-006: Settings

ET	Archivo	Descripcion
Database	ET-SETTINGS-database.md	6 tablas: system_settings, tenant_settings, etc.
Backend	ET-SETTINGS-backend.md	4 servicios, configuracion jerarquica
Frontend	ET-SETTINGS-frontend.md	UI de configuracion

MGN-007: Audit

ET	Archivo	Descripcion
Database	ET-AUDIT-database.md	6 tablas con particionamiento
Backend	ET-AUDIT-backend.md	TypeORM subscriber, interceptors
Frontend	ET-AUDIT-frontend.md	Log viewer, filtros avanzados, exportacion

MGN-008: Notifications

ET	Archivo	Descripcion
Database	ET-NOTIF-database.md	6 tablas: notifications, email_templates, etc.
Backend	ET-NOTIF-backend.md	WebSocket gateway, Bull processors
Frontend	ET-NOTIF-frontend.md	NotificationCenter, WebSocket, Push API

MGN-009: Reports

ET	Archivo	Descripcion
Database	ET-REPORT-database.md	7 tablas: report_definitions, dashboards, etc.
Backend	ET-REPORT-backend.md	ReportBuilder, exportacion multi-formato
Frontend	ET-REPORT-frontend.md	Dashboard grid, Chart.js, Report Builder

MGN-010: Financial

ET	Archivo	Descripcion
Database	ET-FIN-database.md	10 tablas: accounts, journal_entries, etc.
Backend	ET-FIN-backend.md	JournalService, validaciones contables
Frontend	ET-FIN-frontend.md	Account tree, Journal form, Decimal.js

---

Arquitectura de la Fase

                    ┌─────────────────────────────────────────┐
                    │           FASE 01: FOUNDATION           │
                    │  (Auth, Users, Roles, Tenants)          │
                    └─────────────────┬───────────────────────┘
                                      │
        ┌─────────────────────────────┼─────────────────────────────┐
        │                             │                             │
        ▼                             ▼                             ▼
┌───────────────────┐     ┌───────────────────┐     ┌───────────────────┐
│  MGN-005 CATALOGS │     │  MGN-006 SETTINGS │     │   MGN-007 AUDIT   │
│                   │     │                   │     │                   │
│ - Contactos       │     │ - System Config   │     │ - Audit Trail     │
│ - Paises/Estados  │     │ - Tenant Config   │     │ - Access Logs     │
│ - Monedas         │     │ - User Prefs      │     │ - Security Events │
│ - UoM             │     │ - Feature Flags   │     │ - Reports         │
│ - Categorias      │     │                   │     │                   │
└─────────┬─────────┘     └─────────┬─────────┘     └─────────┬─────────┘
          │                         │                         │
          └─────────────────────────┼─────────────────────────┘
                                    │
        ┌───────────────────────────┼───────────────────────────┐
        │                           │                           │
        ▼                           ▼                           ▼
┌───────────────────┐   ┌───────────────────┐   ┌───────────────────┐
│ MGN-008 NOTIF     │   │ MGN-009 REPORTS   │   │ MGN-010 FINANCIAL │
│                   │   │                   │   │                   │
│ - In-App          │   │ - Predefinidos    │   │ - Plan Cuentas    │
│ - Email           │   │ - Dashboards      │   │ - Monedas/TC      │
│ - Push            │   │ - Builder         │   │ - Periodos        │
│ - Preferencias    │   │ - Programados     │   │ - Asientos        │
└───────────────────┘   └───────────────────┘   └───────────────────┘
                                                          │
                                                          ▼
                                            ┌───────────────────────┐
                                            │      VERTICALES       │
                                            │ (Facturacion, CxC,    │
                                            │  CxP, Tesoreria...)   │
                                            └───────────────────────┘

---

Roadmap de Sprints

Sprint	Modulos	SP	Descripcion
Sprint 4	MGN-005, MGN-006	55	Catalogos y Configuraciones
Sprint 5	MGN-007, MGN-008	55	Auditoria y Notificaciones
Sprint 6	MGN-009	36	Reportes y Dashboards
Sprint 7	MGN-010	46	Base Financiera

---

Estructura GAMILIT por Modulo

MGN-XXX-{nombre}/
├── _MAP.md                      # Indice del modulo
├── README.md                    # Descripcion
├── requerimientos/              # RF documentados
│   ├── INDICE-RF-XXX.md         # Indice de RF
│   └── RF-XXX-NNN.md            # Requerimiento individual
├── especificaciones/            # ET documentadas
│   ├── INDICE-ET-XXX.md         # Indice de ET
│   ├── ET-XXX-database.md       # Modelo de datos
│   ├── ET-XXX-backend.md        # Servicios y API
│   └── ET-XXX-frontend.md       # Componentes UI
├── historias-usuario/           # US documentadas
│   ├── INDICE-US-XXX.md         # Indice de US
│   └── US-MGNXXX-NNN.md         # Historia individual
└── implementacion/
    └── TRACEABILITY.yml         # Trazabilidad RF->Codigo

---

Criterios de Completitud de Fase

Documentacion

• RF documentados para todos los modulos (25/25)
• ET documentadas para todos los modulos (18/18)
  • Database: 6, Backend: 6, Frontend: 6
• US documentadas con criterios de aceptacion (25/25)

Implementacion

• MGN-005 Catalogs: Implementado
• MGN-006 Settings: Implementado
• MGN-007 Audit: Implementado
• MGN-008 Notifications: Implementado
• MGN-009 Reports: Implementado
• MGN-010 Financial: Implementado

Calidad

• Integracion entre modulos verificada
• Tests con coverage > 80%
• Documentacion 100% actualizada

---

Proximos Pasos

1. Documentar RF para todos los modulos ✅
2. Crear ET para todos los modulos ✅
3. Definir US con criterios de aceptacion ✅
4. Crear ET Frontend para todos los modulos ✅
5. Actualizar TRACEABILITY.yml con rutas finales post-implementacion
6. Iniciar implementacion Sprint 4

---

Documentos Relacionados

• MASTER_INVENTORY.yml
• TRACEABILITY_MATRIX.yml
• DEPENDENCY_GRAPH.yml
• Fase 01 Foundation

---

Generado por: Requirements-Analyst Fecha: 2025-12-05 Version: 4.0 - RF + ET + ET Frontend + US Documentados