fix: 修复缺少渠道表时商务列表失败并补充接口实测

docs/sw6-to-kra/http-verification-2026-11-03.json

@@ -0,0 +1,64 @@
+{
+  "date": "2026-11-03",
+  "timezone": "Asia/Shanghai",
+  "base_url": "http://127.0.0.1:18000",
+  "database_scope": "沿用已配置的 sw7 系统迁移测试库；未复制或迁移旧正式数据库",
+  "authentication": "通过本地服务验证码及账号密码正常登录后，携带 JWT 请求；凭据和令牌不记录在报告中",
+  "observed_failure": "原 8000 实例日志：Error 1146，sw7.tab_promote 不存在导致商务列表返回商务数据访问失败",
+  "fix": "基础商务资料和已通过绑定数继续返回；有绑定但渠道表未接入时 promoteCount 为 null；完整业务库仍按原口径计算真实渠道数",
+  "checks": [
+    {
+      "path": "/health",
+      "http": 200,
+      "elapsed_ms": 64
+    },
+    {
+      "path": "/sw/business/list?pageNum=1&pageSize=10",
+      "http": 200,
+      "elapsed_ms": 36,
+      "code": 0,
+      "msg": "成功",
+      "total": 45,
+      "rows": 10,
+      "unavailable_promote_counts": 1
+    },
+    {
+      "path": "/sw/business/list?pageNum=2&pageSize=10",
+      "http": 200,
+      "elapsed_ms": 46,
+      "code": 0,
+      "msg": "成功",
+      "total": 45,
+      "rows": 10,
+      "unavailable_promote_counts": 5
+    },
+    {
+      "path": "/sw/business/list?userName=admin&pageNum=1&pageSize=10",
+      "http": 200,
+      "elapsed_ms": 32,
+      "code": 0,
+      "msg": "成功",
+      "total": 1,
+      "rows": 1,
+      "unavailable_promote_counts": 0
+    },
+    {
+      "path": "/sw/business/10001",
+      "http": 200,
+      "elapsed_ms": 33,
+      "code": 0,
+      "msg": "成功"
+    },
+    {
+      "path": "/sw/user/preference",
+      "http": 200,
+      "elapsed_ms": 103,
+      "code": 0,
+      "msg": "成功"
+    }
+  ],
+  "limits": [
+    "验证实例与 GoLand 的 8000 进程独立；GoLand 必须重新运行才能使用新代码",
+    "本次未验证完整渠道数据，完整旧库复制和最终一致性核对仍待迁移结束后确认"
+  ]
+}

docs/sw6-to-kra/implementation.md

@@ -11,6 +11,8 @@
 
 沿用现有迁移 SQL 的 `/sw/` 路由与 `view/sw/` 菜单组件路径。认证、响应信封、权限、表格及图表采用 Kra；业务字段、统计口径、状态流转、可见范围保留旧实现。登录页、系统名称和品牌资源来自旧商务。新增代码注释与提交信息使用中文。
 
+用户补充：允许直接优化旧接口、SQL 和逻辑。优化时记录行为差异并验证业务结果；各批实现必须实际请求 HTTP 接口，不能只以单元测试和构建作为完成依据。
+
 用户已有的 `configs/config.yaml` 修改与迁移 SQL 保留。未经最后阶段的数据库确认，不连接、复制或修改用户的旧数据库。
 
 ## 依赖顺序与完成标准
@@ -47,4 +49,6 @@
 - 已生成 `source-inventory.json`：现有 SQL 的 63 个接口契约、279 个变更源文件及额外找回密码控制器。此清单是范围索引，不代表已完成实现。
 - 已执行 `make generate`、相关 Go 测试、变更前端 ESLint 和生产构建。构建存在原 `arcdash` 依赖的 BigInt 浏览器目标警告。
 - 第一批提交 `ce4b54a` 后 `go test ./...` 全量通过；第二批账号功能的 biz/data/service/modules/server/cmd 检查及前端生产构建通过。
+- 用户反馈实际商务列表失败后，定位为 sw7 缺少 `tab_promote`。已解耦基础列表与渠道统计：有绑定且渠道表缺失时返回 `promoteCount: null`，界面显示“未接入”，无绑定账号仍为真实零。新增通过真实 TCP 请求的 HTTP 回归测试，覆盖系统数据库及完整渠道表两种场景。
+- 已通过正常验证码登录取得测试会话，并在修复后的独立 18000 实例连接同一 sw7 执行 HTTP 请求。列表总数 45，分页、账号筛选、资料和偏好查询全部成功。详见 `http-verification-2026-11-03.json`。8000 为用户 GoLand 旧二进制，需重新运行才加载源码修复。
 - 当前没有执行本轮真实数据库迁移验证。