Files
dacli/docs/decisions
ssw f7bc8d55d0 docs(0014-app-clear-docs-coverage): app clear docs 残留缺口决策记录
事实: docs/jxcj 实测 14 项残留 (8 MD + 4 子目录 + 设计说明)
      不被清理, 历史 DOC_HTML_FILES 只清 4 html

根因: docs/dacli/ssw-dacli/.../ClearAppCommand.java 用 DOC_HTML_FILES 白名单
      Dacli 也复用了同样限制, 漏了所有非 html 文件

修复 (P1-2d commit 60adaab): dacli 端加 --clean-docs flag (默认 false 保持向后兼容)
  true:  docs/{app}/ 整体打包成 FileTarget, 移到 history-bak/{ts}/files/docs/{app}/
  false: 历史行为 + DRY-RUN 警告提示残留项数 + 提示 --clean-docs

决策依据:
- docs/{app}/ 是 ssw-loop 关卡 A/B/C 强依赖 (design/testcase/summary/learnings/plan/debug + _assets 6+ MD)
- 默认不改, 用户显式加 --clean-docs 才真清, history-bak 保留可还原
- 与 P0-3 (2026-07-15) DB fallback 同模式: --no-relation-form-auto / --autoRelease 等 flag

已知 ssw-common 端点 bug (留下游路线 §1):
- DbClearServiceImpl.listBizTables 走 openConn(appCode, null) 把 jxcj 当独立 db
- 但 jxcj 在 PG 共享库 j62 schema=jxcj, 不是独立 db
- 修复需要改 Java 5-10 处 + Maven 编译 + JNPF 重启 (Java 无 devtools auto-reload)
- 风险: testspace 当前活跃测试会中断
- 跨项目路线, 不在 dacli 端实现

下游路线 (ADR §Downstream):
1. ssw-common 端点改进 (跨项目, 高优)
2. dacli 端 fallback 查询 (P1, 中优)
3. ssw-loop 关卡 check_clear_coverage.sh (P2, 低优)
4. dacli app history 子命令 (P3, 远期)

E2E 验证 (testspace 默认应用):
- DRY-RUN --clean-docs 显示 [MOVE] docs/testspace/ 整体打包
- 业务库 preview 列出 72 张表 (testspace schema=public 正常工作)
- jxcj schema=public 不识别业务表 (符合 ADR §已知风险)

README 路径速查表加 "--clean-docs 行为" 行, 指向 0014-ADR
2026-07-21 15:47:19 +08:00
..

dacli Architecture Decision Records (ADR)

记录 dacli 关键设计选择的完整理由 + 替代方案 + 后果, 含来源 (drift round / BS 编号 / 实战 app)。

规则

  • 每篇 ADR 标准结构 (见 template.md): Context / Decision / Alternatives / Consequences / Cross-refs
  • 编号 4 位数, 顺序递增 (0001, 0002, ...)
  • 不撤销旧 ADR; 改设计时新增 ADR 引用旧 ADR 并说明变化
  • 不入 git 的临时调试日志不属于这里

索引

编号 标题 状态
0001 FK 字段必显式 relationForm Accepted
0002 form create --ai 4 限制 Accepted
0003 form update 不同步物理表 Accepted
0004 menu type=3 必传 moduleId Accepted
0005 dict typeCreate 全平台唯一 Accepted
0006 workflow 必传 startFormId Accepted
0007 form --ai 不按依赖顺序 Accepted
0008 test run 不自动注入 FK 数据 Accepted
0009 代码注释卫生规则 Accepted