商城设置 — 功能需求说明
本文档在《商城设置功能需求-草稿》基础上整理，并关联 《关联需求分析.md》 v1.6、平台侧 《订单管理功能需求》 v1.0.1、《会员管理功能需求》 v1.1、《商品管理功能需求》 v1.3.3、《商品审核功能需求》 v1.0、《店铺设置功能需求》 v1.1、《商城服务协议功能需求》 v1.0、《首页 Banner 设置功能需求》 v1.0.1，以及商家侧 《商品列表功能需求》、C 端 《商城首页功能需求》 v1.0.2、《商品详情内页功能需求》 v1.0、《我的订单功能需求》 v1.1、《我的服务功能需求》 v1.1 做边界与流程对齐。
范围：平台管理端 · 商城设置 对 全平台唯一 的商城级参数（备案展示、商品录入与 C 端展示策略、订单自动确认与售后时限、会员默认头像）进行 查看与维护；不涉及 数据库结构、接口定义及技术实现细节。
说明： 本模块为 全局设计——全平台 一套 配置，C 端用户商城 与 商家发品 等下游 读取同一套值；与 店铺设置（商品默认审核、子管理员上限）职责分离、菜单独立。
v1.0： 首版定稿；对齐草稿 §1～§4；补全关联分析、配置口径、生效边界与业务规则。
v1.1： 对齐草稿修订——移除 市场价换算比例、是否显示市场价；商品设置仅保留 编号前缀（只读） 与 是否显示销量；不 在 biz_goods 主表维护市场价字段。
1. 模块定位
1.1 业务目标
在农资商城 平台管理端（Web） 提供 商城设置 配置页，使 平台管理员 能够：
- 维护 备案信息（ICP、公安备案号及跳转链接），供 C 端 合规展示；
- 维护 商品相关全局策略：货币展示口径（只读）、商品编号前缀（只读）、C 端 是否展示销量；
- 维护 订单相关全局策略：已发货后自动确认收货 天数、确认收货后可申请售后 的天数上限，以及 已支付/已发货是否允许取消 的 只读说明（与现行订单规则对齐）；
- 维护 C 端会员默认头像，供 注册及未上传头像会员 使用。
不包含（本期或与它模块分工）：
| 能力 |
说明 |
| 店铺默认审核、子管理员上限 |
见 店铺设置（组织管理） |
| 支付超时关单时长 |
见 订单管理 §3.4（O8）；不在本模块配置 |
| 商城服务协议、入驻协议、Banner |
见 内容管理 各专册 |
| 单店差异化配置 |
本模块 仅全平台一套 |
| 商家发品字段细节 |
见 商品列表；本模块 不配置 也不扩展商品主表字段 |
| 售后审核、退款执行 |
见 我的订单（C 端申请）与 店铺售后管理 |
| 异常返回格式、技术栈 |
草稿 §5、§6 不纳入 功能需求 |
1.2 与《店铺设置》的区分（定稿）
| 维度 |
商城设置（本模块） |
店铺设置 v1.1 |
| 定位 |
C 端展示合规、商品录入/展示、订单时限、会员默认头像 |
商家 submit 是否免审、子管理员全局上限 |
| 主要消费方 |
C 端用户商城、商家发品表单、订单定时任务 |
商家 submit 上架、员工管理（待建） |
| 菜单 |
商城设置（建议置于 内容管理 或 系统/商城 分组，与产品菜单一致即可） |
店铺设置（组织管理） |
| 配置表/存储 |
独立 于店铺全局策略 |
biz_shop_global_config 等（技术实现另册） |
命名提示： 运营沟通时须区分 「商城设置」 与 「店铺设置」，避免与单店资料混淆。
1.3 在业务链中的位置
【平台 · 商城设置】全平台唯一配置
├── 备案信息 ──────────────► C 端页脚/关于页等合规展示
├── 商品：编号前缀(SN)、展示销量开关 ──► 商家发品 + C 端商品页
├── 订单：自动确认收货、售后申请时限 ──► 订单状态机(O7) + C 端售后入口
└── 会员默认头像 ────────────► C 端注册/资料/列表展示
【并行 · 内容管理】服务协议 / Banner / 入驻协议（与本模块无数据依赖）
【供给链】商家发品 ──读取编号前缀等只读口径──► 发品表单
【用户链】下单 → 发货 → 确认收货(手动/自动) → 售后窗口内可申请
| 关联模块 |
关系 |
边界说明 |
| 订单管理 v1.0.1 |
强关联 |
O7 完成时点、O8 支付超时 分工明确；本模块 仅 自动确认收货天数与售后时限 |
| 我的订单 v1.1 |
下游消费 |
手动确认收货、售后申请 受本模块时限约束 |
| 商品列表（商家） |
下游消费 |
编号前缀 只读展示 |
| 商品详情内页 v1.0 |
间接 |
销量 受展示开关 |
| 商城首页 v1.0.2 |
间接 |
热销排序 仍读销量字段；列表卡片 是否展示销量数字 受开关影响 |
| 会员管理 v1.1 |
镜像展示 |
默认头像 维护在本模块；平台会员详情 只读 会员实际上传头像 |
| 我的服务 v1.1 |
下游消费 |
资料页头像；未上传时用 默认头像 |
| 账务管理 |
间接 |
确认收货（含自动）触发结算入账；改天数 不 retro 已完结单 |
1.4 使用端与角色
| 端 |
角色 |
能力 |
| 平台管理端 |
平台管理员 / 运营 |
查看、编辑 全部可编辑项 并保存 |
| C 端 |
买家/访客 |
只读消费 配置结果（备案、展示、头像、订单规则 无配置 UI） |
| 店铺经营管理端 |
商家 |
只读消费 发品换算与编号前缀展示；不可改 本模块 |
| 平台 · 店铺设置 |
同平台角色 |
独立菜单，不合并 到本页 |
2. 与草稿的对应关系
| 草稿条目 |
定稿处理 |
| §1 备案信息（ICP/公安 号与链接） |
§5 |
| §2（1）商品货币符 ¥、中文「元」（只读） |
§6.1 |
| §2（2）编号前缀 SN（只读） |
§6.2 |
| §2（3）是否显示销量 |
§6.3 |
| §3（1）「确认售后设置」→ 自动确认收货 天数 |
§7.1（定稿更正文案） |
| §3（2）确认收货后 可申请售后 的天数限制 |
§7.2 |
| §3（3）已支付/已发货可取消（只读「否」） |
§7.3 |
| §4 移动端会员默认头像 |
§8 |
| §5 异常返回 |
不纳入 |
| §6 技术栈 |
不纳入 |
3. 关联需求分析
3.1 与平台《关联需求分析》
| 关联点 |
定稿 |
| 全平台唯一策略 |
与 店铺设置 同类：一套配置、全站生效 |
| 供给链 vs 用户链 |
商品换算属 供给链；订单/头像/备案属 用户链或 C 端展示 |
| 状态不级联 |
修改本模块 不自动 改订单状态、商品状态、会员启用态 |
| O7 / O8 分工 |
O8 支付超时 在 订单管理；O7 自动确认 在本模块 |
| 销量回写 |
销量仍由 订单完成 回写商品；本模块 只控是否展示 |
3.2 与平台《订单管理功能需求》v1.0.1
| 项 |
定稿 |
| 完成路径 |
买家手动确认收货 或 系统自动确认收货（本模块配置）→ 已完成（O7） |
| 登记送达 |
平台登记「商品到货/送达」仍不替代 完成；仅 作为物流节点 |
| 自动确认起算 |
自订单 整单发货成功（进入 已发货）起，连续 N 个自然日 内买家 未 手动确认 → 系统自动确认收货 |
| 自动确认效果 |
与手动确认 等价：订单 → 已完成，写入 成交/完成时间；触发 消费统计 O11、销量回写、结算入账（与账务管理一致） |
| 已支付/已发货取消 |
平台订单 不支持 买家/运营在已支付、已发货态 直接取消（退款走售后/另册）；草稿只读「否」与现网规则一致 |
| 支付超时 |
不在本模块；见订单 §3.4（O8） |
3.3 与 C 端《我的订单功能需求》v1.1
| 项 |
定稿 |
| 手动确认 |
已发货 详情 确认收货 仍可用；与自动确认 先到先生效 |
| 售后入口 |
待发货/待收货/已完成 等入口 仍保留（MO-AS3）；超出售后时限 后 隐藏或禁用「申请售后」并提示 |
| 售后时限起算 |
自 确认收货时间（含 自动确认 写入的时间）起计 |
| 进行中售后 |
已提交的进行中/已完结售后 不受 后续调短时限影响 |
3.4 与商家《商品列表功能需求》
| 项 |
定稿 |
| 商品编号 |
系统生成、全平台唯一；展示前缀 SN（只读，与编号生成规则一致） |
| 规格明细 |
含 库存 等；不在本模块 维护市场价 |
3.5 与 C 端《商品详情内页功能需求》v1.0
| 项 |
定稿 |
| 销量 |
详情 默认展示 累计销量（GD5）；当 「是否显示销量」= 否 时 隐藏销量行 |
| 货币符 |
价格展示使用 ¥ 与 元 口径（只读配置，与全站一致） |
| 不可购 |
展示开关 不影响 加购/购买校验 |
3.6 与 C 端《商城首页功能需求》v1.0.2
| 项 |
定稿 |
| 热销排序 |
仍按销量降序 取 Top6（读档案字段）；与是否展示销量数字无关 |
| 列表卡片 |
本期热销卡片 默认不展示销量数字；若其他列表（分类落地页等）展示销量，同样受「是否显示销量」约束 |
3.7 与 C 端《我的服务功能需求》v1.1、平台《会员管理》v1.1
| 项 |
定稿 |
| 默认头像 |
新注册 且未上传头像的会员、以及 清空头像 后的展示，使用本模块配置的 默认头像 |
| 已上传头像 |
以会员实际上传为准；本模块 不覆盖 已有自定义头像 |
| 资料编辑 |
个人资料页 支持上传头像；未选图时预览 默认头像（MS §6.2） |
| 平台查看 |
会员管理详情 展示当前生效头像（自定义或默认） |
3.8 与平台《内容管理》并列模块
| 模块 |
关系 |
| 商城服务协议 |
注册/登录勾选；无 备案字段依赖 |
| 首页 Banner |
首页运营位；无 备案依赖 |
| 商城入驻协议 |
商家入驻勾选；无 依赖 |
备案信息与上述协议 并列 属于 合规与展示类 配置，统一由平台运营维护。
4. 业务概念
| 概念 |
说明 |
| 商城设置（全局） |
全平台 唯一 一套参数；无 按店铺、按商户分别设置 |
| 备案信息 |
ICP 备案号/链接、公安备案号/链接；供 C 端 点击跳转 至主管机关公示页 |
| 展示开关（销量） |
控制 C 端 是否展示 销量数字；不删除 档案中的销量数据 |
| 自动确认收货 |
已发货 订单在 发货后第 N 日 届满时，若仍未手动确认，系统自动 置为 已完成 |
| 售后申请时限 |
自 确认收货 起 N 日内 允许 新发起 售后申请；超期 不可新申请 |
| 会员默认头像 |
平台配置的 图片；会员无自定义头像时的 兜底展示 |
| 只读配置项 |
页面 展示固定值、不可编辑；用于 产品口径声明 与 未来扩展预留 |
5. 备案信息
5.1 配置项
| 配置项 |
可编辑 |
说明 |
| ICP 备案号 |
是 |
文本；如「京 ICP 备 xxxxx 号」；可空 则 C 端 不展示 ICP 行 |
| ICP 备案链接 |
是 |
点击 ICP 备案号跳转的 URL；须 与备案号 成对 才有意义 |
| 公安备案号 |
是 |
文本；如「京公网安备 xxxxx 号」；可空 则 C 端 不展示 公安行 |
| 公安备案链接 |
是 |
点击公安备案号跳转的 URL |
5.2 C 端消费
| 项 |
定稿 |
| 展示位置 |
C 端 页脚 或 关于/设置 等 合规区域（具体页面以前台为准）；至少一处 可访问 |
| 展示规则 |
仅 号与链接均非空 的项 展示；单项缺失则 隐藏该项 |
| 跳转 |
点击备案号 新开或内嵌 WebView 打开对应链接（以前台为准） |
| 多端 |
APP / H5 同一套 备案文案 |
5.3 规则
| 编号 |
规则 |
| MC-R1 |
备案号、链接 保存后立即 对 C 端 新请求 生效 |
| MC-R2 |
链接 建议 http/https；格式非法 阻断保存 并提示 |
| MC-R3 |
本模块 不校验 备案号与主体是否已在主管机关备案（运营责任） |
6. 商品设置
6.1 商品货币（只读）
| 配置项 |
展示值 |
可编辑 |
| 商品货币符 |
¥ |
否 |
| 商品货币中文 |
元 |
否 |
| 编号 |
规则 |
| MC-G1 |
全站价格展示 统一 使用上述符号；商家端、C 端、平台商品列表 口径一致 |
| MC-G2 |
只读项 不可 在本页修改；若未来支持多币种 单独立项 |
6.2 商品录入设置
6.2.1 商品编号前缀（只读）
| 编号 |
规则 |
| MC-G3 |
新建商品编号 以 SN 为前缀 参与生成（具体序号规则见商家商品列表技术实现）；本页 仅声明 |
| MC-G4 |
修改前缀 非本期；只读 |
6.3 商品信息显示设置
| 配置项 |
可编辑 |
默认值 |
取值 |
| 是否显示销量 |
是 |
是 |
是 / 否 |
| 消费场景 |
是否显示销量 = 是 |
是否显示销量 = 否 |
| C 端 商品详情 |
展示累计销量 |
隐藏 销量行 |
| C 端 列表卡片（分类/搜索/店铺主页等，若 UI 含销量） |
展示 |
隐藏 |
| 热销排序（首页等） |
仍按销量排序 |
仍按销量排序（仅 不展示数字） |
| 编号 |
规则 |
| MC-G5 |
开关变更 立即 影响 C 端 后续请求 的展示；不删除 商品档案中的 sales_count |
7. 订单设置
7.1 自动确认收货
草稿 §3（1）「确认售后设置」定稿理解为 「自动确认收货」（到货/发货后超时自动完成）。
| 配置项 |
可编辑 |
默认值 |
取值范围 |
| 自动确认收货时间 |
是 |
7 |
正整数，单位：天；建议 1～90 |
业务逻辑：
订单 status = 已发货
→ 记录发货时间 T_ship
→ 每日（或等价调度）扫描：
若 当前时间 ≥ T_ship + N 天 且 仍未手动确认收货
→ 系统自动确认收货
→ 订单 → 已完成
→ 写入完成时间 = 系统自动确认时刻
→ 后续：消费统计、销量回写、结算等与手动确认一致
若 买家在 N 天内手动确认
→ 以手动确认为准，**不再** 触发自动确认
| 编号 |
规则 |
| MC-O1 |
N 指 自然日；起算点为 整单发货成功时间（进入 已发货 的时刻） |
| MC-O2 |
仅已发货 订单参与；待支付/待发货/已完成/已关闭 不参与 |
| MC-O3 |
手动确认与自动确认 互斥；先到先生效 |
| MC-O4 |
平台 缩短 N：已在途 订单按 保存时新 N 与 原 T_ship 重新判定；已完结 订单 不回滚 |
| MC-O5 |
平台 延长 N：在途订单 按新 N 重新计算剩余等待时间 |
7.2 售后申请时限
| 配置项 |
可编辑 |
默认值 |
取值范围 |
| 买家申请售后限制 |
是 |
7 |
正整数，单位：天；自 确认收货 起计；建议 1～365 |
业务逻辑：
订单已有确认收货时间 T_finish（手动或自动）
→ 若 当前时间 ≤ T_finish + M 天
→ C 端「申请售后」可用（仍须满足订单状态等其它规则）
→ 若 当前时间 > T_finish + M 天
→ **不可新发起** 售后；入口隐藏或置灰并提示「已超过售后申请期限」
→ 已存在的进行中/已完结售后 **不受影响**
| 编号 |
规则 |
| MC-O6 |
M 为 自然日；无确认收货时间 的订单（未完成）不适用 本时限（按 MO-AS3 其它规则） |
| MC-O7 |
调短 M：不改变 已提交售后单；仅影响 新申请 |
| MC-O8 |
待发货态申请售后（仅退款-未发货）是否受 M 约束：不受「确认收货后天数」限制；仍受 订单状态与类型规则约束（见 我的订单 §10） |
7.3 平台管理订单流转（只读）
| 配置项 |
展示值 |
可编辑 |
说明 |
| 已支付订单可取消订单 |
否 |
否 |
与 订单管理 一致：支付成功后 不可 买家一键取消（关闭须运营/售后路径） |
| 已发货订单可取消发货 |
否 |
否 |
已发货 不可 「取消发货」回退待发货；物流纠错走 更新物流/运营处理 |
| 编号 |
规则 |
| MC-O9 |
只读项 用于页面声明；不在本页修改 |
| MC-O10 |
若未来产品开放取消能力，单独立项 并同步修订 订单管理 |
8. 会员默认头像
8.1 配置项
| 配置项 |
可编辑 |
说明 |
| 移动端会员默认头像 |
是 |
图片；支持 上传/更换；须 预览 |
8.2 消费规则
会员注册成功 / 未上传头像
→ 展示「移动端会员默认头像」
会员上传自定义头像
→ 展示自定义头像
会员清空头像（若产品允许）
→ 回退为默认头像
| 编号 |
规则 |
| MC-A1 |
默认头像 必填 方可保存本模块（不可 置空提交） |
| MC-A2 |
更换默认头像 不批量替换 已有 自定义头像 会员 |
| MC-A3 |
新默认头像 立即 对 无自定义头像 的会员生效 |
| MC-A4 |
图片格式、大小 与 C 端上传头像规则一致（见 我的服务 MS-P3）；不合规 阻断保存 |
| MC-A5 |
平台 会员管理 列表/详情 展示会员当前生效头像（非本页维护入口） |
9. 功能入口与页面
9.1 入口
| 项 |
说明 |
| 菜单 |
平台管理端 → 商城设置（独立菜单） |
| 权限 |
建议 agri:mall:setting:query 查看、agri:mall:setting:edit 保存（命名以实现为准） |
| 页面结构 |
单页分区表单：备案信息 | 商品设置 | 订单设置 | 会员默认头像 |
9.2 页面分区与字段
| 分区 |
字段 |
控件 |
| 备案信息 |
ICP 备案号、ICP 链接、公安备案号、公安链接 |
文本输入 |
| 商品设置 |
货币符、货币中文、编号前缀 |
只读文本 |
| 商品设置 |
是否显示销量 |
开关 / 单选 |
| 订单设置 |
自动确认收货（天） |
整数输入 |
| 订单设置 |
售后申请限制（天） |
整数输入 |
| 订单设置 |
已支付可取消、已发货可取消发货 |
只读 |
| 会员 |
默认头像 |
图片上传 + 预览 |
9.3 页面说明文案（建议）
- 页头：「全平台商城设置，修改后对全站 C 端及商家发品生效」
- 订单：「自动确认收货与《订单管理》完成规则一致；支付超时关单请在订单参数中配置」（若支付超时仍独立配置）
10. 操作流程
打开「商城设置」
→ 加载当前全平台配置（无则写入 §11 默认值后展示）
→ 运营修改各可编辑项
→ 点击「保存」
→ 前端校验（§12）
→ 校验通过 → 持久化 → 提示「保存成功」
→ 校验失败 → 展示字段级原因，**不保存**
→ 点击「取消」→ 放弃未保存修改，重新加载
| 配置类 |
生效时机 |
| 备案、展示开关、默认头像 |
保存后立即 对新请求生效 |
| 自动确认收货天数 |
保存后 按 MC-O4/O5 对 在途已发货单 重算；新发货单 用新 N |
| 售后申请天数 |
保存后 按 MC-O7 约束 新售后申请 |
11. 默认值汇总（定稿）
| 配置项 |
默认值 |
| ICP 备案号 / 链接 |
空 |
| 公安备案号 / 链接 |
空 |
| 商品货币符 / 中文 |
¥ / 元（只读） |
| 商品编号前缀 |
SN（只读） |
| 是否显示销量 |
是 |
| 自动确认收货时间 |
7 天 |
| 买家申请售后限制 |
7 天 |
| 已支付/已发货可取消 |
否（只读） |
| 会员默认头像 |
系统内置占位图（首次安装须运营 上传 正式图后方可对外） |
12. 校验规则
| 校验项 |
规则 |
| ICP/公安链接 |
非空时 须 为合法 URL |
| 自动确认收货天数 |
1～90 正整数（超出 阻断 或 提示确认，以前台为准） |
| 售后申请限制天数 |
1～365 正整数 |
| 默认头像 |
必传；格式、大小符合上传规范 |
| 只读项 |
不参与 提交校验变更 |
不做（本期）：
- 不校验备案号真实性；
- 不校验缩短自动确认是否导致「即时大量完结」的运营风险（运营自行评估）；
- 不校验子管理员、商品审核开关（属 店铺设置）。
13. 边界与非本期
| 事件 |
影响 |
| 修改展示开关 |
仅影响销量展示；排序、统计 仍用底层数据 |
| 修改自动确认 N |
在途已发货 按新规则；已完成 不变 |
| 店铺停业/商品下架 |
不改变 本模块配置 |
| 会员禁用 |
不影响 默认头像配置；禁用会员 不可登录 |
| 删店/删商户 |
不影响 本模块 |
| 非本期 |
说明 |
| 多币种、多编号前缀策略 |
只读项 预留 |
| 按店铺/地区差异化备案 |
全站一套 |
| 支付超时分钟数 |
订单管理 O8 |
| 已支付/已发货允许取消 |
只读 否；开放须 订单管理 同步修订 |
| 配置变更审计、版本对比 |
另议 |
| 导出配置 |
未要求 |
14. 业务规则索引
| 编号 |
摘要 |
| MC-R1～R3 |
备案展示与链接校验 |
| MC-G1～G5 |
货币、编号、销量展示开关 |
| MC-O1～O10 |
自动确认、售后时限、只读取消规则 |
| MC-A1～A5 |
默认头像 |
15. 验收要点（功能层）
| 编号 |
场景 |
预期 |
| MC-T1 |
保存 ICP 号+链接 |
C 端页脚 可见可点 |
| MC-T2 |
关闭「显示销量」 |
商品详情 无销量行；热销 仍按销量排序 |
| MC-T3 |
已发货超 N 天未确认 |
订单 自动已完成 |
| MC-T4 |
确认收货超 M 天 |
C 端 不可新申请 售后 |
| MC-T5 |
新会员无头像 |
展示 默认头像 |
| MC-T6 |
只读项 |
页面 不可编辑 货币/前缀/取消开关 |
16. 文档修订
| 版本 |
说明 |
| v1.0 |
首版定稿：备案、商品、订单、默认头像；关联平台订单/商品/会员与 C 端首页/详情/订单/我的服务；排除草稿 §5～§6 |
| v1.1 |
对齐草稿修订：移除市场价换算比例、是否显示市场价、biz_goods.market_price；商品设置仅保留编号前缀（只读）与是否显示销量 |
文档版本：v1.1 · 关联《商城设置功能需求-草稿》、《关联需求分析.md》v1.6、《订单管理功能需求》v1.0.1、《我的订单功能需求》v1.1、《商品详情内页功能需求》v1.0、《商城首页功能需求》v1.0.2、《我的服务功能需求》v1.1、《店铺设置功能需求》v1.1、《商品列表功能需求》
