把平台所有业务逻辑融进一张图——从普通商户开店、订单交易,到联合开店、网红、推荐员,再到分账结算。四层架构 + 横切层,回答「我们的平台到底由哪些逻辑构成」。
平台逻辑分四层 + 一层横切能力。下层是上层的基座,每层职责清晰、不交叉。每一层都已对应真实后端模块。
图 1 | 平台四层架构总图。上层依赖下层,横切层贯穿所有层。每层模块均为真实后端模块名。
这是所有交易的地基——无论普通商户自营还是联合开店,订单都得走这套核心流程。对应平台引擎核心(商品/购物车/订单/支付/物流)。
图 2 | 电商核心订单全流程。所有交易模式的共同主干。
product(商品)+ variant(变体/规格)。普通商品、镜像商品、复制商品都基于此。
promotion(促销)+ free-shipping(免邮)。区别于网红优惠码(在③层)。
搜索引擎(Algolia)。商品同步到搜索索引,前台检索。
邮件通知。订单/入驻/审核等关键节点触达。
这一层让平台「多供应商」。包含普通商户开店全流程(你最关心的盲区)、B2B 企业采购层级、议价、审批。
图 3 | 普通商户开店入驻流程:注册→资质审核→(不通过则重提)→开店→自主经营。区别于联合开店的关键:自己备货、自己卖、结算给自己。
樱花堂在 B2C 自助端发起注册(vendor/register),上传日本营业执照(upload-license),平台运营端审核(approvals)通过后获得商家身份(seller)+ 店铺(store)。它自己进了一批 AI 美容仪(不是挂智核科技的货),自己定价 ¥58000 上架,消费者下单后它自己发货,finance 把钱结算给它——全程不碰联合开店。这就是「普通商户开店」。
company(企业)→ employee(员工)→ company-customer-group(企业客户组)。一个企业多个员工,共享企业购物车(company-carts)与议价权限。
B2B 客户发起报价(quote)→商家还价→成交。山田物产批量采购可议价,区别于 B2C 固定价。
大额采购走审批:cart-approvals(购物车审批)+ company-approval-setting(企业审批设置)。员工下单→主管审批→生效。
| 角色 | 对应入口 | 核心能力 |
|---|---|---|
| admin(平台运营) | 平台运营端 | 审核商家/管商品/管订单/管财务/监管全平台 |
| vendor(商家/卖家) | 商家自助端 | 注册/上架/接单/发货/查结算(含联合开店分销商) |
| store/customer(买家) | 三个销售前台 | 浏览/加购/下单/支付/评价(消费者 + B2B 企业员工) |
这一层是平台的「增长飞轮」,叠加在①②层之上。三个独立模块共用④层的分账底座。
joint-store + linked-listing(联营代发/镜像)+ forked-product(联营自营/复制)+ mirror-order(镜像订单/双轨)+ distribution-policy(分销策略)。三种模式见下节对比图。
affiliate 模块(10 模型)+ product-promotion-asset(商品推广素材)。带货归因(商品维度)+ 拉新归因(客户维度)。🚧在建。
推荐企业入驻,平台佣金让利。📋仅设计稿,0 代码。区别于网红拉新(推企业 vs 推消费者)。
平台选品。中国团队按日本需求选品上架。
文章/CMS。核规整改专区可用此承载。
横幅。运营位内容。
法律文档。合规承载。
无论哪种卖货模式,钱最终都流到这里分账。普通商户走单轨结算,联合开店走双轨分账,网红/推荐人从分账里抽成。
佣金引擎。算各方分成。
财务结算/打款/对账。
跨境支付连接(代收代付记录方)。
支付审计 + 防倒贴护栏。
图 4 | ¥58000 四方分账。普通商户=单轨(卖方拿¥49300);联合开店=双轨(再二次分给供应商)。
这些能力不属于某一层,而是被所有层共用。
多语言翻译。translation-config(配置)+ translation-job(任务)。中日英动态内容翻译。
文件存储(兼容 S3 / MinIO)。图片、执照、凭证。
错误日志。运维排查。
统一监管 + joint-store-supervision(联合开店监管)。运营全局视图。
这是平台最核心的业务区分。三种模式备货方、发货方、分账方式、用到的模块完全不同。
图 5 | 三种卖货模式对比。「普通商户自营」是地基,联合开店 A/B 是其上的分销变体。
逐条对照你提的所有逻辑,标明所在层 + 现状。
| 你问的逻辑 | 所在层 | 对应模块/能力 | 现状 |
|---|---|---|---|
| 普通商户 B2B/B2C 开店 | ②多供应商 + ①核心 | seller + store + register/upload-license/approvals + 自营订单 | ✅ 已实现 |
| 联合开店(联营代发) | ③分销增长 | joint-store + linked-listing + mirror-order | ✅ 已实现 |
| 联合开店(联营自营) | ③分销增长 | joint-store + forked-product-trace | ✅ 已实现 |
| 联合开店(联营托管/坑位费) | ③分销增长 | 待建(managed listing) | ❌ 待开发 |
| 网红推广(带货 + 拉新) | ③分销增长 | affiliate(10 模型)+ product-promotion-asset | 🚧 在建 |
| 推荐人/推广员招商 | ③分销增长 | referrer(仅设计稿) | 📋 设计稿 |
| 订单全流程(加购→售后) | ①核心 | cart/order/payment/fulfillment/review | ✅ 引擎核心 |
| 商品管理 | ①核心 | product + variant | ✅ 引擎核心 |
| 物流配送 | ①核心 | shipping-options + free-shipping | ✅ 引擎核心 |
| B2B 企业采购 + 议价 + 审批 | ②多供应商 | company/employee + quote + approval | ✅ 已实现 |
| 促销 / 评价 / 收藏 | ①核心 | promotion + review + wishlist | ✅ 引擎核心 |
| 平台选品 | ③分销增长 | platform-pick | ✅ 已实现 |
| 内容运营(文章/横幅/法律) | ③分销增长 | article + banner + legal-document | ✅ 已实现 |
| 分账结算 | ④支付结算 | commission + finance + Stripe Connect | ✅ 已实现 |
| 多语言翻译 | 横切层 | translation-config + translation-job | ✅ 已实现 |
| 文件存储 | 横切层 | s3-file(MinIO) | ✅ 已实现 |