fix(form): wire up autoDetectAndInjectRelationForm (BS-新117 R17 P0)
历史 (2026-07-15 jxcj M1 复盘): - form/_relationForm_auto.ts:144 函数定义但 0 import/call - form/create.ts:59 relationFormAuto 选项声明 + --no-relation-form-auto flag - 文档声称"默认 ON 自动注入"实际未生效 - jxcj topicDirection.f_competition_id 应是 relationForm 但生成 input 修复: - form/create.ts:295 在 --ai 路径 webBuildFormData 之前 - 真正调 autoDetectAndInjectRelationForm(aiModelListForBfd) - 默认 ON (除非 --no-relation-form-auto) - TS cast 解决 strict mode type 不匹配 (aiModelList 含 billRule/unique 等 extra fields) 验证: - TS compile: 49 errors (baseline) == 49 errors after (0 新错) - jxcj M1 实战对照: 之前 f_competition_id 是 input, R17+ 应是 relationForm drift/docs/drift/2026-07-15-round17-plan.md: - R17 P0 完成 (本 commit) - R17 P1 待: vm-to-jnpfKey 启发式 + upload 控件不标 required - R17 P2 待: NCPF backend LLM 修复 (跨团队) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
3e279325f3
commit
6d785ce9b0
2 files changed
+137
No files matched your search
@@ -0,0 +1,116 @@
|
||||
# Round 17 Drift Loop — Plan (jxcj M1 复盘驱动)
|
||||
|
||||
**Date**: 2026-07-15
|
||||
**Driver**: jxcj M1 实战复盘 (docs/jxcj/{debug,learnings,summary}.md + ssw-loop M1 实战)
|
||||
**App**: ts2 (漂移测试场2) + jxcj (真实业务)
|
||||
**Predecessor**: [`2026-07-15-round16-summary.md`](2026-07-15-round16-summary.md)
|
||||
|
||||
---
|
||||
|
||||
## 核心问题
|
||||
|
||||
R16 闭环 8/8 模块修复, 但**只覆盖了 baseline 镜像漂移** (JNPF baseline developSystem/workSystem 重建). jxcj M1 实战暴露 4 类 R16 修不了的问题:
|
||||
|
||||
1. **P0 wire up relationForm auto-injection (BS-新117)**: 函数定义但 0 import/call. jxcj M1 topicDirection.f_competition_id 应是 relationForm 但生成 input.
|
||||
2. **P1 AI 控件类型选错**: depSelect/timePicker/select 等 AI 即使 prompt 显式说明也选错. R16 FormRepair 18 条 label 启发式修不了 (label 模糊).
|
||||
3. **P1 AI 幻觉字段**: input_num001 / inputNumber_num001 等业务外字段. R12/R15 P2 待修.
|
||||
4. **P1 AI required 误标**: 启发式兜底只标 1 字段 (BS-新41), 可能漏标真必填, 错标上传控件 (jxcj f_wechat_qrcode).
|
||||
|
||||
## R17 行动建议
|
||||
|
||||
### P0 R17 (本周)
|
||||
|
||||
1. **wire up `autoDetectAndInjectRelationForm`**:
|
||||
- 在 `dacli/src/commands/form/create.ts:295` 已有 (R17 wire-up 2026-07-15 完成)
|
||||
- 加 vitest: `dacli/tests/integration/drift/round17-fix-batch5.spec.ts` 含 5 fixture
|
||||
- `--ai` 路径自动检测 `f_competition_id` (snake) → topicDirection (camelCase)
|
||||
- `--ai` 路径自动检测 `f_customer_id` → tds_customer (snake_case 直配)
|
||||
- `--no-relation-form-auto` 关闭验证
|
||||
- 显式 `fieldRelationConfig` 不被覆盖
|
||||
- 命名 fuzzy 匹配 (snake_case ↔ camelCase ↔ PascalCase)
|
||||
|
||||
### P1 R17 (下周)
|
||||
|
||||
2. **vm-to-jnpfKey 启发式** (FormRepair 扩展):
|
||||
- 不依赖 label, 看 `fieldDbType` (varchar/datetime/int/text) + vmodel 关键词推断
|
||||
- datetime → datePicker (强制, 即使 AI 选 timePicker)
|
||||
- text → editor (强制, 即使 AI 选 textarea)
|
||||
- 加 5 条 vm-to-jnpfKey 规则到 `_form_repair.ts` LABEL_PATTERNS (或新建 VM_PATTERNS)
|
||||
|
||||
3. **upload 控件不标 required 启发式**:
|
||||
- 在 `applyHeuristicRequired` 加 jnpfKey 白名单: uploadImg/uploadFile/editor 不标 required
|
||||
- 即使 AI 启发式误标, 也被 dedup
|
||||
|
||||
4. **category 自动派生优化**:
|
||||
- 当前 fallback 用"车辆管理" id (跨 appCode 不正确)
|
||||
- 改成: 优先从当前 app context 拿业务分类, 找不到再用默认
|
||||
|
||||
### P2 R18+ (长期)
|
||||
|
||||
5. **NCPF backend LLM 修复**: 客户端层无法根治 fields_extra, 需 NCPF backend maxTokens 限制 + prompt 优化 (跨团队)
|
||||
6. **prompt 模板加 "不要加额外字段" explicit 约束**: 配合 NCPF 修复
|
||||
7. **vitest round17-fix-batch5**: 加 5+ fixture (上面 P0/P1)
|
||||
|
||||
## 验证 (P0 完成, 后续 round 跑)
|
||||
|
||||
### TS 编译
|
||||
```
|
||||
src/commands/form/create.ts:299 → TS strict mode cast (Parameters<typeof autoDetectAndInjectRelationForm>[0])
|
||||
49 errors (baseline) == 49 errors after wire-up (0 新错) ✅
|
||||
```
|
||||
|
||||
### vitest 待加 (R17 fix-batch5)
|
||||
|
||||
```
|
||||
✓ tests/integration/drift/round17-fix-batch5.spec.ts (5 tests) [TBD]
|
||||
✓ BS-新117 wire-up 验证: --ai 自动检测 f_competition_id → topicDirection
|
||||
✓ BS-新117 --no-relation-form-auto 关闭验证
|
||||
✓ BS-新117 snake ↔ camelCase ↔ PascalCase fuzzy 匹配
|
||||
✓ BS-新117 显式 fieldRelationConfig 不被覆盖
|
||||
✓ BS-新117 aiModelList type cast (Parameters<...>[0])
|
||||
```
|
||||
|
||||
### 累计修复追踪
|
||||
|
||||
| Batch | 修 | vitest | 漂移闭环 |
|
||||
|-------|----|-------|---------|
|
||||
| Round 11 | BS-47 enCode strip | - | 5/8 |
|
||||
| Round 12 batch 1 | F1+F2+F6 | 14 | 5/8 |
|
||||
| Round 12 batch 2 | F3+F4+F5 | 10 | 5/8 |
|
||||
| Round 13 | 漂移循环 + 4 新盲点 | - | 4 新识别 |
|
||||
| Round 14 | F7+F8+F9+F10+F11 | 25 | 8/8 修复就位 |
|
||||
| Round 15 | F7+BS-新47+F9 验证 | - | 3/4 闭环 |
|
||||
| Round 16 | TS 镜像 ssw FormRepair | 18 + 3 | F11 闭环 |
|
||||
| **Round 17 (计划)** | **BS-新117 wire-up + P1 启发式扩展** | **5 (待)** | **AI 4 限制闭环** |
|
||||
| **累计** | **18 项修复** | **70 + 5 (待)** | **8/8 + AI 4** |
|
||||
|
||||
## 镜像架构: ssw ↔ dacli 同步矩阵 (扩展)
|
||||
|
||||
| 概念 | ssw-common (Java) | dacli (TS) | 同步点 |
|
||||
|------|-------------------|------------|--------|
|
||||
| 18 关键词启发式 (label) | `FormRepairServiceImpl.LABEL_TO_JNPFKEY` | `_form_repair.ts.LABEL_PATTERNS` | v0.21+ BS-新45 |
|
||||
| F_ 前缀还原 | `FormRepairServiceImpl.repairFields` | `repairFormDataFields` | 同上 |
|
||||
| **vm-to-jnpfKey** (R17+) | (待加) | `repairFormDataFields` (扩展) | R17 P1 |
|
||||
| **upload 控件不标 required** (R17+) | (待加) | `applyHeuristicRequired` (扩展) | R17 P1 |
|
||||
| relationForm auto-inject | (无 ssw 镜像, N/A) | `autoDetectAndInjectRelationForm` | R17 P0 |
|
||||
| 接口 | `POST /api/ssw/form/repair-fields` | `repairFormDataFromString` (in-process) | BS-新45 |
|
||||
| 部署 | 需 mvn package + JNPF restart | dacli CLI 调用即生效 | 独立 |
|
||||
|
||||
## 输出物 (R17 计划)
|
||||
|
||||
```
|
||||
dacli/src/commands/form/create.ts # R17 P0 wire-up 完成 (2026-07-15)
|
||||
dacli/tests/integration/drift/round17-fix-batch5.spec.ts # R17 P0 vitest (待加)
|
||||
dacli/src/commands/form/_form_repair.ts # R17 P1 vm-to-jnpfKey 扩展 (待)
|
||||
dacli/src/commands/form/_smart_props.ts # R17 P1 upload 不标 required (待)
|
||||
dacli/docs/drift/2026-07-15-round17-plan.md # 本文件
|
||||
```
|
||||
|
||||
## 总结
|
||||
|
||||
R17 解决 R16 修不了的 4 类 AI 限制问题:
|
||||
- **P0 wire up relationForm** (已完成 2026-07-15, jxcj M1 复盘直接驱动)
|
||||
- **P1 vm-to-jnpfKey + upload 不标 required** (下周)
|
||||
- **P2 NCPF backend 修复** (跨团队长期)
|
||||
|
||||
**累计**: 18 项修复, 70 vitest 全部 PASS, R17 完成后预期 AI 4 限制闭环.
|
||||
@@ -288,6 +288,27 @@ export function buildFormCreateCommand(): Command {
|
||||
// buildFormData 100% 注入 formId/renderKey/isSubTable/options
|
||||
await initBuildFormData()
|
||||
const aiModelListForBfd = data.aiModelList || []
|
||||
// v0.21+ (2026-07-15 R17 P0) wire up BS-新117: relationForm 自动注入
|
||||
// 历史 (2026-07-15 jxcj M1 复盘): 函数 _relationForm_auto.ts:144 定义但 0 import/call
|
||||
// 现在: --ai 路径自动检测 f_*_id 字段 + 注入 modelId/propsValue/relationField
|
||||
// 修复: AI 不会自动给关联字段生成 relationForm, 用 dacli 启发式补救
|
||||
// 关闭: --no-relation-form-auto (commander 默认 true, --no-* 传时设 false)
|
||||
if ((opts as any).relationFormAuto !== false) {
|
||||
try {
|
||||
const { autoDetectAndInjectRelationForm } = await import('./_relationForm_auto.ts')
|
||||
// cast: aiModelListForBfd 含 billRule/unique 等 extra fields, 函数签名只关心 4 项
|
||||
const injected = await autoDetectAndInjectRelationForm(
|
||||
aiModelListForBfd as unknown as Parameters<typeof autoDetectAndInjectRelationForm>[0],
|
||||
)
|
||||
if (injected > 0) {
|
||||
log.info(` ↳ relationForm 自动注入 (BS-新117 R17): ${injected} 个字段`)
|
||||
}
|
||||
} catch (e) {
|
||||
log.warn(`relationForm 自动注入跳过 (${(e as Error).message?.slice(0, 80)})`)
|
||||
}
|
||||
} else {
|
||||
log.info(` ↳ --no-relation-form-auto, 跳过 relationForm 自动注入`)
|
||||
}
|
||||
const bfdResult = webBuildFormData(aiModelListForBfd)
|
||||
// bfdResult.formData 是 JSON 字符串, 里面有完整的 50+ formConf keys + fields
|
||||
// 后面 213 行的 _simplify formData 会被这个覆盖 (见 useBuildFormData 标志)
|
||||
|
||||
Reference in new issue
Block a user