# 配套后端发布与真实数据验证（2026-10-13）

用户追加授权直接发布云函数和数据库迁移；前端仍由用户发布。本次接续 `bf7c8b0` 的三端审查修复，生产网关回读版本为 **2026-10-13-launch-security-v7**。

## 已发布

- 五个云函数：`xiaoshu.app.gateway`、`xiaoshu.ops.gateway`、`xiaoshu.ops.gateway.v3`、`xiaoshu.admin.gateway`、`xiaoshu.sync.direct-v1`。发布后核对实际保存代码；直接同步继续使用旧系统直接接口。
- 四份 SQL：`account-security.sql`、`payroll-integrity.sql`、`payroll-cutoff.sql`、`account-deletion.sql`；最终逐一回读 24 个函数体，与当前文件一致。
- 新增 `AccountDeletionRequest`、`PayrollCutoffApproval`、`PayrollCutoffDecision`，账号凭据字段和密码保护触发器。
- 迁移前核对没有活动同步/教学/工资写任务；迁移使用数据库事务、同步与工资锁及执行超时。修正旧 SQL 内层 BEGIN/COMMIT，避免迁移部分提前提交。临时操作入口限定当前操作员、十分钟有效期，执行后删除并核对。

发布前云函数、Parse schema、受影响 SQL 定义和相关工资数据备份在本机私有目录 `/Users/mac/.local/state/xiaoshu/cloud-releases/2026-10-13-launch-security-v7/`，目录 0700、文件 0600。这是针对本次变更的基线备份，不是全库灾备。工资批次、工资行及工资规则迁移前后比较一致。

## 验证证据

- 线上隔离账号真实链路 **53 项通过**：72 位密码、强制改密、旧密码拒绝、旧会话撤销、课程开通、排课、当天上课、并发结课仅扣一次、报告修改/重试/旧版本拒绝、学生评价、余额与流水对账、注销申请与后台处理、退出撤销。详见 `online-smoke-pass.txt`。
- 隔离测试账号和业务测试数据已清理；额外回读测试用户、临时函数剩余数均为 0。测试审计轨迹按正常业务保留。没有对真实客户执行结课、改密、扣费或发薪。
- 服务端完整测试 171 项通过（最终 SQL 性能优化前）；优化后迁移/安全/工资针对性测试 **28 项通过，0 失败**。迁移入口、线上测试脚本及实际 SQL 生成的临时函数均语法检查通过。
- 线上 action 清单：requested 118、implemented 104、blocked 21、missing 0；这些分类有交集，不能相加当覆盖率。既有关闭功能不因此视为已实现。
- 前端沿用前一轮本地验证：移动端 209、后台 261 项及双端生产构建通过，浏览器模拟矩阵见前一份报告。本次新增证据是后端真实接口验证，不替代手机/微信 WebView 实机验证。

## 真实数据与工资状态

| 来源 | 业务编号数量 | 新库匹配 |
|---|---:|---:|
| 预约（54） | 31,254 | 31,254 |
| 上课（59） | 19,411 | 19,411 |
| 抗遗忘（60） | 200,355 | 200,355 |

以上是最近成功直接同步批次的业务编号、投影和校验和核查，不代表本次重新执行全量同步。汇总及校验和见 `release-verification.json`。

十月工资总览回读为 28 名陪练、206 次课程、**工资异常 0 条**。但截止来源还有 **674 条待核对差异**，截止确认尚未批准，`settlementReady=false`。这是独立的来源冲突保护，不能把工资异常为 0 当作可以直接审核发放。应在后台逐条核对并留依据；本次未代替运营批准冲突。

真实查询暴露工资总览约 30.6 秒，超过客户端 20 秒超时。修复 SQL 关联字段转文本导致的低效查询，使用原生完整行计算变更指纹，并复用一次来源版本结果。最终完整请求两次为 **14,582 / 14,915 ms**；所有字段变更检测和业务保护保留。只有两次抽测，不是 p75 或高并发性能承诺。

## 前端上线交接

1. 本报告所列数据库和云函数已完成发布，无需重复迁移；先核对 `migration_status` 返回上述版本。
2. 从当前交付代码执行 `npm ci && npm run verify:local`，发布 `dist/xiaoshu-mobile/browser` 和 `dist/xiaoshu-admin/browser`。本次没有发布这两个前端目录。
3. 配置正式 HTTPS 域名、代理/CORS、SPA 回退及缓存；实机核对登录、音频、学习、报告和后台操作。
4. 既有账号若密码迁移历史不明，默认不允许旧密码覆盖；确有登录问题时由管理员重置，不批量开放回退。
5. 原 Mac 定时任务本次未重新安装。若要启用上一轮新增告警模块，按本地修复报告的运行器安装步骤处理，并核对自然 23 点触发回执。

更早的本地修复报告中“云函数和 SQL 未发布”描述是当时验收边界，当前后端发布状态以本报告为准。回滚需要使用兼容的配套版本并重新检查凭据、会话及工资保护，不能单独撤除安全触发器。