- Add project design document with complete specifications - Configure Turborepo monorepo structure - Add README with project overview and setup instructions - Configure .gitignore for Node.js/TypeScript project - Set up pnpm workspace configuration Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
702 lines
26 KiB
Markdown
702 lines
26 KiB
Markdown
# Horux Strategy - Documento de Diseño
|
||
|
||
**Versión:** 1.0
|
||
**Fecha:** 31 de Enero, 2026
|
||
**Autor:** HORUX360
|
||
**Estado:** Aprobado para implementación
|
||
|
||
---
|
||
|
||
## Tabla de Contenidos
|
||
|
||
1. [Resumen Ejecutivo](#1-resumen-ejecutivo)
|
||
2. [Decisiones de Producto](#2-decisiones-de-producto)
|
||
3. [Arquitectura General](#3-arquitectura-general)
|
||
4. [Métricas y KPIs](#4-métricas-y-kpis)
|
||
5. [Pipeline de Reportes con IA](#5-pipeline-de-reportes-con-ia)
|
||
6. [Integraciones](#6-integraciones)
|
||
7. [Estructura de Base de Datos](#7-estructura-de-base-de-datos)
|
||
8. [Planes y Pricing](#8-planes-y-pricing)
|
||
9. [Flujos de Usuario](#9-flujos-de-usuario)
|
||
10. [Roadmap de Implementación](#10-roadmap-de-implementación)
|
||
|
||
---
|
||
|
||
## 1. Resumen Ejecutivo
|
||
|
||
### 1.1 Visión del Producto
|
||
|
||
Horux Strategy es una plataforma SaaS de inteligencia financiera que transforma datos fiscales y contables en insights estratégicos accionables. Combina dashboards en tiempo real con reportes ejecutivos generados por IA, posicionándose como el "CFO Digital" para empresas mexicanas.
|
||
|
||
### 1.2 Propuesta de Valor
|
||
|
||
- **50% más económico que Monthly.la** (competidor principal)
|
||
- **Automatización completa**: Conexión directa con SAT y 5 sistemas contables
|
||
- **Dashboards en tiempo real** + **Reportes ejecutivos con IA**
|
||
- **+50 métricas financieras** organizadas en módulos (Core, Startup, Enterprise)
|
||
- **Plataforma modular** que se adapta a PYMES, startups y empresas medianas
|
||
|
||
### 1.3 Diferenciadores Clave
|
||
|
||
| Aspecto | Monthly.la | Horux Strategy |
|
||
|---------|------------|----------------|
|
||
| Precio | $11,999 - $19,999/mes | $5,999 - $9,999/mes |
|
||
| Dashboards | No (solo reportes) | Sí, tiempo real |
|
||
| Integraciones | Manual | Automáticas (5 sistemas) |
|
||
| Frecuencia reportes | Mensual | Bajo demanda |
|
||
| Alertas | No | Sí, automáticas |
|
||
| API | No | Sí (planes Pro+) |
|
||
|
||
---
|
||
|
||
## 2. Decisiones de Producto
|
||
|
||
### 2.1 Resumen de Decisiones
|
||
|
||
| Aspecto | Decisión |
|
||
|---------|----------|
|
||
| **Público objetivo** | Modular: PYMES, startups, empresas medianas |
|
||
| **Fuentes de datos** | SAT (FIEL) + Sistemas contables (5) |
|
||
| **Core value** | Dashboards live + Reportes ejecutivos con IA |
|
||
| **Relación con Horux360** | Productos completamente separados |
|
||
| **Modelo de pricing** | Suscripción mensual por tamaño de empresa |
|
||
| **Stack tecnológico** | Next.js 14 + Express + PostgreSQL + Turborepo |
|
||
| **IA** | DeepSeek API |
|
||
| **Timeline** | Máxima velocidad (16 semanas) |
|
||
|
||
### 2.2 Público Objetivo
|
||
|
||
#### Segmento 1: PYMES Tradicionales
|
||
- Restaurantes, comercios, servicios
|
||
- Necesitan visibilidad básica de flujo de caja y rentabilidad
|
||
- Buscan evitar sorpresas fiscales
|
||
|
||
#### Segmento 2: Startups con Inversionistas
|
||
- Empresas tecnológicas en crecimiento
|
||
- Necesitan métricas de crecimiento (MRR, CAC, LTV, runway)
|
||
- Reportes para inversionistas
|
||
|
||
#### Segmento 3: Empresas Medianas
|
||
- Operaciones establecidas
|
||
- Necesitan estados financieros completos, presupuestos, comparativos
|
||
- Reportes para junta directiva
|
||
|
||
---
|
||
|
||
## 3. Arquitectura General
|
||
|
||
### 3.1 Diagrama de Arquitectura
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ HORUX STRATEGY │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ FRONTEND (Next.js 14) │
|
||
│ ├── Dashboard Hub (métricas en tiempo real) │
|
||
│ ├── Centro de Reportes (generación y descarga) │
|
||
│ ├── Configuración de Empresa │
|
||
│ └── Gestión de Integraciones │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ BACKEND (Express + TypeScript) │
|
||
│ ├── Auth Service (JWT + roles) │
|
||
│ ├── Integration Service (SAT, contables) │
|
||
│ ├── Analytics Engine (cálculo de métricas) │
|
||
│ ├── Report Generator (plantillas + IA) │
|
||
│ └── Scheduler (sync automático, alertas) │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ DATA LAYER │
|
||
│ ├── PostgreSQL (multi-tenant por schema) │
|
||
│ ├── Redis (cache de métricas, colas) │
|
||
│ └── S3/MinIO (reportes PDF generados) │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ INTEGRACIONES EXTERNAS │
|
||
│ ├── SAT (descarga CFDI vía FIEL) │
|
||
│ ├── Sistemas Contables (CONTPAQi, Aspel, Odoo, Alegra, SAP) │
|
||
│ └── DeepSeek API (generación narrativa) │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 3.2 Stack Tecnológico
|
||
|
||
| Componente | Tecnología |
|
||
|------------|------------|
|
||
| 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 |
|
||
| Contenedores | Docker Compose |
|
||
| IA | DeepSeek API |
|
||
| Gráficas | Recharts (frontend), Chart.js (server-side) |
|
||
| PDF | Puppeteer |
|
||
|
||
### 3.3 Arquitectura Multi-tenant
|
||
|
||
- **Estrategia**: Schema por tenant en PostgreSQL
|
||
- **Beneficios**:
|
||
- Aislamiento de datos garantizado a nivel BD
|
||
- Facilita backups y restauración por cliente
|
||
- Performance consistente
|
||
- Cumplimiento de privacidad
|
||
|
||
---
|
||
|
||
## 4. Métricas y KPIs
|
||
|
||
### 4.1 Módulo Core (Todos los planes)
|
||
|
||
| Métrica | Fuente | Requisitos Usuario | Cálculo |
|
||
|---------|--------|-------------------|---------|
|
||
| Ingresos totales | SAT | Conectar FIEL | Σ CFDIs emitidos tipo "I" |
|
||
| Gastos totales | SAT | Conectar FIEL | Σ CFDIs recibidos |
|
||
| Utilidad bruta | SAT | Clasificar costos | Ingresos - Costo de ventas |
|
||
| Utilidad neta | SAT + Contable | Clasificar gastos | Utilidad bruta - Gastos - Impuestos |
|
||
| Flujo de caja | SAT | Ninguno | Complementos de pago recibidos - pagados |
|
||
| Cuentas por cobrar | SAT | Ninguno | Facturas emitidas sin pago |
|
||
| Cuentas por pagar | SAT | Ninguno | Facturas recibidas sin pago |
|
||
| Antigüedad CxC | SAT | Ninguno | Días desde emisión, agrupado 0-30, 31-60, 61-90, 90+ |
|
||
| Antigüedad CxP | SAT | Ninguno | Días desde recepción sin pago |
|
||
| IVA por pagar | SAT | Ninguno | IVA trasladado - IVA acreditable |
|
||
| IVA a favor | SAT | Ninguno | Cuando acreditable > trasladado |
|
||
|
||
### 4.2 Módulo Startup (Plan PYME+)
|
||
|
||
| Métrica | Fuente | Requisitos Usuario | Cálculo |
|
||
|---------|--------|-------------------|---------|
|
||
| MRR | SAT + Config | Marcar clientes recurrentes | Σ ingresos recurrentes mensuales |
|
||
| ARR | Derivado | Igual que MRR | MRR × 12 |
|
||
| Runway | SAT + Config | Ingresar saldo bancario | Saldo ÷ Burn rate |
|
||
| Burn rate | SAT | Ninguno | Promedio (Gastos - Ingresos) mensual |
|
||
| Net Burn | SAT | Ninguno | Gastos - Ingresos mensual |
|
||
| Gross Burn | SAT | Ninguno | Solo gastos mensuales |
|
||
| CAC | Config | Gasto marketing + clientes nuevos | Gasto MKT ÷ Clientes nuevos |
|
||
| LTV | SAT + Config | Marcar recurrentes + histórico | (ARPU × Margen) ÷ Churn |
|
||
| Churn rate | Config | Registrar clientes activos/cancelados | Perdidos ÷ Inicio período |
|
||
| Growth rate MoM | SAT | Ninguno | (Actual - Anterior) ÷ Anterior |
|
||
| Growth rate YoY | SAT | Ninguno | (Año actual - Año anterior) ÷ Año anterior |
|
||
| LTV:CAC Ratio | Derivado | Igual que LTV y CAC | LTV ÷ CAC |
|
||
| Months to recover CAC | Derivado | Igual que CAC | CAC ÷ (ARPU × Margen) |
|
||
|
||
### 4.3 Módulo Enterprise (Plan Enterprise+)
|
||
|
||
| Métrica | Fuente | Requisitos Usuario | Cálculo |
|
||
|---------|--------|-------------------|---------|
|
||
| EBITDA | Contable | Conectar sistema contable | Utilidad + Depreciación + Amortización |
|
||
| Margen EBITDA | Derivado | Igual que EBITDA | EBITDA ÷ Ingresos |
|
||
| ROI | Contable + Config | Ingresar inversión | (Ganancia - Inversión) ÷ Inversión |
|
||
| ROE | Contable | Conectar contable | Utilidad neta ÷ Capital contable |
|
||
| ROA | Contable | Conectar contable | Utilidad neta ÷ Activos totales |
|
||
| Razón corriente | Contable | Conectar contable | Activos circulantes ÷ Pasivos circulantes |
|
||
| Prueba ácida | Contable | Conectar contable | (AC - Inventarios) ÷ PC |
|
||
| Endeudamiento | Contable | Conectar contable | Pasivos ÷ Activos |
|
||
| Apalancamiento | Contable | Conectar contable | Pasivos ÷ Capital |
|
||
| Punto equilibrio | SAT + Config | Clasificar costos fijos/variables | Fijos ÷ (1 - Variables/Ventas) |
|
||
| Margen contribución | SAT + Config | Clasificar variables | Ventas - Costos variables |
|
||
| Presupuesto vs Real | Config | Cargar presupuesto | Variación absoluta y % |
|
||
| Forecast | SAT + IA | Histórico 6+ meses | Proyección estadística + IA |
|
||
| Working capital | Contable | Conectar contable | AC - PC |
|
||
| DSO | SAT | Ninguno | (CxC ÷ Ventas crédito) × Días |
|
||
| DPO | SAT | Ninguno | (CxP ÷ Compras crédito) × Días |
|
||
| Cash Conversion Cycle | Derivado | Ninguno | DSO + Days Inventory - DPO |
|
||
|
||
---
|
||
|
||
## 5. Pipeline de Reportes con IA
|
||
|
||
### 5.1 Tipos de Reportes
|
||
|
||
| Reporte | Frecuencia | Audiencia | Contenido |
|
||
|---------|------------|-----------|-----------|
|
||
| Ejecutivo Mensual | Mensual | CEO/Dueño | Resumen, tendencias, alertas, recomendaciones |
|
||
| Para Inversionistas | Mensual/Trimestral | Inversionistas | Métricas startup, runway, crecimiento |
|
||
| Junta Directiva | Trimestral | Consejo | Análisis profundo, comparativos, proyecciones |
|
||
| Flash Semanal | Semanal | Operaciones | KPIs clave, alertas urgentes |
|
||
| Fiscal | Mensual | Contador/CFO | IVA, retenciones, cumplimiento |
|
||
|
||
### 5.2 Pipeline de Generación (10 Fases)
|
||
|
||
#### FASE 1: Trigger y Scheduling
|
||
- Disparadores: Cron, manual, evento, fecha programada
|
||
- Cola de trabajos con BullMQ
|
||
- Prioridades y reintentos
|
||
|
||
#### FASE 2: Extracción de Datos
|
||
- Datos del período actual
|
||
- Datos históricos (YoY, MoM)
|
||
- Contexto del cliente (industria, tamaño, metas)
|
||
- Datos del sistema contable
|
||
|
||
#### FASE 3: Cálculo de Métricas
|
||
- Ejecutar fórmulas de métricas
|
||
- Calcular variaciones
|
||
- Detectar anomalías (reglas)
|
||
- Clasificar insights (positivo, neutral, negativo)
|
||
|
||
#### FASE 4: Preparación de Contexto para IA
|
||
- Construcción de JSON estructurado
|
||
- Selección de plantilla de prompt
|
||
- Personalización por tipo de reporte
|
||
|
||
#### FASE 5: Llamadas a DeepSeek API
|
||
- Llamadas paralelas por sección
|
||
- Configuración: temperature=0.3, max_tokens variable
|
||
- Manejo de errores y fallbacks
|
||
- Validación de respuestas (anti-alucinación)
|
||
|
||
#### FASE 6: Generación de Visualizaciones
|
||
- Gráficas con Chart.js server-side
|
||
- Output PNG/SVG para PDF
|
||
- Temas consistentes con branding
|
||
|
||
#### FASE 7: Composición del Documento
|
||
- Motor de plantillas (Puppeteer HTML→PDF)
|
||
- Inyección de textos, métricas, gráficas
|
||
- Formatos: PDF, Excel, PowerPoint
|
||
|
||
#### FASE 8: Post-procesamiento y Calidad
|
||
- Validación del PDF
|
||
- Detección de alucinaciones (segunda capa)
|
||
- Scoring de calidad
|
||
|
||
#### FASE 9: Almacenamiento y Entrega
|
||
- Storage en S3/MinIO
|
||
- Email automático
|
||
- Notificación in-app
|
||
- Link de descarga
|
||
|
||
#### FASE 10: Feedback y Mejora Continua
|
||
- Rating del reporte
|
||
- Feedback por sección
|
||
- Mejora de prompts
|
||
- Analytics del sistema
|
||
|
||
### 5.3 Estructura del Reporte Ejecutivo
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ HORUX STRATEGY - Reporte Ejecutivo │
|
||
│ [Nombre Empresa] | [Mes Año] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 📊 RESUMEN EJECUTIVO (IA) │
|
||
│ [Narrativa generada con insights principales] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 💰 RESULTADOS DEL MES │
|
||
│ [KPIs principales con variaciones] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 📈 GRÁFICAS │
|
||
│ [Visualizaciones de tendencias y composición] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ ⚠️ ALERTAS Y RIESGOS (IA) │
|
||
│ [Problemas detectados automáticamente] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 💡 RECOMENDACIONES (IA) │
|
||
│ [Acciones sugeridas basadas en datos] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 📅 PRÓXIMO MES - QUÉ ESPERAR │
|
||
│ [Proyecciones y eventos importantes] │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 6. Integraciones
|
||
|
||
### 6.1 SAT (Solo FIEL)
|
||
|
||
**Autenticación**: Exclusivamente e.firma (FIEL)
|
||
- Archivos: .cer + .key + contraseña
|
||
- Contraseña NO se almacena
|
||
- .key encriptado con AES-256
|
||
|
||
**Seguridad**:
|
||
- Validar vigencia del certificado
|
||
- Verificar que no esté revocado
|
||
- Alertar 30 días antes de expiración
|
||
|
||
**Sincronización**:
|
||
- Inicial: últimos 12-72 meses
|
||
- Incremental: cada 2-8 horas (según plan)
|
||
- Delta: solo CFDIs nuevos
|
||
|
||
### 6.2 Sistemas Contables
|
||
|
||
| Sistema | Método de Conexión | Datos |
|
||
|---------|-------------------|-------|
|
||
| **CONTPAQi** | SDK/BD directa + Agente Windows | Catálogo, pólizas, balanza, auxiliares |
|
||
| **Aspel** | Firebird/SQL Server + Agente | COI, SAE, balanza, CxC/CxP |
|
||
| **Odoo** | API XML-RPC/JSON-RPC | Cuentas, moves, payments, partners |
|
||
| **Alegra** | API REST (OAuth 2.0) | Invoices, bills, payments, contacts |
|
||
| **SAP B1** | Service Layer REST API | Chart of accounts, journals, invoices |
|
||
|
||
### 6.3 Agente Local (Horux Sync Agent)
|
||
|
||
Para CONTPAQi y Aspel on-premise:
|
||
- Instalador Windows (.msi)
|
||
- Servicio Windows auto-inicio
|
||
- Comunicación siempre saliente (no requiere abrir puertos)
|
||
- Datos encriptados en tránsito y reposo
|
||
- Auto-actualización
|
||
|
||
### 6.4 Arquitectura de Conectores
|
||
|
||
```
|
||
┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐
|
||
│ Conector │ │ Adapter │ │ Modelo │
|
||
│ (por sistema) │───▶│ (normaliza) │───▶│ Unificado │
|
||
└─────────────────┘ └──────────────────┘ └──────────────────┘
|
||
```
|
||
|
||
Interfaz común: `IConnector`
|
||
- validateCredentials()
|
||
- testConnection()
|
||
- getAccounts(), getTransactions(), getJournalEntries()
|
||
- syncIncremental(), syncFull()
|
||
|
||
---
|
||
|
||
## 7. Estructura de Base de Datos
|
||
|
||
### 7.1 Schema Public (Compartido)
|
||
|
||
**Tablas principales**:
|
||
- `tenants` - Empresas registradas
|
||
- `users` - Usuarios de la plataforma
|
||
- `user_sessions` - Sesiones activas
|
||
- `plans` - Planes de suscripción
|
||
- `subscriptions` - Relación tenant-plan
|
||
- `subscription_history` - Historial de cambios
|
||
- `payment_methods` - Métodos de pago
|
||
- `invoices` - Facturas de cobro
|
||
- `audit_log` - Log de auditoría global
|
||
- `background_jobs` - Jobs en cola
|
||
- `api_keys` - Llaves de API
|
||
- `webhooks` - Webhooks configurados
|
||
- `feature_flags` - Feature flags
|
||
|
||
### 7.2 Schema Tenant (Por Empresa)
|
||
|
||
**Tablas de datos fiscales**:
|
||
- `sat_credentials` - Credenciales FIEL encriptadas
|
||
- `sat_sync_history` - Historial de sincronizaciones
|
||
- `cfdis` - Comprobantes fiscales
|
||
- `complementos_pago` - Complementos de pago
|
||
- `documentos_pagados` - Relación pago-CFDI
|
||
|
||
**Tablas de datos financieros**:
|
||
- `transactions` - Modelo unificado de transacciones
|
||
- `payments` - Pagos registrados
|
||
- `contacts` - Clientes y proveedores
|
||
- `accounts` - Cuentas contables
|
||
- `journal_entries` - Pólizas contables
|
||
- `journal_entry_lines` - Movimientos de pólizas
|
||
- `categories` - Categorías de clasificación
|
||
- `cost_centers` - Centros de costo
|
||
- `projects` - Proyectos
|
||
- `bank_accounts` - Cuentas bancarias
|
||
- `bank_transactions` - Movimientos bancarios
|
||
|
||
**Tablas de análisis**:
|
||
- `metrics_cache` - Métricas precalculadas
|
||
- `metrics_history` - Historial para tendencias
|
||
- `goals` - Metas y objetivos
|
||
- `alerts` - Alertas generadas
|
||
- `alert_rules` - Reglas de alertas
|
||
- `budgets` - Presupuestos
|
||
- `budget_lines` - Líneas de presupuesto
|
||
- `recurring_revenue_config` - Configuración MRR
|
||
|
||
**Tablas de reportes**:
|
||
- `reports` - Reportes generados
|
||
- `report_schedules` - Reportes programados
|
||
- `report_feedback` - Feedback de reportes
|
||
|
||
**Tablas de configuración**:
|
||
- `integration_configs` - Configuración de integraciones
|
||
- `integration_sync_history` - Historial de sync
|
||
- `settings` - Configuración general
|
||
- `categorization_rules` - Reglas de categorización
|
||
- `dashboard_configs` - Configuración de dashboards
|
||
|
||
**Tablas auxiliares**:
|
||
- `attachments` - Archivos adjuntos
|
||
- `notes` - Notas y comentarios
|
||
- `activity_log` - Actividad del usuario
|
||
- `user_notifications` - Notificaciones
|
||
- `exports` - Exportaciones
|
||
|
||
---
|
||
|
||
## 8. Planes y Pricing
|
||
|
||
### 8.1 Estructura de Precios
|
||
|
||
| Plan | Precio Mensual | Precio Anual | Ingresos Anuales |
|
||
|------|---------------|--------------|------------------|
|
||
| **STARTUP** | $5,999 MXN | $59,990 MXN | < $100M MXN |
|
||
| **PYME** | $6,499 MXN | $64,990 MXN | < $400M MXN |
|
||
| **ENTERPRISE** | $8,499 MXN | $84,990 MXN | < $1,000M MXN |
|
||
| **CORPORATIVO** | $9,999 MXN | $99,990 MXN | > $1,000M MXN |
|
||
|
||
**Comparativa con Monthly.la** (50% más económico):
|
||
- Monthly.la Pequeña: $11,999 → Horux: $5,999
|
||
- Monthly.la Mediana: $12,999 → Horux: $6,499
|
||
- Monthly.la Grande: $16,999 → Horux: $8,499
|
||
- Monthly.la Extra: $19,999 → Horux: $9,999
|
||
|
||
### 8.2 Features por Plan
|
||
|
||
| Feature | STARTUP | PYME | ENTERPRISE | CORPORATIVO |
|
||
|---------|---------|------|------------|-------------|
|
||
| Usuarios incluidos | 3 | 5 | 10 | Ilimitados |
|
||
| RFCs conectados | 1 | 2 | 5 | 10 |
|
||
| SAT (FIEL) | ✅ | ✅ | ✅ | ✅ |
|
||
| CONTPAQi/Aspel | ✅ | ✅ | ✅ | ✅ |
|
||
| Odoo/Alegra | ❌ | ✅ | ✅ | ✅ |
|
||
| SAP Business One | ❌ | ❌ | ✅ | ✅ |
|
||
| Métricas totales | +40 | +50 | +50 | +50 |
|
||
| Módulo Core | ✅ | ✅ | ✅ | ✅ |
|
||
| Módulo Startup | ✅ | ✅ | ✅ | ✅ |
|
||
| Módulo Enterprise | ❌ | ✅ | ✅ | ✅ |
|
||
| Reportes/mes | 5 | 15 | 30 | Ilimitados |
|
||
| Historial datos | 24 meses | 36 meses | 60 meses | Ilimitado |
|
||
| API | ❌ | Lectura | Completa | Completa |
|
||
| Soporte | Email | Chat | Prioritario | Dedicado |
|
||
|
||
### 8.3 Trial
|
||
|
||
- **Duración**: 14 días
|
||
- **Acceso**: Plan PYME completo
|
||
- **Tarjeta**: No requerida
|
||
- **Ofertas conversión**: 17% descuento anual, 20% primeros 3 meses
|
||
|
||
---
|
||
|
||
## 9. Flujos de Usuario
|
||
|
||
### 9.1 Mapa de Navegación
|
||
|
||
```
|
||
SIDEBAR:
|
||
├── 🏠 Dashboard
|
||
├── 📊 Métricas (Core, Startup, Enterprise)
|
||
├── 📄 Reportes (Generar, Historial, Programados)
|
||
├── 💰 Transacciones (Ingresos, Gastos, CxC, CxP)
|
||
├── 🧾 CFDIs (Emitidos, Recibidos, Complementos)
|
||
├── 👥 Contactos (Clientes, Proveedores)
|
||
├── 🔗 Integraciones (SAT, Contables)
|
||
├── 🔔 Alertas
|
||
├── 📈 Presupuestos
|
||
└── ⚙️ Configuración
|
||
```
|
||
|
||
### 9.2 Flujo de Onboarding
|
||
|
||
1. **Registro**: Email + contraseña o OAuth
|
||
2. **Información empresa**: RFC, industria, tamaño, ingresos
|
||
3. **Conectar SAT**: Upload FIEL (.cer, .key, contraseña)
|
||
4. **Sincronización**: Descarga automática de CFDIs
|
||
5. **Sistema contable** (opcional): Seleccionar y configurar
|
||
6. **¡Listo!**: Dashboard con métricas
|
||
|
||
### 9.3 Pantallas Principales
|
||
|
||
- **Dashboard**: KPIs, gráficas, alertas, acciones rápidas
|
||
- **Métricas**: Tabs por módulo, gráficas de tendencia, detalles
|
||
- **Generar Reporte**: Selección tipo, período, opciones, generación
|
||
- **Transacciones**: Lista filtrable, detalles, categorización
|
||
- **CFDIs**: Lista, búsqueda, XML, complementos de pago
|
||
- **Integraciones**: Estado de conexiones, configuración, sync manual
|
||
|
||
---
|
||
|
||
## 10. Roadmap de Implementación
|
||
|
||
### 10.1 Resumen de Fases
|
||
|
||
| Fase | Nombre | Duración | Equipos |
|
||
|------|--------|----------|---------|
|
||
| 1 | Foundation | 2 semanas | 3 |
|
||
| 2 | Core MVP | 4 semanas | 4 |
|
||
| 3 | Integraciones | 4 semanas | 5 |
|
||
| 4 | IA y Reportes | 3 semanas | 3 |
|
||
| 5 | Scale & Polish | 3 semanas | 4 |
|
||
| **Total** | | **16 semanas** | |
|
||
|
||
### 10.2 Fase 1: Foundation (Semanas 1-2)
|
||
|
||
**Equipo A: Infraestructura**
|
||
- Setup monorepo Turborepo
|
||
- Configurar PostgreSQL, Redis, MinIO
|
||
- Docker Compose dev
|
||
- CI/CD pipeline básico
|
||
|
||
**Equipo B: Auth & Tenants**
|
||
- Sistema JWT + refresh tokens
|
||
- Registro, login, reset password
|
||
- Multi-tenant middleware
|
||
- Creación schemas tenant
|
||
|
||
**Equipo C: Frontend Base**
|
||
- Setup Next.js 14
|
||
- Tailwind + componentes UI
|
||
- Layout principal
|
||
- Sistema de rutas
|
||
|
||
**Entregables**:
|
||
- ✅ Repo configurado y funcionando
|
||
- ✅ Auth completo con multi-tenant
|
||
- ✅ Usuario puede registrarse y ver dashboard vacío
|
||
|
||
### 10.3 Fase 2: Core MVP (Semanas 3-6)
|
||
|
||
**Equipo A: Integración SAT**
|
||
- Upload y validación FIEL
|
||
- Conexión Web Service SAT
|
||
- Descarga masiva CFDIs
|
||
- Parser XML, sync incremental
|
||
|
||
**Equipo B: Motor de Métricas**
|
||
- Modelo de transacciones
|
||
- Cálculo métricas Core
|
||
- Cache de métricas
|
||
- API endpoints
|
||
|
||
**Equipo C: Dashboard Frontend**
|
||
- Dashboard principal
|
||
- KPI cards, gráficas
|
||
- Selector período, comparativos
|
||
|
||
**Equipo D: Gestión de Datos**
|
||
- CRUD Contactos, Categorías
|
||
- Vista transacciones, CFDIs
|
||
- Filtros, búsqueda, exportar
|
||
|
||
**Entregables**:
|
||
- ✅ Usuario conecta SAT con FIEL
|
||
- ✅ CFDIs se descargan automáticamente
|
||
- ✅ Dashboard muestra métricas Core
|
||
|
||
### 10.4 Fase 3: Integraciones (Semanas 7-10)
|
||
|
||
**5 equipos paralelos**:
|
||
- Equipo A: CONTPAQi (SDK + Agente)
|
||
- Equipo B: Aspel (Firebird + Agente)
|
||
- Equipo C: Odoo (XML-RPC)
|
||
- Equipo D: Alegra (REST API)
|
||
- Equipo E: SAP B1 + Métricas avanzadas
|
||
|
||
**Entregables**:
|
||
- ✅ 5 integraciones contables funcionando
|
||
- ✅ Agente local disponible
|
||
- ✅ Todas las métricas (+50) calculándose
|
||
|
||
### 10.5 Fase 4: IA y Reportes (Semanas 11-13)
|
||
|
||
**Equipo A: Pipeline IA**
|
||
- Integración DeepSeek API
|
||
- Construcción de contexto
|
||
- Prompt templates
|
||
- Validación respuestas
|
||
|
||
**Equipo B: Generación Reportes**
|
||
- Motor gráficas server-side
|
||
- Plantillas HTML/PDF
|
||
- Generación Excel, PowerPoint
|
||
- Job queue async
|
||
|
||
**Equipo C: UI Reportes + Alertas**
|
||
- Pantalla generar reporte
|
||
- Historial, visor PDF
|
||
- Sistema de alertas
|
||
- Centro notificaciones
|
||
|
||
**Entregables**:
|
||
- ✅ Reportes ejecutivos con IA
|
||
- ✅ 5 tipos de reportes
|
||
- ✅ Sistema de alertas funcionando
|
||
|
||
### 10.6 Fase 5: Scale & Polish (Semanas 14-16)
|
||
|
||
**Equipo A: Billing & Plans**
|
||
- Integración Stripe/Conekta
|
||
- Planes y precios
|
||
- Trial, upgrade/downgrade
|
||
- Facturación CFDI
|
||
|
||
**Equipo B: Admin & Settings**
|
||
- Gestión usuarios, roles
|
||
- Multi-RFC, presupuestos
|
||
- Reportes programados
|
||
|
||
**Equipo C: API & Webhooks**
|
||
- API REST documentada
|
||
- API keys, rate limiting
|
||
- Webhooks salientes
|
||
|
||
**Equipo D: QA & Launch**
|
||
- Testing E2E
|
||
- Performance, security
|
||
- Bug fixes, landing page
|
||
- Deploy producción
|
||
|
||
**Entregables**:
|
||
- ✅ Sistema de pagos funcionando
|
||
- ✅ API documentada
|
||
- ✅ Plataforma lista para producción
|
||
|
||
### 10.7 Hitos Clave
|
||
|
||
| Semana | Hito |
|
||
|--------|------|
|
||
| 2 | Auth + Multi-tenant funcionando |
|
||
| 6 | MVP con SAT + Dashboard + Métricas Core |
|
||
| 10 | 5 integraciones + Métricas completas |
|
||
| 13 | Reportes con IA + Alertas |
|
||
| 16 | **LAUNCH** - Plataforma en producción |
|
||
|
||
### 10.8 Recursos Estimados
|
||
|
||
- 4-5 desarrolladores full-stack
|
||
- 1 diseñador UI/UX (parcial)
|
||
- 1 QA engineer (desde semana 10)
|
||
- Claude Code como multiagente para acelerar
|
||
|
||
### 10.9 Dependencias Externas
|
||
|
||
- API DeepSeek (cuenta y créditos)
|
||
- Procesador de pagos (Stripe/Conekta)
|
||
- Acceso APIs sistemas contables para testing
|
||
- Servidor Windows para agente (desarrollo)
|
||
|
||
---
|
||
|
||
## Apéndices
|
||
|
||
### A. Glosario
|
||
|
||
| Término | Definición |
|
||
|---------|------------|
|
||
| CFDI | Comprobante Fiscal Digital por Internet |
|
||
| FIEL | Firma Electrónica Avanzada (e.firma del SAT) |
|
||
| MRR | Monthly Recurring Revenue |
|
||
| ARR | Annual Recurring Revenue |
|
||
| CAC | Customer Acquisition Cost |
|
||
| LTV | Lifetime Value |
|
||
| EBITDA | Earnings Before Interest, Taxes, Depreciation, Amortization |
|
||
| CxC | Cuentas por Cobrar |
|
||
| CxP | Cuentas por Pagar |
|
||
|
||
### B. Referencias
|
||
|
||
- Repositorio Horux360: https://git.consultoria-as.com/consultoria-as/Horux360
|
||
- Monthly.la: https://monthly.la
|
||
- DeepSeek API: https://platform.deepseek.com
|
||
- SAT Web Services: https://www.sat.gob.mx
|
||
|
||
---
|
||
|
||
**Documento aprobado para implementación**
|
||
|
||
*Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>*
|