2026-06-30 · 基于真实代码梳理(19 模块 / 17 工作流域 / 三套 API)

NexaAI 平台全量业务逻辑大底座

把平台所有业务逻辑融进一张图——从普通商户开店、订单交易,到联合开店、网红、推荐员,再到分账结算。四层架构 + 横切层,回答「我们的平台到底由哪些逻辑构成」。

4 层
主体架构
1 层
横切能力
19 个
后端业务模块
10 张
架构流程图
3 种
卖货模式
🎬 贯穿角色: 🏭 深圳智核科技(中国供应商) 🏪 樱花堂(东京零售商) 🌸 美月(网红) 🧑‍💼 王经理(推荐人) 🏢 山田物产(批发商) 👤 田中(消费者)
总览

平台四层架构总图

平台逻辑分四层 + 一层横切能力。下层是上层的基座,每层职责清晰、不交叉。每一层都已对应真实后端模块

🖥️ 接入层(前端,三个销售前台 storefront) B2C 零售 · B2B 批发 · H2B 跨境撮合 | 平台运营端 · 商家自助端 统一通过 HTTP API 调后端 ① 电商核心层 平台引擎核心能力(商品/购物车/订单/支付/物流/促销/评价) 📦 product(商品) · 🛒 cart(购物车) · 📋 order(订单) · 💳 payment(支付) · 🚚 shipping(配送) 🏷️ promotion(促销) · ⭐ review(评价) · ❤️ wishlist(收藏) · 🔍 搜索(Algolia) · 📧 通知 引擎 核心 ② 多供应商层 商家入驻/审核/店铺 · B2B 企业采购 · 议价 · 审批流 · 权限体系 🏪 seller(商家)+seller-profile(档案)+store(店铺) · 📝 register/upload-license(入驻审核) 🏢 company/employee(企业采购) · 💬 quote(议价) · ✅ approval(审批流) 多供 应商 ③ 分销增长层 联合开店 · 网红推广 · 推荐人招商 · 平台选品 · 内容运营 🟠 joint-store+linked-listing+mirror-order+forked-product(联合开店全家桶) · 🟣 affiliate(网红) 🟢 referrer(推荐人·设计稿) · 🎯 platform-pick(选品) · 📰 article/banner(内容) 分销 增长 ④ 支付结算层 佣金引擎 · 财务结算 · 跨境支付 · 支付审计 · 防倒贴护栏 💰 commission(佣金) · 🏦 finance(财务) · 🔌 Stripe Connect(跨境) · 🛡️ payment-audit + 护栏 🔧 横切能力层(贯穿所有层) 🌐 translation(多语言翻译) · 📁 s3-file(文件存储/MinIO) · 📋 error-log(错误日志) · 👁️ unified-supervision(统一监管)

图 1 | 平台四层架构总图。上层依赖下层,横切层贯穿所有层。每层模块均为真实后端模块名。

🎯 这张图回答了你的问题
普通商户开店、联合开店、网红、推荐员——全部都在这里,分属不同层:普通商户开店 = ②层(商家入驻)+ ①层(自营交易);联合开店/网红/推荐员 = ③层(分销增长);所有交易最终落到 ④层(支付结算)。下面逐层展开。
① Layer 1

电商核心层 · 平台引擎的基础能力

这是所有交易的地基——无论普通商户自营还是联合开店,订单都得走这套核心流程。对应平台引擎核心(商品/购物车/订单/支付/物流)。

🛒 订单全流程(每一笔交易都走这条链)

🛒 加购 cart(购物车) 选品+数量 📋 下单 order(订单) 填地址/确认 💳 支付 payment(支付) 跨境支付通道 🚚 履约 fulfillment(发货) 配送+签收 ✅ 完成 订单完成 触发分账 ↩️ 售后 退款/退货 冲正分账 ⭐ 评价 review(评价) +收藏 wishlist 💡 这套流程对所有卖货模式通用——普通自营/联合开店/网红带货都走它,只是「发货方」和「分账方」不同 B2B 额外有议价(quote)+ 审批(approval)环节插在下单前

