2.2 KiB
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
- dacli 自动从 formId 推导 moduleId: formId 和 moduleId 在 JNPF 中是同一个值 (表单发布后的 ID), dacli 可以自动填充。但 form 可能未发布 (moduleId 不存在), 自动推导会静默使用错误值。
- 全部走低级模式 (urlAddress): 绕过了 moduleId 校验, 但丢失了 JNPF 的模块绑定能力 (权限/数据范围等依赖 moduleId)。
- 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: 浏览器层列表白屏 (与列定义缺失相关)