数据驾驶舱（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 库）

初始化数据库（示例）

CREATE DATABASE cockpit DEFAULT CHARACTER SET utf8mb4;

2. 后端启动

1. 复制配置文件：

cp backend/configs/config.example.yaml backend/configs/config.yaml

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

3. 安装依赖并启动：

cd backend
go mod tidy
go run ./cmd/server

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

默认账号

系统启动时会自动创建默认管理员：

• username: admin
• password: admin123

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

3. 前端启动

cd frontend
npm install
npm run dev

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

如需配置后端地址，可在 frontend/.env.local 中指定：

VITE_API_BASE=http://localhost:8080

4. 功能清单（已实现）

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