fix: some

2026-10-13 11:25:03 +08:00
parent 52268859aa
commit b2a76adc9a
67 changed files with 1982 additions and 200 deletions
--- a/openspec/changes/update-october-batch-one-admin-integration/design.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/design.md
@@ -0,0 +1,113 @@
+# 十月第 1 批后台适配设计
+
+## Context
+
+本仓库为 Vue 3/TypeScript 后台，HTTP 服务使用 `BaseService` 与 Axios，页面已有业务权限、状态映射、详情组件、异步导入导出任务。用户明确排除所有 C 端接口和页面。后台本人改密虽然使用 `/api/auth/password`，仍属于本次后台适配。
+
+本设计依据十月第 1 批说明、用户最新确认和当前代码。用户确认不提供最新 OpenAPI，不以该文件作为实施前置条件；新密码禁止特殊符号的确认优先于原说明。实施已获批准，代码与本地模拟页面验证详见实施记录；没有调用真实后台写接口或验证后端运行行为。
+
+### 代码证据与修改路径
+
+| 依据/代码证据 | 当前差异 | 修改路径 |
+| --- | --- | --- |
+| M3；`src/types/api/order.ts`、`src/api/modules/order.ts` | 详情与列表共用 `Order`，缺三项支付信息与支付记录 | `Order` 补公共字段，另建 `OrderDetail` 与支付记录类型，详情服务改用详情类型 |
+| M8；`employeeCollectionDisplay.ts`、核销申请列表/详情 | 状态仅 0～3，可重提仅状态 2；提交状态只读名称 | 补终态 4、状态值映射与恢复/重提判断，覆盖账单关联申请 |
+| M14；退款/充值/提现类型与状态映射 | 缺退款 7、充值 7、提现 5；旧重提及补发条件不认识终态 | 各业务独立扩展类型、筛选、标签和可执行操作 |
+| M14；后台代理注册查询类型/详情 | 筛选仅 0～2，恢复操作仅看 `recoverable` | 补状态 3，并在业务终态下优先隐藏恢复 |
+| M1；账号、客户账号、店铺、企业表单及本人改密弹窗 | 仍使用 8～32 或 6～20；旧密码也有长度规则 | 新密码使用专用校验，旧密码只保留必要输入校验 |
+| M1；`AccountService.updateAccountPassword` | 独立改密发送 `{ password }`，说明要求 `{ new_password }` | 按第 1 批说明修正独立改密请求，不误改其他接口字段 |
+| M12；换货创建/确认完成、`apiError.ts` | 无 1202 定制反馈；错误归一化不暴露业务 data，换货 catch 可能输出错误对象 | 在换货操作定向提取 code/msg/message/data.phone，只在提示中展示号码，不记录完整错误对象 |
+| M16；预警规则与记录类型/页面 | 规则依赖已删除的 `real_data_mb`；记录未定义三项 MB 字段 | 只移除规则响应引用，补记录快照并明确 MB 单位 |
+| M2；业务员导入页 | 仍写「业务员登录账号」且未注明只填手机号 | 同步说明及已有前端模板，保留逐行失败明细 |
+| M23；设备导入任务页 | IMEI 被列为可选，已支持 `failed_items` | 改说明，复用失败明细，不改 Excel 模板结构 |
+
+## Goals / Non-goals
+
+- Goals：让后台显示、筛选、请求字段和可执行操作符合本批次说明；保留既有权限、表单内容、财务快照和导入导出流程。
+- Non-goals：C 端适配、后台接口实现、新审批机制、新页面架构、自动解绑手机号、前端重算预警或余额、替换设备导入模板、引入测试框架。
+
+## Decisions
+
+### 1. 订单详情类型与支付状态隔离
+
+公共 `Order` 接收三项字符串字段，列表与创建响应仍使用公共类型；详情增加独立 `payments` 数组。支付记录状态 0～3 与订单 `PaymentStatus` 的 1～4 含义不同，使用独立枚举/映射，不能复用。
+
+支付记录使用后端顺序，不自行筛掉失败或待支付记录；金额用已有分转元格式化，`paid_at`、`expire_at` 空值显示 `-`。渠道码映射 `wechat` 为微信直连 v3、`wechat_v2` 为微信直连 v2、`fuiou` 为富友；支付方式微信/支付宝与技术渠道分开展示，未知非空渠道保留原值。公共字段为空串显示 `-`，不能据此虚构支付信息。
+
+### 2. 业务终态优先于恢复标志
+
+六个业务各自定义终态，禁止跨业务共用数值。恢复入口使用「不是本业务审批提交失败终态 + 后端允许恢复 + 原权限允许」共同判断；即使陈旧响应仍返回 `recoverable=true`，终态也不得显示恢复按钮。
+
+「提交结果未知」不能只凭提交状态转换成业务失败，保留原后端恢复资格判断，不扩大恢复权限。终态下隐藏恢复/补发和不适用的审批操作，查看详情、凭证等只读操作保留。
+
+重新发起复用既有表单和文档规定的接口：核销/退款/提现使用原业务重提接口，线下充值创建新单，提现资料提交新版本。代理注册仅提示申请人重新扫码，后台不调用 `/api/c/v1`、不补建后台代注册接口。涉及预占/冻结金额时重新加载账单或佣金概览，前端不乐观加减财务数据。
+
+核销审批提交状态使用 `approval_submission_status` 的 0 待提交、1 提交中、2 已提交、3 提交失败、4 结果未知。名称字段存在时可使用后端名称，但字段为空时需按真实数值回退，0 不能因 falsy 判断显示成缺失。
+
+### 3. 新密码校验专用化
+
+新增/复用新登录密码专用工具，避免直接改通用 `validatePassword` 或 `validateStrongPassword` 影响非登录密码。按用户最新确认，长度 8～12，仅允许 ASCII 英文字母和数字，并必须同时包含大写字母、小写字母和数字；所有特殊符号、空白、中文、emoji 和其他非英文字母数字字符均拒绝。不对输入静默 `trim` 后放行。
+
+实现判定为 `^[A-Za-z0-9]{8,12}$` 且同时满足 `[A-Z]`、`[a-z]`、`[0-9]` 三个包含条件。例如 `Abc12345` 可接受，`abcd1234` 因缺少大写拒绝，`Abc1234!` 即使包含大写、小写和数字也因特殊符号拒绝。
+
+新密码和确认密码统一长度限制、规则说明与一致性校验；本人改密 `old_password` 不设新规则的 `maxlength` 或类别限制，旧登录表单不收紧。账号编辑目前没有密码输入则不新增；若既有调用传递可选 `password`，仅非空新值需要校验，未修改密码时不发送空串。
+
+后台七个契约：
+
+| 场景 | 接口 | 新密码字段 |
+| --- | --- | --- |
+| 本人修改 | `PUT /api/auth/password` | `new_password` |
+| 创建账号（含店铺/企业下的客户账号） | `POST /api/admin/accounts` | `password` |
+| 修改账号 | `PUT /api/admin/accounts/{id}` | 可选 `password` |
+| 独立修改账号密码 | `PUT /api/admin/accounts/{id}/password` | `new_password` |
+| 创建店铺初始账号 | `POST /api/admin/shops` | `init_password` |
+| 创建企业 | `POST /api/admin/enterprises` | `password` |
+| 修改企业密码 | `PUT /api/admin/enterprises/{id}/password` | `password` |
+
+错误消息兼容项目既有 `msg` 与说明中的 `message`，优先展示后端提供的可读字段级原因；不改变 401 等既有统一处理，不重复弹错、不输出密码值。
+
+### 4. 换货 1202 定向错误处理
+
+创建换货和确认完成同时覆盖 HTTP 200 的非零业务码与 Axios HTTP 错误响应，不假定只有一种承载形式。在受影响的两个服务调用范围关闭重复默认提示，局部共享处理器处理 1202，其余错误仍按既有统一错误分类/文案展示。
+
+1202 提示读取业务 `data.phone`，有号码则显示「新资产已绑定手机号 {phone}，请先到『手机号资产关联』解除后再提交」，无号码时显示不含号码的完整指引，不输出 `undefined`。只以文本插值渲染，不把后端内容拼成 HTML。
+
+具备关联管理页面查看权限时可提供跳转；无权限时提示联系有权限人员，不扩大解绑权限。禁止自动调用 DELETE、批量解绑或 CSV 解绑。响应内完整号码不写日志或持久化；换货页现有打印完整错误对象的受影响分支也应修正，防止号码间接泄漏。
+
+创建失败保留资产/原因等字段；完成失败重新加载换货单，保持后端「已发货待确认」事实，不乐观标记完成。解除后由用户再次提交。取消只关闭提示，不当作解绑或换货成功。
+
+### 5. 预警只展示快照，不重算阈值
+
+删除 `PackageTrafficAlertRuleItem.real_data_mb` 与规则行/详情/列设置依赖。来自 `/api/admin/packages` 的套餐选项 `real_data_mb` 保留，套餐选择与规则参数校验不变。
+
+记录列表/详情接收后端 `threshold_mb`、`used_mb`、`limit_mb`，用 MB 显示两位小数；0 显示 `0.00`，缺失/null 显示 `-`。标签分别为阈值流量、已用流量（含加油包）、总流量（含加油包）。不使用当前套餐额度重新计算历史 `threshold_mb`，不把新字段作为新的请求入参或筛选项。
+
+### 6. 导入说明与后端结果保持一致
+
+CSV 只同步新表头和手机号说明，不为旧表头做客户端转换、不将用户名转为手机号。发现内置模板时同步，否则仅改当前说明，任务明细保留原后端原因。
+
+设备导入保持原下载文件与列序，将说明中的 IMEI 移到必填列；只把空值规则交给后端逐行处理，不为单行缺失拦截整个文件，不添加格式或去重限制。
+
+## Risks / Trade-offs
+
+- 无最新 OpenAPI：按用户确认，以第 1 批说明实施，不要求补文件；联调发现真实接口与说明不符时先反馈，不自行猜测或声称已通过联调。
+- 密码口径覆盖原说明：用户明确禁止特殊符号，前端不得按原「四类至少三类」放行含符号的新密码；如后端实际校验与该确认冲突，先反馈用户。
+- 恢复旧规范与新业务终态冲突：文档注明差异，实施时优先按本批次终态处理，结果未知继续守原恢复规则。
+- 改错密码/流量范围：专用新密码工具和独立规则/套餐类型限制修改范围，回归旧密码、操作密码、WiFi 密码、套餐额度。
+- 换货错误提示重复或泄漏号码：两个请求定向接管提示，共享处理器保留其他错误行为，删除受影响分支的完整错误输出。
+- 财务状态不同步：重提和失败后重新拉取后端数据，不修改本地冻结金额来模拟后端效果。
+- 仓库未配置可直接运行的单测脚本：先检查现有测试方式，以针对性逻辑检查、类型检查、编码检查和人工联调为验收，不自动引入新框架。
+
+## Migration plan
+
+提案获批后，依据第 1 批说明和用户最新确认，依任务清单按公共类型/规则、各页面、联调顺序实施；前端与对应测试后端一起验收。无数据库迁移、权限迁移、历史导出重生成或自动数据修复。
+
+回退只回退本次业务代码，不触及原有提案和用户改动；后端若仍保留新校验及终态，旧前端将重新出现展示与提交问题，因此上线/回退需确认前后端契约匹配。
+
+## 已确认事项
+
+1. 没有最新 `admin-openapi.yaml`，不要求提供，以第 1 批说明实施。
+2. 新密码 8～12 位，仅允许英文字母和数字，且大写、小写和数字均必需，不允许特殊符号。
+3. 所有 `/api/c/v1` 和 C 端页面排除；后台代理注册失败仅展示重新扫码申请指引，不代发 C 端申请。
+
+当前没有待确认的需求问题。用户已批准实施，后台代码已适配；真实后端联调项继续在任务清单保留未完成状态。
--- a/openspec/changes/update-october-batch-one-admin-integration/implementation.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/implementation.md
@@ -0,0 +1,53 @@
+# 后台实施记录
+
+后台代码已按第 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 卡、设备、预警导出文件列。
+
+这些项目继续保留在任务清单，用户验收及部署后再归档。
--- a/openspec/changes/update-october-batch-one-admin-integration/proposal.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/proposal.md
@@ -0,0 +1,88 @@
+# Change: 十月第 1 批后台前端对接修正
+
+## Why
+
+依据 [第 1 批前端对接说明](../../../docs/产品迭代10月份修改/第1批-8-9月迭代前端对接说明.md)，后台现有代码仍使用旧密码校验、旧审批业务状态和旧预警规则字段，缺少订单在线支付记录与换货手机号冲突反馈。后端已部署测试环境，后台需要同步契约与交互，避免失败单据继续显示审批恢复操作、导入提示误导以及已删除字段显示异常。
+
+用户已于 2026-10-13 批准实施。后台代码已完成适配，本地验证与真实后端联调状态分开记录在 [实施记录](./implementation.md)。用户已确认：只管后台，所有 `/api/c/v1` 接口及 C 端页面均不在范围内。
+
+## What Changes
+
+- M3：后台订单列表和详情展示 `third_party_trade_no`、`payment_channel`、`payment_merchant_name`；详情新增支付记录表，详情类型与列表/创建类型分离，支付单状态独立于订单支付状态。
+- M8、M14：六类后台业务补充各自的「审批提交失败」终态、筛选、标签和操作判断；显式失败不再恢复原审批，结果未知保留原有恢复资格与权限判断。
+- M8：核销申请列表和详情使用真实的 `approval_submission_status` 展示审批提交状态，不能只依赖当前可能为空的名称字段；账单详情中的申请状态同步扩展。
+- M1：**BREAKING**：按用户最新确认，后台七个密码接口相关的既有表单、服务和类型统一到「8～12 位、只允许英文字母和数字，必须同时包含大写字母、小写字母和数字，不允许特殊符号」，包括后台 `PUT /api/auth/password`；账号独立改密服务按文档将请求字段修正为 `new_password`。旧密码登录、本人改密的旧密码输入、操作密码、WiFi 密码不套用新密码规则。
+- M12：创建换货与确认完成捕获错误码 `1202`，从错误响应 `data.phone` 读取手机号，在弹窗中引导到已有「手机号资产关联」入口；不自动解绑、不新增扫码/退款前置拦截，失败时保留表单及原单状态。
+- M16：**BREAKING**：删除预警规则响应类型、规则列表及规则详情展示中对 `real_data_mb` 的依赖；预警列表和详情补齐 `used_mb`、`limit_mb` 及新增 `threshold_mb`，以 MB 展示触发时快照，说明包含加油包。套餐接口和套餐选项中的 `real_data_mb` 保留。
+- M2：**BREAKING**：店铺业务员批量换绑说明及前端内置模板（如有）改用固定表头 `店铺编码,操作类型,平台登录账号,备注`，注明换绑时只填写平台用户登录手机号、清空时该列留空；不兼容旧表头，保留逐行失败原因。
+- M23：设备导入文案将 IMEI 列从可选改为必填，不改变现有模板列名、列序、请求结构，也不新增 IMEI 长度、格式或重复校验；失败详情继续展示后端行号和原因。
+- M13：保留退款状态 3 的重新发起入口；若存在引导在企微重新提交的文案则移除，统一指向后台退款重提流程。
+- M4～M6 及 M16 导出补列：仅安排新建/历史导出任务下载回归，文件列由后端生成，不增加前端导出模板或修改历史文件。
+
+## Scope
+
+| 项目 | 后台纳入内容 | 不纳入内容 |
+| --- | --- | --- |
+| M1 | 本人改密、账号创建/修改/独立改密、店铺初始密码、企业创建/改密，共七个接口 | 扫码注册代理页面的密码校验 |
+| M3 | `/api/admin/orders` 列表/创建响应与详情支付记录 | C 端订单请求、支付流程 |
+| M8、M14 | 核销、退款、代理注册审核、线下充值、佣金提现、提现资料资格 | C 端注册申请及其他 `/api/c/v1` 调用 |
+| M12、M13 | 换货冲突提示、退款重提引导及回归 | 后端手机号解绑规则、企微回调实现 |
+| M16 | 预警规则与记录的展示契约、导出回归 | 预警计算、套餐商品额度调整 |
+| M2、M23 | 导入说明/已有模板表头及任务失败原因 | 后端 CSV/Excel 解析器实现 |
+| F1、M9 | 无 | H5 手机号绑定、登录响应、资产临期提醒、通知中心 |
+
+### 审批失败状态与后台处理
+
+| 后台业务 | 新业务状态 | 失败后的后台处理 |
+| --- | --- | --- |
+| 核销申请 | `4` | 有修改权限时，通过原 `PUT /api/admin/employee-collection-applications/{id}` 重新提交；账单重新读取可核销金额 |
+| 退款 | `7` | 有重提权限时，通过原 `POST /api/admin/refunds/{id}/resubmit` 重新发起 |
+| 代理注册审核 | `3` | 隐藏恢复审批，提示「请申请人重新扫码申请」；后台不代申请人发起 C 端注册请求 |
+| 线下充值 | `7` | 复用现有线下新建表单，通过 `POST /api/admin/agent-recharges` 新建单，不给原单补发审批 |
+| 佣金提现 | `5` | 在有操作资格的店铺提现入口，通过原 `PUT /api/admin/shops/{shop_id}/withdrawal-requests/{id}` 重新提交 |
+| 提现资料资格 | `4` | 复用已有资料提交表单，通过原 `POST /api/admin/shops/{shop_id}/withdrawal-qualifications` 提交新版本 |
+
+### 不新增的能力
+
+- 不修改任何 `/api/c/v1` 服务封装或页面，包括本仓库已有的公开扫码注册页。
+- 不新增后端接口、权限编码、审批实例或财务冻结/释放逻辑。
+- 不因密码接口清单存在而补建目前没有的账号改密页面；覆盖既有页面和服务契约，新增入口须另行确认。
+- 不修改 `src/types/components.d.ts` 的用户已有改动。
+
+## Impact
+
+- Affected specs: `order-management`、`admin-authentication`、`employee-collection`、`refund-management`、`agent-distribution-registration`、`agent-recharge`、`commission-management`、`exchange-management`、`package-traffic-alert`、`shop-management`、`device-batch-import`。
+- Affected code:
+  - `src/types/api/{order,account,employeeCollection,refund,agentDistributionRegistration,agentRecharge,commission,packageTrafficAlert}.ts` 及相关类型导出。
+  - `src/api/modules/{order,account,exchange}.ts`；其余审批相关服务仅按既有接口复用，不扩展 C 端请求。
+  - `src/views/order-management/order-list/{index,detail}.vue`。
+  - `src/components/core/layouts/art-header-bar/ChangePasswordDialog.vue`、`src/views/account-management/{account,enterprise-customer}/index.vue`、`src/views/common/account-list.vue`、`src/views/shop-management/list/index.vue`。
+  - `src/views/finance/employee-collection/`、`src/views/finance/refund/`、`src/views/finance/agent-recharge/`、`src/views/shop-management/agent-distribution-registrations/`。
+  - `src/views/commission-management/{withdrawal-approval,my-commission}/index.vue` 及使用相同提现状态的其他后台视图。
+  - `src/views/asset-management/exchange-management/{index,detail}.vue`。
+  - `src/views/package-management/traffic-alert-rules/index.vue`、`src/views/package-management/traffic-alerts/{index,detail}.vue`。
+  - `src/views/shop-management/business-owner-import/index.vue`、`src/views/asset-management/task-management/device-task/index.vue`。
+  - `src/config/constants/{refund,commission}.ts`、新密码专用校验工具、`src/utils/business/apiError.ts`、必要的中英文文案。
+- 不引入新依赖；复用现有 Vue、Element Plus、权限、表单、错误处理和异步任务机制。
+
+### 与现有提案的关系
+
+当前 `openspec/specs/` 无已发布能力规范，相关功能仅存在于历史未归档提案与业务代码中，因此本次沿用既有 capability 名称，以 `ADDED Requirements` 记录本批次的独立适配约束，不伪造 `MODIFIED` 基线。
+
+- 订单：承接 `update-order-management-response-semantics`，保持操作者/销售店铺/佣金语义。
+- 核销：承接 `update-employee-collection-approval-recovery`、`update-writeoff-application-and-superadmin-commission`，不回退抽屉和账单筛选优化。
+- 退款：承接 `update-refund-management`、`add-refund-approval-recovery`。旧提案允许显式提交失败恢复原审批的描述，在新业务终态 `7` 下不再适用；保留结果未知的恢复路径。
+- 代理注册：承接 `add-agent-registration-approval-management`，仅扩展后台审核状态和反馈。
+- 充值：承接 `update-agent-self-recharge-and-offline-approval`，保留线下凭证、OCR、收款方式等已有字段。
+- 佣金：承接 `add-commission-management`，保留既有店铺范围和超管选店逻辑。
+- 换货：承接 `update-exchange-refund-interception-feedback`、`update-exchange-migration-and-shop-import`，`1202` 为独立定制反馈，非 `1202` 错误继续按原逻辑展示。
+- 预警：承接 `add-package-traffic-alert`，其旧「规则展示当前真流量额度」描述被本批次规则响应契约取代。
+- 导入：承接 `update-exchange-migration-and-shop-import`、`update-device-batch-import-contract`，保留任务字段与设备模板结构。
+
+## 已确认的实施依据
+
+1. 用户确认没有最新 `admin-openapi.yaml`，本次不要求提供，也不将其作为实施前置条件；接口适配以第 1 批对接说明为依据，仓库中的八月 OpenAPI 不作为十月最新版。
+2. 用户确认密码不允许特殊符号，因此新密码只接受 ASCII 英文字母和数字，长度 8～12 位，必须同时包含大写、小写和数字；这一确认优先于原说明的「四类至少三类」规则。
+3. 只实施后台，所有 `/api/c/v1` 和 C 端页面仍排除。
+
+以上需求疑问已消除。详见 [设计说明](./design.md)、[任务清单](./tasks.md) 与 [实施记录](./implementation.md)；如联调发现实际接口与说明或用户确认不符，先向用户反馈，不自行改变口径。
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/admin-authentication/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/admin-authentication/spec.md
@@ -0,0 +1,59 @@
+## ADDED Requirements
+
+### Requirement: 后台新登录密码统一校验
+
+后台既有设置新登录密码的表单 SHALL 按用户最新确认使用专用统一校验：长度 8～12 位，仅允许 ASCII 英文字母和数字，必须同时包含大写字母、小写字母和数字。特殊符号、空白、中文、emoji 和其他非英文字母数字字符 MUST 拒绝；用户确认 MUST 优先于原对接说明的四类字符规则。
+
+#### Scenario: 有效新密码
+
+- **WHEN** 用户在后台本人改密、账号创建、店铺初始账号、企业创建或企业改密入口输入 `Abc12345`
+- **THEN** 新密码校验 MUST 通过
+- **AND** 新密码/确认密码输入限制及说明 MUST 为 8～12 位，仅英文字母和数字，且大写、小写和数字三类均必需
+- **AND** 需要确认密码的表单 MUST 验证其与新密码一致
+
+#### Scenario: 无效新密码
+
+- **WHEN** 用户输入 7 位、13 位、缺少大写/小写/数字任一类的密码，或包含特殊符号、空白、中文、emoji 等非法字符的密码
+- **THEN** 前端 MUST 阻止提交并展示具体规则提示
+- **AND** MUST NOT 静默 trim 密码后当作合法值提交
+
+#### Scenario: 字符类别齐全但含特殊符号
+
+- **WHEN** 用户输入 `Abc1234!`，长度符合且已包含大写、小写和数字
+- **THEN** 前端 MUST 因 `!` 是禁止的特殊符号拒绝该密码
+- **AND** MUST 提示只允许英文字母和数字，不能按原四类字符规则放行
+
+#### Scenario: 修改账号未设置新密码
+
+- **WHEN** 既有账号修改操作未提供可选 `password`
+- **THEN** 页面 MUST NOT 因缺少密码阻止其他字段修改
+- **AND** MUST NOT 提交空密码覆盖原值
+- **AND** 本批次 MUST NOT 仅为接口清单补建当前没有的账号密码编辑入口
+
+### Requirement: 后台密码接口字段与旧密码兼容
+
+后台密码服务 SHALL 保持各接口规定的请求字段；本人改密和账号独立改密的新密码使用 `new_password`，账号创建/可选修改及企业创建/改密使用 `password`，店铺初始密码使用 `init_password`。后端字段级错误 MUST 以既有 `msg` 或提供的 `message` 展示，不替换为笼统提示，不记录密码。
+
+#### Scenario: 独立修改账号密码
+
+- **WHEN** 既有服务调用 `PUT /api/admin/accounts/{id}/password`
+- **THEN** 请求体 MUST 按本批次说明使用 `new_password`，而不是当前旧封装的 `password`
+- **AND** 本批次 MUST NOT 将其他账号接口的 `password` 改名
+
+#### Scenario: 使用旧密码登录和本人改密
+
+- **WHEN** 用户使用仍被后端接受的旧密码登录或填写本人改密 `old_password`
+- **THEN** 前端 MUST NOT 对这些旧密码输入套用新的 8～12 位/三类/禁止特殊符号限制
+- **AND** 本人改密成功后的清理表单、清理登录态和返回登录页行为 MUST 保留
+
+#### Scenario: 非登录密码与 C 端保持不变
+
+- **WHEN** 实施本批次密码适配
+- **THEN** 操作密码、WiFi 密码和通用校验器其他调用行为 MUST 保持不变
+- **AND** 本仓库公开扫码注册页面和所有 `/api/c/v1` 服务 MUST 不修改
+
+#### Scenario: 展示后端字段级原因
+
+- **WHEN** 密码相关请求返回包含具体校验原因的 `msg` 或 `message`
+- **THEN** 页面 MUST 展示该原因且不重复弹错
+- **AND** 请求、日志和错误反馈 MUST NOT 输出输入的密码值
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/agent-distribution-registration/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/agent-distribution-registration/spec.md
@@ -0,0 +1,19 @@
+## ADDED Requirements
+
+### Requirement: 后台代理注册审批提交失败反馈
+
+后台代理注册审核 SHALL 支持业务状态 `3`「审批提交失败」的筛选和失败标签，终态下隐藏恢复审批，并提示申请人从原扫码入口重新申请。后台 MUST NOT 为重新申请调用任何 `/api/c/v1` 接口。
+
+#### Scenario: 审核失败申请
+
+- **WHEN** 列表或详情收到 `status=3` 的注册申请
+- **THEN** 页面 MUST 展示「审批提交失败」，查询类型和筛选 MUST 支持值 3
+- **AND** MUST 隐藏恢复审批，即使陈旧响应 `recoverable=true`
+- **AND** MUST 提示「请申请人重新扫码申请」，保留详情只读功能
+- **AND** MUST NOT 新增后台代注册提交或修改公开注册页面
+
+#### Scenario: 非终态未知结果仍可恢复
+
+- **WHEN** 非失败终态申请的提交结果未知，后端允许恢复且用户有原恢复权限
+- **THEN** 页面 MUST 保留原恢复审批行为并在操作后刷新详情
+- **AND** MUST NOT 把提交状态数值直接当作注册业务状态
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/agent-recharge/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/agent-recharge/spec.md
@@ -0,0 +1,26 @@
+## ADDED Requirements
+
+### Requirement: 线下充值审批失败重新新建
+
+后台线下充值 SHALL 识别业务状态 `7` 为「审批提交失败」终态，支持状态筛选和失败标签；有原创建资格的用户 SHALL 通过既有线下新建表单重新发起，使用 `POST /api/admin/agent-recharges` 新建单，而不是给原单恢复/补发审批。
+
+#### Scenario: 失败单只读与终态操作
+
+- **WHEN** 线下充值列表或详情展示 `status=7` 的单据
+- **THEN** 页面 MUST 展示「审批提交失败」，筛选 MUST 支持值 7
+- **AND** MUST 隐藏原单补发审批、恢复审批及仅适用于待处理单的确认/拒绝操作
+- **AND** 原权限允许的查看详情和查看凭证 MUST 保留
+
+#### Scenario: 重新发起线下充值
+
+- **WHEN** 具备现有线下创建资格的用户为失败单选择重新发起
+- **THEN** 页面 MUST 打开既有线下创建表单并沿用原字段校验
+- **AND** 提交 MUST 使用 `POST /api/admin/agent-recharges`，不得携带原单 ID 调用虚构重提接口
+- **AND** 新建成功后 MUST 刷新列表，不乐观将旧单状态改成成功
+
+#### Scenario: 保留线上充值与原权限
+
+- **WHEN** 实施终态适配
+- **THEN** 在线支付、可用方式、线下收款方式/流水号/OCR/凭证等原行为 MUST 保持不变
+- **AND** 前端 MUST NOT 为重新发起扩大原角色、店铺或创建权限
+- **AND** MUST NOT 修改 C 端接口或将未知结果自动视为失败
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/commission-management/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/commission-management/spec.md
@@ -0,0 +1,37 @@
+## ADDED Requirements
+
+### Requirement: 佣金提现审批提交失败状态
+
+后台提现审核、店铺提现记录和相关详情 SHALL 支持业务状态 `5`「审批提交失败」，各原有提现状态筛选 MUST 包含值 5；具备既有店铺操作资格的用户 SHALL 通过原提现重提接口重新提交，不复用失败审批或本地模拟冻结金额。
+
+#### Scenario: 失败提现展示与操作
+
+- **WHEN** 提现列表或详情收到 `status=5`
+- **THEN** 页面 MUST 展示失败标签并支持筛选值 5
+- **AND** MUST NOT 为该终态展示待审核专有审批或恢复旧审批操作
+- **AND** 可操作的店铺提现入口 MUST 支持「重新提交」，调用 `PUT /api/admin/shops/{shop_id}/withdrawal-requests/{id}`
+- **AND** 既有金额、收款信息、附件校验及店铺权限范围 MUST 保留
+
+#### Scenario: 刷新已释放的冻结金额
+
+- **WHEN** 失败状态已由后端释放冻结金额，或用户成功重新提交提现
+- **THEN** 页面 MUST 刷新后端佣金概览和提现记录
+- **AND** MUST NOT 前端自行增减冻结金额或推断新的冻结结果
+
+### Requirement: 提现资料审批失败提交新版本
+
+后台提现资料 SHALL 识别业务状态 `4` 为「审批提交失败」，展示失败标签并支持以值 4 筛选。原权限允许的用户 SHALL 使用已有资料表单提交新版本，不对失败实例恢复审批。
+
+#### Scenario: 失败资料展示和重提
+
+- **WHEN** 店铺提现资料返回 `status=4`
+- **THEN** 页面 MUST 展示「审批提交失败」，资料状态筛选 MUST 支持值 4
+- **AND** 有原资料提交资格时 MUST 允许复用原表单，通过 `POST /api/admin/shops/{shop_id}/withdrawal-qualifications` 提交新版本
+- **AND** 成功后 MUST 刷新版本列表，保留旧版本历史，不乐观复用旧审批
+- **AND** 原店铺隔离、附件校验和作废权限 MUST 保持不变
+
+#### Scenario: 状态数值不跨业务共用
+
+- **WHEN** 页面同时处理提现状态 5、资料状态 4 和佣金明细状态
+- **THEN** 前端 MUST 使用各自业务映射
+- **AND** MUST NOT 将佣金明细的状态 5「回溯」改成审批提交失败
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/device-batch-import/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/device-batch-import/spec.md
@@ -0,0 +1,27 @@
+## ADDED Requirements
+
+### Requirement: 设备导入说明标注 IMEI 必填
+
+后台设备导入说明 SHALL 将独立 IMEI 列标注为必填，不再列作可选；现有 Excel 模板列名、列数、列序和上传结构 MUST 不变，前端 MUST NOT 增加文档以外的 IMEI 格式、长度或重复限制。
+
+#### Scenario: 查看导入说明和模板
+
+- **WHEN** 用户打开设备导入弹窗
+- **THEN** 说明 MUST 明确 IMEI 必填，且不能因为首列允许 IMEI 作为设备标识就误认为独立 IMEI 列可省略
+- **AND** 原模板下载及列结构 MUST 保持不变
+- **AND** 其他已约定的设备标识、SN 和卡 ICCID 规则 MUST 保留
+
+### Requirement: 保留设备导入行级失败反馈
+
+设备导入任务详情 SHALL 继续按后端 `failed_items` 展示行号、设备标识和原因，IMEI 空值/空白导致的失败 MUST 不影响后端已成功导入的其他行。
+
+#### Scenario: 混合成功与 IMEI 空值失败
+
+- **WHEN** 任务详情返回某行原因「设备IMEI(imei)不能为空」和其他成功行
+- **THEN** 页面 MUST 展示该行号和原始失败原因，保留任务成功/失败计数
+- **AND** 前端 MUST NOT 因单行为空在提交前拒绝整个文件
+
+#### Scenario: 全部失败
+
+- **WHEN** 整个文件所有行失败，后端任务状态为失败
+- **THEN** 页面 MUST 展示后端失败状态及行级明细，不当作上传成功等于导入成功
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/employee-collection/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/employee-collection/spec.md
@@ -0,0 +1,34 @@
+## ADDED Requirements
+
+### Requirement: 核销审批提交失败终态与重提
+
+核销申请 SHALL 识别业务状态 `4` 为「审批提交失败」终态，申请列表、详情及账单中的关联申请状态 MUST 一致。该状态不得恢复原审批，有原修改权限的用户 SHALL 通过既有修改表单重新提交申请。
+
+#### Scenario: 显式失败申请
+
+- **WHEN** 核销申请 `status=4`，或账单分摊记录 `application_status=4`
+- **THEN** 页面 MUST 以失败标签展示「审批提交失败」，申请筛选 MUST 包含值 4
+- **AND** MUST 隐藏恢复审批，即使陈旧数据仍返回 `recoverable=true`
+- **AND** 有原修改权限时 MUST 允许通过 `PUT /api/admin/employee-collection-applications/{id}` 重新提交
+- **AND** MUST 保留原表单、账单分摊与权限范围
+
+#### Scenario: 金额释放与重提结果
+
+- **WHEN** 核销申请失败后用户刷新账单，或通过既有接口重新提交申请
+- **THEN** 页面 MUST 从后端重新读取预占和可核销金额，不本地模拟释放金额
+- **AND** 成功重提后 MUST 刷新申请与关联账单
+
+### Requirement: 核销真实审批提交状态
+
+核销列表和详情 SHALL 根据真实 `approval_submission_status` 展示 `0 待提交 / 1 提交中 / 2 已提交 / 3 提交失败 / 4 结果未知`；后端名称为空时 MUST 按数值回退，不仅依赖名称字段。
+
+#### Scenario: 无审批上下文
+
+- **WHEN** 申请返回 `approval_submission_status=0`
+- **THEN** 列表和详情 MUST 展示「待提交」，不得因 0 为 falsy 而展示为缺失
+
+#### Scenario: 提交结果未知
+
+- **WHEN** 提交状态为 4，业务单并非失败终态，且后端返回 `recoverable=true`
+- **THEN** 有原恢复权限的用户 MUST 仍能看到恢复审批入口
+- **AND** 前端 MUST NOT 将结果未知自行当作审批提交失败或直接生成新审批
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/exchange-management/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/exchange-management/spec.md
@@ -0,0 +1,44 @@
+## ADDED Requirements
+
+### Requirement: 换货新资产手机号绑定冲突提示
+
+后台创建换货和确认完成 SHALL 在错误码 `1202` 时读取错误业务响应的 `data.phone`，用一次文本弹窗提示解除关联的后台入口；处理 MUST 覆盖正常 HTTP 承载的业务失败和 HTTP 错误响应，不自动解绑、预查扫码记录或扩大权限。
+
+#### Scenario: 1202 返回手机号
+
+- **WHEN** `POST /api/admin/exchanges` 或 `POST /api/admin/exchanges/{id}/complete` 返回 `code=1202` 且含 `data.phone`
+- **THEN** 页面 MUST 提示「新资产已绑定手机号 {phone}，请先到『手机号资产关联』解除后再提交」
+- **AND** 默认错误提示与该弹窗 MUST NOT 重复展示
+- **AND** 手机号 MUST 只作为文本渲染，不写日志或持久化
+- **AND** 前端 MUST NOT 自动调用单条、批量或 CSV 解绑接口
+
+#### Scenario: 号码缺失或无管理权限
+
+- **WHEN** 1202 响应不含有效号码，或用户没有关联管理入口权限
+- **THEN** 页面 MUST 显示不含 `undefined` 的解除指引，无号码时不自行猜测
+- **AND** 无管理权限时 MUST 提示联系有权限人员，不暴露越权操作按钮
+
+### Requirement: 换货冲突后保持数据并允许手动重试
+
+1202 失败后后台 SHALL 保留当前创建表单或后端原完成状态，解除关联后允许用户手动再次提交。非 1202 错误 MUST 保留原统一反馈及业务判断。
+
+#### Scenario: 创建失败保留表单
+
+- **WHEN** 创建换货因 1202 被拒绝
+- **THEN** 当前新旧资产、原因、换货类型和其他表单值 MUST 保留
+- **AND** loading MUST 结束，取消提示 MUST NOT 被当作成功
+- **AND** 用户解除关联后 MUST 可手动再次提交原接口
+
+#### Scenario: 确认完成被拒绝
+
+- **WHEN** 确认完成接口因 1202 被拒绝
+- **THEN** 页面 MUST 刷新原换货单，并保持后端「已发货待确认」状态
+- **AND** MUST NOT 乐观标记换货完成或清空当前单据
+- **AND** 用户解除关联后 MUST 可手动重新确认
+
+#### Scenario: 其他错误及原流程不变
+
+- **WHEN** 换货接口返回非 1202 错误，包括退款拦截、权限失败、迁移失败或网络错误
+- **THEN** 页面 MUST 继续按原业务文案及统一错误分类反馈，不重复弹错
+- **AND** MUST NOT 新增依据扫码历史或退款状态的前置拒绝逻辑
+- **AND** 当前换货迁移字段、角色限制和接口成功行为 MUST 保持不变
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/order-management/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/order-management/spec.md
@@ -0,0 +1,36 @@
+## ADDED Requirements
+
+### Requirement: 后台订单在线支付摘要
+
+后台订单公共类型 SHALL 接收 `third_party_trade_no`、`payment_channel`、`payment_merchant_name` 三个字符串字段；订单列表和详情 MUST 分别展示交易流水号、支付渠道和收款商户，不自行推断或补造后端未提供的值。
+
+#### Scenario: 查看个人客户已支付在线订单
+
+- **WHEN** 后台订单列表或详情收到个人客户微信/支付宝已支付订单的支付摘要
+- **THEN** 页面 MUST 展示后端返回的三个字段
+- **AND** `wechat`、`wechat_v2`、`fuiou` MUST 分别展示为微信直连 v3、微信直连 v2、富友
+- **AND** 未知非空渠道 MUST 保留原值，不错误映射成其他渠道
+- **AND** 已退款订单返回的原支付信息 MUST 继续展示
+
+#### Scenario: 查看无在线支付摘要的订单
+
+- **WHEN** 代理、钱包、线下或未支付订单的三个字段为空串
+- **THEN** 页面 MUST 统一展示 `-`，不得显示 `undefined` 或虚构渠道/商户
+- **AND** 列表和创建响应类型 MUST NOT 要求存在详情专有的 `payments`
+
+### Requirement: 后台订单详情支付记录
+
+后台订单详情 SHALL 使用独立于列表/创建响应的详情类型，接收并展示 `payments` 数组。支付单状态 MUST 使用独立映射 `0 待支付 / 1 已支付 / 2 已失败 / 3 已退款`，不得复用订单支付状态枚举。
+
+#### Scenario: 展示多个支付尝试
+
+- **WHEN** `GET /api/admin/orders/{id}` 返回多条支付记录
+- **THEN** 页面 MUST 按后端返回的创建时间倒序展示，不删除待支付或失败记录
+- **AND** MUST 展示支付单号、支付方式、渠道、商户、交易流水号、金额、状态、创建/支付/过期时间
+- **AND** 金额 MUST 从分转换为元，`paid_at`、`expire_at` 的 null 值 MUST 展示 `-`
+
+#### Scenario: 无支付记录
+
+- **WHEN** 订单详情返回 `payments=[]`
+- **THEN** 页面 MUST 显示支付记录空态，不报错或生成占位支付单
+- **AND** 页面 MUST NOT 为加载支付记录调用 C 端接口
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/package-traffic-alert/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/package-traffic-alert/spec.md
@@ -0,0 +1,41 @@
+## ADDED Requirements
+
+### Requirement: 预警规则不依赖已删除额度字段
+
+后台预警规则 SHALL 按本批次响应字段展示规则，响应类型、列表、详情和列选项 MUST NOT 依赖 `real_data_mb`；套餐商品接口和套餐选项的同名额度字段 MUST 保留。
+
+#### Scenario: 规则响应不含额度
+
+- **WHEN** 后台加载规则列表或详情且后端不再返回 `real_data_mb`
+- **THEN** 页面 MUST 不展示规则的套餐流量额度列及详情字段
+- **AND** MUST 正常展示套餐、阈值百分比、启用状态、备注和更新时间
+- **AND** MUST NOT 因删除字段显示 `undefined` 或产生类型错误
+
+#### Scenario: 套餐商品额度保留
+
+- **WHEN** 规则表单从 `/api/admin/packages` 加载套餐候选
+- **THEN** 套餐类型及选项中 `real_data_mb` 的原用途 MUST 保留
+- **AND** 原规则创建/修改参数与阈值百分比校验 MUST 不变
+
+### Requirement: 预警记录展示主套餐与加油包流量快照
+
+后台预警列表和详情 SHALL 接收并展示后端 `threshold_mb`、`used_mb`、`limit_mb`，三者单位为 MB；阈值流量 MUST 使用触发时快照，不以当前套餐额度重新计算，已用和总量说明 MUST 标注包含加油包。
+
+#### Scenario: 展示预警流量
+
+- **WHEN** 预警列表或详情返回三项 MB 数值
+- **THEN** 页面 MUST 展示「阈值流量(MB)」「已用流量(MB，含加油包)」「总流量(MB，含加油包)」或同等明确标签
+- **AND** MUST 以两位小数展示，不混用规则百分比或 GB 数值
+- **AND** MUST NOT 使用当前套餐商品或前端计算覆盖 `threshold_mb`
+
+#### Scenario: 零与缺失值
+
+- **WHEN** 流量值为 0、null 或缺失
+- **THEN** 0 MUST 展示 `0.00`，null/缺失 MUST 展示 `-`
+- **AND** MUST NOT 把 0 显示为缺失或将缺失值当作 0
+
+#### Scenario: 导出仍由后端生成
+
+- **WHEN** 用户创建预警导出任务或下载历史文件
+- **THEN** 前端 MUST 复用原导出任务流程，不新增前端列模板或重写历史文件
+- **AND** 本批次验收 MUST 检查新任务最后一列阈值流量及历史任务原文件不变
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/refund-management/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/refund-management/spec.md
@@ -0,0 +1,36 @@
+## ADDED Requirements
+
+### Requirement: 退款审批提交失败状态与后台重提
+
+退款后台 SHALL 识别业务状态 `7` 为「审批提交失败」终态，列表与详情 MUST 支持该状态展示和筛选。有原重提权限的用户 SHALL 使用原退款重提表单重新发起，不得恢复失败单的原审批。
+
+#### Scenario: 显式提交失败
+
+- **WHEN** 退款记录 `status=7`
+- **THEN** 列表和详情 MUST 展示失败标签，状态筛选 MUST 允许值 7
+- **AND** MUST 隐藏恢复及补发审批，不因陈旧 `approval_recoverable=true` 重新显示
+- **AND** 有重提权限时 MUST 通过 `POST /api/admin/refunds/{id}/resubmit` 重新发起
+- **AND** 成功后 MUST 刷新记录，不复用旧审批实例
+
+#### Scenario: 不混淆原路退款失败
+
+- **WHEN** 退款记录 `status=6`
+- **THEN** 页面 MUST 继续按原「原路退款失败」含义及 `anomaly_flag` 限制处理
+- **AND** MUST NOT 将该状态改成审批提交失败或放宽其原有异常限制
+
+#### Scenario: 结果未知保留恢复资格
+
+- **WHEN** 退款提交结果未知，业务状态不是 7，后端允许恢复且用户有原权限
+- **THEN** 页面 MUST 保留恢复审批入口
+- **AND** MUST NOT 直接把未知结果改成终态或创建重复申请
+
+### Requirement: 退款企微结束后使用后台重新发起
+
+后台退款页面 SHALL 对企微拒绝/撤销/删除后返回的 `status=3` 按「已拒绝」处理，允许符合原权限和规则的后台重提。页面 MUST NOT 引导用户在企微重新提交作为后台退款重提方式。
+
+#### Scenario: 已拒绝退款重新发起
+
+- **WHEN** 用户查看状态 3 的退款，且具备原重提权限
+- **THEN** 页面 MUST 保留后台重新发起入口并调用原 `resubmit` 接口
+- **AND** 若存在「在企微重新提交」文案，MUST 移除或改为后台重新发起指引
+- **AND** 换货资格 MUST 仍由换货接口判断，不新增退款状态前置拦截
--- a/openspec/changes/update-october-batch-one-admin-integration/specs/shop-management/spec.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/specs/shop-management/spec.md
@@ -0,0 +1,19 @@
+## ADDED Requirements
+
+### Requirement: 业务员批量换绑使用平台登录手机号表头
+
+后台业务员批量换绑页面 SHALL 将说明及已有前端内置模板（如有）统一为固定表头 `店铺编码,操作类型,平台登录账号,备注`，说明「平台登录账号」仅填写平台用户登录手机号。请求路径、结构、逐行结果和已有任务信息 MUST 保持不变。
+
+#### Scenario: 换绑说明和清空规则
+
+- **WHEN** 用户查看导入说明或下载已有前端模板
+- **THEN** 表头 MUST 使用「平台登录账号」，不得保留「业务员登录账号」
+- **AND** MUST 说明换绑时填写平台用户登录手机号而非用户名，清空时该列留空
+- **AND** MUST NOT 自动兼容/转换旧表头或把用户名转换为手机号
+
+#### Scenario: 展示逐行失败
+
+- **WHEN** 后端返回表头错误或行级格式不对、手机号不存在、非平台用户、账号禁用、多账号匹配等原因
+- **THEN** 页面 MUST 原样展示后端原因
+- **AND** 混合结果 MUST 保留成功行与失败行，不因部分失败改为前端整批拒绝
+- **AND** 接口 MUST 继续使用 `POST /api/admin/shops/business-owner-imports`
--- a/openspec/changes/update-october-batch-one-admin-integration/tasks.md
+++ b/openspec/changes/update-october-batch-one-admin-integration/tasks.md
@@ -0,0 +1,61 @@
+## 1. 实施前核对
+
+- [x] 1.1 用户于 2026-10-13 批准实施，仅后台，不修改 `/api/c/v1`。
+- [x] 1.2 按说明落实账号独立改密、核销提交状态、预警字段和错误响应，不依赖最新 OpenAPI。
+- [x] 1.3 按已确认密码规则准备长度、字符类别、非法字符及旧密码边界用例。
+- [x] 1.4 核对旧提案与代码，保留权限、核销抽屉、店铺范围、原换货流程及用户改动。
+
+## 2. 订单在线支付信息（M3）
+
+- [x] 2.1 补订单公共摘要字段、独立支付单状态与详情类型，列表/创建不要求 `payments`。
+- [x] 2.2 列表和详情展示三项支付摘要、渠道映射、未知值及空值。
+- [x] 2.3 详情支付表展示字段、金额、独立状态及空时间，保留失败记录和后端顺序。
+
+## 3. 审批提交失败终态（M8、M14）
+
+- [x] 3.1 核销状态 4、筛选/标签、关联申请和真实提交状态；支持原表单重提，终态隐藏恢复。
+- [x] 3.2 退款状态 7、筛选/标签和原 resubmit，终态禁止恢复/补发，状态 6 异常限制保留。
+- [x] 3.3 后台代理注册状态 3、筛选/标签和重新扫码指引，终态隐藏恢复，不改 C 端。
+- [x] 3.4 线下充值状态 7、筛选/标签及操作判断，复用原创建权限/表单发起新单。
+- [x] 3.5 提现状态 5、相关后台筛选/标签/详情、原重提入口及概览刷新，不本地模拟金额。
+- [x] 3.6 资料资格状态 4、筛选/标签和原资料表单提交新版本。
+- [x] 3.7 本地代码与逻辑测试复核终态/未知结果、只读操作和权限判断；财务事实随 7.3 联调。
+
+## 4. 后台新密码规则（M1）
+
+- [x] 4.1 新密码专用校验和说明：8～12 位，三类英文字母/数字必需，拒绝所有非法字符，不 trim。
+- [x] 4.2 本人改密新密码/确认限制及双语说明；旧密码仅必填，原成功行为保持；错误换行不重叠。
+- [x] 4.3 账号及客户账号创建接入校验，可选修改空密码不发送，不新增入口。
+- [x] 4.4 账号独立改密改为 `new_password`，其他字段不改名。
+- [x] 4.5 店铺初始密码、企业创建/改密接入校验及 maxlength。
+- [x] 4.6 兼容 `msg`/`message`，受影响密码操作检查非零业务码且不记录带密码的错误对象；其他密码与 C 端不改。
+
+## 5. 换货手机号冲突反馈（M12）
+
+- [x] 5.1 两入口共用 1202 提取/提示，兼容业务与 HTTP 错误和无号码降级。
+- [x] 5.2 创建保留表单，完成失败重新读原单，用户解除后手动重试。
+- [x] 5.3 按已有权限指引，不自动解绑、记录或持久化号码。
+- [x] 5.4 非 1202 保持后端原因与原错误分类，不新增前置检查或重复默认提示。
+
+## 6. 预警口径与导入说明（M16、M2、M23）
+
+- [x] 6.1 删除规则额度引用，保留套餐商品/候选额度及规则参数。
+- [x] 6.2 补三项 MB 快照、两位小数、0/空值与加油包说明，不重算历史阈值。
+- [x] 6.3 新 CSV 表头及说明；下载从统一 UTF-8 BOM 文本生成，原 GBK 文件保留，逐行结果不变。
+- [x] 6.4 IMEI 说明改必填，原 Excel 模板及上传/失败明细保持，不加格式或去重限制。
+
+## 7. 回归与验收
+
+- [x] 7.1 未发现引导企微重提的后台文案；本地测试确认状态 3 仍允许后台重提，真实流程随 7.3 联调。
+- [ ] 7.2 检查订单个人在线已支付/已退款信息，未支付及代理/钱包/线下空字段，详情多个支付记录的顺序、金额、状态和空时间。
+- [ ] 7.3 检查六类失败终态、状态筛选、恢复隐藏、重提入口；覆盖陈旧 recoverable=true、结果未知、无权限及刷新财务数据。
+- [x] 7.4 本地规则与改密页检查长度、三类、非法字符、可选空密码及旧密码兼容；375px 错误文案不重叠，其他密码代码未改。
+- [ ] 7.5 检查换货两入口 1202 有/无号码、无管理权限、用户取消、解除后重试和其他错误；确认日志不含号码、原完成状态不被误改。
+- [x] 7.6 本地规则/详情页与数值测试确认规则无额度、套餐字段保留、三项 MB/0/空值及加油包文案。
+- [ ] 7.7 检查 CSV 新/旧表头、用户名误填、清空行和混合成功失败；检查设备 IMEI 空白行、部分成功、全失败以及模板未改变。
+- [ ] 7.8 新建订单/IoT 卡/设备/预警导出任务检查后端新增列，下载历史任务检查旧列仍在；不修改前端导出模板或历史文件。
+- [x] 7.9 本地 63 项测试、受影响文件 lint、类型检查、生产构建、UTF-8、OpenSpec 严格校验通过；模拟页面检查通过，真实环境项单列。
+- [x] 7.10 C 端页面/服务无差异，组件声明 SHA-256 与实施前一致；回写实际完成和待联调项。
+- [ ] 7.11 完成真实测试环境联调及用户验收后归档，不以模拟页面替代后端验收。
+
+  7.2、7.3、7.5、7.7 的本地逻辑与部分模拟页面已覆盖；尚未验证真实支付、冻结/预占金额、解除后重试、导入结果与导出文件。复现方式及证据见 [实施记录](./implementation.md)。