101 lines
2.8 KiB
Markdown
101 lines
2.8 KiB
Markdown
# 任务011：代码质量优化
|
||
|
||
## 目标
|
||
|
||
修复代码审查发现的警告问题，提升代码质量。
|
||
|
||
## 修复清单
|
||
|
||
### 1. 拆分大文件（ 中优先级）
|
||
|
||
**organizations.rs（693行）**
|
||
拆分为：
|
||
- `src/routes/organizations.rs` — 组织CRUD（~150行）
|
||
- `src/routes/projects.rs` — 项目CRUD（~150行）
|
||
- `src/routes/cabinets.rs` — 设备CRUD+详情（~200行）
|
||
- `src/routes/cabinet_tree.rs` — 树状结构（~100行）
|
||
|
||
**users.rs（495行）**
|
||
拆分为：
|
||
- `src/routes/users.rs` — 用户CRUD（~200行）
|
||
- `src/routes/user_operations.rs` — 操作日志辅助函数（~100行）
|
||
|
||
**devices/index.tsx（631行）**
|
||
拆分为：
|
||
- `src/pages/devices/index.tsx` — 主页面（~150行）
|
||
- `src/pages/devices/OrganizationTree.tsx` — 组织树组件（~150行）
|
||
- `src/pages/devices/CabinetGrid.tsx` — 柜子卡片网格（~150行）
|
||
- `src/pages/devices/AddCabinetModal.tsx` — 添加柜子弹窗（~100行）
|
||
|
||
### 2. JWT密钥安全检查（🟡 中优先级）
|
||
|
||
**位置：** `src/middleware/auth.rs:28`
|
||
|
||
**修复方案：**
|
||
启动时检测默认密钥，打印WARN日志。
|
||
|
||
```rust
|
||
// config.rs 添加
|
||
impl Config {
|
||
pub fn validate(&self) -> Result<()> {
|
||
if self.jwt_secret == JWT_SECRET_DEFAULT {
|
||
tracing::warn!("⚠️ 使用默认JWT密钥，生产环境请设置JWT_SECRET环境变量");
|
||
}
|
||
Ok(())
|
||
}
|
||
}
|
||
|
||
// main.rs 启动时调用
|
||
let config = Config::from_env()?;
|
||
config.validate()?; // 新增
|
||
```
|
||
|
||
### 3. 修复IconFolderOpen构建错误（🟡 中优先级）
|
||
|
||
**位置：** `src/pages/devices/index.tsx:33`
|
||
|
||
**修复方案：**
|
||
替换为可用图标。
|
||
|
||
```tsx
|
||
// 错误
|
||
import { IconFolderOpen } from '@arco-design/web-react/icon';
|
||
|
||
// 修复（选择存在的图标）
|
||
import { IconFolder } from '@arco-design/web-react/icon';
|
||
// 或
|
||
import { IconApps } from '@arco-design/web-react/icon';
|
||
```
|
||
|
||
### 4. 清理clippy警告（🟢 低优先级）
|
||
|
||
**修复方案：**
|
||
```bash
|
||
cd software/server
|
||
cargo clippy --fix --allow-dirty
|
||
```
|
||
|
||
自动修复大部分clippy警告（collapsible_if、manual_unwrap_or_default等）。
|
||
|
||
### 5. H5充电曲线数据（🟢 低优先级）
|
||
|
||
**位置：** `src/h5/pages/compartment-detail.tsx:156`
|
||
|
||
**修复方案：**
|
||
添加TODO注释，标记为待后端提供数据后替换。
|
||
|
||
```tsx
|
||
// TODO: 待后端提供充电曲线API后替换为真实数据
|
||
const mockChartData = [30, 45, 55, ...];
|
||
```
|
||
|
||
## 质量约束
|
||
|
||
1. 完成代码后执行 `cargo check` + `cargo clippy` + `tsc --noEmit`，零报错零警告
|
||
2. 分层拆分，单函数≤80行，命名语义化，完整注释
|
||
3. 所有外部IO/网络请求异常捕获，禁止裸panic
|
||
4. 分支逻辑全覆盖，不遗漏兜底分支
|
||
5. 常量抽离，不使用废弃API
|
||
6. Rust内存安全，React函数组件+Hooks
|
||
7. 拆分后的文件职责单一，无循环依赖
|