- 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>
108 lines
2.9 KiB
Markdown
108 lines
2.9 KiB
Markdown
# 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)
|