feat: 添加货币和汇率管理功能

refactor: 重构前端路由和登录逻辑

docs: 更新业务闭环、任务和架构文档

style: 调整代码格式和文件结构

chore: 更新依赖项和配置文件
This commit is contained in:
2026-03-19 19:08:15 +08:00
parent 8de9ea0aaa
commit eafa1bbe94
203 changed files with 20240 additions and 39580 deletions

View File

@@ -0,0 +1,41 @@
# 后端文档索引
> **模块**: 02_Backend - 后端设计与实现
> **更新日期**: 2026-03-19
---
## 核心设计
| 文档 | 描述 | 状态 |
|------|------|------|
| [01_Design](01_Design.md) | 后端设计总览,架构原则 | ✅ |
| [02_Service_Design](02_Service_Design.md) | 服务层设计规范 | ✅ |
| [03_Event_Driven](03_Event_Driven.md) | 事件驱动架构设计 | ✅ |
| [04_Config_Driven](04_Config_Driven.md) | 配置驱动架构设计 | ✅ |
| [05_Data_Consistency](05_Data_Consistency.md) | 数据一致性保障 | ✅ |
| [06_Observability](06_Observability.md) | 可观测性设计 | ✅ |
| [07_RBAC_Design](07_RBAC_Design.md) | RBAC权限设计 | ✅ |
## API规范
| 文档 | 描述 | 状态 |
|------|------|------|
| [api/00_API_Index](api/00_API_Index.md) | API规范索引 | ✅ |
| [api/01_Data_API](api/01_Data_API.md) | 数据API规范 | ✅ |
| [api/02_Finance_API](api/02_Finance_API.md) | 财务API规范 | ✅ |
| [api/03_Order_API](api/03_Order_API.md) | 订单API规范 | ✅ |
| [api/04_Product_API](api/04_Product_API.md) | 产品API规范 | ✅ |
---
## 关联模块
- [架构模块](../01_Architecture/00_Architecture_Index.md)
- [前端模块](../03_Frontend/00_Frontend_Index.md)
---
## 最近更新
- 2026-03-19: 重构后端文档结构,统一命名规范

View File

@@ -7,6 +7,8 @@
## 1. 技术栈 (Tech Stack)
### 1.1 当前技术栈
| 层级 | 技术 | 版本 | 用途 |
|------|------|------|------|
| **Runtime** | Node.js | 20+ | 运行时环境 |
@@ -18,6 +20,20 @@
| **Queue** | BullMQ | 5.x | 异步任务队列 |
| **Testing** | Jest | 29.x | 单元测试 |
### 1.2 技术栈演进 (2026 Q4 目标)
| 层级 | 技术 | 版本 | 用途 |
|------|------|------|------|
| **Runtime** | Node.js | 22+ | 运行时环境 |
| **Language** | TypeScript | 5.x | 开发语言 |
| **Framework** | NestJS | 10.x | Web 框架 |
| **Database** | MySQL 8.0 + MongoDB | - | 主数据库 + 文档数据库 |
| **ORM** | Prisma | 5.x | ORM 框架 |
| **Cache** | Redis | 7.0+ | 缓存 & 队列 |
| **Queue** | BullMQ | 5.x | 异步任务队列 |
| **Testing** | Jest + SuperTest | - | 单元测试 + 集成测试 |
| **微服务** | gRPC + Kubernetes | - | 服务通信 & 容器编排 |
---
## 2. 目录结构 (Directory Structure)
@@ -346,4 +362,52 @@ npm start # 生产模式
---
## 11. 后端发展规划
### 11.1 架构规划
- **微服务架构**: 将核心服务拆分为独立微服务,如商品服务、订单服务、财务服务等
- **服务网格**: 引入 Istio 实现服务治理、流量管理和安全策略
- **容器化部署**: 使用 Docker + Kubernetes 实现容器编排和自动扩缩容
- **Serverless 集成**: 部分无状态服务采用 Serverless 架构,降低运维成本
- **API 网关**: 统一 API 入口,实现认证、限流、监控等功能
### 11.2 服务能力扩展
| 服务 | 现有功能 | 计划扩展 |
|------|---------|---------|
| 商品服务 | 基础商品管理、套利分析 | 智能选品、商品生命周期管理、多平台自动同步 |
| 订单服务 | 订单管理、状态流转 | 智能审单、异常订单自动处理、多渠道订单聚合 |
| 财务服务 | 财务结算、税务计算 | 智能对账、多币种自动换算、税务报表自动生成 |
| 库存服务 | 库存管理、库存预测 | 智能补货建议、库存预测、多仓协同 |
| 营销服务 | 营销管理、广告自动化 | 智能广告优化、竞品分析、多平台营销协同 |
| 供应链服务 | 供应链管理、供应商管理 | 智能供应商评估、采购预测、供应链风险预警 |
| 物流服务 | 物流智能 | 智能物流路径规划、运费优化、实时轨迹监控 |
### 11.3 AI 能力规划
- **智能决策引擎**: 基于机器学习的定价、选品、营销决策
- **自然语言处理**: 客户服务、商品描述生成、评论分析
- **计算机视觉**: 商品图片识别、质量检测、视觉寻源
- **预测分析**: 销售预测、库存预测、风险预测
- **自动化运营**: 智能客服、自动广告优化、自动库存管理
### 11.4 性能优化规划
- **数据库优化**: 读写分离、分库分表、索引优化
- **缓存策略**: 多级缓存、热点数据预加载
- **并发处理**: 异步处理、批量操作、线程池优化
- **网络优化**: HTTP/2、HTTP/3 支持,减少请求体积
- **监控体系**: 全链路监控、性能指标采集、异常预警
### 11.5 安全增强
- **零信任架构**: 基于身份的访问控制,最小权限原则
- **数据加密**: 传输加密、存储加密、敏感数据保护
- **漏洞扫描**: 定期安全扫描、漏洞修复
- **安全审计**: 全操作审计、合规性检查
- **灾备方案**: 多地域部署、数据备份、容灾演练
---
*本文档基于代码自动生成,最后更新: 2026-03-18*

