feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义

archive/handover/redme.md

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