Files
dacli/docs/decisions/0004-menu-create-type3-moduleid.md
T

2.2 KiB

0004-menu-create-type3-moduleid

⚠️ 引用归档说明 (2026-07-23): 本 ADR 引用 drift/R5, 已迁 dacli/docs/archive/drift-rounds-2026-07/2026-07-14-round5-menu-workflow-summary.md. 路径仅溯源不变.

日期: 2026-07-17 状态: Accepted 作者: claude-code

Context

dacli menu create --type=3 (表单列表模式) 需要关联一个表单模块。当不传 --moduleId 时, 后端 API 返回 400, 因为 type=3 的 menu 必须绑定 moduleId 才能生成前端路由和列表页。

drift/R5 发现: dacli 简化版 menu create 不强制 moduleId, 用户传 --formId=<id> 但 dacli 没有自动将 formId 映射为 moduleId。导致 menu 创建失败或 menu 创建成功但列表页空白 (没有绑定表单模块)。

影响范围: AP-mc-1, 涉及所有 type=3 菜单创建。

Decision

dacli menu create --type=3 必传 --moduleId=<formId>, 命令层在 parseArgs 阶段校验。如果用户不确定 moduleId, 走低级模式:

dacli menu create --type=3 --urlAddress=model/{enCode} --parentId=...

低级模式不验证 moduleId 存在性, 但如果目标表单字段不完整, 列表页会空白 (无列定义)。

CLAUDE.md § 盲点 50 记录了此问题 + 两条路径的优缺点。

Alternatives Considered

  1. dacli 自动从 formId 推导 moduleId: formId 和 moduleId 在 JNPF 中是同一个值 (表单发布后的 ID), dacli 可以自动填充。但 form 可能未发布 (moduleId 不存在), 自动推导会静默使用错误值。
  2. 全部走低级模式 (urlAddress): 绕过了 moduleId 校验, 但丢失了 JNPF 的模块绑定能力 (权限/数据范围等依赖 moduleId)。
  3. menu create 自动查 formId→moduleId: dacli 可以 dacli form info 查 state=1 后再填充, 但增加 API 调用延迟。

Consequences

正面

  • 明确的参数要求, 降低静默错误的概率
  • 低级模式兜底覆盖 moduleId 不确定的场景

负面

  • 用户需手动查 formId (dacli form list), 多一步
  • 低级模式不校验, 列表空白问题仍需用户自行发现

Cross-refs

  • ANTI_PATTERNS: AP-mc-1
  • CLAUDE.md § 盲点 50: 菜单创建 "主表不存在"
  • CLAUDE.md § 盲点 51: 浏览器层列表白屏 (与列定义缺失相关)