feat: 添加前端页面和业务说明书

refactor(server): 重构服务层代码结构
feat(server): 添加基础设施、跨境电商、AI决策等核心服务
docs: 完善前端业务说明书和开发进度文档
style: 格式化代码和文档
This commit is contained in:
2026-03-18 19:12:38 +08:00
parent c932a67be2
commit 6d0d2b6157
140 changed files with 23859 additions and 5833 deletions

View File

@@ -9,50 +9,95 @@
## 1. 页面流转总览
```
登录页
登录页 (/Auth/LoginPage)
仪表盘 (Dashboard)
仪表盘 (Dashboard) (/)
├──► 商品管理
│ ├── 商品列表 ──► 商品详情
├──► 商品管理 (/Product)
│ ├── 商品列表 ──► 商品详情 (/Product/ProductDetail)
│ │ ├── 编辑商品
│ │ └── 审核商品
│ ├── 创建商品
│ └── 商品审核
│ ├── 创建商品 (/Product/ProductPublishForm)
│ └── 物料上传 (/Product/MaterialUpload)
├──► 订单管理
│ ├── 订单列表 ──► 订单详情
├──► 订单管理 (/Orders)
│ ├── 订单列表 (/Orders/OrderList) ──► 订单详情 (/Orders/OrderDetail)
│ │ └── 状态流转
── 订单审核
── 异常订单处理 (/Orders/ExceptionOrder)
│ └── 订单聚合分析 (/Orders/OrderAggregation)
├──► 财务管理
│ ├── 财务概览
│ ├── 交易流水
── 利润对账
├──► 商户管理 (/Merchant)
│ ├── 商户管理 (/Merchant/MerchantManage)
│ ├── 商户订单管理 (/Merchant/MerchantOrderManage)
── 商户结算管理 (/Merchant/MerchantSettlementManage)
│ └── 商户店铺管理 (/Merchant/MerchantShopManage)
├──► 库存管理
│ ├── 库存概览
│ ├── 仓库管理
│ └── 库存预测
├──► 售后服务 (/AfterSales)
│ ├── 退货申请 (/AfterSales/ReturnApply)
│ ├── 退款流程 (/AfterSales/RefundProcess)
│ └── 客户服务 (/AfterSales/CustomerService)
├──► 营销广告
│ ├── 营销概览
│ ├── 广告管理
│ └── 竞品监控
├──► 物流管理 (/Logistics)
│ ├── 物流选择 (/Logistics/LogisticsSelect)
│ ├── 运费计算 (/Logistics/FreightCalc)
│ └── 物流追踪 (/Logistics/LogisticsTrack)
├──► 供应商管理
│ ├── 供应商列表 ──► 供应商详情
── 供应商审核
├──► 合规管理 (/Compliance)
│ ├── 合规检查 (/Compliance/ComplianceCheck)
── 证书管理 (/Compliance/CertificateManage)
│ └── 证书过期提醒 (/Compliance/CertificateExpiryReminder)
├──► 报表分析
│ ├── 利润报表
│ └── 绩效报表
├──► 黑名单管理 (/Blacklist)
│ ├── 黑名单管理 (/Blacklist/BlacklistManage)
│ └── 风险监控 (/Blacklist/RiskMonitor)
──► 系统设置
├── 个人设置
├── 租户设置
└── 用户管理
──► B2B贸易 (/B2B)
├── 企业报价 (/B2B/EnterpriseQuote)
├── 批量订单 (/B2B/BatchOrder)
└── 合同管理 (/B2B/ContractManage)
├──► 广告管理 (/Ad)
│ ├── 广告投放 (/Ad/AdDelivery)
│ ├── ROI分析 (/Ad/ROIAnalysis)
│ └── 广告计划 (/Ad/AdPlanPage)
├──► 财务管理 (/Finance)
│ ├── 交易记录 (/Finance/Transactions)
│ └── 对账记录 (/Finance/Reconciliation)
├──► 库存管理 (/Inventory)
│ ├── 仓库管理 (/Inventory/Warehouses)
│ └── 库存预测 (/Inventory/InventoryForecast)
├──► 营销管理 (/Marketing)
│ ├── 广告管理 (/Marketing/Ads)
│ └── 竞争对手分析 (/Marketing/Competitors)
├──► 供应商管理 (/Suppliers)
│ └── 供应商详情 (/Suppliers/SupplierDetail)
├──► 报表中心 (/Reports)
│ ├── 利润报表 (/Reports/ProfitReport)
│ └── 绩效报表 (/Reports/PerformanceReport)
├──► 设置 (/Settings)
│ ├── 个人设置 (/Settings/ProfileSettings)
│ ├── 租户设置 (/Settings/TenantSettings)
│ └── 用户管理 (/Settings/UserManagement)
├──► A/B测试 (/ABTest)
│ ├── A/B测试配置 (/ABTest/ABTestConfig)
│ └── 测试结果分析 (/ABTest/ABTestResults)
├──► 退货管理 (/Return)
│ ├── 退货监控 (/Return/ReturnMonitor)
│ └── SKU管理 (/Return/SKUManage)
└──► 用户资产管理 (/UserAsset)
├── 会员等级管理 (/UserAsset/MemberLevel)
├── 积分管理 (/UserAsset/PointsManage)
└── 用户资产 (/UserAsset/UserAssets)
```
---
@@ -330,29 +375,93 @@
├── 仪表盘
├── 商品管理
├── 订单管理
├── 财务管理
├── 库存管理
├── 营销广告
├── 供应商
├── 报表分析
── 系统设置
├── 商户管理
├── 售后服务
├── 物流管理
├── 合规管理
├── 黑名单管理
── B2B贸易
├── 广告管理
├── A/B测试
├── 退货管理
└── 用户资产管理
```
### 10.2 面包屑导航
```
首页 / 商品管理 / 商品详情
首页 / 订单管理 / 订单审核
首页 / 财务管理 / 利润对账
首页 / 订单管理 / 订单列表
首页 / 商户管理 / 商户管理
首页 / 售后服务 / 退货申请
首页 / 物流管理 / 物流追踪
首页 / 合规管理 / 合规检查
首页 / 黑名单管理 / 风险监控
首页 / B2B贸易 / 企业报价
首页 / 广告管理 / ROI分析
首页 / A/B测试 / 测试结果分析
首页 / 退货管理 / 退货监控
首页 / 用户资产管理 / 会员等级管理
```
### 10.3 快捷操作
| 操作 | 触发方式 | 说明 |
|------|----------|------|
| 全局搜索 | Ctrl + K | 快速搜索商品、订单 |
| 通知中心 | 顶部图标 | 查看系统通知 |
| 个人菜单 | 头像下拉 | 个人设置、退出登录 |
| 全局搜索 | Ctrl + K | 快速搜索商品、订单、商户等 |
| 通知中心 | 顶部图标 | 查看系统通知、待办事项 |
| 个人菜单 | 头像下拉 | 个人设置、退出登录、切换租户 |
| 主题切换 | 顶部图标 | 切换深色/浅色主题 |
| 语言切换 | 顶部图标 | 切换系统语言 |
| 帮助中心 | 顶部图标 | 查看系统文档、常见问题 |
### 10.4 交互优化
#### 10.4.1 表单交互
- **实时验证**:表单输入时实时验证,提供即时反馈
- **自动保存**:重要表单自动保存草稿,防止数据丢失
- **智能填充**:根据历史数据和上下文自动填充表单字段
- **批量操作**:支持表单数据的批量编辑和导入导出
#### 10.4.2 列表交互
- **虚拟滚动**:长列表使用虚拟滚动,提升性能
- **列排序**:支持点击列头排序
- **列筛选**:支持按列筛选数据
- **列调整**:支持调整列宽和显示/隐藏列
- **批量选择**:支持复选框批量选择和操作
#### 10.4.3 页面过渡
- **加载状态**:使用骨架屏代替简单的加载动画
- **页面切换**:平滑的页面切换动画
- **错误处理**:友好的错误提示和恢复方案
- **成功反馈**:操作成功后的明确反馈
#### 10.4.4 响应式交互
- **移动端适配**:针对移动设备优化的交互体验
- **触摸友好**:增大触摸区域,支持手势操作
- **自适应布局**:根据屏幕尺寸自动调整布局
### 10.5 用户体验考虑
#### 10.5.1 可访问性
- **键盘导航**:支持全键盘操作
- **屏幕阅读器**:兼容屏幕阅读器
- **颜色对比度**符合WCAG标准的颜色对比度
#### 10.5.2 性能优化
- **懒加载**:非关键资源懒加载
- **缓存策略**:合理的缓存策略减少请求
- **预加载**:预测用户行为,预加载相关资源
#### 10.5.3 反馈机制
- **操作反馈**:所有用户操作都有明确的反馈
- **进度指示**:长时间操作显示进度条
- **错误提示**:清晰的错误提示和解决方案
#### 10.5.4 引导机制
- **新用户引导**:首次使用时的功能引导
- **功能提示**:重要功能的使用提示
- **上下文帮助**:在适当位置提供帮助信息
---