Files
Sergio 06c4fb9130 feat(nakui): metainterfaz declarativa + 6 modulos ERP estandar
Salto cualitativo: Nakui pasa de "library + demos + read-only viewer
del event log" a plataforma ERP con UI dirigida por datos. Cada
modulo de negocio se declara como un module.json (sin codigo Rust
nuevo) y el runtime GPUI lo carga dinamicamente: sidebar de menus,
listas con columnas configurables, formularios de alta.

3 entregables:

1. Crate nakui-ui-schema (datos puros): Module, View::List/Form,
   FieldSpec con FieldKind {Text|Multiline|Number|Boolean|Date},
   Action {OpenView|SeedEntity|Morphism}. Module::from_path,
   Module::validate, load_modules_from_dir(dir). 6 tests unit + 4
   integration.

2. Crate nakui-ui (binario GPUI): carga modulos desde
   NAKUI_MODULES_DIR. Sidebar + main panel. List view con tabla
   weighted; form view con campos labeled + submit que ejecuta
   SeedEntity contra MemoryStore in-process compartido. Toast +
   error banner. 6 tests unit.

3. 6 modulos demo en examples/nakui-modules/:
   - customers (nombre, email, telefono, credito, notas)
   - products (SKU, nombre, categoria, precio, stock)
   - suppliers (razon social, ID fiscal, contacto, terminos pago)
   - inventory_movements (fecha, tipo, SKU, cantidad, costo, motivo)
   - sales_orders (numero, cliente, fechas, estado, totales)
   - invoices (numero, cliente, fechas, totales, pagado, moneda)

Filosofia: UI como datos. Persistencia universal (MemoryStore hoy,
SurrealStore manana, sin tocar module.json). Schema primero, semantica
despues.

Activacion:
  NAKUI_MODULES_DIR=examples/nakui-modules cargo run -p nakui-ui

Limitaciones conocidas (proximos iters):
- Inputs sin teclado (GPUI no lo trae nativo; integrar
  yahweh-widget-text-input).
- Click handlers no propagan mutacion al estado (refactor con
  cx.listener pendiente).
- Action::Morphism queda como TODO hasta cargar Manifest junto al
  Module.
- Sin persistencia entre runs (wire con EventLog/SurrealStore para
  cuando el daemon Nakui exista).

Tests: 16 totales nuevos. Lo que esto desbloquea: cualquiera puede
escribir un module.json para su dominio (pacientes, alumnos,
reservaciones) y aparece en la UI sin recompilar.
2026-05-09 19:54:21 +00:00

73 lines
3.4 KiB
JSON

{
"id": "invoices",
"label": "Facturación",
"description": "Facturas emitidas y su seguimiento de pago.",
"entities": [
{
"name": "invoice",
"label": "Factura",
"fields": [
{ "name": "invoice_number", "label": "N° factura", "kind": "text", "required": true },
{ "name": "customer_name", "label": "Cliente", "kind": "text", "required": true },
{ "name": "issued_at", "label": "Emitida", "kind": "date", "required": true },
{ "name": "due_at", "label": "Vencimiento", "kind": "date", "required": true },
{ "name": "subtotal", "label": "Subtotal", "kind": "number", "default": "0" },
{ "name": "tax", "label": "Impuestos", "kind": "number", "default": "0" },
{ "name": "total", "label": "Total", "kind": "number", "default": "0" },
{ "name": "amount_paid", "label": "Pagado", "kind": "number", "default": "0" },
{ "name": "status", "label": "Estado", "kind": "text", "required": true, "default": "issued", "help": "draft / issued / partially_paid / paid / overdue / void" },
{ "name": "currency", "label": "Moneda", "kind": "text", "default": "USD" },
{ "name": "reference_order", "label": "Orden referencia", "kind": "text" }
]
}
],
"menu": [
{ "label": "Facturas", "view": "list", "icon": "💳" },
{ "label": "Nueva factura", "view": "form", "icon": "✚" }
],
"views": {
"list": {
"kind": "list",
"title": "Facturas",
"entity": "invoice",
"columns": [
{ "field": "invoice_number", "label": "N°", "weight": 1.0 },
{ "field": "customer_name", "label": "Cliente", "weight": 2.0 },
{ "field": "issued_at", "label": "Emitida", "weight": 1.0 },
{ "field": "due_at", "label": "Vence", "weight": 1.0 },
{ "field": "total", "label": "Total", "weight": 1.0 },
{ "field": "amount_paid", "label": "Pagado", "weight": 1.0 },
{ "field": "currency", "label": "Mon.", "weight": 0.5 },
{ "field": "status", "label": "Estado", "weight": 0.9 }
],
"actions": [
{ "kind": "open_view", "view": "form", "label": "✚ Nueva" }
],
"search_in": ["invoice_number", "customer_name", "reference_order"]
},
"form": {
"kind": "form",
"title": "Nueva factura",
"entity": "invoice",
"fields": [
{ "name": "invoice_number", "label": "Número de factura", "kind": "text", "required": true },
{ "name": "customer_name", "label": "Cliente", "kind": "text", "required": true },
{ "name": "issued_at", "label": "Fecha de emisión", "kind": "date", "required": true },
{ "name": "due_at", "label": "Fecha de vencimiento", "kind": "date", "required": true },
{ "name": "subtotal", "label": "Subtotal", "kind": "number", "default": "0" },
{ "name": "tax", "label": "Impuestos", "kind": "number", "default": "0" },
{ "name": "total", "label": "Total", "kind": "number", "default": "0" },
{ "name": "amount_paid", "label": "Pagado", "kind": "number", "default": "0" },
{ "name": "status", "label": "Estado", "kind": "text", "required": true, "default": "issued" },
{ "name": "currency", "label": "Moneda", "kind": "text", "default": "USD" },
{ "name": "reference_order", "label": "Orden de venta referenciada", "kind": "text" }
],
"on_submit": {
"kind": "seed_entity",
"entity": "invoice",
"next_view": "list"
}
}
}
}