Files
makemd/docs/ARCHIVE/01_Architecture/frontend/04_IndependentSite.md
wurenzhi 2b86715c09 refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理
2026-03-23 12:41:35 +08:00

145 lines
4.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 独立站 页面前端业务说明书
## 1⃣ 页面定义
### 页面目标
帮助商户:
- 创建和管理独立站
- 配置独立站的基本信息和设置
- 管理独立站的商品和订单
- 分析独立站的运营数据
- 优化独立站的运营策略
### 页面类型
- 业务核心页(直接影响独立站运营)
## 2⃣ 页面核心数据
### 核心数据字段
- siteId站点ID唯一标识独立站
- siteName站点名称独立站的名称
- domain域名独立站的域名
- status站点状态活跃、暂停、关闭等
- template模板独立站使用的模板
- theme主题独立站的主题设置
- products商品独立站内的商品列表
- orders订单独立站的订单列表
- traffic流量独立站的访问流量
- sales销售额独立站的销售数据
- createdAt创建时间独立站的创建时间
- updatedAt更新时间独立站的更新时间
## 3⃣ 页面核心操作
### 用户操作
- 创建独立站:创建新的独立站
- 配置独立站:设置独立站的基本信息和参数
- 管理商品:添加、编辑和删除独立站内的商品
- 管理订单:处理独立站的订单
- 分析数据:查看独立站的运营数据和分析报告
- 优化设置:调整独立站的设置以提高运营效果
## 4⃣ 操作 → 业务结果
### 操作闭环
1. **创建独立站**
- 触发:用户点击"创建独立站"按钮
- 服务IndependentSiteService.createSite
- 结果创建新的独立站生成站点ID和默认配置
- 反馈:显示创建成功提示,跳转到独立站配置页面
2. **配置独立站**
- 触发:用户修改独立站的配置
- 服务IndependentSiteService.updateConfig
- 结果:更新独立站的配置信息
- 反馈:显示配置更新成功提示
3. **管理商品**
- 触发:用户在独立站内添加、编辑或删除商品
- 服务IndependentSiteService.manageProducts
- 结果:更新独立站的商品列表
- 反馈:显示商品操作成功提示
4. **分析数据**
- 触发:用户点击"分析数据"按钮
- 服务AnalyticsService.analyzeSiteData
- 结果:生成独立站的运营分析报告
- 反馈:显示分析结果和图表
## 5⃣ 页面状态
### 状态定义
- loading数据加载中
- empty无独立站数据
- error操作错误
- success操作成功
- creating独立站创建中
- configuring独立站配置中
- analyzing数据分析中
## 6⃣ 收费点
### 收费触发点
- 独立站创建:按站点数量收费
- 高级模板:按模板类型收费
- 数据分析:按功能使用时间收费
- 流量优化:按优化效果收费
## 7⃣ 页面结构
### 主要区域
1. **独立站列表区**:显示所有独立站,包含核心数据字段
2. **独立站详情区**:显示单个独立站的详细信息
3. **站点配置区**:配置独立站的基本信息和设置
4. **商品管理区**:管理独立站内的商品
5. **订单管理区**:管理独立站的订单
6. **数据分析区**:显示独立站的运营数据和分析报告
## 8⃣ 业务价值
### 核心价值
- 帮助商户快速创建和管理独立站
- 提供个性化的独立站配置选项
- 实现商品和订单的统一管理
- 提供数据驱动的运营分析
- 优化独立站的运营效果,提高销售额
### 商业闭环
独立站创建 → 配置设置 → 商品上传 → 订单处理 → 数据分析 → 优化调整 → 销售增长
## 9⃣ 前端实现要点
### 技术实现
- 使用React组件化开发
- 集成Ant Design表格和表单组件
- 实现虚拟列表,优化大数据量渲染
- 使用Umi Model管理全局状态
- 实现实时数据更新和WebSocket连接
- 集成第三方模板和主题选择器
### 用户体验
- 响应式设计,支持多终端访问
- 操作反馈及时显示loading和success/error提示
- 数据可视化,使用图表展示运营数据和分析结果
- 批量操作支持,提高工作效率
- 拖拽式页面构建器,方便用户自定义独立站页面
## 🔟 后端服务依赖
### 核心服务
- IndependentSiteService独立站管理和配置
- ProductService商品管理
- OrderService订单管理
- AnalyticsService数据分析
- TemplateService模板管理
### 数据接口
- GET /api/v1/sites获取独立站列表
- POST /api/v1/sites创建独立站
- GET /api/v1/sites/:id获取独立站详情
- PUT /api/v1/sites/:id更新独立站配置
- DELETE /api/v1/sites/:id删除独立站
- GET /api/v1/sites/:id/products获取独立站商品列表
- GET /api/v1/sites/:id/orders获取独立站订单列表
- GET /api/v1/sites/:id/analytics获取独立站分析数据
- GET /api/v1/templates获取可用模板列表