222 lines
7.3 KiB
Markdown
222 lines
7.3 KiB
Markdown
# 任务001：后端骨架
|
||
|
||
## 目标
|
||
|
||
搭建Rust + Axum后端项目骨架，连接MySQL和Redis，建立基础路由框架。
|
||
|
||
## 技术栈
|
||
|
||
- Rust + Axum + Tokio
|
||
- MySQL (sqlx)
|
||
- Redis (redis crate)
|
||
|
||
## 数据库连接
|
||
|
||
```
|
||
MySQL: 10.8.0.252:3306 (root / Hbhyg731024@)
|
||
Redis: 10.8.0.252:6379 (password: Hbhyg731024@, db: 5)
|
||
```
|
||
|
||
**注意：** 不要动现有的 `AZZCWeChat*` 数据库，新建 `pms_dev` 库。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
software/server/
|
||
├── Cargo.toml
|
||
├── src/
|
||
│ ├── main.rs # 启动入口
|
||
│ ├── config.rs # 配置管理
|
||
│ ├── db/
|
||
│ │ ├── mod.rs # MySQL连接池
|
||
│ │ └── migrate.rs # 数据库迁移（建表）
|
||
│ ├── redis.rs # Redis连接
|
||
│ ├── routes/
|
||
│ │ ├── mod.rs # 路由注册
|
||
│ │ └── health.rs # 健康检查接口
|
||
│ ── error.rs # 统一错误处理
|
||
```
|
||
|
||
## 数据库表
|
||
|
||
创建 `pms_dev` 库，执行以下建表SQL：
|
||
|
||
```sql
|
||
-- 组织表
|
||
CREATE TABLE organizations (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
name VARCHAR(100) NOT NULL COMMENT '组织名称',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 项目表
|
||
CREATE TABLE projects (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
organization_id BIGINT NOT NULL,
|
||
name VARCHAR(100) NOT NULL COMMENT '项目名称',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (organization_id) REFERENCES organizations(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 充电柜表
|
||
CREATE TABLE cabinets (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
project_id BIGINT,
|
||
abstract_id VARCHAR(20) NOT NULL UNIQUE COMMENT '平台抽象ID，如10-00000000',
|
||
imei VARCHAR(15) NOT NULL UNIQUE COMMENT '4G模块IMEI',
|
||
auth_str VARCHAR(8) COMMENT '签名安全码',
|
||
name VARCHAR(100) COMMENT '柜子名称',
|
||
status TINYINT DEFAULT 0 COMMENT '0离线 1在线',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (project_id) REFERENCES projects(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 仓控板表
|
||
CREATE TABLE cabin_boards (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
cabinet_id BIGINT NOT NULL,
|
||
board_id TINYINT NOT NULL COMMENT '仓控板ID 1-6',
|
||
status TINYINT DEFAULT 0,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (cabinet_id) REFERENCES cabinets(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 仓体表
|
||
CREATE TABLE compartments (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
cabin_board_id BIGINT NOT NULL,
|
||
channel_id TINYINT NOT NULL COMMENT '通道ID 1-6',
|
||
status TINYINT DEFAULT 0 COMMENT '0空闲 1充电中 2故障 3禁用',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (cabin_board_id) REFERENCES cabin_boards(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 用户表
|
||
CREATE TABLE users (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
phone VARCHAR(11) NOT NULL UNIQUE COMMENT '手机号',
|
||
name VARCHAR(50) COMMENT '姓名',
|
||
password VARCHAR(100) NOT NULL,
|
||
role TINYINT DEFAULT 0 COMMENT '0普通 1企业管理员 2总管理员',
|
||
organization_id BIGINT,
|
||
status TINYINT DEFAULT 1 COMMENT '0禁用 1启用',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (organization_id) REFERENCES organizations(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 充电记录表
|
||
CREATE TABLE charge_records (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
compartment_id BIGINT NOT NULL,
|
||
cabinet_id BIGINT NOT NULL,
|
||
start_time TIMESTAMP,
|
||
end_time TIMESTAMP,
|
||
energy DECIMAL(10,2) COMMENT '充电量kWh',
|
||
max_temperature DECIMAL(5,1) COMMENT '最高温度',
|
||
status TINYINT DEFAULT 0 COMMENT '0正常 1异常 2手动停止',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (compartment_id) REFERENCES compartments(id),
|
||
FOREIGN KEY (cabinet_id) REFERENCES cabinets(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 设备日志表
|
||
CREATE TABLE device_logs (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
cabinet_id BIGINT NOT NULL,
|
||
log_type TINYINT NOT NULL COMMENT '1状态上报 2故障 3告警 4停电',
|
||
content TEXT COMMENT '日志内容JSON',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (cabinet_id) REFERENCES cabinets(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 能耗统计表
|
||
CREATE TABLE energy_stats (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
cabinet_id BIGINT NOT NULL,
|
||
stat_date DATE NOT NULL,
|
||
total_energy DECIMAL(10,2) COMMENT '总能耗kWh',
|
||
charge_count INT DEFAULT 0 COMMENT '充电次数',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (cabinet_id) REFERENCES cabinets(id),
|
||
UNIQUE KEY uk_cabinet_date (cabinet_id, stat_date)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 操作日志表
|
||
CREATE TABLE operation_logs (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
user_id BIGINT NOT NULL,
|
||
action VARCHAR(100) NOT NULL COMMENT '操作动作',
|
||
target_type VARCHAR(50) COMMENT '操作对象类型',
|
||
target_id BIGINT COMMENT '操作对象ID',
|
||
detail TEXT COMMENT '操作详情',
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
FOREIGN KEY (user_id) REFERENCES users(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
```
|
||
|
||
## API路由
|
||
|
||
注册以下基础路由：
|
||
|
||
```rust
|
||
// 健康检查
|
||
GET /api/health → 返回 {"status": "ok"}
|
||
|
||
// 认证
|
||
POST /api/auth/login → 登录
|
||
POST /api/auth/logout → 登出
|
||
|
||
// 组织管理
|
||
GET /api/organizations → 组织列表
|
||
POST /api/organizations → 创建组织
|
||
PUT /api/organizations/:id → 更新组织
|
||
DELETE /api/organizations/:id → 删除组织
|
||
|
||
// 项目管理
|
||
GET /api/projects → 项目列表
|
||
POST /api/projects → 创建项目
|
||
PUT /api/projects/:id → 更新项目
|
||
DELETE /api/projects/:id → 删除项目
|
||
|
||
// 设备管理
|
||
GET /api/cabinets → 柜子列表
|
||
POST /api/cabinets → 添加柜子（支持批量IMEI）
|
||
PUT /api/cabinets/:id → 更新柜子
|
||
DELETE /api/cabinets/:id → 删除柜子
|
||
POST /api/cabinets/:id/regenerate-auth → 重新生成auth_str
|
||
|
||
// 充电记录
|
||
GET /api/charge-records → 充电记录列表
|
||
GET /api/charge-records/export → 导出充电记录
|
||
|
||
// 设备日志
|
||
GET /api/device-logs → 设备日志列表
|
||
|
||
// 能耗管理
|
||
GET /api/energy-stats → 能耗统计
|
||
|
||
// 用户管理
|
||
GET /api/users → 用户列表
|
||
POST /api/users → 创建用户
|
||
PUT /api/users/:id → 更新用户
|
||
PUT /api/users/:id/reset-password → 重置密码
|
||
|
||
// 操作日志
|
||
GET /api/operation-logs → 操作日志列表
|
||
```
|
||
|
||
## 质量约束
|
||
|
||
1. 完成代码后执行 `cargo check`，必须零报错、零警告
|
||
2. 分层拆分，单函数≤80行，命名语义化，完整注释
|
||
3. 所有外部IO/网络请求异常捕获，禁止裸panic
|
||
4. 分支逻辑全覆盖，不遗漏兜底分支
|
||
5. 常量抽离，不使用废弃API
|
||
6. Rust内存安全，合理管理所有权，禁用unsafe无合理理由
|