Warengine

Plataforma de gestión de inventario, facturación/POS, personal, activos internos y asistente conversacional con IA.

Arquitectura

Monorepo con tres zonas independientes:

Cómo arrancar en desarrollo

1. Base de datos

# Copia las variables de entorno
cp .env.example .env
# Edita .env con tus valores reales
# Levanta MySQL con Docker
docker-compose up -d

2. Backend

cd Backend
deno task dev-api       # Inicia la API REST
deno task dev-mcp       # Inicia el servidor MCP (en otra terminal)

3. Frontend

cd Frontend
npm install
npm run dev

Reglas de dependencia (resumen)

shared-kernel ← core ← database
                     ← platform
                           ↓
                       composition
                           ↓
                    apps/api  apps/mcp-server

Ver Docs/adr/0001-architecture-rules.md y Docs/context/proyecto-warengine.md para las reglas completas.

Documentación

• Docs/srs/ — Documento de Requisitos del Sistema (SRS)
• Docs/database/ — Script SQL completo de la base de datos
• Docs/adr/ — Decisiones de arquitectura (Architecture Decision Records)
• Docs/context/proyecto-warengine.md — Contexto vivo para desarrolladores y asistente IA