# 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*