# EPICA: EPIC-MAE-014 - Finanzas y Controlling

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MAE-014 |
| **Nombre** | Finanzas y Controlling de Obra |
| **Modulo** | finanzas-controlling |
| **Fase** | Fase 2 - Enterprise |
| **Prioridad** | P1 |
| **Estado** | Backlog |
| **Story Points** | 80 |
| **Sprint(s)** | Sprint 13-16 |

---

## Descripcion

Sistema financiero enterprise integrado con proyectos de construccion. Incluye libro mayor, cuentas por pagar/cobrar ligadas a compras y estimaciones, flujo de efectivo proyectado vs real por obra, conciliacion bancaria por proyecto, e integracion con sistemas contables externos (SAP, CONTPAQi).

**Disponibilidad SaaS:** Plan Enterprise o Add-on $200/mes

---

## Objetivo de Negocio

Proveer control financiero que:
- Integre contabilidad con proyectos de obra
- Rastree cuentas por pagar a proveedores
- Gestione cuentas por cobrar de clientes
- Proyecte y controle flujo de efectivo
- Genere estados financieros por proyecto
- Se integre con ERPs externos

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MAE014-001 | Como contador, quiero configurar plan de cuentas por proyecto | P0 | 8 | Backlog |
| US-MAE014-002 | Como contador, quiero registrar polizas contables | P0 | 8 | Backlog |
| US-MAE014-003 | Como tesorero, quiero gestionar cuentas por pagar | P0 | 8 | Backlog |
| US-MAE014-004 | Como tesorero, quiero gestionar cuentas por cobrar | P0 | 8 | Backlog |
| US-MAE014-005 | Como contralor, quiero ver flujo de efectivo proyectado | P0 | 8 | Backlog |
| US-MAE014-006 | Como contador, quiero conciliar movimientos bancarios | P0 | 8 | Backlog |
| US-MAE014-007 | Como contralor, quiero generar balance general | P0 | 5 | Backlog |
| US-MAE014-008 | Como contralor, quiero generar estado de resultados | P0 | 5 | Backlog |
| US-MAE014-009 | Como contador, quiero exportar polizas a CONTPAQi | P1 | 8 | Backlog |
| US-MAE014-010 | Como contador, quiero exportar polizas a SAP | P1 | 5 | Backlog |
| US-MAE014-011 | Como director, quiero ver dashboard financiero | P1 | 5 | Backlog |
| US-MAE014-012 | Como sistema, quiero generar polizas automaticas de compras | P1 | 5 | Backlog |

**Total Story Points:** 81 SP (ajustado a 80)

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Plan de cuentas configurable (PCGA Mexico, IFRS)
- [ ] Polizas contables con partida doble
- [ ] AP ligado a ordenes de compra y facturas proveedor
- [ ] AR ligado a estimaciones y facturas cliente
- [ ] Cash flow proyectado con precision ±5%
- [ ] Conciliacion bancaria mensual
- [ ] Estados financieros: Balance, PyG
- [ ] Export SAP/CONTPAQi (formato XML/TXT)

**No Funcionales:**
- [ ] Cumplimiento SOX para constructoras US
- [ ] Cumplimiento NIF Mexico
- [ ] Cierre contable por periodo

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MAI-001 Fundamentos | Backlog | Si |
| EPIC-MAI-004 Compras | Backlog | Si |
| EPIC-MAI-008 Estimaciones | Backlog | Si |
| MGN-010 Financial (Core) | Backlog | Si |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `finance`
- [ ] Tablas: 15 (accounts, journals, entries, entry_lines, ap_invoices, ar_invoices, payments, bank_statements, reconciliations, etc.)
- [ ] Funciones: 8 (calcular_saldos, generar_poliza, conciliar)

**Backend:**
- [ ] Modulo: `finance`
- [ ] Submodulos: accounting, ap, ar, cashflow, reports
- [ ] Entities: 15
- [ ] Endpoints: 35+
- [ ] Integraciones: SAP, CONTPAQi, Bancos
- [ ] Tests: 50+

**Frontend:**
- [ ] Paginas: 10 (Accounts, Entries, AP, AR, CashFlow, Reconciliation, Balance, PL, Dashboard)
- [ ] Componentes: EntryForm, APTable, ARTable, CashFlowChart
- [ ] Stores: 3 (accountingStore, apStore, arStore)

---

## Integraciones Externas

### CONTPAQi
- Export: Polizas en formato TXT
- Import: Catalogo de cuentas

### SAP S/4HANA
- Export: Polizas via RFC/BAPI
- Import: Saldos iniciales

### Bancos
- Import: Estados de cuenta (formato bancario)
- Matching automatico con pagos

---

**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-05
