初始化

This commit is contained in:
李琦
2026-07-08 15:04:42 +08:00
commit 70264153e5
129 changed files with 13797 additions and 0 deletions

View File

@@ -0,0 +1,25 @@
# xk-data 设计思路
## 架构决策
### 独立部署
数据大屏作为独立的前端应用部署:
- 不依赖管理后台框架
- 简化的技术栈Vue CLI + ECharts
- 可独立部署为静态页面
### 数据聚合
通过后端 Open API 获取聚合数据:
- 前端只负责展示,不做数据计算
- 后端 `DashboardDataController` 负责数据聚合
- 支持缓存,减少数据库查询
### 大屏适配
针对大屏显示优化:
- 全屏布局
- 高对比度配色
- 自适应分辨率
- 数字动画效果

View 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[趋势图表]
```

View 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` — 趋势数据

View 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` — 趋势数据