120 lines
4.7 KiB
Markdown
120 lines
4.7 KiB
Markdown
|
# 任务004：组织架构管理
|
|||
|
|
|
|||
|
|
## 目标
|
|||
|
|
|
|||
|
|
实现组织、项目、设备的增删改查，树状菜单展示，设备划拨功能。
|
|||
|
|
|
|||
|
|
## 后端API
|
|||
|
|
|
|||
|
|
### 组织管理
|
|||
|
|
```
|
|||
|
|
GET /api/organizations # 组织列表
|
|||
|
|
POST /api/organizations # 创建组织
|
|||
|
|
PUT /api/organizations/:id # 更新组织
|
|||
|
|
DELETE /api/organizations/:id # 删除组织
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 项目管理
|
|||
|
|
```
|
|||
|
|
GET /api/organizations/:org_id/projects # 项目列表（按组织）
|
|||
|
|
POST /api/organizations/:org_id/projects # 创建项目
|
|||
|
|
PUT /api/projects/:id # 更新项目
|
|||
|
|
DELETE /api/projects/:id # 删除项目
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 设备管理
|
|||
|
|
```
|
|||
|
|
GET /api/projects/:project_id/cabinets # 柜子列表（按项目）
|
|||
|
|
POST /api/cabinets # 添加柜子（支持批量IMEI）
|
|||
|
|
PUT /api/cabinets/:id # 更新柜子（划拨项目）
|
|||
|
|
DELETE /api/cabinets/:id # 删除柜子
|
|||
|
|
POST /api/cabinets/:id/regenerate-auth # 重新生成auth_str
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 树状结构
|
|||
|
|
```
|
|||
|
|
GET /api/organization-tree # 返回完整树：组织→项目→设备
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
返回格式：
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"id": 1,
|
|||
|
|
"name": "组织A",
|
|||
|
|
"children": [
|
|||
|
|
{
|
|||
|
|
"id": 1,
|
|||
|
|
"name": "项目1",
|
|||
|
|
"children": [
|
|||
|
|
{"id": 1, "abstract_id": "10-00000001", "imei": "123456789012345", "status": 1}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 前端页面
|
|||
|
|
|
|||
|
|
### 设备管理页
|
|||
|
|
|
|||
|
|
**布局：**
|
|||
|
|
```
|
|||
|
|
┌─────────────────┬──────────────────────────────────
|
|||
|
|
│ 组织架构树 │ 卡片网格 │
|
|||
|
|
│ ├─ 全部 │ ┌─────┐ ┌─────┐ ┌─────┐ │
|
|||
|
|
│ ├─ 组织A │ │柜子1 │ │柜子2 │ │柜子3 │ │
|
|||
|
|
│ │ ├─ 项目1 │ │ID │ │ID │ │ID │ │
|
|||
|
|
│ │ └─ 项目2 │ │状态 │ │状态 │ │状态 │ │
|
|||
|
|
│ ─ 组织B │ └─────┘ └─────┘ └─────┘ │
|
|||
|
|
│ │ │
|
|||
|
|
└─────────────────┴──────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**左侧树：**
|
|||
|
|
- 显示组织→项目→设备树状结构
|
|||
|
|
- 右键菜单：添加组织、添加项目、编辑、删除
|
|||
|
|
- 点击节点过滤右侧卡片
|
|||
|
|
|
|||
|
|
**右侧卡片：**
|
|||
|
|
- 显示柜子ID、状态（在线/离线/充电中/故障）
|
|||
|
|
- 点击卡片进入柜子详情页
|
|||
|
|
|
|||
|
|
### 柜子详情页
|
|||
|
|
|
|||
|
|
**布局：**
|
|||
|
|
```
|
|||
|
|
┌──────────────────────────────────────────────┐
|
|||
|
|
│ ← 返回 柜子10-00000000 状态: 在线 │
|
|||
|
|
├──────────────────────────────────────────────┤
|
|||
|
|
│ 仓板1 (ID:1) │
|
|||
|
|
│ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐│
|
|||
|
|
│ │通道1 │ │通道2 │ │通道3 │ │通道4 │ │通道5 │ │通道6 ││
|
|||
|
|
│ │状态 │ │状态 │ │状态 │ │状态 │ │状态 │ │状态 ││
|
|||
|
|
│ │电压 │ │电压 │ │电压 │ │电压 │ │电压 │ │电压 ││
|
|||
|
|
│ │电流 │ │电流 │ │电流 │ │电流 │ │电流 │ │电流 ││
|
|||
|
|
│ │功率 │ │功率 │ │功率 │ │功率 │ │功率 │ │功率 ││
|
|||
|
|
│ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘│
|
|||
|
|
├──────────────────────────────────────────────┤
|
|||
|
|
│ 仓板2 (ID:2) ... │
|
|||
|
|
└──────────────────────────────────────────────
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**通道卡片显示：** 工作状态、电压、电流、功率
|
|||
|
|
|
|||
|
|
**点击通道 → 模态框显示充电记录**
|
|||
|
|
|
|||
|
|
### 添加柜子弹窗
|
|||
|
|
|
|||
|
|
- 文本框输入IMEI，一行一个（支持批量）
|
|||
|
|
- 选择所属组织/项目
|
|||
|
|
- 提交后后端生成auth_str
|
|||
|
|
|
|||
|
|
## 质量约束
|
|||
|
|
|
|||
|
|
1. 完成代码后执行 `cargo check` + `tsc --noEmit`，零报错零警告
|
|||
|
|
2. 分层拆分，单函数≤80行，命名语义化，完整注释
|
|||
|
|
3. 所有外部IO/网络请求异常捕获，禁止裸panic
|
|||
|
|
4. 分支逻辑全覆盖，不遗漏兜底分支
|
|||
|
|
5. 常量抽离，不使用废弃API
|
|||
|
|
6. Rust内存安全，React函数组件+Hooks
|