feat: bulk XML upload, period selector, and session persistence

- Add bulk XML CFDI upload support (up to 300MB)
- Add period selector component for month/year navigation
- Fix session persistence on page refresh (Zustand hydration)
- Fix income/expense classification based on tenant RFC
- Fix IVA calculation from XML (correct Impuestos element)
- Add error handling to reportes page
- Support multiple CORS origins
- Update reportes service with proper Decimal/BigInt handling
- Add RFC to tenant view store for proper CFDI classification
- Update README with changelog and new features

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

README.md

@@ -19,6 +19,7 @@ Horux360 es una aplicación SaaS que permite a las empresas mexicanas:
 - **Backend:** Node.js + Express + TypeScript
 - **Base de datos:** PostgreSQL (multi-tenant por schema)
 - **Autenticación:** JWT personalizado
+- **Estado:** Zustand con persistencia
 
 ## Estructura del Proyecto
 
@@ -50,9 +51,32 @@ horux360/
 ## Características Destacadas
 
 - **4 Temas visuales:** Light, Vibrant, Corporate, Dark
-- **Multi-tenant:** Aislamiento de datos por empresa
+- **Multi-tenant:** Aislamiento de datos por empresa (schema por tenant)
 - **Responsive:** Funciona en desktop y móvil
 - **Tiempo real:** Dashboards actualizados al instante
+- **Carga masiva de XML:** Soporte para carga de hasta 300MB de archivos XML
+- **Selector de período:** Navegación por mes/año en todos los dashboards
+- **Clasificación automática:** Ingresos/egresos basado en RFC del tenant
+
+## Configuración
+
+### Variables de entorno (API)
+
+```env
+NODE_ENV=development
+PORT=4000
+DATABASE_URL="postgresql://user:pass@localhost:5432/horux360"
+JWT_SECRET=your-secret-key
+JWT_EXPIRES_IN=15m
+JWT_REFRESH_EXPIRES_IN=7d
+CORS_ORIGIN=http://localhost:3000
+```
+
+### Variables de entorno (Web)
+
+```env
+NEXT_PUBLIC_API_URL=http://localhost:4000/api
+```
 
 ## Demo
 
@@ -61,6 +85,33 @@ Credenciales de demo:
 - **Contador:** contador@demo.com / demo123
 - **Visor:** visor@demo.com / demo123
 
+## Changelog
+
+### v0.4.0 (2026-01-22)
+- Carga masiva de XML CFDI (hasta 300MB)
+- Selector de período mes/año en dashboards
+- Fix: Persistencia de sesión en refresh de página
+- Fix: Clasificación ingreso/egreso basada en RFC
+- Fix: Cálculo de IVA desde XML
+- Mejoras en reportes con manejo de errores
+- Soporte CORS para múltiples orígenes
+
+### v0.3.0 (2026-01-22)
+- Sistema multi-tenant con gestión de clientes
+- Temas visuales (4 layouts diferentes)
+
+### v0.2.0 (2026-01-22)
+- Dashboard principal con KPIs
+- Módulo de CFDI
+- Control de IVA/ISR
+- Calendario fiscal
+- Sistema de alertas
+
+### v0.1.0 (2026-01-22)
+- Autenticación JWT
+- Estructura multi-tenant
+- Configuración inicial del proyecto
+
 ## Licencia
 
 Propietario - Consultoría AS