HORUX360
45570baccc
## Phase 3: DeepSeek AI Integration ### AI Services (apps/api/src/services/ai/) - DeepSeek API client with streaming, rate limiting, retries - AI service for financial analysis, executive summaries, recommendations - Optimized prompts for Mexican CFO digital assistant - Redis caching for AI responses ### Report Generation (apps/api/src/services/reports/) - ReportGenerator: monthly, quarterly, annual, custom reports - PDF generator with corporate branding (PDFKit) - Report templates for PYME, Startup, Enterprise - Spanish prompts for financial narratives - MinIO storage for generated PDFs ### AI & Reports API Routes - POST /api/ai/analyze - Financial metrics analysis - POST /api/ai/chat - CFO digital chat with streaming - POST /api/reports/generate - Async report generation - GET /api/reports/:id/download - PDF download - BullMQ jobs for background processing ### Frontend Pages - /reportes - Report listing with filters - /reportes/nuevo - 3-step wizard for report generation - /reportes/[id] - Full report viewer with charts - /asistente - CFO Digital chat interface - Components: ChatInterface, ReportCard, AIInsightCard ## Phase 4: ERP Integrations ### CONTPAQi Connector (SQL Server) - Contabilidad: catalog, polizas, balanza, estado de resultados - Comercial: clientes, proveedores, facturas, inventario - Nominas: empleados, nominas, percepciones/deducciones ### Aspel Connector (Firebird/SQL Server) - COI: accounting, polizas, balanza, auxiliares - SAE: sales, purchases, inventory, A/R, A/P - NOI: payroll, employees, receipts - BANCO: bank accounts, movements, reconciliation - Latin1 to UTF-8 encoding handling ### Odoo Connector (XML-RPC) - Accounting: chart of accounts, journal entries, reports - Invoicing: customer/vendor invoices, payments - Partners: customers, vendors, statements - Inventory: products, stock levels, valuations - Multi-company and version 14-17 support ### Alegra Connector (REST API) - Invoices, credit/debit notes with CFDI support - Contacts with Mexican fiscal fields (RFC, regimen) - Payments and bank reconciliation - Financial reports: trial balance, P&L, balance sheet - Webhook support for real-time sync ### SAP Business One Connector (OData/Service Layer) - Session management with auto-refresh - Financials: chart of accounts, journal entries, reports - Sales: invoices, credit notes, delivery notes, orders - Purchasing: bills, POs, goods receipts - Inventory: items, stock, transfers, valuation - Banking: accounts, payments, cash flow ### Integration Manager - Unified interface for all connectors - BullMQ scheduler for automated sync - Webhook handling for real-time updates - Migration 003_integrations.sql with sync tables - Frontend page /integraciones for configuration Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Horux Strategy
CFO Digital para Empresas Mexicanas
Plataforma SaaS de inteligencia financiera que transforma datos fiscales y contables en insights estratégicos accionables.
Características Principales
- 📊 Dashboards en tiempo real - KPIs financieros actualizados automáticamente
- 📄 Reportes ejecutivos con IA - Narrativas inteligentes generadas con DeepSeek
- 🔗 Integraciones automáticas - SAT (FIEL), CONTPAQi, Aspel, Odoo, Alegra, SAP
- 📈 +50 métricas financieras - Core, Startup (MRR, CAC, LTV), Enterprise (EBITDA, ROI)
- 🔔 Alertas inteligentes - Detección automática de anomalías y riesgos
- 💰 50% más económico que la competencia
Stack Tecnológico
- Frontend: Next.js 14, TypeScript, Tailwind CSS, Zustand
- Backend: Node.js, Express, TypeScript
- Base de datos: PostgreSQL (multi-tenant por schema)
- Cache/Colas: Redis, BullMQ
- Storage: MinIO / AWS S3
- Monorepo: Turborepo + pnpm
- IA: DeepSeek API
Estructura del Proyecto
horux-strategy/
├── apps/
│ ├── web/ # Frontend Next.js
│ └── api/ # Backend Express
├── packages/
│ ├── shared/ # Tipos y utilidades compartidas
│ ├── database/ # Schemas y migraciones
│ └── ui/ # Componentes UI reutilizables
├── docs/
│ └── plans/ # Documentos de diseño
├── docker/ # Configuración Docker
└── scripts/ # Scripts de utilidad
Requisitos
- Node.js 20+
- pnpm 8+
- PostgreSQL 15+
- Redis 7+
- Docker (opcional, recomendado)
Instalación
# Clonar repositorio
git clone https://git.consultoria-as.com/consultoria-as/HoruxStrategy.git
cd HoruxStrategy
# Instalar dependencias
pnpm install
# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus credenciales
# Iniciar servicios (Docker)
docker-compose up -d
# Ejecutar migraciones
pnpm db:migrate
# Iniciar desarrollo
pnpm dev
Scripts Disponibles
| Script | Descripción |
|---|---|
pnpm dev |
Iniciar todos los servicios en modo desarrollo |
pnpm build |
Compilar todos los paquetes |
pnpm test |
Ejecutar tests |
pnpm lint |
Ejecutar linter |
pnpm db:migrate |
Ejecutar migraciones de BD |
pnpm db:seed |
Poblar BD con datos de prueba |
Documentación
- Documento de Diseño
- API Documentation (próximamente)
- Guía de Contribución (próximamente)
Planes y Precios
| Plan | Precio | Para empresas con ingresos |
|---|---|---|
| Startup | $5,999 MXN/mes | < $100M MXN/año |
| PYME | $6,499 MXN/mes | < $400M MXN/año |
| Enterprise | $8,499 MXN/mes | < $1,000M MXN/año |
| Corporativo | $9,999 MXN/mes | > $1,000M MXN/año |
Licencia
Propietario - HORUX360 © 2026
Desarrollado por HORUX360