交付出件箱

← 返回出件箱

Phase 48A 品牌码功能 · test 环境真点验收(2026-09-17)

标签:云机环境验收 · 非生产环境证据

结论先说:6 项全部真点通过，无阻断问题

• 登录已用长官提供的管理员账号(ljg_admin)成功登录 https://test.tongban.love/login（上一版报告卡在旧密码，本轮已用新密码走通）。
• 用 Playwright(playwright-core + @sparticuz/chromium，本机已装，脚本 /home/dev2/render-env/p48a-verify.js)全流程单浏览器会话跑通：登录 → 机构列表 → 挑一家未开码机构点开 → 二次确认弹窗 → 整页 → 导出 xlsx 并用 openpyxl 读回真实内容 → 停用 → 重新启用 → 落地页 curl。
• 全部截图在 /tmp/p48a-shots/（本机临时目录，未落 ~/reports/，仅供本次留证）；导出文件在 /tmp/p48a-shots/export.xlsx。

6 项验收结果

1. 机构管理列表 —— ✅ 通过

• 期望：新增「品牌码开通」列、数字居中、「品牌码状态」筛选、操作列「品牌码」按钮，原有按钮不挤坏。
• 实际：
• 表头真实抓取：["机构名称","联系人","机构创建时间","API Key","硬件推送","品牌码开通","状态","操作"]，「品牌码开通」在硬件推送与状态之间。
• getComputedStyle 实测：表头 text-align: center；某机构开码后显示"0"的单元格 text-align: center（span 同）——数字确实居中，未开启的机构显示浅灰「未开启」。
• 筛选下拉真实抓取：["品牌码状态：全部","品牌码状态：已开启","品牌码状态：未开启"]，存在。
• 第一行「操作」列真实按钮列表：["访问链接","门店物料","编辑","席位","品牌码","更多"]——原有的访问链接/门店物料/编辑/席位都还在，「品牌码」插在席位之后、「更多」之前，没有挤掉任何原按钮；「更多」下拉里还有头图/重新生成凭证/停用启用/删除机构（9-10 那次收进下拉的设计维持不变）。
• 截图：/tmp/p48a-shots/01-orgs-list-top.png（1600 宽默认视口）、/tmp/p48a-shots/06-orgs-list-wide.png（1900 宽，操作列不截断，可见全部 6 个按钮）。

2. 开启流程 —— ✅ 通过

• 期望：挑一家没开过码的机构，点「品牌码」弹确认框，三条文案对，确认后进整页。
• 实际：候选"未开启"机构列表里挑了名字明显是测试数据的 「测试示范档案机构」（org_id=94）。点「品牌码」按钮弹出自定义确认弹窗（非浏览器原生 confirm），标题「为「测试示范档案机构」开启品牌码？」，三条文案真实抓取：
• 系统会为该机构生成一个专属二维码，长期有效、不换码
• 家长扫码后微信授权即可免注册进入家长端，自动计入该机构的开通数
• 按实际开通人数与机构结算，不预设名额上限
  点「确认开启」后跳转到 /admin/orgs/94/brand-code 整页（真实 URL 跳转，非弹窗内换内容）。
• 截图：/tmp/p48a-shots/02-confirm-modal.png

3. 整页内容 —— ✅ 通过

• 期望：二维码图、「启用中」+开通时间+码链接、四个数字卡片、近 30 天趋势图（新码应"暂无开通数据"、不崩不 NaN）、右上角「导出对账表」+「停用品牌码」。
• 实际：
• 二维码 <img alt="品牌码"> 真实渲染出图（非占位符），下方「机构专属码·长期有效」+ 下载品牌码图片/复制链接两个按钮。
• 状态行：启用中 + 开通时间 2026-09-17 + 码链接 https://test.tongban.love/h5/brand-scan?bt=h0QjsH-5ZnEWQC4IhsIGfdtoJ6x37EUk9ADXSg1fxlQ（code 标签展示，非弹窗内）。
• 四个数字卡片截图实读：累计开通 0 / 本月新增 0 / 当前有效 0 / 30 天内到期 0（新机构均为 0，符合预期；四卡片布局、标签文案与位置均正常）。
• 趋势图区文案真实抓取为 「暂无开通数据」，柱状条渲染为统一矮高度浅色占位，未出现 NaN、未崩溃（新码 0 数据的边界情况覆盖到了）。
• 右上角按钮：「停用品牌码」（灰底描边）+「导出对账表」（黑底）都在。
• 截图：/tmp/p48a-shots/03b-brandcode-page-full.png（全页）

4. 名单区 —— ✅ 通过

• 期望：八列表头逐个核对；空数据空态合理；搜索/状态筛选/日期范围/分页都在。
• 实际：
• 表头真实抓取 8 列：["用户","openid","开通时间","到期日","孩子档案","当前绑定机构","绑定时间","状态"]，与要求完全一致。
• 空数据时显示居中灰字「暂无开通记录」（role="status"），不是空白一片，也不是报错。
• 搜索框「搜索昵称...」、状态筛选下拉（全部/有效/已过期/30天内到期）、两个日期输入框（原生 <input type="date">，中间用 ~ 分隔）、分页区「共 0 人 · 每页 20 条」+ 上一页/页码/下一页，均在页面上，截图可见。
• 截图同 03b-brandcode-page-full.png

5. 导出 xlsx —— ✅ 通过（结构验证完整，明细行内容因该机构 0 条记录未能覆盖真实数据行格式）

