初始化
This commit is contained in:
25
docs/projects/xk-data/design.md
Normal file
25
docs/projects/xk-data/design.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# xk-data 设计思路
|
||||
|
||||
## 架构决策
|
||||
|
||||
### 独立部署
|
||||
|
||||
数据大屏作为独立的前端应用部署:
|
||||
- 不依赖管理后台框架
|
||||
- 简化的技术栈(Vue CLI + ECharts)
|
||||
- 可独立部署为静态页面
|
||||
|
||||
### 数据聚合
|
||||
|
||||
通过后端 Open API 获取聚合数据:
|
||||
- 前端只负责展示,不做数据计算
|
||||
- 后端 `DashboardDataController` 负责数据聚合
|
||||
- 支持缓存,减少数据库查询
|
||||
|
||||
### 大屏适配
|
||||
|
||||
针对大屏显示优化:
|
||||
- 全屏布局
|
||||
- 高对比度配色
|
||||
- 自适应分辨率
|
||||
- 数字动画效果
|
||||
32
docs/projects/xk-data/modules/charts.md
Normal file
32
docs/projects/xk-data/modules/charts.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# 数据展示模块
|
||||
|
||||
## 图表类型
|
||||
|
||||
基于 ECharts 实现:
|
||||
|
||||
| 图表 | 说明 |
|
||||
|------|------|
|
||||
| 折线图 | 趋势分析(订单/用户/收入趋势) |
|
||||
| 柱状图 | 对比分析 |
|
||||
| 饼图 | 占比分析 |
|
||||
| 地图 | 区域分布 |
|
||||
| 数字动画 | countup.js 实现数字滚动效果 |
|
||||
|
||||
## 数据接口
|
||||
|
||||
| 接口 | 说明 |
|
||||
|------|------|
|
||||
| `GET /api/open/data/count` | 统计总数 |
|
||||
| `GET /api/open/data/top-drugs` | 热门药品 |
|
||||
| `GET /api/open/data/store-number` | 门店数量 |
|
||||
| `GET /api/open/data/trend` | 趋势数据 |
|
||||
|
||||
## 页面结构
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
APP[数据大屏] --> COUNT[统计总览]
|
||||
APP --> TOP[热门药品]
|
||||
APP --> STORE[门店统计]
|
||||
APP --> TREND[趋势图表]
|
||||
```
|
||||
24
docs/projects/xk-data/modules/index.md
Normal file
24
docs/projects/xk-data/modules/index.md
Normal file
@@ -0,0 +1,24 @@
|
||||
# xk-data 功能模块
|
||||
|
||||
## 模块清单
|
||||
|
||||
| 模块 | 说明 | 页面 |
|
||||
|------|------|------|
|
||||
| 数据展示 | 统计总览、趋势图表 | [数据展示](./charts.md) |
|
||||
|
||||
## 数据展示
|
||||
|
||||
| 模块 | 说明 |
|
||||
|------|------|
|
||||
| 统计总览 | 订单数、用户数、门店数等核心指标 |
|
||||
| 热门药品 | 热销药品排行 |
|
||||
| 门店统计 | 门店数量、分布 |
|
||||
| 趋势图表 | 订单/用户/收入趋势折线图 |
|
||||
|
||||
## 数据来源
|
||||
|
||||
通过 `open-api.php` 的 `/api/open/data/*` 接口获取数据:
|
||||
- `data/count` — 统计总数
|
||||
- `data/top-drugs` — 热门药品
|
||||
- `data/store-number` — 门店数量
|
||||
- `data/trend` — 趋势数据
|
||||
38
docs/projects/xk-data/overview.md
Normal file
38
docs/projects/xk-data/overview.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# xk-data 概览
|
||||
|
||||
xk-data 是 XK 系统的数据大屏,基于 Vue 3 和 ECharts 构建,用于业务数据可视化展示。
|
||||
|
||||
## 基本信息
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| 框架 | Vue 3 (Vue CLI) |
|
||||
| 构建工具 | @vue/cli-service 5.0 |
|
||||
| 图表库 | ECharts 5.5.1 |
|
||||
| HTTP | Axios |
|
||||
| 计数动画 | countup.js |
|
||||
| 其他 | jQuery |
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
xk-data/
|
||||
├── public/ # 静态文件
|
||||
├── src/
|
||||
│ ├── api/ # API 调用
|
||||
│ ├── App.vue # 根组件
|
||||
│ ├── App1.vue # 备用根组件
|
||||
│ ├── assets/ # 资源文件
|
||||
│ ├── components/ # 组件
|
||||
│ └── main.js # 入口
|
||||
├── vue.config.js # Vue CLI 配置
|
||||
└── babel.config.js # Babel 配置
|
||||
```
|
||||
|
||||
## 数据来源
|
||||
|
||||
通过 `open-api.php` 的 `/api/open/data/*` 接口获取数据:
|
||||
- `data/count` — 统计总数
|
||||
- `data/top-drugs` — 热门药品
|
||||
- `data/store-number` — 门店数量
|
||||
- `data/trend` — 趋势数据
|
||||
Reference in New Issue
Block a user