图 2 | 电商核心订单全流程。所有交易模式的共同主干。

📦 商品

product(商品)+ variant(变体/规格)。普通商品、镜像商品、复制商品都基于此。

🏷️ 促销

promotion(促销)+ free-shipping(免邮)。区别于网红优惠码(在③层)。

🔍 搜索

搜索引擎(Algolia)。商品同步到搜索索引,前台检索。

📧 通知

邮件通知。订单/入驻/审核等关键节点触达。

② Layer 2

多供应商层 · 商家入驻 + B2B 采购 + 议价审批

这一层让平台「多供应商」。包含普通商户开店全流程(你最关心的盲区)、B2B 企业采购层级、议价、审批。

🏪 普通商户开店入驻流程(盲区补全)

① 注册申请 vendor/register 提交店铺资料 商家自助端发起 ② 资质审核 upload-license + approvals 上传执照/平台审核 ③ 不通过 resubmit- qualification 重新提交资质 ④ 通过·开店 seller(商家) +store(店铺) 建档+开店铺 ⑤ 自主经营 上架商品→接单→发货 →finance(财务)结算给自己 全程不依赖联合开店 打回重审

图 3 | 普通商户开店入驻流程:注册→资质审核→(不通过则重提)→开店→自主经营。区别于联合开店的关键:自己备货、自己卖、结算给自己。

🏪 场景:樱花堂作为「普通商户」开店(非联合开店)

樱花堂在 B2C 自助端发起注册(vendor/register),上传日本营业执照(upload-license),平台运营端审核(approvals)通过后获得商家身份(seller)+ 店铺(store)。它自己进了一批 AI 美容仪(不是挂智核科技的货),自己定价 ¥58000 上架,消费者下单后它自己发货,finance 把钱结算给它——全程不碰联合开店。这就是「普通商户开店」。

🏢 B2B 企业采购层级 + 议价 + 审批

🏢 企业采购层级

company(企业)→ employee(员工)→ company-customer-group(企业客户组)。一个企业多个员工,共享企业购物车(company-carts)与议价权限。

💬 议价 quote

B2B 客户发起报价(quote)→商家还价→成交。山田物产批量采购可议价,区别于 B2C 固定价。

✅ 审批流 approval

大额采购走审批:cart-approvals(购物车审批)+ company-approval-setting(企业审批设置)。员工下单→主管审批→生效。

👥 权限体系(三种角色)

角色对应入口核心能力
admin(平台运营)平台运营端审核商家/管商品/管订单/管财务/监管全平台
vendor(商家/卖家)商家自助端注册/上架/接单/发货/查结算(含联合开店分销商)
store/customer(买家)三个销售前台浏览/加购/下单/支付/评价(消费者 + B2B 企业员工)
③ Layer 3

分销增长层 · 联合开店 + 网红 + 推荐人 + 选品

这一层是平台的「增长飞轮」,叠加在①②层之上。三个独立模块共用④层的分账底座。

🟠 联合开店(全家桶)

joint-store + linked-listing(联营代发/镜像)+ forked-product(联营自营/复制)+ mirror-order(镜像订单/双轨)+ distribution-policy(分销策略)。三种模式见下节对比图。

🟣 网红推广 affiliate

affiliate 模块(10 模型)+ product-promotion-asset(商品推广素材)。带货归因(商品维度)+ 拉新归因(客户维度)。🚧在建。

🟢 推荐人招商 referrer

推荐企业入驻,平台佣金让利。📋仅设计稿,0 代码。区别于网红拉新(推企业 vs 推消费者)。

🎯 平台选品 + 内容运营

🎯 platform-pick

平台选品。中国团队按日本需求选品上架。

📰 article

文章/CMS。核规整改专区可用此承载。

🖼️ banner

横幅。运营位内容。

📜 legal-document

