Initial commit: Horux Strategy project setup

- 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>
This commit is contained in:
2026-01-31 09:50:44 +00:00
commit c1321c3f0c
6 changed files with 967 additions and 0 deletions

107
README.md Normal file
View File

@@ -0,0 +1,107 @@
# 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)