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
parent 5b8f71e0de
commit 06c4fb9130
14 changed files with 1919 additions and 0 deletions
@@ -0,0 +1,89 @@
+//! Validación de los 6 módulos demo en `examples/nakui-modules/`.
+//!
+//! Si esto verde, garantizamos que un usuario que clone el repo y
+//! corra `NAKUI_MODULES_DIR=examples/nakui-modules cargo run -p nakui-ui`
+//! va a obtener los 6 módulos cargados sin tocar nada.
+
+use nakui_ui_schema::{load_modules_from_dir, FieldKind, View};
+
+fn examples_dir() -> std::path::PathBuf {
+    // Tests corren desde el dir del crate; el repo root está dos
+    // niveles arriba: crates/modules/nakui/ui-schema → repo.
+    let here = std::path::Path::new(env!("CARGO_MANIFEST_DIR"));
+    here.join("../../../..").join("examples/nakui-modules")
+}
+
+#[test]
+fn loads_all_six_demo_modules() {
+    let dir = examples_dir();
+    let mods = load_modules_from_dir(&dir).unwrap_or_else(|e| {
+        panic!("load failed for {}: {e}", dir.display());
+    });
+    let ids: Vec<&str> = mods.iter().map(|m| m.id.as_str()).collect();
+    assert_eq!(
+        ids,
+        vec![
+            "customers",
+            "inventory_movements",
+            "invoices",
+            "products",
+            "sales_orders",
+            "suppliers",
+        ],
+        "expected 6 modules in alphabetical order"
+    );
+}
+
+#[test]
+fn every_demo_module_has_list_and_form_views() {
+    let mods = load_modules_from_dir(examples_dir()).unwrap();
+    for m in &mods {
+        let mut has_list = false;
+        let mut has_form = false;
+        for v in m.views.values() {
+            match v {
+                View::List(_) => has_list = true,
+                View::Form(_) => has_form = true,
+            }
+        }
+        assert!(
+            has_list && has_form,
+            "module {} should expose at least one list + one form view",
+            m.id
+        );
+    }
+}
+
+#[test]
+fn every_demo_form_field_kind_is_recognized() {
+    // Sanity: ningún módulo demo usa un kind que no esté en el enum
+    // (sería rechazado al parsear, pero check explícito no daña).
+    let mods = load_modules_from_dir(examples_dir()).unwrap();
+    for m in &mods {
+        for v in m.views.values() {
+            if let View::Form(form) = v {
+                for f in &form.fields {
+                    let _ok = matches!(
+                        f.kind,
+                        FieldKind::Text
+                            | FieldKind::Multiline
+                            | FieldKind::Number
+                            | FieldKind::Boolean
+                            | FieldKind::Date
+                    );
+                }
+            }
+        }
+    }
+}
+
+#[test]
+fn every_module_validates_clean() {
+    // validate() chequea que cada MenuItem.view exista en views.
+    // Un typo en cualquiera de los 6 módulos haría fallar este test.
+    let mods = load_modules_from_dir(examples_dir()).unwrap();
+    for m in &mods {
+        m.validate()
+            .unwrap_or_else(|e| panic!("module {} failed validate: {e}", m.id));
+    }
+}