技术开发需求文档 — 赊销额度设置开关
创建时间：2026-05-08
截止日期：2026-05-09（2天）
概要表
| 项目 |
值 |
| 任务名 |
赊销额度设置开关 |
| 涉及终端 |
PC端（后台）、收银机端、PDA端 |
| 功能属性 |
原生支持 |
| 权限控制 |
店长角色可开启/关闭 |
| 与现有系统关系 |
现有功能优化 |
| 部署服务器 |
爱优新零售 118.24.231.235（腾讯云重庆一区） |
| 数据库 |
爱优 TDSQL-C 云数据库（cq-cynosdbmysql-grp-9z6bxdc5 读写 / cq-cynosdbmysql-grp-m2z44ykj 只读） |
| 后端 |
徐涛 |
| 前端（PC端） |
张玉杰 |
| 前端（收银机端） |
张家学 |
| 前端（PDA端） |
刘文伟 |
| 测试 |
朱一花 |
| 截止日期 |
2026-05-09 |
一、涉及终端
- [x] PC端（后台）
- [x] 收银机端
- [x] PDA端
二、功能属性
| 项目 |
值 |
| 插件模式 |
否 — 原生功能，无需插件分配 |
| 权限控制 |
PC端后台控制，店长角色有权限开启/关闭 |
| 与现有系统关系 |
现有功能优化 |
| 开关位置 |
PC后台 — 基本设置页面 |
| 控制粒度 |
按门店独立控制 |
三、部署规划
| 项目 |
目标位置 |
| 后台服务器 |
爱优新零售 118.24.231.235（腾讯云重庆一区，8C16G 8M） |
| 数据库 |
爱优 TDSQL-C 读写实例 cq-cynosdbmysql-grp-9z6bxdc5.sql.tencentcdb.com:26099 |
四、人员分工
| 负责人 |
职责 |
| 徐涛 |
后端 — 赊销授信检查逻辑改造、开关API接口、数据库字段设计 |
| 张玉杰 |
PC端前端 — 基本设置页面开关UI、开关保存/读取交互 |
| 张家学 |
收银机端前端 — 开单赊销时读取开关状态，执行对应逻辑 |
| 刘文伟 |
PDA端前端 — 开单赊销时读取开关状态，执行对应逻辑 |
| 朱一花 |
测试 — 各端功能验证、边界测试 |
五、功能模块清单
| # |
模块 |
功能描述 |
涉及端 |
负责人 |
优先级 |
| 1 |
门店赊销开关 |
PC后台基本设置页面新增"关闭授信检查"开关，支持按门店独立配置，店长可操作 |
PC端（后台） |
张玉杰 |
P0 |
| 2 |
开关存储设计 |
数据库门店配置表新增赊销开关字段（enable_credit_check），默认值为1（开启授信检查） |
后端 |
徐涛 |
P0 |
| 3 |
授信检查API |
后端提供开关读取接口，供收银机端和PDA端调用 |
后端 |
徐涛 |
P0 |
| 4 |
收银机端适配 |
开单赊销时调用API读取开关状态：关闭则跳过额度校验，直接叠加应收账款余额 |
收银机端 |
张家学 |
P0 |
| 5 |
PDA端适配 |
开单赊销时调用API读取开关状态：关闭则跳过额度校验，直接叠加应收账款余额 |
PDA端 |
刘文伟 |
P0 |
| 6 |
授信检查逻辑改造 |
后端判断开关状态：关闭时跳过授信额度校验，直接叠加应收账款余额 |
后端 |
徐涛 |
P0 |
六、业务逻辑说明
赊销开单流程
【默认行为（开关 = 关闭授信检查 = 否）】
客户开单选择赊销
↓
检验客户授信额度（剩余额度 >= 赊销金额？）
↓
额度充足 → 开单成功，叠加应收账款余额
额度不足 → 拒绝开单，提示"授信额度不足"
【开启后（开关 = 关闭授信检查 = 是）】
客户开单选择赊销
↓
跳过授信额度校验
↓
直接叠加应收账款余额（不限制额度）
开关存储位置
| 字段 |
说明 |
| 表名 |
门店配置表（待确认具体表名） |
| 字段 |
enable_credit_check（INT，默认1） |
| 控制粒度 |
按门店独立控制 |
七、备注
- 开关默认值：默认不开启（1 = 校验，0 = 跳过校验），确保现有业务不受影响
- 权限说明：店长角色可在PC后台操作该开关，其他角色（店员）不可操作
- 数据一致性：收银机端和PDA端均读取同一开关状态，需确保接口返回及时准确
- 回归测试：需验证开关开启后，原有赊销流程不受影响
八、待确认事项
| # |
待确认项 |
负责人 |
状态 |
| 1 |
门店配置表具体名称及字段 |
徐涛 |
待确认 |
| 2 |
收银机端/PDA端现有赊销开单入口位置 |
张家学/刘文伟 |
待确认 |
| 3 |
授信额度现有校验逻辑位置（订单模块/客户模块） |
徐涛 |
待确认 |
