csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

迭代计划准备

Browse Source
This commit is contained in:
break
2026-07-16 15:07:59 +08:00
parent 1a9db9328e
commit c4f430ccb3
22 changed files with 2969 additions and 1569 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
docs/7月迭代/业务需求.md
View File

@@ -1,3 +1,5 @@
> 本文保留原始业务需求措辞。涉及架构、字段和接口的最终技术口径，以同目录的专项技术方案和 `基础设施/` 文档为准。
其中有一些需要对接第三方系统的,除了gateway,都可以划分阶段
@@ -10,8 +12,13 @@
6. 在资产详情页增加所有待生效套餐加上生效套餐加起来的最后到期时间
7.lot卡管理和设备管理新增已实名/未实名的筛选查询条件
8.设备批量分配代理和套餐系列:因设备号不是连号，故需要提供导入excel表的方式进行批量分配代理和套餐系列。excle表头为：设备号
> 评审结论：拆成“批量分配代理”和“批量分配套餐系列”两个独立命令、两个前端入口和两个任务类型；可复用 Excel 解析与任务基础设施，但单个任务不得同时修改两个字段。
9.C端支付时,卡资产只允许支付宝支付以及钱包支付,如果用微信支付就拒绝,设备只允许微信支付以及钱包支付,如果用支付宝支付就拒绝
10.限速规则:根据不同运营商限速规则，基于套餐流量设置不同的卡/设备的限速规则,限速接口由gateway提供
> 技术口径说明：Gateway 只支持按 `cardNo` 限速，不存在设备级限速。单卡直接使用 ICCID；设备场景先查 `tb_device_sim_binding.is_current=true` 的当前卡，再使用该卡 ICCID。取消限速仍重复调用同一个限速接口，只是发送取消参数。本期仅提供后台手动设置/取消，内部单位为 `kbps`；不做套餐字段和自动限速规则。
11. 资产信息详情字段新增:资产信息页面卡信息/设备信息板块，将当前生效套餐的过期时间作为一个字段显示且套餐还剩15天到期时该字段高亮显示。
12. 换货管理:
| 编号 | 需求 |
@@ -27,9 +34,9 @@
| COL-002 | 代理充值列表 | 提交人、审批人 |
| COL-003 | 换号管理列表 | 提交人 |
14. 导出功能:
#### 6.8.1 lot 卡导出
## 6.8.1 lot 卡导出
##### 支持套餐临期30天内所有资产的导出。字段按照卡/设备的导出表进行导出。
### 支持套餐临期30天内所有资产的导出。字段按照卡/设备的导出表进行导出。
| 编号 | 需求 |
| -------- | ---------------------------- |
@@ -37,7 +44,7 @@
| EXPD-002 | lot 卡导出字段新增使用流量。 |
| EXPD-003 | lot 卡导出字段新增剩余流量。 |
#### 6.8.2 代理资金概况-预充值钱包流水导出
## 6.8.2 代理资金概况-预充值钱包流水导出
导出字段：
@@ -58,7 +65,7 @@
| 关联业务订单号 | 充值、扣款、退款等交易对应的原始业务订单编号 |
| 交易渠道 / 支付方式 | 明确交易来源：余额支付等 |
#### 6.8.3 套餐列表导出
## 6.8.3 套餐列表导出
导出字段：
@@ -90,7 +97,7 @@
| 更新时间 |
| 删除时间 |
#### 6.8.4 退款管理退款列表导出
## 6.8.4 退款管理退款列表导出
导出字段：
@@ -119,9 +126,9 @@
| 财务审批人 |
| 退款凭证 |
#### 6.8.5 换货管理导出
## 6.8.5 换货管理导出
##### C端客户有自己的唯一标识码。换货管理可以针对该C端客户记录该客户换过几次设备或卡。同时资产本身也做换货标识。
### C端客户有自己的唯一标识码。换货管理可以针对该C端客户记录该客户换过几次设备或卡。同时资产本身也做换货标识。
导出字段：
@@ -143,7 +150,7 @@
| 创建人 |
| 创建时间 |
#### 6.8.6 代理充值导出
## 6.8.6 代理充值导出
导出字段：
@@ -176,7 +183,7 @@
这个好像没有 ：
##### 之后是否需要增加？因加入财务审批操作退款，可能有原路退回或不同的退款方式如支付宝退款或微信退款？
### 之后是否需要增加？因加入财务审批操作退款，可能有原路退回或不同的退款方式如支付宝退款或微信退款？
| 部门领导审批人 |
@@ -184,22 +191,27 @@
这两个好像也没有
##### 目前是没有呀，但是之前不是说了审批流程需要加上吗？列表字段同时需要新增
### 目前是没有呀，但是之前不是说了审批流程需要加上吗？列表字段同时需要新增
| 支付通道 |
这是啥玩意
##### 去掉
### 去掉
"导出功能可以根据不同权限显示的字段不同且可以自己选择需要导出的字段。像现在这样全量导出，大家都可以看到虚流量等不想让所有人都看到的字段。" 什么叫不同权限,这个不同权限显示字段不同是固定的吗,平台就是固定的,代理就是固定的等等,如果是这样的话需要标记对应的导出字段的权限划分
##### 因为不同的角色，权限不一致，列表的字段不能给每个用户看到类似真流量这样的字段，比如客服只能看到虚流量跟客户看到的一样,应当在角色管理中新增一个导出字段配置
### 因为不同的角色，权限不一致，列表的字段不能给每个用户看到类似真流量这样的字段，比如客服只能看到虚流量跟客户看到的一样,应当在角色管理中新增一个导出字段配置
> 评审结论：角色级导出字段配置属于本期范围。后端返回当前角色允许导出的字段，最终导出字段取“角色授权字段”与“用户本次选择字段”的交集，前端不能绕过服务端授权。
15. 套餐相关: 套餐下架后，正在使用该套餐的客户仍可续费。,下架套餐续费仅支持客户自己购买。 ,下架套餐不可被新购买。
15. 套餐相关: 套餐下架后，正在使用该套餐的客户仍可续费。,下架套餐续费仅支持客户自己购买。 ,下架套餐不可被新购买。
16. 代理分销码与佣金提现
##### 员工可作为代理发展人进行标识。（在系统中如何体现？）
> 迭代范围变更（2026-07-14）：需求 16 整体移出 7 月迭代，后续独立立项和评审。以下内容仅保留原始需求记录，本期不开发、不迁移、不发布。
### 员工可作为代理发展人进行标识。（在系统中如何体现？）
| 编号 | 需求 |
| ------- | ---------------------------------------------------- |
@@ -210,6 +222,9 @@
| DST-005 | 佣金提现需上传法人身份证。（必填） |
| DST-006 | 佣金提现可选上传门头照。（可选） |
| DST-007 | 佣金提现需上传发票，且公司主体需与合同一致。（可选） |
> 当前结论：原技术方案不再属于 7 月迭代范围。后续重新立项时再评审分销关系、代理申请审批、开店幂等和提现材料。
17. 不同渠道信用额度,钱包支持信用额度支付
| 编号 | 需求 |
| ------- | ------------------------------------------------------------ |
@@ -217,6 +232,9 @@
| BPO-010 | 不同代理可设置不同额度下限。平台用户可根据不同的角色设置不同的额度下限。 |
| BPO-011 | 授权额度用于订购套餐、代理余额充值等需要涉及金额的所有模块。 |
| BPO-012 | 授权额度代理可显示负数余额。平台用户也可显示负数余额。 |
> 评审结论：信用额度只属于代理主钱包。平台员工是操作主体而不是结算主体，不建立员工钱包、不配置员工信用额度，也不展示员工负余额；角色仅控制谁可以查看或调整代理额度。
18. 系统原先对于审核都是单人审核,现在希望增加多人审批以及相关设置
| 编号 | 需求 |
| ------- | ------------------------------------------------------------ |
@@ -229,6 +247,11 @@
| APR-007 | 审核通过后通知申请人。 |
| APR-008 | 审核驳回后通知申请人，并附带驳回原因。 |
| APR-009 | 审核流程需对接企业微信审批流程。 |
> 技术口径说明：当前系统没有部门组织模型。“部门领导审核、财务审核”作为默认流程节点名称处理，实际审批人由流程定义配置的角色或指定账号产生，不根据提交人部门自动推导，也不在代码中固定角色名称。每次通过、驳回、退回都形成不可修改的审批意见记录，并可附带最多 5 个审批附件；驳回和退回意见必填。
> 审批详情必须展示业务单号、提交人、审批关键字段、业务资料、此前审批人的意见和审批附件。业务资料与审批附件分开存储和展示；流程启动时固化业务快照，实时业务页仍按原业务数据范围校验。
19.批量订购套餐
内部员工进入批量订购页面。
2. 选择代理、ICCID号段/设备号、订购套餐。或上传 Excel 文件，资产标识支持 ICCID/设备号
@@ -277,6 +300,8 @@ excel表导入字段修改为以下：
如果用批量订购应当上传对应凭证
> 评审结论：支付方式按整批统一。页面选择“线下支付”或“代理钱包支付”，Excel 不再包含支付方式列；线下支付按整批上传凭证，混合支付必须拆成不同批次。
20.退款审批
（审批均可通过企微进行提醒和显示并将最新状态同步至卡管）
1. 员工提交退款申请。
@@ -284,6 +309,8 @@ excel表导入字段修改为以下：
3. 按部门领导、财务顺序审批。
4. 当前环节审批完成后，下一环节审批人收到消息提示。
5. 审批通过或驳回后通知申请人。
> 评审结论：微信、支付宝和线下退款由财务在系统外人工完成后确认；本期不接入第三方自动退款。代理钱包支付的退款仅自动回退原扣款代理主钱包，客户资产钱包不在本期自动回退范围。
21. 充值审核流程
代理自己充值：
1. 代理在系统提交充值申请。
@@ -296,6 +323,9 @@ excel表导入字段修改为以下：
3. 财务在上一审批人通过后收到待办提醒并审批。
4. 审批通过后通知申请人。
5. 审批驳回后通知申请人，并展示驳回原因。
> 技术口径说明：审批通过只表示审批结论成立，不表示退款已经到账或充值已经入账。退款、充值分别维护业务处理状态并支持异步重试。此次采用停机发布，旧退款业务单审批接口和线下充值 `offline-pay/reject` 不保留兼容窗口。
22. 套餐临期提醒
1. 系统每日计算卡/设备套餐剩余有效期。
2. 命中临期规则后生成临期数据。临期提醒规则：按 15 天、7 天、3 天节点分别进行不同方式的提醒。
@@ -303,7 +333,7 @@ excel表导入字段修改为以下：
4. 代理端场景（展示）：首页展示卡、设备临期数量；资产列表按临期天数高亮。
5. C 端场景（展示）：公众号首页在套餐剩余有效期小于或等于 15天时展示续费提醒，并显示立即续费按钮。
6. 当资产续费成功或不再满足临期条件时，临期提醒自动取消。
#### 6.1.1 企业客户临期提醒
## 6.1.1 企业客户临期提醒
| 编号 | 需求 |
| ------- | ------------------------------------------------------------ |
| EXP-001 | 后台每日生成企业客户临期列表。 |
@@ -311,7 +341,7 @@ excel表导入字段修改为以下：
| EXP-003 | 系统需对接企业微信，将临期列表推送给对应业务员。 |
| EXP-004 | 同一资产在不同临期节点可重复触发对应节点提醒，但同一节点每日不可重复推送给同一业务员。 |
#### 6.1.2 代理端临期提醒
## 6.1.2 代理端临期提醒
| 编号 | 需求 |
| ------- | ------------------------------------------------------------ |
@@ -320,7 +350,7 @@ excel表导入字段修改为以下：
| EXP-007 | 剩余 15 天标记为粉色，剩余 7 天标记为紫色，剩余 3 天标记为红色。 |
| EXP-008 | 剩余 3 天资产在列表中置顶优先展示。 |
#### 6.1.3 C 端公众号首页提醒
## 6.1.3 C 端公众号首页提醒
| 编号 | 需求 |
| ------- | ------------------------------------------------------------ |
@@ -358,7 +388,7 @@ excel表导入字段修改为以下：
代理 15,7,3天
C端公众号 小于等于15天
颜色规则
颜色规则
临期天数小于等于15天时，显示粉红色；
临期天数小于等于7天时，显示紫色；
临期天数小于等于3天时，显示黄色；