ERP Kernel — Intelisis (universal)
Bundle OKF 0.2 · 27 conceitos · carlosg2/sk-eve
Open source Repository Open in the app JSON README (API)
About
# ERP Kernel — Intelisis (universal)
Conocimiento estructural de Intelisis, compartido por todos los clientes.
`tenant: null`. Cambia lento (con releases del ERP). El kernel jamás contiene
datos de un cliente ni políticas locales.
# Ciclo de vida de movimientos (universal)
Todos los movimientos (CXP, Dinero, etc.) siguen el mismo ciclo:
`SINAFECTAR` (borrador) → `PENDIENTE` (afectado, pendiente) → `CONCLUIDO` · `CANCELADO`.
Las transiciones se ejecutan con el SP [Afectar](afectar.md), no con `update_record`.
# Entidades — módulo CXP / Tesorería
* [CXP](cxp.md) - Cuentas por Pagar (cabecera).
* [CxpD](cxpd.md) - Detalle de CXP.
* [CtaDinero](ctadinero.md) - Cuentas bancarias.
* [Dinero](dinero.md) - Tesorería (movimientos bancarios).
* [DineroD](dinerod.md) - Detalle de tesorería.
# Entidades — módulo VTAS / COMS / ART (ICF)
* [Venta](venta.md) - Cabecera de ventas (pedidos, facturas).
* [VentaD](ventad.md) - Detalle de ventas (renglones de artículos).
* [Compra](compra.md) - Cab
Details
- Kind
- OKF bundles
- Topic
- No topic detected
- Publisher
- carlosg2
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Last push
- 2026-08-22T04:13:20Z
- Repository state
- ativo
- Language
- Svelte
- Added
- 2026-09-09 12:03:57
- Updated
- 2026-09-09 12:03:57
- Origin id
carlosg2/sk-eve:company-twin/erp-kernel/index.md
README
# sk-eve — Agente ERP (Sigma AGI) Asistente conversacional de ERP **Intelisis** construido con **Eve** + **SvelteKit**. Se conecta al ERP vía **MCP sobre DAB** y responde preguntas de negocio con datos reales de SQL Server. Es la implementación de la tesis **Sigma AGI** (`tesis/`): tres abstracciones (Meta-fábrica, Agente, Company Twin) + Governance, con *recursive self-improvement*: el runtime captura errores → buffer → la fábrica (VS Code Copilot) promueve conocimiento a su hogar canónico. ## Stack | Capa | Tecnología | |---|---| | UI + SSR | SvelteKit 2 + Svelte 5 | | Agent framework | Eve 0.29.2 (embebido en Vite) | | LLM | `deepseek/deepseek-v4-flash-0731` vía AI Gateway de Vercel; modelo dinámico por agente | | MCP server | DAB custom; tenant ICF remoto `https://api2.maserp.mx/icf/mcp` (DAB local en 5050) | | Base de datos | SQL Server 2022 (Docker) | | Node.js | **24.x obligatorio** (Eve requiere ≥24) | ## Arranque ```bash # 1. SQL Server docker (ya debe estar corriendo) docker start sv5-sqlserver # 2. DAB custom (MCP server) — ver .github/copilot-instructions.md §DAB custom # (binario DLL con ~/.dotnet/dotnet, config symlink a dab/dab-config.json) # 3. SvelteKit + Eve nvm use 24 npm install npm run dev # → http://localhost:5173 (o 5174/5175 si hay conflicto) ``` Variables de entorno en `.env.local` (ver `.env.example`): `ANTHROPIC_API_KEY`, `AI_GATEWAY_API_KEY`, `INTELISIS_MCP_URL` (opcional). > El runbook operativo completo (gotchas de Eve, DAB build, protocolo de pruebas, > self-improvement) vive en **`.github/copilot-instructions.md`** — léelo antes de > tocar el agente. ## Estructura ``` agent/ # el agente: agent.ts, instructions/, hooks/, lib/, skill-library/ (19 skills), tools/ company-twin/ # el activo: erp-kernel/ (universal OKF) + companies/<tenant>/ (ICF, marmoles, joyarock…) evals/ # gates de regresión (npx eve eval) tesis/ # la tesis Sigma AGI (ver tesis/README.md) src/ # SvelteKit: /chat, /studio, /audit, /api/* scripts/ # probes de la meta-fábrica, linter de conocimiento, e2e .data/ # radiografía durable (sessions.sqlite3) — gitignored ``` ## Verificación (antes de cada cambio) ```bash nvm use 24 npm run check # svelte-check, 0 errores node scripts/check-knowledge.ts # linter de conocimiento vs MCP real: 0 críticos node_modules/.bin/eve eval --url http://127.0.0.1:62803/ --timeout 360000 # evals 4/4 ``` ## Documentación - `tesis/README.md` — guía de lectura de la tesis (arquitectura → tesis → constitución → ADRs) - `.github/copilot-instructions.md` — runbook operativo de la fábrica (VS Code Copilot) - `tesis/protocolo-pruebas.md` — protocolo de evaluación con evidencia (radiografía)