c3ce7199af
- 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>
118 lines
3.2 KiB
Markdown
118 lines
3.2 KiB
Markdown
# Horux360 SaaS
|
|
|
|
Plataforma de análisis financiero y gestión fiscal para empresas mexicanas.
|
|
|
|
## Descripción
|
|
|
|
Horux360 es una aplicación SaaS que permite a las empresas mexicanas:
|
|
|
|
- Gestionar sus CFDI (facturas electrónicas)
|
|
- Controlar IVA e ISR automáticamente
|
|
- Visualizar dashboards financieros en tiempo real
|
|
- Realizar conciliación bancaria
|
|
- Recibir alertas fiscales proactivas
|
|
- Generar reportes y proyecciones financieras
|
|
|
|
## Stack Tecnológico
|
|
|
|
- **Frontend:** Next.js 14 + TypeScript + Tailwind CSS
|
|
- **Backend:** Node.js + Express + TypeScript
|
|
- **Base de datos:** PostgreSQL (multi-tenant por schema)
|
|
- **Autenticación:** JWT personalizado
|
|
- **Estado:** Zustand con persistencia
|
|
|
|
## Estructura del Proyecto
|
|
|
|
```
|
|
horux360/
|
|
├── apps/
|
|
│ ├── web/ # Frontend Next.js
|
|
│ └── api/ # Backend Express
|
|
├── packages/
|
|
│ └── shared/ # Tipos y utilidades compartidas
|
|
├── docs/
|
|
│ └── plans/ # Documentación de diseño
|
|
└── docker-compose.yml
|
|
```
|
|
|
|
## Documentación
|
|
|
|
- [Documento de Diseño](docs/plans/2026-01-22-horux360-saas-design.md)
|
|
|
|
## Planes
|
|
|
|
| Plan | CFDI/mes | Usuarios | Características |
|
|
|------|----------|----------|-----------------|
|
|
| Starter | 100 | 1 | Dashboard, IVA/ISR, CFDI básico |
|
|
| Business | 500 | 3 | + Reportes, Alertas, Calendario |
|
|
| Professional | 2,000 | 10 | + Conciliación, Forecasting |
|
|
| Enterprise | Ilimitado | Ilimitado | + API, Multi-empresa |
|
|
|
|
## Características Destacadas
|
|
|
|
- **4 Temas visuales:** Light, Vibrant, Corporate, Dark
|
|
- **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
|
|
|
|
Credenciales de demo:
|
|
- **Admin:** admin@demo.com / demo123
|
|
- **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
|