Q04 · 商户资料完整性巡检包（WIP-318 · 小齐 R9+R10）

版本：v1.0｜执行：小齐｜时间：2026-09-14 00:2x｜基线 HEAD：9b88ece9（推送后 c833f77d）

依据设计文档：docs/reports/gpt6-评审-2026-09-13/03-波波小齐苦力活长线包设计.md（14 要素 / 12 字段证据 / P0-P3）

依赖：B05（波波商户入驻资料模型）、现有商户接口；不改核心代码，缺陷回原包

1. 包名称与目标

Q04「商户资料完整性巡检包」。目标：对商户域 9 项字段域（资料/联系人/收款账户/资质证照/staff/角色权限/状态/营业时间/位置坐标）做字段存在性、接口暴露与脱敏、权限一致性核验。

2. 本次覆盖范围

• 商户域相关表全量列清单（staging 实测）
• 商户列表接口响应字段与脱敏情况（实接口）
• 与 P0 缺口③（商户入驻资料）相关的字段完整性

3. 明确不覆盖范围

• 收款账户变更的安全实现（属核心席，仅登记字段缺失）
• 资质审核最终状态机（属核心席）
• 商户前端页面（属一号/二号）

4. 涉及接口/文件/文档边界

• 表：merchants、merchant_profiles、merchant_staff、merchant_applications、merchant_positions、merchant_position_perms、merchant_service_fee_profiles、distributors
• 接口：GET /api/miniapp/merchants（公开列表）
• 产出：仅本目录 + 回执 + TASKS 行尾

5. 字段定义（9 项字段域）

6. 成功路径

登录 staging 库取 information_schema.columns → 逐域比对字段 → 调公开商户接口取响应字段 → 判定脱敏与完整性。

7. 异常路径

• 字段域无任何承载列 ⇒ 记 GAP（缺实现）
• 接口暴露敏感字段 ⇒ 记缺陷并标"待核心席确认是否应脱敏"
• 库中无数据/接口不可达 ⇒ 记 ENV_UNAVAILABLE，不记通过

8. 幂等与重复请求规则

全部为只读查询；可重复执行，证据按版本落盘。

9. 权限与审计要求

• 仅读取 staging 库结构与公开接口，不写入、不导出真实商户敏感数据
• 输出中电话号码等仅列字段名与是否暴露，不落真实值

10. 与现有实现的差异

11. 依赖与阻塞项

• B05（波波） 未交付 ⇒ 资料模型字段定义无权威基线，本轮按"库+接口现状"核
• 收款账户是否另存他处（如支付域）需核心席确认

12. 待核心席确认事项

1. 营业时间是否需要？若需要，属 B05 定义还是后端直接加列？
2. 收款账户承载位置（merchants 加列 / 支付域独立表）？涉敏感，须核心席定
3. 公开商户列表是否应返回 phone？（当前明文返回）
4. rating/reviewCount 与"商户平等·无评分"红线的最终口径（关联 OBS-01，待刘总拍板）

13. 验收证据

13.1 表与列清单（staging 实测，information_schema.columns）

• merchants（16 列）：id / name / industry / region / owner_user_id / status / created_at / is_test / temple_id / payment_mode / offline_direct_flag / platform_no_involvement_note / highlights_text / business_type / quota_tier / service_fee_paid_at
• merchant_profiles（16 列）：merchant_id / avatar / cover / description / address / phone / lat / lng / rating / review_count / leader_recommended / recommended_by / is_old_friend / last_visit / updated_at / is_test
• merchant_staff（8 列）：id / merchant_id / user_id / role / status / invited_by / created_at / is_test
• merchant_applications（20 列）：含 applicant_name/phone、contact_name/contact_phone、business_license、status / reviewer_user_id / reviewed_at / review_note / approved_merchant_id / is_test
• 其他：merchant_positions(4) / merchant_position_perms(4) / merchant_service_fee_profiles(15) / distributors(12)

13.2 九域巡检结果

13.3 接口暴露（实接口）

• 对象：GET /api/miniapp/merchants
• 环境：staging｜版本/提交号：9b88ece9→c833f77d
• 实际结果：返回 26 条，字段 16 个 = address, avatar, category, cover, description, id, isOldFriend, lastVisit, leaderRecommended, location, name, phone, rating, recommendedBy, reviewCount, status
• 其中 phone 明文返回、rating/reviewCount 返回

13.4 缺陷单

🟡 Q04-D01｜营业时间字段缺失（P2 一般）

• 对象：商户资料域 ⑧ 营业时间
• 实际结果：merchants / merchant_profiles / merchant_applications 均无营业时段承载列
• 预期结果：9 项字段域应闭环
• 结论：FAIL｜等级 P2（不影响资金与权限，属资料完整性）
• 责任人：B05 波波（模型定义）+ 核心席（实现）
• 复验条件：字段落地并可由接口读写；或明确"本期不做"并在资料模型中标注

🟡 Q04-D02｜收款账户无承载字段（P2 一般 · 涉敏感）

• 对象：商户资料域 ③ 收款账户
• 实际结果：merchants 仅有 payment_mode / offline_direct_flag / platform_no_involvement_note，无账户号/开户行等列
• 结论：FAIL（登记，可能为支付域独立承载）｜等级 P2｜责任人：核心席（阿仁）确认承载位置
• 复验条件：明确承载位置；若涉真实账户须评估加密与权限（我不接触真实账户数据）

🟡 Q04-D03｜公开接口明文返回商户电话（P2 一般）

• 对象：GET /api/miniapp/merchants → phone
• 实际结果：公开列表（无需登录）返回商户电话字段
• 结论：FAIL（待确认是否应脱敏/仅登录可见）｜等级 P2｜责任人：核心席确认口径，波波入契约（B02 角色矩阵）
• 复验条件：口径明确后按契约调整；如应脱敏则接口侧脱敏并留审计

⚪ 观察项（不记缺陷，关联 OBS-01 待刘总拍板）

• merchant_profiles.rating / review_count 存在，且公开接口返回 rating / reviewCount；与「商户平等·无评分」红线口径待刘总裁定
• 位置坐标样例为 {"lat":0,"lng":0}＝未录入（数据问题，非字段缺失）

14. 版本号与变更摘要

• v1.0（2026-09-14 00:2x）：首版。9 项字段域巡检完成（✅5 / ⚠️2 / 🔴GAP 1 + 观察 1），3 张 P2 缺陷单（营业时间缺失 / 收款账户无承载 / 公开接口明文电话），1 项红线观察（评分）。
• 不停顿：Q04 已交，续接 Q07（用户隐私与审计巡检）。