Files
makemd/docs/06_Reports/04_Temporary.md
wurenzhi eafa1bbe94 feat: 添加货币和汇率管理功能
refactor: 重构前端路由和登录逻辑

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

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

chore: 更新依赖项和配置文件
2026-03-19 19:08:15 +08:00

147 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⃣ 数据模型设计
### 1.1 核心实体
| 实体 | 说明 | 核心字段 |
| ----------------- | -------------------- | --------------------------------------------------------------------------------------- |
| 店铺Store | 多店铺管理,包括我们的独立站、外部独立站 | store_id, store_name, store_type(自营/外部), credentials(登录信息/API Key) |
| 商品Product | 商品信息,支持一店多商品 | product_id, store_id, sku, name, price, stock, status |
| 订单Order | 订单信息 | order_id, store_id, product_id[], user_id, status, total_amount, created_at, updated_at |
| 报表Report | 按店铺/时间/状态汇总 | report_id, store_id, type(销售/库存/ROI), period, data(JSON) |
| 用户User/Customer | 买家信息 | user_id, name, contact, address |
### 1.2 关联逻辑
* 一店铺可以有多商品、多订单、多报表。
* 商品与订单是多对多关系(一个订单可能包含多商品)。
* 报表基于订单和商品计算。
* 支持不同店铺类型(自营、外部独立站、亚马逊等)统一接口。
---
## 2⃣ 前端交互设计
### 2.1 总览页Dashboard
* **功能**
* 显示各店铺的销售总额、订单数、库存情况。
* 过滤器:店铺类型、时间段、状态(待发货/已发货)。
* 快速入口:进入某个店铺的商品管理或订单管理。
### 2.2 店铺管理页
* **列表视图**:展示店铺名称、类型、总订单数、总销售额。
* **操作按钮**
* 编辑店铺信息
* 查看报表
* 同步商品/订单
* 添加/移除店铺
### 2.3 商品管理页(店铺内)
* 逻辑类似你已有商品管理:
* 列表SKU、名称、库存、价格、状态
* 批量操作:上架/下架、修改价格、同步库存
* 支持多店铺切换查看切换store_id
### 2.4 订单管理页
* **列表视图**
* 订单ID、用户、状态、金额、下单时间、店铺
* **操作**
* 查看订单详情
* 修改订单状态(支付确认、发货、完成)
* 批量处理(发货/取消)
* 导出 CSV / 对接报表
* **过滤器**
* 店铺
* 订单状态
* 时间段
* 商品 SKU
### 2.5 报表页
* 支持多维度:
* 店铺维度(单店/全部店铺)
* 时间维度(日/周/月/季度)
* 类型维度销售额、订单量、库存、ROI
* 可导出 PDF / Excel / CSV
* 可自定义图表
---
## 3⃣ 后端架构
### 3.1 接口设计REST 或 GraphQL
* **店铺接口**
* `GET /stores`:列表
* `POST /store`:新增
* `PUT /store/{id}`:更新
* `DELETE /store/{id}`:删除
* **商品接口**
* `GET /store/{id}/products`:获取商品
* `POST /store/{id}/product`:新增商品
* `PUT /product/{id}`:更新
* `DELETE /product/{id}`:删除
* **订单接口**
* `GET /store/{id}/orders`:获取订单列表
* `GET /order/{id}`:订单详情
* `PUT /order/{id}`:修改状态
* `POST /order/batch-update`:批量操作
* **报表接口**
* `GET /store/{id}/report?type=sales&period=month`:获取报表
### 3.2 数据同步逻辑
* 对接外部独立站或电商平台时,支持定时抓取或 API 同步:
* 商品库存、价格
* 订单状态、物流信息
* 使用队列(如 RabbitMQ / Kafka处理异步同步任务保证系统流畅。
### 3.3 多店铺隔离
* 数据库可选:
* **单库多表**:每个实体表里加 `store_id` 字段,统一管理。
* **多库方案**:每个店铺单独数据库,跨店铺汇总需要 ETL。
* 建议初期用单库多表,方便报表和操作统一。
---
## 4⃣ 交互逻辑总结
```
Dashboard
└─ 店铺列表
├─ 商品管理
└─ 订单管理
└─ 报表
```
* 每一层都支持批量操作、过滤器、多店铺切换。
* 报表基于订单和商品计算,保持实时性或每日更新。
* 多店铺/多系统接口统一,后端做抽象层处理不同 API。
---
如果你需要,我可以帮你画一张**完整的多店铺-多商品-多订单交互架构图**,把前端交互和后端逻辑、报表处理都可视化出来,这样团队开发时一目了然。
你希望我帮你画吗?