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