erp-mecanicas-diesel/README.md

86 lines
3.2 KiB
Markdown

# ERP Mecanicas Diesel
## Descripcion
Sistema ERP especializado para laboratorios y talleres de mecanica diesel. Incluye modulos especificos para diagnosticos, reparaciones, gestion de refacciones e inventario.
**Estado:** Documentacion completa - Listo para desarrollo
**Version:** 1.0.0
**Tipo:** Proyecto independiente
## Estructura del Proyecto
```
mecanicas-diesel/
├── backend/ # APIs y servicios (NestJS + TypeScript)
├── frontend/ # UI especializada (React + TypeScript)
├── database/ # DDL y scripts de base de datos
│ └── init/ # Scripts de inicializacion
├── docs/ # Documentacion del proyecto
│ ├── 00-vision-general/ # Vision y objetivos
│ ├── 02-definicion-modulos/ # Modulos y user stories
│ ├── 03-modelo-datos/ # Documentacion de schemas
│ ├── 08-epicas/ # Epicas del proyecto
│ └── 90-transversal/ # Documentacion transversal
└── orchestration/ # Sistema de agentes
├── 00-guidelines/ # Guias del proyecto
├── inventarios/ # Inventarios de componentes
└── PROXIMA-ACCION.md # Siguiente paso a ejecutar
```
## Modulos del MVP
| Modulo | Codigo | Descripcion | Estado |
|--------|--------|-------------|--------|
| Fundamentos | MMD-001 | Configuracion, usuarios, tenants | Documentado |
| Ordenes de Servicio | MMD-002 | Gestion de servicios y trabajos | Documentado |
| Diagnosticos | MMD-003 | Pruebas y diagnosticos diesel | Documentado |
| Inventario | MMD-004 | Stock de refacciones | Documentado |
| Vehiculos | MMD-005 | Registro y control de unidades | Documentado |
| Cotizaciones | MMD-006 | Presupuestos de reparacion | Documentado |
## Schemas de Base de Datos
| Schema | Tablas | Descripcion |
|--------|--------|-------------|
| workshop_core | 9 | Configuracion, usuarios, clientes |
| service_management | 14+ | Ordenes, diagnosticos, cotizaciones |
| parts_management | 12+ | Inventario, refacciones, garantias |
| vehicle_management | 8 | Vehiculos, flotas, motores |
| notifications | 6 | Tracking, followers, actividades |
| analytics | 4 | Contabilidad analitica |
| purchasing | 5 | Compras y proveedores |
**Total:** 65+ tablas con RLS multi-tenant
## Stack Tecnologico
- **Base de datos:** PostgreSQL 15+ con Row Level Security
- **Backend:** Node.js + NestJS + TypeScript
- **Frontend:** React + TypeScript
- **Autenticacion:** JWT + RBAC
## Documentacion
- **Estado del proyecto:** `PROJECT-STATUS.md`
- **Vision:** `docs/00-vision-general/VISION.md`
- **Epicas:** `docs/08-epicas/`
- **User Stories:** `docs/02-definicion-modulos/*/historias-usuario/`
- **Modelo de datos:** `docs/03-modelo-datos/`
## Inicio Rapido
```bash
# Crear base de datos
createdb mecanicas_diesel_db
# Ejecutar scripts DDL en orden
psql -d mecanicas_diesel_db -f database/init/00-extensions.sql
psql -d mecanicas_diesel_db -f database/init/01-create-schemas.sql
psql -d mecanicas_diesel_db -f database/init/02-rls-functions.sql
# ... continuar con los demas scripts
```
---
*Proyecto parte de ERP Suite - Fabrica de Software con Agentes IA*