tawasuyu/brahman
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(nakui): Fase 1 del ERP — FieldKind Select + AutoId, seed inyecta id

Browse Source 
Primera fase del plan maestro. La metainterfaz gana dos tipos de campo:
Select (chips de un conjunto cerrado, con options validadas) y AutoId
(UUID autogenerado read-only). NakuiBackend::seed inyecta el id de la
entity = clave del store. El módulo CRM los adopta: etapa/canal son
selects, los ids de idempotencia se autogeneran, el form de cliente ya
no pide id. Ningún formulario pide un UUID a mano.

Tests en meta-schema, meta-runtime y nakui-ui verdes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
sergio
2026-05-21 18:55:13 +00:00
parent 0d1e378e42
commit 86d06da020
12 changed files with 442 additions and 210 deletions
Download Patch File Download Diff File Expand all files Collapse all files
crates/modules/nahual/libs/meta-schema/src/lib.rs
+138 -10
View File
@@ -190,6 +190,10 @@ pub struct FieldSpec {
/// Para los demás kinds, este campo se ignora.
#[serde(default)]
pub ref_entity: Option<String>,
/// Opciones de un campo `kind == Select`. Ignorado para los demás
/// kinds. `Module::validate` exige que un Select las tenga.
#[serde(default)]
pub options: Vec<SelectOption>,
}
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
@@ -210,6 +214,31 @@ pub enum FieldKind {
/// `FieldSpec.ref_entity`; el value almacenado es el UUID del
/// seleccionado, parseable como cualquier text/UUID al submit.
EntityRef,
/// Valor elegido de un conjunto cerrado declarado en
/// `FieldSpec.options`. El runtime lo renderiza como selección
/// (no texto libre). `Module::validate` exige `options` no vacío.
Select,
/// Identificador autogenerado (UUID v4). El runtime lo rellena al
/// abrir el formulario; el usuario no lo teclea ni lo edita. Para
/// los ids de idempotencia que piden los morfismos.
AutoId,
}
/// Una opción de un campo [`FieldKind::Select`].
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SelectOption {
/// Valor que se guarda (lo que recibe el backend o el morfismo).
pub value: String,
/// Etiqueta legible. Si se omite, se muestra el `value` crudo.
#[serde(default)]
pub label: Option<String>,
}
impl SelectOption {
/// Texto a mostrar: `label` si está, sino el `value`.
pub fn display(&self) -> &str {
self.label.as_deref().unwrap_or(&self.value)
}
}
/// Acciones disparables por menús, botones o submit de formularios.
@@ -307,6 +336,15 @@ pub enum SchemaError {
view: String,
field: String,
},
#[error(
"módulo {id} vista '{view}': field '{field}' tiene kind=select \
pero no declaró options"
)]
SelectMissingOptions {
id: String,
view: String,
field: String,
},
}
impl Module {
@@ -349,6 +387,13 @@ impl Module {
field: f.name.clone(),
});
}
if f.kind == FieldKind::Select && f.options.is_empty() {
return Err(SchemaError::SelectMissingOptions {
id: self.id.clone(),
view: view_key.clone(),
field: f.name.clone(),
});
}
}
}
}
@@ -419,6 +464,7 @@ mod tests {
required: true,
help: None,
ref_entity: None,
options: Vec::new(),
},
FieldSpec {
name: "email".into(),
@@ -428,6 +474,7 @@ mod tests {
required: false,
help: Some("Opcional".into()),
ref_entity: None,
options: Vec::new(),
},
],
}],
@@ -481,6 +528,7 @@ mod tests {
required: true,
help: None,
ref_entity: None,
options: Vec::new(),
}],
on_submit: Action::SeedEntity {
entity: "customer".into(),
@@ -573,6 +621,7 @@ mod tests {
required: true,
help: None,
ref_entity: None,
options: Vec::new(),
}],
on_submit: Action::SeedEntity {
entity: "customer".into(),
@@ -603,6 +652,7 @@ mod tests {
required: true,
help: None,
ref_entity: Some("supplier".into()),
options: Vec::new(),
}],
on_submit: Action::SeedEntity {
entity: "customer".into(),
@@ -618,6 +668,92 @@ mod tests {
m.validate().unwrap();
}
#[test]
fn select_without_options_is_rejected() {
let mut m = sample_module();
m.views.insert(
"sel_form".into(),
View::Form(FormView {
title: "Select roto".into(),
entity: "customer".into(),
fields: vec![FieldSpec {
name: "estado".into(),
label: "Estado".into(),
kind: FieldKind::Select,
default: None,
required: true,
help: None,
ref_entity: None,
options: Vec::new(),
}],
on_submit: Action::SeedEntity {
entity: "customer".into(),
next_view: None,
},
}),
);
let err = m.validate().unwrap_err();
assert!(
matches!(err, SchemaError::SelectMissingOptions { .. }),
"got: {err:?}"
);
}
#[test]
fn select_with_options_validates_clean() {
let mut m = sample_module();
m.views.insert(
"sel_form".into(),
View::Form(FormView {
title: "Select OK".into(),
entity: "customer".into(),
fields: vec![FieldSpec {
name: "estado".into(),
label: "Estado".into(),
kind: FieldKind::Select,
default: None,
required: true,
help: None,
ref_entity: None,
options: vec![
SelectOption {
value: "activo".into(),
label: Some("Activo".into()),
},
SelectOption {
value: "baja".into(),
label: None,
},
],
}],
on_submit: Action::SeedEntity {
entity: "customer".into(),
next_view: None,
},
}),
);
m.menu.push(MenuItem {
label: "Sel".into(),
view: "sel_form".into(),
icon: None,
});
m.validate().unwrap();
}
#[test]
fn select_option_display_falls_back_to_value() {
let with_label = SelectOption {
value: "x".into(),
label: Some("Equis".into()),
};
let bare = SelectOption {
value: "y".into(),
label: None,
};
assert_eq!(with_label.display(), "Equis");
assert_eq!(bare.display(), "y");
}
#[test]
fn load_modules_detects_duplicate_id() {
let tmp = tempfile::tempdir().unwrap();
@@ -626,16 +762,8 @@ mod tests {
std::fs::create_dir_all(&a_dir).unwrap();
std::fs::create_dir_all(&b_dir).unwrap();
let m = sample_module(); // id = "customers"
std::fs::write(
a_dir.join("module.json"),
serde_json::to_vec(&m).unwrap(),
)
.unwrap();
std::fs::write(
b_dir.join("module.json"),
serde_json::to_vec(&m).unwrap(),
)
.unwrap();
std::fs::write(a_dir.join("module.json"), serde_json::to_vec(&m).unwrap()).unwrap();
std::fs::write(b_dir.join("module.json"), serde_json::to_vec(&m).unwrap()).unwrap();
let err = load_modules_from_dir(tmp.path()).unwrap_err();
assert!(matches!(err, SchemaError::DuplicateModuleId { .. }));
}
crates/modules/nahual/libs/meta-schema/tests/example_modules.rs
+3 -2
View File
@@ -26,6 +26,7 @@ fn loads_all_demo_modules() {
assert_eq!(
ids,
vec![
"crm",
"customers",
"inventory_movements",
"invoices",
@@ -34,8 +35,8 @@ fn loads_all_demo_modules() {
"sales_orders",
"suppliers",
],
"expected 7 modules in alphabetical order \
(sales_engine se sumó al wirear Action::Morphism)"
"expected 8 modules in alphabetical order \
(crm se sumó como ERP con morfismos)"
);
}