wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
7.3 KiB
7.3 KiB
跨境大件 B2B/轻B 套利交易系统
需求文档（PRD）
适用场景：无货源/身边有货源、资本充足、技术团队自研，做高门槛大件整柜 + 跨境零售，不做服装/小件/红海类目 技术栈：前端 JS / Vue / React，后端 Node.js + Express，对接海运计价API、海外仓API
1. 项目定位
1.1 产品定位
一套通用型跨境大件套利&报价&订单系统
- 不绑定单一品类（扫地车/清洗机/叉车/仓储设备等通用）
- 支持：整柜B2B批发 + 跨境轻B零售 + B2C 平台零售
- 核心：自动算成本、算利润、算风险、自动报价、多平台库存/价格同步
- 面向用户：海外小B、经销商、工程商、物业、工厂、C端个人消费者
1.2 业务模式
- 模式A：整柜B2B（港到港，客户自提/自清关，低风险）
- 模式B：跨境轻B零售（整柜→海外仓→商业地址派送，不做C端个人）
- 模式C：B2C 平台零售（TK / Temu / Amazon 等平台下单 → 海外仓发货/直邮）
- 货源：身边供应商/1688，系统不锁货源，只做计价与交易链路
1.3 核心壁垒
- 资金门槛：整柜、海外仓
- 技术门槛：自动计价、海运API、风控、动态定价
- 品类门槛：大件/商用/低退货/低内卷
2. 目标用户
2.1 后端操作用户（你团队）
- 运营：上架产品、审核询盘、报价、订单管理
- 开发：对接API、配置参数、日志、监控
2.2 前端客户（海外）
- 经销商：整柜采购
- 小B客户：1–5台采购（商用）
- C端散客：平台零售（TikTok/Temu等）
- 禁止：低质量、恶意退货客
3. 核心业务流程
3.1 整柜B2B流程
- 客户在独立站询盘 → 填写台数/目的港
- 系统自动计算：体积装箱数、海运费、目的港费用、利润
- 后台审核 → 一键生成报价单
- 客户付定金（30%–50%）
- 向供应商下单 → 订舱 → 装柜
- 上船前收齐尾款
- 提单给客户 → 客户目的港提货
- 订单完成
3.2 跨境轻B零售流程
- 客户在独立站选品 → 填公司名/商业地址
- 系统自动计算：海运+海外仓+仓储+尾程卡车+关税+佣金
- 在线报价/直接下单
- 支付
- 海外仓发货 → 商业地址卡车派送
- 不支持无理由退货
3.3 B2C 平台零售流程
- 电商平台（TikTok / Temu / Amazon）产生订单
- 系统通过 API 抓取订单信息 → 自动打单
- 自动匹配最近仓库库存 → 扣减库存
- 通知海外仓发货 → 回传物流号至平台
- 平台结算打款（自动核销佣金/运费）
- 系统自动计算该单利润与回款周期
4. 功能模块清单（完整）
4.1 前端（客户）
- 产品展示页（商用设备，无购物车偏向询价）
- 整柜询价表单
- 零售询价/下单页
- 报价单在线查看
- 在线支付（定金/尾款）
- 订单进度跟踪
4.2 后端管理系统（Node.js）
- 产品管理（尺寸、重量、体积、成本、图片、平台SKU映射）
- 自动装箱计算（20GP/40HQ最多装多少台）
- 海运计价API对接（Freightos/SeaRates/船公司）
- 海外仓&尾程计价
- 多平台 API 对接（TK / Temu / Amazon 订单抓取、状态同步）
- 库存同步引擎（全渠道库存共享、自动分配预警）
- 利润&套利引擎（含平台佣金、广告费扣除）
- 报价单自动生成（PDF/英文）
- 询盘管理
- 订单&支付管理
- 库存&周转预警
- 风控规则引擎
- 日志&报表
4.3 核心引擎（最关键）
- 整柜成本引擎
- 零售全链路成本引擎
- B2C 平台套利引擎（计算实时回款利润）
- 多平台库存分配引擎
- 动态定价引擎
- 风险控制引擎
- 账期&资金占用计算
5. 核心计算公式（开发直接用）
5.1 整柜B2B 利润
- 台数/柜 = 向下取整(柜体积 / 单台体积)
- 单台摊海运费 = 整柜海运费 / 台数
- 总成本/台 = 拿货价(USD) + 海运摊 + 清关/文件费摊
- 报价/台 = 总成本 + 目标利润
- 利润 = 报价 − 总成本
- 定金 = 报价 × 30%/50%
5.2 轻B零售 全链路成本
- 总成本/台 =
拿货成本
- 整柜海运摊
- 海外仓仓储费（按天/按月）
- 尾程卡车派送费
- 关税（拿货成本×税率）
- 交易手续费
- 广告摊
- 售价 = 总成本 × (1+利润率)
- 净利润 = 售价 − 总成本
5.3 B2C 平台零售利润 (TikTok / Temu)
- 平台回款 = 售价 − 平台佣金(8%-15%) − 平台配送费(如有)
- 实际到手 = 平台回款 − 海外仓出库费 − 广告费摊
- 纯利润 = 实际到手 − 拿货成本 − 关税 − 海运摊
- 资金占用天数 = 备货期 + 运输期 + 平台结算期(14-30天)
5.4 风险阈值（系统自动预警）
- 库存周转预警 > 60 天
- B2B 利润率 < 15% 禁止报价
- B2C 利润率 < 20% (含广告) 禁止上架
- 平台退货率 > 5% 自动下架产品
- 住宅地址自动拦截（针对轻B模式）
6. 必须对接的外部API
- 海运计价API（Freightos / SeaRates / 货代API）
- 获取：整柜价格、拼箱价格、船期、附加费
- 海外仓API
- 获取：仓储费、操作费、尾程派送费、实时库存
- 电商平台API（TikTok / Temu / Amazon / eBay）
- 接入：订单拉取、库存同步、履约状态、财务对账
- 汇率API
- 实时CNY/USD
- 支付API
- Stripe / PayPal / 定金尾款 / TT支付
- 物流追踪API
- 17Track / AfterShip (用于 B2C 订单追踪)
7. 风控规则（强制写入系统）
- 轻B模式：只允许商业地址，住宅地址拦截
- B2C 模式：允许住宅地址，但单价<$200 或 高退货率 SKU 拦截
- 不可退货政策：商用/大件设备一律不支持无理由退货（系统强制弹窗提示）
- 分期支付：整柜必须先付定金，上船前收尾款
- 库存管理：超过60天清仓，超过90天止损
- 平台风控：TK / Temu 账号关联与合规风险监控
- 汇率/运费波动：波动 >10% 自动更新 B2C 售价或停止 B2B 报价
- 利润底线：B2B < 15% 或 B2C < 20% (含广告) 不允许成交
8. 运营规则（写入需求）
- 只做大件/商用/工业/高客单（≥$1500）
- 不做：服装、鞋包、3C、美妆、家用小件
- 每个品类SKU不超过5个
- 独立站不用频繁更新，只做询盘型官网
- 流量以 Google Ads + SEO + LinkedIn 为主
9. 前端页面（极简5页）
- 首页（实力展示：整柜、工厂、设备）
- 产品列表
- 产品详情 + 询价
- 整柜询价页
- 联系/报价单页
10. 交付物（给开发团队）
- 前端 JS/Vue 页面
- Node.js + Express 后端接口
- 套利计价引擎（核心，支持 B2B/轻B/B2C）
- 海运 & 海外仓 & 电商平台 API 对接模块
- 报价单生成模块
- 订单 & 支付 & 平台履约流程
- 全渠道库存同步与风控预警
- 后台管理面板（含多平台订单聚合管理）
如果你愿意，我可以再往下输出一版： 《给程序员直接看的：接口文档 + 数据库表结构 + 核心API字段》 你直接丢给开发，就能开工。