法律文档。合规承载。

④ Layer 4

支付结算层 · 所有交易的终点

无论哪种卖货模式,钱最终都流到这里分账。普通商户走单轨结算,联合开店走双轨分账,网红/推荐人从分账里抽成。

💰 commission

佣金引擎。算各方分成。

🏦 finance

财务结算/打款/对账。

🔌 Stripe Connect

跨境支付连接(代收代付记录方)。

🛡️ payment-audit + 护栏

支付审计 + 防倒贴护栏。

💰 ¥58000 订单的四方分账(真实金额)

消费者付款 ¥58000 🌸 网红美月 10% ¥5800 🏢 平台佣金 5% ¥2900 🧑‍💼 推荐人 3%(从平台让利) 🏪 卖方实得(樱花堂) ¥49300 单轨(普通自营) 🟠 若是联合开店(联营代发) 卖方 ¥49300 再二次分(双轨): 供应商智核拿供货价 + 樱花堂拿差价 由 mirror-order(镜像订单)执行

图 4 | ¥58000 四方分账。普通商户=单轨(卖方拿¥49300);联合开店=双轨(再二次分给供应商)。

横切

横切能力层 · 贯穿所有层的基础设施

这些能力不属于某一层,而是被所有层共用。

🌐 translation

多语言翻译。translation-config(配置)+ translation-job(任务)。中日英动态内容翻译。

📁 s3-file

文件存储(兼容 S3 / MinIO)。图片、执照、凭证。

📋 error-log

错误日志。运维排查。

👁️ unified-supervision

统一监管 + joint-store-supervision(联合开店监管)。运营全局视图。

★ 重点

三种卖货模式对比 · 普通自营 vs 联营代发 vs 联营自营

这是平台最核心的业务区分。三种模式备货方、发货方、分账方式、用到的模块完全不同

🏪 A 普通商户自营 自己备货自己卖(单轨) 🟠 B 联营代发(镜像) 挂供应商货·供方发货(双轨) 🟣 C 联营自营(复制) 复制商品·自发(单轨) 备货方 🏪 樱花堂自己进货备货 🏭 智核科技(中国供应商)备货 🏪 樱花堂独立备货(复制后) 商品机制 📦 普通商品 product(自有) 🪞 镜像 linked-listing(挂源货) 📋 复制 forked-product(独立) 定价权 🏪 樱花堂自主定价 🏪 樱花堂改零售价赚差价 🏪 樱花堂完全自主 发货方 🏪 樱花堂自己发货 🏭 智核科技从中国直发 🏪 樱花堂自发(已日本化) 订单/分账 单轨 · finance 结算给樱花堂 双轨 · mirror-order 供方+分销 单轨 · 结算给樱花堂 关键模块 seller + store + product joint-store + linked-listing + mirror-order joint-store + forked-product-trace 💡 三种模式可叠加网红带货 + 推荐人招商,分账时再各抽成

图 5 | 三种卖货模式对比。「普通商户自营」是地基,联合开店 A/B 是其上的分销变体。

🔑 关系澄清(回答你的核心疑问)
普通商户开店 ≠ 联合开店。普通商户(A)是商家自己进自己卖;联合开店(B/C)是分销商挂/复制供应商的货。一个商家(如樱花堂)可以同时:自营一部分商品(A)+ 代发智核的货(B)+ 复制另一款自发(C)。三种模式共享①电商核心层和④分账层,只是③层的分销逻辑不同。
核对

完整性核对表 · 你问的逻辑全在这里

逐条对照你提的所有逻辑,标明所在层 + 现状。

你问的逻辑所在层对应模块/能力现状
普通商户 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)✅ 已实现
✅ 结论
你问的所有逻辑——普通商户开店、联合开店、网红、推荐员、以及各种细节——全部已纳入这份大底座。其中 80% 已实现/在建,仅「联营托管模式」和「推荐人招商」待开发。这才是平台完整的业务逻辑全貌。