makemd/archive/handover/redme.md

# 跨境大件 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字段》**
你直接丢给开发，就能开工。