# 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

```bash
# 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](./docs/plans/2026-01-31-horux-strategy-design.md)
- [API Documentation](./docs/api/) (próximamente)
- [Guía de Contribución](./CONTRIBUTING.md) (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](https://horux360.com)