3763014eca
Detailed implementation plan with 9 phases: 1. Database models and migrations 2. Cryptography and FIEL services 3. SAT communication services 4. CFDI XML parser 5. Main orchestrator service 6. Scheduled cron job 7. API endpoints 8. Frontend components 9. Testing and validation Includes: - 16 new files to create - 5 files to modify - Dependencies list - Implementation order Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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
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)
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)
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