c44e7cea34
Complete design document covering: - Database-per-tenant architecture (NDA compliance) - FIEL dual storage (filesystem + DB, encrypted) - MercadoPago subscription payments - Transactional emails via Gmail SMTP - Production deployment (Nginx, PM2, SSL, backups) - Plan enforcement and feature gating Co-Authored-By: Claude Opus 4.6 <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