常购清单在功能上不复杂，但它横跨配置管理、订单生成与权限代操作三个环节，属于典型的 “入口简单、边界很多” 的模块。本文按需求定义、数据模型、关键机制、边界处理的顺序梳理一遍设计要点，供同类业务参考。
一、需求定义
做批发、配送、供货这类生意，固定客户的采购内容往往比较稳定：餐饮店每周进的品类大同小异，食堂每天的清单也相差不大。每次报单都从头说一遍，对客户是负担，对商家也意味着重复录入。
客户常购清单是商家为某个客户建立的常用商品集合，记录该客户常采购的品名与数量。清单建立后，既可由客户自己调用下单，也可由商家在后台代为操作。
与历史订单的关键差异：历史订单是行为记录，常购清单是经整理的标准配置——去掉偶发的一次性商品，保留周期性采购的内容。
二、数据模型
实体 | 关键字段 | 说明 |
清单 BuyingList | id、customer_id、name、created_at、updated_at、status | 一个客户可有多份清单，name 建议含客户标识 |
清单项 ListItem | id、list_id、sku_id、qty、last_price、sort | last_price 仅作参考，下单时以实时价为准 |
客户 Customer | id、account、contact | 清单归属，列表页展示账号与联系方式 |
订单 Order | id、customer_id、source、operator_id | source 标记 self / agent（代下单） |
设计要点：清单项只存「参考价」而非成交价，下单时必须回源取实时单价，这是随行就市品类最容易踩的坑。
三、关键机制
1. 列表页信息结构
后台常购清单以表格展示，每行包含：展开 / 收起、清单名称、所属客户（账号与联系方式）、创建时间、操作（代下单、编辑、删除）。其中创建时间用于判断清单是否需要更新，建议配合「更新时间」一起做保鲜提示。
2. 卡片式明细与批量操作
展开清单后，商品以卡片呈现，每张显示图片、名称、价格与数量，并带选择圆圈。批量操作三项：全选、修改选中项、移除选中项，同时支持逐个勾选。
3. 代下单：基于清单生成订单
流程为：找到清单 → 点击「代下单」→ 展开勾选商品 → 确认数量与价格（如需调整先「修改选中项」）→ 提交生成订单 → 进入分拣与配送。
4. 价格回源校验
清单中若含随行就市的商品，下单前必须回源取当前单价，避免按旧价成单：
# 示例：由清单项生成订单前校验价格（示例代码仅用于说明设计思路）
def build_order_items(list_items):
items, changed = [], []
for li in list_items:
current = price_service.get_price(li.sku_id, li.customer_id)
if current != li.last_price:
changed.append((li.sku_id, li.last_price, current))
items.append(OrderItem(sku_id=li.sku_id, qty=li.qty, price=current))
if changed:
# 交由前端提示确认，不静默成单
raise PriceChanged(changed)
return items
5. 清单保鲜：基于更新周期做提醒
客户采购内容会随季节、菜单变化，清单长期不更新会失真。可结合创建时间与更新时间做保鲜提示：
# 示例：清单保鲜度检查（示例代码仅用于说明设计思路）
STALE_DAYS = 30
def is_stale(lst, now):
base = lst.updated_at or lst.created_at
return (now - base).days > STALE_DAYS
# 命中后在列表页给出「建议核对」提示，引导商家增删商品与调整数量
6. 代下单的权限与留痕
代下单由商家在后台操作，需在订单中标记 operator 与 source=agent，并在成单后回传订单明细给客户确认，减少后续争议。
四、边界与坑
删除前需确认：删除清单前建议与客户确认，避免需要时重新整理；可优先做软删除。
价格不做固化：清单项只存参考价，成交价一律实时回源。
多清单场景：同一客户有日常采购与周补充等不同需求时，支持分建多份清单。
部分勾选：客户只要其中一部分是常态，必须支持逐个勾选而非只能全选。
不习惯线上操作的客户：代下单是覆盖这类客户的关键通道，不能只做客户端自助下单。
五、落地排期建议
清单增删改查 + 列表页（展开 / 收起、所属客户、创建时间、操作入口）。
清单项卡片与三项批量操作（全选、修改选中项、移除选中项）。
客户自助调用清单下单。
商家代下单与 source / operator 留痕。
价格回源校验与变动提示。
清单保鲜提醒与定期核对任务。
