# 数据驾驶舱（Go+Gin+Gorm / Vite+Vue3+Tailwind / ECharts）

本仓库包含两个子项目：
- `backend/`：后端 API（Go + Gin + Gorm）
- `frontend/`：前端管理台 + 总览大屏（Vite + Vue3 + Tailwind + ECharts）

## 1. 运行前准备

### 必需软件
- Go（建议 1.22+）
- Node.js（建议 20+）
- MySQL（示例 DSN 默认：`cockpit` 库）

### 初始化数据库（示例）
```sql
CREATE DATABASE cockpit DEFAULT CHARACTER SET utf8mb4;
```

## 2. 后端启动

1) 复制配置文件：
```bash
cp backend/configs/config.example.yaml backend/configs/config.yaml
```

2) 修改 `backend/configs/config.yaml` 的 `db.dsn`、`auth.accessTokenSecret`、`auth.refreshTokenSecret`

3) 安装依赖并启动：
```bash
cd backend
go mod tidy
go run ./cmd/server
```

后端默认监听：`http://localhost:8080`

### 默认账号
系统启动时会自动创建默认管理员：
- username: `admin`
- password: `admin123`

> 生产环境请务必修改密码或自行实现用户管理页面/接口。

## 3. 前端启动
```bash
cd frontend
npm install
npm run dev
```

前端默认：`http://localhost:5173`

如需配置后端地址，可在 `frontend/.env.local` 中指定：
```bash
VITE_API_BASE=http://localhost:8080
```

## 4. 功能清单（已实现）
- 登录：JWT Access + Refresh Token（自动刷新）
- 权限：RBAC（后端中间件校验 + 前端按权限显示菜单）
- 字典维护：客户、状态 CRUD
- 订单 CRUD：筛选 + 新增/编辑/删除（金额两口径）
- 导入中心：
  - Excel 模板下载
  - Excel 上传预览、确认入库
  - JSON 批量入库
  - 导入任务列表、错误明细
- 总览大屏：
  - 年度 KPI（年度下单/出货/未出货、平均客单价）
  - 按月趋势（下单/出货）
  - 客户 Top10（按金额口径）
  - 状态分布（饼图）
  - 客户下单次数与环比（表格）