feat: 添加货币和汇率管理功能
refactor: 重构前端路由和登录逻辑 docs: 更新业务闭环、任务和架构文档 style: 调整代码格式和文件结构 chore: 更新依赖项和配置文件
This commit is contained in:
41
docs/02_Backend/00_Backend_Index.md
Normal file
41
docs/02_Backend/00_Backend_Index.md
Normal 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: 重构后端文档结构,统一命名规范
|
||||
@@ -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*
|
||||
21
docs/02_Backend/api/00_API_Index.md
Normal file
21
docs/02_Backend/api/00_API_Index.md
Normal 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)
|
||||
@@ -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 |
|
||||
Reference in New Issue
Block a user