115 lines
3.6 KiB
Markdown
115 lines
3.6 KiB
Markdown
# ERP Core - Base Genérica Reutilizable
|
|
|
|
## Descripción
|
|
|
|
ERP Core es el módulo base que proporciona el **60-70% del código compartido** para todas las verticales del ERP Suite. Contiene la funcionalidad común que será extendida por cada vertical específica.
|
|
|
|
**Estado:** En desarrollo (60%)
|
|
**Versión:** 0.1.0
|
|
|
|
## Estructura del Proyecto
|
|
|
|
```
|
|
erp-core/
|
|
├── backend/ # API REST (Node.js + Express + TypeScript)
|
|
│ ├── src/
|
|
│ │ ├── modules/ # Módulos de negocio
|
|
│ │ ├── shared/ # Código compartido
|
|
│ │ └── config/ # Configuración
|
|
│ ├── package.json
|
|
│ └── tsconfig.json
|
|
│
|
|
├── frontend/ # Web App (React + Vite + TypeScript)
|
|
│ ├── src/
|
|
│ │ ├── components/ # Componentes reutilizables
|
|
│ │ ├── pages/ # Páginas
|
|
│ │ ├── stores/ # Estado (Zustand)
|
|
│ │ └── services/ # Servicios API
|
|
│ ├── package.json
|
|
│ └── vite.config.ts
|
|
│
|
|
├── database/ # PostgreSQL
|
|
│ ├── ddl/ # Definiciones de tablas
|
|
│ ├── migrations/ # Migraciones
|
|
│ └── seeds/ # Datos iniciales
|
|
│
|
|
├── docs/ # Documentación del proyecto
|
|
│ ├── 00-vision-general/
|
|
│ ├── 01-fase-mvp/
|
|
│ ├── 02-modelado/
|
|
│ └── ...
|
|
│
|
|
└── orchestration/ # Sistema de agentes NEXUS
|
|
├── 00-guidelines/
|
|
│ └── CONTEXTO-PROYECTO.md
|
|
├── trazas/ # Historial de tareas por agente
|
|
│ ├── TRAZA-TAREAS-BACKEND.md
|
|
│ ├── TRAZA-TAREAS-FRONTEND.md
|
|
│ └── TRAZA-TAREAS-DATABASE.md
|
|
├── estados/ # Estado actual de agentes
|
|
└── PROXIMA-ACCION.md
|
|
```
|
|
|
|
## Stack Tecnológico
|
|
|
|
| Capa | Tecnología |
|
|
|------|------------|
|
|
| **Backend** | Node.js 20+, Express, TypeScript, TypeORM |
|
|
| **Frontend** | React 18, Vite, TypeScript, Tailwind CSS, Zustand |
|
|
| **Database** | PostgreSQL 15+ con RLS |
|
|
| **Auth** | JWT + bcryptjs |
|
|
|
|
## Módulos Core
|
|
|
|
| Módulo | Estado | Descripción |
|
|
|--------|--------|-------------|
|
|
| `auth` | En desarrollo | Autenticación y autorización |
|
|
| `users` | Planificado | Gestión de usuarios |
|
|
| `roles` | Planificado | Roles y permisos (RBAC) |
|
|
| `tenants` | Planificado | Multi-tenancy |
|
|
| `catalogs` | Planificado | Catálogos maestros |
|
|
| `settings` | Planificado | Configuración del sistema |
|
|
| `audit` | Planificado | Auditoría y logs |
|
|
| `reports` | Planificado | Sistema de reportes |
|
|
| `financial` | Planificado | Módulo financiero básico |
|
|
| `inventory` | Planificado | Módulo de inventario básico |
|
|
| `purchasing` | Planificado | Módulo de compras básico |
|
|
| `crm` | Planificado | CRM básico |
|
|
|
|
## Inicio Rápido
|
|
|
|
```bash
|
|
# Backend
|
|
cd backend
|
|
npm install
|
|
cp .env.example .env
|
|
npm run dev
|
|
|
|
# Frontend
|
|
cd frontend
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## Documentación
|
|
|
|
- **Contexto del proyecto:** `orchestration/00-guidelines/CONTEXTO-PROYECTO.md`
|
|
- **Próxima tarea:** `orchestration/PROXIMA-ACCION.md`
|
|
- **Trazas de agentes:** `orchestration/trazas/`
|
|
- **Documentación técnica:** `docs/`
|
|
|
|
## Relación con Verticales
|
|
|
|
Las verticales (construcción, vidrio-templado, etc.) **extienden** este core:
|
|
|
|
```
|
|
erp-core (60-70%)
|
|
↓ hereda
|
|
vertical-construccion (+30-40% específico)
|
|
vertical-vidrio-templado (+30-40% específico)
|
|
...
|
|
```
|
|
|
|
---
|
|
*Proyecto parte de ERP Suite - Fábrica de Software con Agentes IA*
|