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:
107
README.md
Normal file
107
README.md
Normal 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)
|
||||
Reference in New Issue
Block a user