workspace-v1/projects/erp-core

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

# 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