HORUX360 a9b1994c48 feat: Implement Phase 1 & 2 - Full monorepo architecture
## Backend API (apps/api)
- Express.js server with TypeScript
- JWT authentication with access/refresh tokens
- Multi-tenant middleware (schema per tenant)
- Complete CRUD routes: auth, cfdis, transactions, contacts, categories, metrics, alerts
- SAT integration: CFDI 4.0 XML parser, FIEL authentication
- Metrics engine: 50+ financial metrics (Core, Startup, Enterprise)
- Rate limiting, CORS, Helmet security

## Frontend Web (apps/web)
- Next.js 14 with App Router
- Authentication pages: login, register, forgot-password
- Dashboard layout with Sidebar and Header
- Dashboard pages: overview, cash-flow, revenue, expenses, metrics
- Zustand stores for auth and UI state
- Theme support with flash prevention

## Database Package (packages/database)
- PostgreSQL migrations with multi-tenant architecture
- Public schema: plans, tenants, users, sessions, subscriptions
- Tenant schema: sat_credentials, cfdis, transactions, contacts, accounts, alerts
- Tenant management functions
- Seed data for plans and super admin

## Shared Package (packages/shared)
- TypeScript types: auth, tenant, financial, metrics, reports
- Zod validation schemas for all entities
- Utility functions for formatting

## UI Package (packages/ui)
- Chart components: LineChart, BarChart, AreaChart, PieChart
- Data components: DataTable, MetricCard, KPICard, AlertBadge
- PeriodSelector and Skeleton components

## Infrastructure
- Docker Compose: PostgreSQL 15, Redis 7, MinIO, Mailhog
- Makefile with 25+ development commands
- Development scripts: dev-setup.sh, dev-down.sh
- Complete .env.example template

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 11:05:24 +00:00

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

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

Description
CFO Digital para Empresas Mexicanas - Plataforma de inteligencia financiera con dashboards en tiempo real y reportes ejecutivos con IA
Readme 832 KiB
Languages
TypeScript 98.3%
Shell 0.6%
CSS 0.3%
Makefile 0.3%
PLpgSQL 0.3%
Other 0.2%