View File

@@ -0,0 +1,21 @@
# API规范索引
> **模块**: 02_Backend/api - API接口规范
> **更新日期**: 2026-03-19
---
## API文档列表
| 文档 | 描述 | 状态 |
|------|------|------|
| [01_Data_API](01_Data_API.md) | 数据模块API规范 | ✅ |
| [02_Finance_API](02_Finance_API.md) | 财务模块API规范 | ✅ |
| [03_Order_API](03_Order_API.md) | 订单模块API规范 | ✅ |
| [04_Product_API](04_Product_API.md) | 产品模块API规范 | ✅ |
---
## 返回上级
- [后端模块](../00_Backend_Index.md)

View File

@@ -48,6 +48,60 @@
**cf_shop** (店铺表)
| 字段 | 类型 | 说明 |
#### 1.3.3 跨境电商相关表
**cf_platform_integration** (平台集成表)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | string(PK) | 集成ID |
| tenant_id | string(FK) | 租户ID |
| platform_name | enum | Sellbrite/Shoplazza/SaleSmartly |
| api_key | string | API密钥 |
| api_secret | string | API密钥 |
| access_token | string | 访问令牌 |
| refresh_token | string | 刷新令牌 |
| status | string | 状态 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
**cf_cross_border_product** (跨境商品表)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | string(PK) | 跨境商品ID |
| product_id | string(FK) | 商品ID |
| hs_code | string | HS编码 |
| tariff_rate | decimal(10,2) | 关税税率 |
| compliance_status | string | 合规状态 |
| country_of_origin | string | 原产国 |
| weight | decimal(10,2) | 重量(kg) |
| dimensions | json | 尺寸(cm) |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
**cf_customs_document** (清关文件表)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | string(PK) | 文档ID |
| order_id | string(FK) | 订单ID |
| document_type | string | 文档类型 |
| document_url | string | 文档URL |
| status | string | 状态 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
**cf_cross_border_order** (跨境订单表)
| 字段 | 类型 | 说明 |
|------|------|------|
| id | string(PK) | 跨境订单ID |
| order_id | string(FK) | 订单ID |
| customs_status | string | 清关状态 |
| shipping_status | string | 物流状态 |
| tracking_number | string | 追踪号 |
| logistics_provider | string | 物流提供商 |
| estimated_delivery | datetime | 预计送达时间 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |
|------|------|------|
| id | string(PK) | 店铺ID |
| tenant_id | string(FK) | 租户ID |