# 后台实施记录

后台代码已按第 1 批对接说明及用户确认适配，仅后台，不修改 C 端。真实后端联调尚未完成，未部署、提交或调用真实后台写接口。

## 结果与证据

| 证据 | 已确认结果 | 实现路径 |
| --- | --- | --- |
| 规则测试与本地订单详情 | 支付摘要、独立支付单状态、失败记录、空时间与金额展示正常 | `src/types/api/order.ts`、订单列表/详情、`orderPayment.ts` |
| 规则测试与模拟核销/代理注册详情 | 终态优先于陈旧恢复标志，核销可重提、代理注册提示重新扫码 | 核销展示工具、退款常量、注册状态辅助函数及相应页面 |
| 规则测试与模拟改密弹窗 | 新密码禁止符号，旧密码不受新长度限制；375px 下错误说明不重叠 | `loginPassword.ts`、后台密码表单、本人改密弹窗与双语文案 |
| 规则测试与模拟换货确认完成 | 1202 从 `data.phone` 展示号码，提示可取消，单据仍待确认，不自动解绑 | `exchangeError.ts`、换货页面与服务 |
| 数值测试与模拟预警规则/详情 | 规则额度移除，MB 快照两位小数，零和缺失区分，套餐商品额度保留 | 预警类型、规则页、记录列表/详情及 `trafficAlert.ts` |
| 模板和源码回归检查 | 新四列表头与手机号说明，设备 IMEI 必填说明、原 Excel 模板和行级失败反馈保持 | `shopBusinessOwnerImport.ts`、导入页面 |

ui-ux-pro-max 用于检查标签含义、错误反馈和长文案换行；保留现有 Element Plus 样式，未引入新 UI 依赖或改版。docs-generator 用于区分实施结果、可复现检查和未完成的真实联调，任务清单没有将后端验收提前标为完成。

## 复现本地验证

在项目根目录执行：

```powershell
# 63 项规则及已有回归测试；加载入口兼容 pnpm 的 esbuild 隔离布局。
node --import ./scripts/tests/register-esbuild.mjs --test --test-reporter=spec scripts/tests/*.test.mjs
npx --no-install vue-tsc --noEmit

# 生产构建输出到临时目录，关闭自动声明生成并校验原声明内容未被覆盖。
node scripts/tests/verifyBuild.mjs
openspec validate update-october-batch-one-admin-integration --strict --no-interactive
```

受影响文件 ESLint、Prettier 和 UTF-8 检查通过。生产构建存在原有搜索表单常量赋值、审计/认证循环分块和大 chunk 警告，未扩大本次修改去重构这些模块。

### 本地页面检查

```powershell
node scripts/tests/verifyBuild.mjs --serve
```

访问 `http://127.0.0.1:5190`。该预览拦截全部 `/api/` 请求且禁用真实代理，测试数据为模拟值；登录和写请求不会到真实后台。模拟账号为超级管理员，仅用于本地验收，输入满足登录页既有规则的任意测试账号密码即可。

已检查订单详情、核销失败详情、代理注册失败详情、预警详情/规则页、改密弹窗和换货完成 1202 提示；页面检查未产生 JS 错误。改密弹窗额外检查 375px 视口。

模板下载从统一 UTF-8 BOM 文本生成新 CSV，原 GBK 静态文件不再被此页面引用，没有改写用户已有模板资产。设备 Excel 模板没有修改。`src/types/components.d.ts` 与实施前内容 SHA-256 一致；已有开发服务器的自动生成曾补入本次新 Alert 声明，已改显式组件导入并只撤回该自动新增行，用户原差异保留。

## 待真实联调

1. 六类审批失败终态真实数据、权限矩阵、未知结果恢复、核销预占释放和提现重新冻结。
2. 真实支付摘要与多次支付历史、换货解除关联后成功重试及其他错误响应。
3. CSV 表头/手机号错误、逐行部分成功，以及设备 IMEI 空白/全部失败。
4. 新建与历史订单、IoT 卡、设备、预警导出文件列。

这些项目继续保留在任务清单，用户验收及部署后再归档。