erp-core/docs/04-modelado/requerimientos-funcionales/README.md

356 lines
15 KiB
Markdown

# REQUERIMIENTOS FUNCIONALES (RF) - ERP GENÉRICO
**Fecha:** 2025-11-23
**Versión:** 1.0
**Total RF:** 80
**Total Story Points:** 673 SP
---
## Resumen Ejecutivo
Este directorio contiene los 80 Requerimientos Funcionales (RF) del ERP Genérico, organizados en 14 módulos (MGN-001 a MGN-014). Cada RF documenta:
- Descripción y alcance funcional
- Actores involucrados
- Flujos principales y alternativos
- Reglas de negocio
- Criterios de aceptación
- Entidades de base de datos involucradas
- Referencias cruzadas (alcance, domain models, schemas, gaps)
- Dependencias entre RF
---
## Resumen por Módulo
| Módulo | Nombre | RF | Story Points | Prioridad |
|--------|--------|-----|--------------|-----------|
| MGN-001 | Fundamentos | 8 | 68 SP | P0 (MVP) |
| MGN-002 | Empresas y Organizaciones | 5 | 34 SP | P0 (MVP) |
| MGN-003 | Catálogos Maestros | 6 | 29 SP | P0 (MVP) |
| MGN-004 | Financiero Básico | 8 | 81 SP | P0 (MVP) |
| MGN-005 | Inventario Básico | 7 | 66 SP | P0 (MVP) |
| MGN-006 | Compras Básico | 6 | 42 SP | P0/P1 |
| MGN-007 | Ventas Básico | 6 | 45 SP | P0 (MVP) |
| MGN-008 | Contabilidad Analítica | 5 | 35 SP | P0 (MVP) |
| MGN-009 | CRM Básico | 5 | 31 SP | P1 |
| MGN-010 | RRHH Básico | 5 | 29 SP | P1 |
| MGN-011 | Proyectos Genéricos | 5 | 40 SP | P1 |
| MGN-012 | Reportes y Analytics | 4 | 39 SP | P1 |
| MGN-013 | Portal de Usuarios | 4 | 29 SP | P1 |
| MGN-014 | Mensajería y Notificaciones | 6 | 47 SP | P0 (MVP) |
| **TOTAL** | **14 módulos** | **80** | **673 SP** | - |
---
## Distribución por Prioridad
| Prioridad | RF | Story Points | % Total | Descripción |
|-----------|-----|--------------|---------|-------------|
| **P0 (MVP)** | 52 | 462 SP | 69% | Funcionalidades esenciales para MVP |
| **P1 (Post-MVP)** | 23 | 169 SP | 25% | Funcionalidades importantes, no críticas |
| **P2 (Futuro)** | 5 | 42 SP | 6% | Funcionalidades avanzadas |
| **TOTAL** | **80** | **673 SP** | **100%** | - |
---
## Índice de Requerimientos Funcionales
### MGN-001: Fundamentos (68 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-001-001: Autenticación de Usuarios](mgn-001/RF-MGN-001-001-autenticacion-usuarios.md) - 8 SP - P0
2. [RF-MGN-001-002: Gestión de Roles y Permisos (RBAC)](mgn-001/RF-MGN-001-002-gestion-roles.md) - 13 SP - P0
3. [RF-MGN-001-003: Gestión de Usuarios](mgn-001/RF-MGN-001-003-gestion-usuarios.md) - 8 SP - P0
4. [RF-MGN-001-004: Multi-Tenancy con Schema-Level Isolation](mgn-001/RF-MGN-001-004-multi-tenancy.md) - 13 SP - P0
5. [RF-MGN-001-005: Reset de Contraseña](mgn-001/RF-MGN-001-005-reset-password.md) - 5 SP - P0
6. [RF-MGN-001-006: Registro de Usuarios (Signup)](mgn-001/RF-MGN-001-006-registro-usuarios.md) - 5 SP - P1
7. [RF-MGN-001-007: Gestión de Sesiones](mgn-001/RF-MGN-001-007-session-management.md) - 5 SP - P0
8. [RF-MGN-001-008: Record Rules (Row Level Security)](mgn-001/RF-MGN-001-008-record-rules-rls.md) - 13 SP - P1
---
### MGN-002: Empresas y Organizaciones (34 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-002-001: Gestión de Empresas](mgn-002/RF-MGN-002-001-gestion-empresas.md) - 8 SP - P0
2. [RF-MGN-002-002: Configuración de Empresa](mgn-002/RF-MGN-002-002-configuracion-empresa.md) - 5 SP - P0
3. [RF-MGN-002-003: Asignación de Usuarios a Empresas (Multi-Empresa)](mgn-002/RF-MGN-002-003-asignacion-usuarios-empresas.md) - 8 SP - P0
4. [RF-MGN-002-004: Jerarquías de Empresas (Holdings)](mgn-002/RF-MGN-002-004-jerarquias-empresas.md) - 5 SP - P1
5. [RF-MGN-002-005: Plantillas de Configuración por País](mgn-002/RF-MGN-002-005-plantillas-configuracion.md) - 8 SP - P1
---
### MGN-003: Catálogos Maestros (29 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-003-001: Gestión de Partners Universales](mgn-003/RF-MGN-003-001-gestion-partners.md) - 8 SP - P0
2. [RF-MGN-003-002: Gestión de Países y Regiones](mgn-003/RF-MGN-003-002-gestión-de-países-y-regiones.md) - 3 SP - P0
3. [RF-MGN-003-003: Gestión de Monedas y Tasas de Cambio](mgn-003/RF-MGN-003-003-gestión-de-monedas-y-tasas-de-cambio.md) - 5 SP - P0
4. [RF-MGN-003-004: Gestión de Unidades de Medida (UoM)](mgn-003/RF-MGN-003-004-gestión-de-unidades-de-medida-uom.md) - 5 SP - P0
5. [RF-MGN-003-005: Gestión de Categorías de Productos](mgn-003/RF-MGN-003-005-gestión-de-categorías-de-productos.md) - 3 SP - P0
6. [RF-MGN-003-006: Condiciones de Pago (Payment Terms)](mgn-003/RF-MGN-003-006-condiciones-de-pago-payment-terms.md) - 5 SP - P0
---
### MGN-004: Financiero Básico (81 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-004-001: Gestión de Plan de Cuentas](mgn-004/RF-MGN-004-001-gestión-de-plan-de-cuentas.md) - 8 SP - P0
2. [RF-MGN-004-002: Gestión de Journals Contables](mgn-004/RF-MGN-004-002-gestión-de-journals-contables.md) - 5 SP - P0
3. [RF-MGN-004-003: Registro de Asientos Contables](mgn-004/RF-MGN-004-003-registro-de-asientos-contables.md) - 13 SP - P0
4. [RF-MGN-004-004: Gestión de Impuestos](mgn-004/RF-MGN-004-004-gestión-de-impuestos.md) - 8 SP - P0
5. [RF-MGN-004-005: Gestión de Facturas de Cliente](mgn-004/RF-MGN-004-005-gestión-de-facturas-de-cliente.md) - 13 SP - P0
6. [RF-MGN-004-006: Gestión de Facturas de Proveedor](mgn-004/RF-MGN-004-006-gestión-de-facturas-de-proveedor.md) - 13 SP - P0
7. [RF-MGN-004-007: Gestión de Pagos y Conciliación](mgn-004/RF-MGN-004-007-gestión-de-pagos-y-conciliación.md) - 13 SP - P0
8. [RF-MGN-004-008: Reportes Financieros (Balance y P&L)](mgn-004/RF-MGN-004-008-reportes-financieros-balance-y-p&l.md) - 8 SP - P0
---
### MGN-005: Inventario Básico (66 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-005-001: Gestión de Productos](mgn-005/RF-MGN-005-001-gestión-de-productos.md) - 8 SP - P0
2. [RF-MGN-005-002: Gestión de Almacenes y Ubicaciones](mgn-005/RF-MGN-005-002-gestión-de-almacenes-y-ubicaciones.md) - 8 SP - P0
3. [RF-MGN-005-003: Movimientos de Stock](mgn-005/RF-MGN-005-003-movimientos-de-stock.md) - 13 SP - P0
4. [RF-MGN-005-004: Pickings (Albaranes de Entrada/Salida)](mgn-005/RF-MGN-005-004-pickings-albaranes-de-entrada-salida.md) - 8 SP - P0
5. [RF-MGN-005-005: Trazabilidad (Lotes y Números de Serie)](mgn-005/RF-MGN-005-005-trazabilidad-lotes-y-números-de-serie.md) - 8 SP - P1
6. [RF-MGN-005-006: Valoración de Inventario (FIFO, Promedio)](mgn-005/RF-MGN-005-006-valoración-de-inventario-fifo,-promedio.md) - 13 SP - P0
7. [RF-MGN-005-007: Inventario Físico y Ajustes](mgn-005/RF-MGN-005-007-inventario-físico-y-ajustes.md) - 8 SP - P0
---
### MGN-006: Compras Básico (42 SP)
**Core Phase - P0/P1**
1. [RF-MGN-006-001: Solicitudes de Cotización (RFQ)](mgn-006/RF-MGN-006-001-solicitudes-de-cotización-rfq.md) - 5 SP - P1
2. [RF-MGN-006-002: Gestión de Órdenes de Compra](mgn-006/RF-MGN-006-002-gestión-de-órdenes-de-compra.md) - 13 SP - P0
3. [RF-MGN-006-003: Workflow de Aprobación de Compras](mgn-006/RF-MGN-006-003-workflow-de-aprobación-de-compras.md) - 5 SP - P1
4. [RF-MGN-006-004: Recepciones de Compras](mgn-006/RF-MGN-006-004-recepciones-de-compras.md) - 8 SP - P0
5. [RF-MGN-006-005: Facturación de Proveedores desde Compras](mgn-006/RF-MGN-006-005-facturación-de-proveedores-desde-compras.md) - 8 SP - P0
6. [RF-MGN-006-006: Reportes de Compras](mgn-006/RF-MGN-006-006-reportes-de-compras.md) - 3 SP - P1
---
### MGN-007: Ventas Básico (45 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-007-001: Gestión de Cotizaciones](mgn-007/RF-MGN-007-001-gestión-de-cotizaciones.md) - 8 SP - P0
2. [RF-MGN-007-002: Conversión a Órdenes de Venta](mgn-007/RF-MGN-007-002-conversión-a-órdenes-de-venta.md) - 5 SP - P0
3. [RF-MGN-007-003: Gestión de Órdenes de Venta](mgn-007/RF-MGN-007-003-gestión-de-órdenes-de-venta.md) - 13 SP - P0
4. [RF-MGN-007-004: Entregas de Ventas](mgn-007/RF-MGN-007-004-entregas-de-ventas.md) - 8 SP - P0
5. [RF-MGN-007-005: Facturación de Clientes desde Ventas](mgn-007/RF-MGN-007-005-facturación-de-clientes-desde-ventas.md) - 8 SP - P0
6. [RF-MGN-007-006: Reportes de Ventas](mgn-007/RF-MGN-007-006-reportes-de-ventas.md) - 3 SP - P1
---
### MGN-008: Contabilidad Analítica (35 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-008-001: Gestión de Cuentas Analíticas](mgn-008/RF-MGN-008-001-gestión-de-cuentas-analíticas.md) - 8 SP - P0
2. [RF-MGN-008-002: Registro de Líneas Analíticas](mgn-008/RF-MGN-008-002-registro-de-líneas-analíticas.md) - 8 SP - P0
3. [RF-MGN-008-003: Distribución Analítica Multi-Cuenta](mgn-008/RF-MGN-008-003-distribución-analítica-multi-cuenta.md) - 8 SP - P1
4. [RF-MGN-008-004: Tags Analíticos](mgn-008/RF-MGN-008-004-tags-analíticos.md) - 3 SP - P1
5. [RF-MGN-008-005: Reportes Analíticos (P&L por Proyecto)](mgn-008/RF-MGN-008-005-reportes-analíticos-p&l-por-proyecto.md) - 8 SP - P0
---
### MGN-009: CRM Básico (31 SP)
**Complementary Phase - P1**
1. [RF-MGN-009-001: Gestión de Leads y Oportunidades](mgn-009/RF-MGN-009-001-gestión-de-leads-y-oportunidades.md) - 8 SP - P1
2. [RF-MGN-009-002: Pipeline de Ventas (Kanban)](mgn-009/RF-MGN-009-002-pipeline-de-ventas-kanban.md) - 8 SP - P1
3. [RF-MGN-009-003: Actividades y Seguimiento](mgn-009/RF-MGN-009-003-actividades-y-seguimiento.md) - 5 SP - P1
4. [RF-MGN-009-004: Lead Scoring y Calificación](mgn-009/RF-MGN-009-004-lead-scoring-y-calificación.md) - 5 SP - P2
5. [RF-MGN-009-005: Conversión a Cotización](mgn-009/RF-MGN-009-005-conversión-a-cotización.md) - 5 SP - P1
---
### MGN-010: RRHH Básico (29 SP)
**Complementary Phase - P1**
1. [RF-MGN-010-001: Gestión de Empleados](mgn-010/RF-MGN-010-001-gestión-de-empleados.md) - 8 SP - P1
2. [RF-MGN-010-002: Departamentos y Puestos](mgn-010/RF-MGN-010-002-departamentos-y-puestos.md) - 3 SP - P1
3. [RF-MGN-010-003: Contratos Laborales](mgn-010/RF-MGN-010-003-contratos-laborales.md) - 5 SP - P1
4. [RF-MGN-010-004: Asistencias (Check-in/Check-out)](mgn-010/RF-MGN-010-004-asistencias-check-in-check-out.md) - 5 SP - P1
5. [RF-MGN-010-005: Ausencias y Permisos](mgn-010/RF-MGN-010-005-ausencias-y-permisos.md) - 8 SP - P1
---
### MGN-011: Proyectos Genéricos (40 SP)
**Complementary Phase - P1**
1. [RF-MGN-011-001: Gestión de Proyectos](mgn-011/RF-MGN-011-001-gestión-de-proyectos.md) - 8 SP - P1
2. [RF-MGN-011-002: Gestión de Tareas (Kanban)](mgn-011/RF-MGN-011-002-gestión-de-tareas-kanban.md) - 13 SP - P1
3. [RF-MGN-011-003: Milestones (Hitos)](mgn-011/RF-MGN-011-003-milestones-hitos.md) - 3 SP - P1
4. [RF-MGN-011-004: Timesheet de Proyectos](mgn-011/RF-MGN-011-004-timesheet-de-proyectos.md) - 8 SP - P1
5. [RF-MGN-011-005: Vista Gantt de Proyectos](mgn-011/RF-MGN-011-005-vista-gantt-de-proyectos.md) - 8 SP - P2
---
### MGN-012: Reportes y Analytics (39 SP)
**Complementary Phase - P1**
1. [RF-MGN-012-001: Dashboards Configurables](mgn-012/RF-MGN-012-001-dashboards-configurables.md) - 13 SP - P1
2. [RF-MGN-012-002: Query Builder y Reportes Personalizados](mgn-012/RF-MGN-012-002-query-builder-y-reportes-personalizados.md) - 13 SP - P2
3. [RF-MGN-012-003: Exportación de Datos (PDF, Excel, CSV)](mgn-012/RF-MGN-012-003-exportación-de-datos-pdf,-excel,-csv.md) - 5 SP - P1
4. [RF-MGN-012-004: Gráficos y Visualizaciones](mgn-012/RF-MGN-012-004-gráficos-y-visualizaciones.md) - 8 SP - P1
---
### MGN-013: Portal de Usuarios (29 SP)
**Complementary Phase - P1**
1. [RF-MGN-013-001: Acceso Portal para Clientes](mgn-013/RF-MGN-013-001-acceso-portal-para-clientes.md) - 8 SP - P1
2. [RF-MGN-013-002: Vista de Documentos en Portal](mgn-013/RF-MGN-013-002-vista-de-documentos-en-portal.md) - 8 SP - P1
3. [RF-MGN-013-003: Aprobación y Firma Electrónica](mgn-013/RF-MGN-013-003-aprobación-y-firma-electrónica.md) - 8 SP - P1
4. [RF-MGN-013-004: Mensajería en Portal](mgn-013/RF-MGN-013-004-mensajería-en-portal.md) - 5 SP - P1
---
### MGN-014: Mensajería y Notificaciones (47 SP)
**Core Phase - P0 (MVP)**
1. [RF-MGN-014-001: Sistema de Mensajes (Chatter)](mgn-014/RF-MGN-014-001-sistema-de-mensajes-chatter.md) - 13 SP - P0
2. [RF-MGN-014-002: Notificaciones In-App y Email](mgn-014/RF-MGN-014-002-notificaciones-in-app-y-email.md) - 8 SP - P0
3. [RF-MGN-014-003: Tracking Automático de Cambios](mgn-014/RF-MGN-014-003-tracking-automático-de-cambios.md) - 8 SP - P0
4. [RF-MGN-014-004: Actividades Programadas](mgn-014/RF-MGN-014-004-actividades-programadas.md) - 8 SP - P1
5. [RF-MGN-014-005: Followers (Seguidores)](mgn-014/RF-MGN-014-005-followers-seguidores.md) - 5 SP - P1
6. [RF-MGN-014-006: Templates de Email](mgn-014/RF-MGN-014-006-templates-de-email.md) - 5 SP - P1
---
## Métricas de Calidad
### Completitud
-**80 RF creados** (100% completitud)
-**Todos los módulos documentados** (14/14)
-**Trazabilidad completa** (referencias a alcance, domain models, schemas, gaps)
-**Criterios de aceptación definidos** (todos los RF)
-**Dependencias identificadas** (todos los RF)
### Distribución
- **Core Phase (MVP):** 52 RF (65%) - 462 SP (69%)
- **Complementary Phase:** 28 RF (35%) - 211 SP (31%)
### Estimaciones
- **Total Story Points:** 673 SP
- **Velocidad estimada:** 20 SP/sprint (equipo 5 personas)
- **Duración estimada MVP (P0):** ~23 sprints = 46 semanas
- **Duración total (P0 + P1):** ~34 sprints = 68 semanas
---
## Estructura de cada RF
Cada requerimiento funcional sigue esta estructura estandarizada:
```markdown
# RF-MGN-XXX-YYY: [Título del Requerimiento]
**Módulo:** MGN-XXX
**Prioridad:** P0 / P1 / P2
**Story Points:** [Estimación]
**Estado:** Definido
**Fecha:** 2025-11-23
## Descripción
[Descripción clara desde perspectiva de negocio]
## Actores
- Actor Principal
- Actores Secundarios
## Precondiciones
[Condiciones que deben cumplirse antes]
## Flujo Principal
[Pasos del flujo normal]
## Flujos Alternativos
[Escenarios alternativos y de error]
## Reglas de Negocio
[Reglas que rigen la funcionalidad]
## Criterios de Aceptación
[Checklist medible de aceptación]
## Entidades Involucradas
[Tablas de base de datos]
## Referencias
[Links a documentos relacionados]
## Notas Técnicas
[Patrones, tecnologías, consideraciones]
## Dependencias
[RF dependientes y bloqueantes]
```
---
## Nomenclatura de Archivos
- **Formato:** `RF-MGN-XXX-YYY-descripcion-corta.md`
- **XXX:** Número de módulo (001-014)
- **YYY:** Número secuencial de RF (001, 002, ...)
- **Ejemplo:** `RF-MGN-001-001-autenticacion-usuarios.md`
---
## Referencias Cruzadas
Cada RF incluye referencias a:
1. **ALCANCE-POR-MODULO.md:** Alcance detallado del módulo
2. **Domain Models:** Modelos de dominio en `02-modelado/domain-models/`
3. **Database Schemas:** Schemas DDL en `02-modelado/database-design/schemas/`
4. **Gap Analysis:** Gaps identificados en `01-definicion-modulos/gaps/`
---
## Próximos Pasos
1. **Revisión de RF con Stakeholders:** Validar que RF cubren necesidades de negocio
2. **Refinamiento de Estimaciones:** Ajustar Story Points con equipo técnico
3. **Priorización Final:** Confirmar prioridades P0/P1/P2 con Product Owner
4. **Planificación de Sprints:** Agrupar RF en sprints según dependencias
5. **Diseño de APIs:** Crear especificaciones OpenAPI 3.0 para cada RF
6. **Implementación:** Comenzar desarrollo por módulos Core (MGN-001 a MGN-008)
---
## Equipo de Análisis
- **Business Analyst:** Definición de RF basados en Odoo, Gamilit y ERP Construcción
- **Fecha de Creación:** 2025-11-23
- **Estado:** ✅ Completado
- **Siguiente Fase:** Diseño de APIs (ADR-005)
---
**Documento creado:** 2025-11-23
**Versión:** 1.0
**Estado:** ✅ Completado
**Total Páginas de Documentación:** 80 RF + 1 README = 81 archivos