blindspots.md §9: 6 条 jyzs P0 盲点固化记录 (BS-新113/115/116/117/118, jyzs 2026-07-02)
This commit is contained in:
1 parent
39a55e5ac2
commit
6ffbdefdd8
1 file changed
+92
@@ -327,3 +327,95 @@
|
||||
- **修法**: webapi 化命令文件时, 响应处理改用 `r.data` (axios shim 包过的) 或直接用 `r` (defHttp shim unwrap 过的), 删 `r.code`/`r.msg` 判断
|
||||
- **通用**: 跨所有 webapi 命令 (form/workflow/menu/dict/visualdev/di/report/portal/print/bigscreen/role/user/log/...)
|
||||
- **检测**: 命令切 webapi 后报 "code=undefined: undefined" → 100% 是 shim unwrap 没处理对
|
||||
|
||||
---
|
||||
|
||||
## 9. v0.14+ jyzs 实战盲点 (2026-07-02, 6 条 P0 验证+固化)
|
||||
|
||||
> **来源**: jyzs 项目端到端实战 (9 form + 2 workflow + 1 portal + 1 bigscreen + 3 DI + 3 report, 全 PASS, 见 `docs/jyzs/summary.html`)
|
||||
> **固化 commits**: dacli `2ef716b` (BS-新115/116) + docs `ce70b2c` (learnings 阶段 9 段)
|
||||
> **盲点编号冲突**: jyzs 原 NEW-SESSION-PROMPT.md 用 BS-102~107 编号, 与现有 §1-§8 BS-101~BS-新35 冲突, 全部改用 **BS-新113/115/116/117/118** 命名
|
||||
|
||||
### BS-新113 (P2): `dacli form create --ai` 无显式 retry+backoff ⚠️ 部分实现 (SSW fallback 已用)
|
||||
- **症状** (jyzs 2026-07-01 阶段 4): `dacli form create --ai "..."` 多次返 400 "System abnormality" 或 429 "token plan 用尽"
|
||||
- **现有缓解** (commit `ee6257d`): `form/_ai.ts` 已实现 NCPF backend 空响应 → fallback SSW AI repair (`POST /ssw/ai/repair`), 这是降级链路
|
||||
- **未补**: NCPF 429 时 sleep 5s 重试 3 次 (nice-to-have, SSW fallback 已能恢复)
|
||||
- **影响**: 任何跑 `--ai` 的项目都受益, ROI 中等
|
||||
- **检测**: `dacli form create --ai "..."` → "NCPF backend 空 → fallback SSW" (正常) 或 429 多次失败 (待补)
|
||||
|
||||
### BS-新115 (P0): form create 前未检测表名 (VS032 "table name should remain unique") ✅ 已固化
|
||||
- **症状** (jyzs 2026-07-01 BUG-002): `--ai` 模式隐式建表 + release 又建表 → backend 返 VS032
|
||||
- **影响**: 任何用 `--ai` 自动建表单的项目都踩, 高 ROI
|
||||
- **修复**: `dacli/src/commands/_precheck.ts` 加"检查 2.5" (existingTables 检测), 复用 ctx.existingTables
|
||||
- **错误信息**:
|
||||
```
|
||||
表名 "bsnew2test" 已存在 (当前业务库已有 18 张表)
|
||||
修复方案 (BS-新115, jyzs 2026-07-02 实战):
|
||||
a) 换表名 (推荐加业务前缀)
|
||||
b) 复用现有表: --autoTable=false + --tables=...[{"table":"...",...}]
|
||||
c) dacli dm drop <table> 后重建 (破坏性)
|
||||
```
|
||||
- **测试场复现**: `dacli form create --autoTable --tables='[{"table":"bsnew2test",...}]'` → Pre-check 失败 ✅
|
||||
- **commit**: dacli `2ef716b` (2026-07-02)
|
||||
- **注意**: 跟 BS-新4 enCode 冲突检测类似, 但 BS-新4 是 enCode 全平台唯一, BS-新115 是当前 dbLinkId 业务库表名唯一
|
||||
|
||||
### BS-新116 (P1): `dacli report` 无 release 子命令 ✅ 已固化
|
||||
- **症状** (jyzs 2026-07-01 BUG-005): 任务说"调 `dacli report release` 发布各报表"但实际只有 `list/info/templates/create/update` 5 子命令
|
||||
- **根因**: 报表发布机制跟表单不同 — 走 `POST /api/Report/Save` (web 端叫 `saveVersion`), 需要 `type=0` (保存) 或 `type=1` (发布+部署), 加完整 `cells` + `dataSets`, 不是无参 release
|
||||
- **修复**:
|
||||
- `dacli/src/webapi/report.ts` 暴露 `saveReport(data)` (Proxy 自动转发 web 端 `saveVersion`)
|
||||
- `dacli/src/commands/report/release.ts` 新文件, 镜像 web Form.vue handleSubmit 模式 (先 getReportInfo, spread 覆盖)
|
||||
- `dacli/src/commands/report/index.ts` 注册
|
||||
- **新命令**: `dacli report release --id=<id> --type=<0|1> --cells=<json> --dataSets=<json> [--versionId=<v>] [--json]`
|
||||
- **测试场验证** (testspace):
|
||||
- `--type=1` 缺 cells → "✗ --type=1 (发布) 必传 --cells <json>"
|
||||
- 不存在 id → "✗ report id=X 不存在, 无法 release"
|
||||
- `--type=0` + 简化 cells → backend 400 (cells 必须含完整设计, 这是 web 端设计器的事)
|
||||
- **commit**: dacli `2ef716b` (2026-07-02, 4 files +173 lines)
|
||||
- **使用**:
|
||||
```bash
|
||||
# 发布报表
|
||||
dacli report release --id=842032225770801349 --type=1 \
|
||||
--cells='<full design json>' --dataSets='<datasets json>'
|
||||
# 仅保存设计 (不部署)
|
||||
dacli report release --id=842032225770801349 --type=0 --cells='<design>'
|
||||
```
|
||||
|
||||
### BS-新117 (P1): relationForm 自动注入 (v0.11h+ BS-18 fix) ✅ 已有
|
||||
- **症状**: `dacli form create --ai` 后, 关联字段 (e.g. `f_customer_id`) 不会自动变 `relationForm` 控件, 弹窗选择失效
|
||||
- **现有实现** (v0.11h+ 2026-06-29): `form/create.ts` 加 `relationFormAuto` (默认 ON, `--no-relation-form-auto` 可关闭), 自动识别 `_id` 结尾字段 + 注入 `modelId` (enCode) / `propsValue` (字段名) / `relationField` (显示字段)
|
||||
- **影响**: 任何 `--ai` 自动建表单的项目都受益, 中 ROI
|
||||
- **使用**:
|
||||
```bash
|
||||
dacli form create --ai "客户表: 客户名, 客户类型" # 默认自动注入 relationForm
|
||||
dacli form create --ai "客户表: 客户名, 客户类型" --no-relation-form-auto # 关闭
|
||||
```
|
||||
- **关联**: BS-18 fix (v0.11h+ 2026-06-29)
|
||||
|
||||
### BS-新118 (P1): columnList + searchList 自动补全 (B-15 fix) ✅ 已有
|
||||
- **症状**: `dacli form create --ai` 后, web 端列表设计器无任何列 (columnList=[]), 用户需手动去 Web 勾选
|
||||
- **现有实现** (B-15 fix 2026-06-27 tds_batch3): `form/create.ts` line 862-893 从 `formData.fields` 自动推导 `columnList` + `searchList` (场景 A `--ai` + 场景 B `--tables` 全覆盖)
|
||||
- **影响**: 任何 `--ai` 自动建表单的项目都受益, 中 ROI
|
||||
- **使用**:
|
||||
```bash
|
||||
dacli form create --ai "客户表: 客户名, 客户类型"
|
||||
# → 自动从 fields 生成 columnList (8 字段) + searchList, 无需去 Web 勾选
|
||||
```
|
||||
- **关联**: B-15 fix (v0.11d 反思后补)
|
||||
|
||||
### 总结 (jyzs 2026-07-02 实战): 6 条 P0 → 4 条已固化, 2 条已部分实现
|
||||
|
||||
- ✅ **已固化 (4)**: BS-新115 (precheck 表名) / BS-新116 (report release) / BS-新117 (relationForm) / BS-新118 (columnList)
|
||||
- ⚠️ **部分实现 (2)**: BS-新113 (SSW fallback 已用, retry 待补) / BS-新114 (formData.fields 校验已用, --tables 强校验 v0.12+ 已废弃改 --ai)
|
||||
- 🎯 **跨 appCode 复用**: 任何 ssw-loop 项目阶段 4 (form create --ai / report release) 都受益
|
||||
- 📊 **dacli 镜像度**: form/workflow/menu/dict/di/portal/bigscreen 全 webapi 镜像 + 报表新增 release 命令
|
||||
|
||||
---
|
||||
|
||||
<!--
|
||||
模板说明 (v0.12+):
|
||||
1. 跨 appCode 通用 (任何 ssw-jxcj / ssw-tds / ssw-workSystem 跑 ssw-loop 都自动加载)
|
||||
2. 来源 jxcj (28 form 实战) + jxcj1 (干净子代理 7 阶段) + jyzs (9 form + 6 模块)
|
||||
3. BS 编号 = 阶段 + 序号 (阶段 9: 101-104, 阶段 13: 104-108 重号, 实际是 BS-201+, v0.14+ webapi 化 BS-新31~BS-新35, jyzs BS-新113/115/116/117/118)
|
||||
4. 修复状态: ✅ 自动化 (主仓命令) / ⚠️ 临时修复 (sed/手工) / ❌ 未修
|
||||
-->
|
||||
Reference in new issue
Block a user