27 lines
3.8 KiB
Markdown
27 lines
3.8 KiB
Markdown
## Context
|
||
|
||
Vue 3 / Element Plus 后台已有订单列表与详情、两处单项购买、套餐创建/分配/系列授权、资产当前/历史套餐、统一导出、企微审批与角色权限树。本次复用现有能力，延续店铺列表/详情标准、时间格式、条件 >=4 才展开和响应式。
|
||
|
||
## Decisions
|
||
|
||
- 原订单列表接收受控分类 props，三个薄路由入口使用独立名称缓存，按分类选择服务与导出场景，不在 query 注入 category。旧列表继续 all；企业路由门禁与请求/处理函数都限制，代理 online 严格禁止，后端继续鉴权。
|
||
- 企业操作限制使用公共账号类型判断；不能仅改一个 v-if：覆盖基础信息、绑定卡、当前套餐、历史套餐及父页处理函数，保留 start/stop、历史与只读数据。
|
||
- 套餐商品默认天数、单次购买覆盖天数、延期天数分别校验，不能共享错误的 90 天上限；null/空与 0 区分；加油包白名单剔除沉默期字段。原实名生效条件保存为只读基线，禁止转换为购买生效。
|
||
- 下单前冻结目标、表单字段和幂等标识；权限取消或资产/套餐切换不发送旧覆盖值。后端决定实际是否适用及是否审批，不靠前端成功提示推定立即生效。
|
||
- silence 可选且不可从其他套餐复用。当前/历史套餐分别展示各自响应；后端不返回对象时不猜测未启用与不适用的区别，不请求资格接口。
|
||
- 首次购买显示使用 formatDateTime；查询与导出共享同一范围转换，ICCID/IMEI 保持字符串。世代与结束原因由服务端返回，记录 DTO 不明时仅完成字段/筛选，记录弹窗保持待补契约。
|
||
- 使用现有预签名上传、凭证、二维码与审批组件，不引入依赖。延期付款金额必须取 quote，不能在浏览器自行按 30 天计费；未知的金额单位与 evidence_refs 结构是实现前置条件。
|
||
- 对文档只列 URL、未列 DTO 的延期页面，先列覆盖清单与契约缺口，不擅自制作可写空壳或推断财务模型。
|
||
|
||
## Validation
|
||
|
||
2026-10-28 契约补齐：保存 Apifox 的 21 个后台操作为 `docs/api/package-silence.openapi.json`；全部金额为整数分，前端元输入精确转换。首次购买记录使用 `/api/admin/assets/{asset_type}/{id}/first-purchase-records`，流水/首次购买记录为数组；政策列表也为数组但支持 page/page_size，因此显示上一页/下一页而不伪造总数。政策适用系列/套餐使用既有名称搜索接口。
|
||
|
||
特殊延期 CSV 在前端按 `package_usage_id,days` 两列解析，再以明确的 items[] 提交，不猜后端 import_file_key 的未说明文件格式。二维码/线下订单同一快照重试复用 request_id；特殊接口不定义幂等字段，结果不确定时阻止重复提交并提示核对批次。免审批场景保留真实返回的字符串，提供文档明确的 offline_paid/batch；其他编码需后端提供，不猜完整枚举。
|
||
|
||
先记录当前 198 项基线与 dirty worktree；新增精确请求/角色/字段校验及组件行为测试，覆盖企业 5 项操作但保留停复机、三分类服务、导出 false/0、套餐天数边界、购买覆盖与原因、无权限不发字段、加油包剔除、首次购买时间与空值、未知错误和 0 元退款。运行全量 Node 测试、vue-tsc、受影响文件 lint/format/encoding、生产构建与针对性本地 mock；不把不完整 DTO 的自造响应作为后端验收。
|
||
|
||
## Rollout and risks
|
||
|
||
无数据库迁移，不自动开沉默期总开关，旧订单路由/导出与现有菜单配置保留。新菜单是否可见仍需后端菜单数据授权；清单在实施后按实际 URL/权限交付。真实支付与审批、资产范围和文件内容需测试环境联调。C 端为独立工程，仅提供同步清单。
|