| id |
title |
type |
status |
version |
created_date |
updated_date |
| STACK-TECNOLOGICO-ERP-CORE |
Stack Tecnologico - ERP Core |
Technical |
Published |
1.0.0 |
2026-01-10 |
2026-01-10 |
Stack Tecnologico - ERP Core
Detalle completo del stack tecnologico utilizado en ERP Core
Resumen
ERP Core utiliza un stack moderno basado en TypeScript tanto en backend como en frontend, con PostgreSQL como base de datos principal y servicios externos para funcionalidades SaaS e IA.
1. Backend
1.1 Core
| Tecnologia |
Version |
Proposito |
| Node.js |
20+ LTS |
Runtime de JavaScript |
| Express.js |
4.x |
Framework HTTP |
| TypeScript |
5.3+ |
Lenguaje tipado |
| TypeORM |
0.3.17+ |
ORM para PostgreSQL |
1.2 Autenticacion y Seguridad
| Tecnologia |
Version |
Proposito |
| jsonwebtoken |
9.x |
Generacion/validacion JWT |
| bcryptjs |
2.x |
Hash de passwords |
| helmet |
7.x |
Headers de seguridad |
| cors |
2.x |
Cross-Origin Resource Sharing |
1.3 Validacion
| Tecnologia |
Version |
Proposito |
| Zod |
3.x |
Validacion de schemas |
| class-validator |
0.14+ |
Validacion de DTOs |
| class-transformer |
0.5+ |
Transformacion de objetos |
1.4 Documentacion
| Tecnologia |
Version |
Proposito |
| Swagger/OpenAPI |
3.x |
Especificacion de API |
| swagger-ui-express |
5.x |
UI de documentacion |
1.5 Testing
| Tecnologia |
Version |
Proposito |
| Jest |
29.x |
Framework de testing |
| supertest |
6.x |
Testing de HTTP |
1.6 Utilidades
| Tecnologia |
Version |
Proposito |
| Winston |
3.x |
Logging estructurado |
| dotenv |
16.x |
Variables de entorno |
| uuid |
9.x |
Generacion de UUIDs |
| date-fns |
3.x |
Manipulacion de fechas |
1.7 SaaS y Colas
| Tecnologia |
Version |
Proposito |
| Stripe SDK |
Latest |
Billing y suscripciones |
| BullMQ |
5.x |
Colas de trabajos |
| ioredis |
5.x |
Cliente Redis |
1.8 IA y Comunicacion
| Tecnologia |
Version |
Proposito |
| OpenRouter Client |
Latest |
Gateway LLM |
| @anthropic-ai/sdk |
Latest |
SDK de Anthropic (MCP) |
| Socket.io |
4.x |
WebSocket real-time |
2. Frontend
2.1 Core
| Tecnologia |
Version |
Proposito |
| React |
18.x |
Framework UI |
| Vite |
5.x |
Build tool y dev server |
| TypeScript |
5.3+ |
Lenguaje tipado |
2.2 State Management
| Tecnologia |
Version |
Proposito |
| Zustand |
4.x |
Estado global ligero |
| React Query |
5.x |
Cache y fetching de datos |
2.3 Estilos
| Tecnologia |
Version |
Proposito |
| Tailwind CSS |
4.x |
Utility-first CSS |
| clsx |
2.x |
Condicionales de clases |
2.4 Formularios
| Tecnologia |
Version |
Proposito |
| React Hook Form |
7.x |
Manejo de formularios |
| @hookform/resolvers |
3.x |
Validacion con Zod |
| Zod |
3.x |
Schemas de validacion |
2.5 Navegacion
| Tecnologia |
Version |
Proposito |
| React Router |
6.x |
Routing SPA |
2.6 UI Components
| Tecnologia |
Version |
Proposito |
| Radix UI |
Latest |
Primitivos accesibles |
| Lucide React |
Latest |
Iconos |
2.7 Utilidades
| Tecnologia |
Version |
Proposito |
| axios |
1.x |
Cliente HTTP |
| date-fns |
3.x |
Fechas |
| Socket.io-client |
4.x |
WebSocket |
2.8 Testing
| Tecnologia |
Version |
Proposito |
| Vitest |
1.x |
Testing unitario |
| Playwright |
Latest |
Testing E2E |
| Testing Library |
14.x |
Testing de componentes |
3. Database
3.1 Motor Principal
| Tecnologia |
Version |
Proposito |
| PostgreSQL |
16+ |
Base de datos relacional |
3.2 Extensiones PostgreSQL
| Extension |
Proposito |
| uuid-ossp |
Generacion de UUIDs |
| pg_trgm |
Busqueda fuzzy/trigrams |
| pgcrypto |
Encriptacion de datos |
3.3 Caracteristicas Utilizadas
| Caracteristica |
Proposito |
| Row-Level Security (RLS) |
Aislamiento multi-tenant |
| JSONB |
Datos flexibles (configs, metadata) |
| Generated Columns |
Columnas calculadas |
| Partial Indexes |
Optimizacion de queries |
3.4 Cache y Colas
| Tecnologia |
Version |
Proposito |
| Redis |
7.x |
Cache, sessions, colas |
4. Servicios Externos
4.1 Pagos y Billing
| Servicio |
Proposito |
| Stripe |
Suscripciones, pagos, facturas |
4.2 Comunicaciones
| Servicio |
Proposito |
| SendGrid |
Email transaccional |
| AWS SES |
Email (alternativo) |
| Web Push API |
Notificaciones push |
| Meta WhatsApp Business |
Mensajeria WhatsApp |
4.3 Almacenamiento
| Servicio |
Proposito |
| AWS S3 |
Storage de archivos |
| Cloudflare R2 |
Storage (alternativo) |
| MinIO |
Storage self-hosted |
4.4 Inteligencia Artificial
| Servicio |
Proposito |
| OpenRouter |
Gateway a 50+ modelos LLM |
| OpenAI Whisper |
Transcripcion de audio |
| Google Vision |
OCR y vision por computadora |
5. DevOps
5.1 Contenedores
| Tecnologia |
Version |
Proposito |
| Docker |
24+ |
Contenedorizacion |
| Docker Compose |
2.x |
Orquestacion local |
5.2 CI/CD
| Tecnologia |
Proposito |
| GitHub Actions |
Pipeline de CI/CD |
5.3 Linting y Formateo
| Tecnologia |
Version |
Proposito |
| ESLint |
8.x |
Linting de codigo |
| Prettier |
3.x |
Formateo de codigo |
6. Versiones Minimas Requeridas
| Componente |
Version Minima |
| Node.js |
20.0.0 |
| npm |
10.0.0 |
| PostgreSQL |
15.0 |
| Redis |
7.0 |
| Docker |
24.0 |
7. Setup de Desarrollo
7.1 Prerrequisitos
# Verificar versiones
node --version # >= 20.0.0
npm --version # >= 10.0.0
docker --version # >= 24.0.0
7.2 Instalacion
# Clonar repositorio
git clone <repo-url> erp-core
cd erp-core
# Instalar dependencias
npm install
# Copiar variables de entorno
cp .env.example .env
# Levantar servicios con Docker
docker-compose up -d
# Ejecutar migraciones
npm run db:migrate
# Iniciar desarrollo
npm run dev
7.3 Puertos por Defecto
| Servicio |
Puerto |
| Backend API |
3000 |
| Frontend |
5173 |
| PostgreSQL |
5432 |
| Redis |
6379 |
| MCP Server |
3142 |
| WhatsApp Service |
3143 |
Referencias
Actualizado: 2026-01-10
rckrdmrd
0086695b4c