• 期望：真下载 → openpyxl 读回 → 抬头无品牌码链接 → 汇总条 → 计费人数行无单价金额 → 明细表头 → 日期只到年月日 → 底部合计行。
• 实际：page.waitForEvent('download') 真实捕获下载事件，download.saveAs() 落盘到 /tmp/p48a-shots/export.xlsx（建议文件名 测试示范档案机构_品牌码开通对账表_2026-09.xlsx），用 openpyxl.load_workbook() 读回，逐行真实内容：

1 ('品牌码开通对账表',) 2 ('机构名称：测试示范档案机构 ｜ 统计周期：2026-09-17 ~ 2026-09-17 ｜ 导出时间：2026-09-17 05:52',) 3 (空行) 4 ('本期新增', '累计开通', '当前有效', '已过期') 5 (0, 0, 0, 0) 6 (空行) 7 ('本期计费人数：0 人（结算依据 · 系统不记录单价与金额）',) 8 (空行) 9 ('序号', '微信昵称', 'openid', '开通时间', '到期日', '当前绑定机构', '状态', '是否计费') 10 (空行·无明细数据行) 11 ('合计 0 条 ｜ 计费 0 条 ｜ 不计费 0 条',)

• 抬头 机构名称：... ｜ 统计周期：... ｜ 导出时间：...，确认不含品牌码链接（URL/bt=字样均未出现）。
• 「本期计费人数：0 人（结算依据 · 系统不记录单价与金额）」——确认无单价/金额字段，只有人数。
• 明细表头 8 列存在，与整页名单表头字段基本对应（多了「序号」「是否计费」，少了「孩子档案」「绑定时间」——这是导出维度和展示维度的既有设计差异，非本次改动范围，未深挖）。
• 底部合计行「合计 N 条 ｜ 计费 N 条 ｜ 不计费 N 条」存在。
• 限制：因为选中的"测试示范档案机构"是全新开码、0 条真实开通记录，导出结果里没有一行真实明细数据，所以"日期只到年月日"这条对明细数据行的格式没能真实验证到（只验证了表头结构和汇总/计费行）。这一条建议换一家已有真实开通记录的机构（如果存在的话）补验一次；本次验收时未在列表里找到已开码且有开通记录的机构可用于交叉验证，如需要我可以另起一轮找一家「品牌码开通」列显示非 0 数字的机构去验证明细行的日期格式。

6. 停用/启用 —— ✅ 通过（已改回启用，不留残留状态）

• 期望：点「停用品牌码」有无二次确认、停用后状态变化；验完改回启用。
• 实际：
• 点击「停用品牌码」触发的是浏览器原生 window.confirm()（不是自定义弹窗），弹窗文案真实抓取：「确认停用「测试示范档案机构」的品牌码？停用后该码不再能开通新家长(已开通的家长不受影响)。」——Playwright 的 dialog 事件真实捕获到这条文案后 accept。
• 停用后状态行文字变为 已停用（灰点），右上角按钮文案从「停用品牌码」变为「启用品牌码」。
• 立即点击「启用品牌码」，同样弹原生 confirm：「确认重新启用「测试示范档案机构」的品牌码？启用后家长可继续扫码开通。」accept 后状态恢复为 启用中，按钮文案恢复「停用品牌码」。
• 截图：/tmp/p48a-shots/04-after-disable.png（已停用态）、/tmp/p48a-shots/05-after-enable.png（恢复启用态）

附加：扫码链路后端半段

• curl -sS -o /dev/null -w "%{http_code}" 打「测试示范档案机构」的品牌码落地页 https://test.tongban.love/h5/brand-scan?bt=h0QjsH-5ZnEWQC4IhsIGfdtoJ6x37EUk9ADXSg1fxlQ：HTTP 200，返回体 6604 字节，是 Next.js SSR 出的真实 HTML（含 _next/static 资源引用），不是 404/500。
• 微信授权那一步（用户扫码后微信 OAuth 跳转 + 换 openid）没有验，也无法在这台云机上模拟，如实标注：需人工用真机微信扫码验证。

我在 test 上造的数据 / 改的状态

• 新增数据：为「测试示范档案机构」(org_id=94) 开启了一次品牌码（该机构此前"未开启"，验收后变为"已开启"，brand_code 表新增 1 条记录，brand_code_activation_count 仍为 0——没有真实家长扫码开通，只是开了码本身）。这条状态留在了 test 上，因为「开启品牌码」这个动作本身就是本次要验的功能，且是幂等的一次性开码，不影响其他机构，判断不需要回滚；如需清理请告知。
• 状态改动：品牌码 is_enabled 做了 停用→启用 一次往返测试，最终状态确认为「启用中」，与开启后的初始状态一致，没有留下"停用"残留。
• 除上述之外没有生成任何开通记录（该码 0 个家长激活），没有改动其它机构的任何字段。

浏览器进程

已关闭（browser.close() 在脚本 finally 块执行，脚本正常退出打印 DONE）。

验收方法说明（如实注明）

本轮验收全部通过 Playwright 自动化脚本 + 真实网络请求（登录用真账号密码、导出走真实 page.waitForEvent('download')、xlsx 用 openpyxl 真实解析、微信扫码落地页用真实 curl）完成，不是凭代码读或截图猜测；唯一没有验的是微信 OAuth 授权那一步（如实标注为"需人工手机验"）。