三级架构体系

ORGANIZATION MODEL

三级组织模型

总部 → 商户 → 店铺，系统一切业务都建立在此基础架构之上。

MERCHANT MODE

三种商户经营模式

自营、加盟、联营混合经营，一套系统同时承载，总部统一管控。

自营（0）

总部直管，无结算（或内部划转）。适用于总部直营店铺与直营门店，业务数据直接归属总部。

加盟（1）

标准供货价结算（核心场景）。总部供货给加盟商户，商户按总部定价售卖，渠道订单自动生成渠道账单，应付账款一目了然。

联营（2）

总部统一运营，联营方参与分成。销售员归属商户，提成、业绩、工资体系完整支持联营结算。

DATA ISOLATION

多级身份与数据隔离

5种身份统一登录体系，数据按身份自动隔离，总部全局可见，下级只见自己的数据。

身份码	身份	可见范围	登录入口
0	总部	所有数据（不设过滤）	总部后台
10	仓库	本仓库数据	仓管端
20	商户	本商户数据	商户端
30	供应商	本供应商数据	供应商端
40	店铺	本店铺数据	店铺端

数据隔离机制

Controller 层按登录身份自动设置 merchantId / shopId 过滤
总部不设过滤，可查看全部数据
商户/店铺/仓库/供应商只可见本身份数据
跨商户查询必须带身份过滤，杜绝数据越权

5套独立菜单体系

sys_menu（总部）/ oms_menu（商户/店铺）
sys_menu_wms（仓库）/ sys_supplier_menu（供应商）
前端一套代码，按身份动态加载菜单
一套部署，多端多身份共用

CHANNEL TRADE

渠道订单双向交易

总部向商户供货、商户向总部退货，双向交易全流程数字化，对账自动完成。

交易方向	流程	说明
渠道要货	41待商户审核 → 0待审核	门店发起需商户审核，商户直接发起则跳过41
渠道供货	0待审核 → 1待发货 → 2已发货 → 3已完成	总部审核、发货、商户确认收货
渠道退货	商户发起退货 → 总部审核 → 退货入库	退货自动触发库存回补

PRICING

定价三级回退

商户价 → 店铺价 → 售价，渠道商品定价自动逐级回退，无需逐个配置。

CHANNEL BILLING

渠道账单与对账

渠道订单自动生成渠道账单，支付登记、对账、结算全流程管理。

自动生成账单

渠道订单完成后自动生成渠道账单
账单关联渠道订单，明细可追溯
应付/应收自动核算

支付登记

支持余额 / 授信 / 转账 / 微信 / 支付宝 / 现金
登记后账单状态更新：0未支付 → 2已支付
paid_amount 累计，支持部分支付

财务流水入账

账单支付自动写入财务流水
recordLedger 统一记账，幂等防重复
总部/商户往来账清晰可查

SALES TEAM

销售员与业绩体系

支持商户/店铺下的销售员管理：人员档案、考勤、工资查询，订单归属销售员，为业绩统计与提成计算提供基础。

销售员档案

主表：姓名 / 手机 / 工号 / 所属商户店铺 / 登录账号 / 提成比例
扩展：身份证 / 部门 / 岗位 / 基本工资 / 入职离职
考勤：年/月应出勤 / 实出勤 / 请假 / 缺勤
附件：合同 / 证件等

业绩归属

渠道订单创建时指定 salesman_id，订单归属销售员
订单库 o_order.salesman_id 记录销售归属
工资/提成按年/月查询，状态管理
数据隔离：总部看全部 / 商户看本商户 / 店铺看本店