# 当前开发状态

更新时间：2026-09-05

## 已完成的基础改造

- 页面布局已改为左侧导航：一级、二级菜单都在左侧。
- Logo 已移动到左侧菜单顶部。
- Header 保留折叠按钮、面包屑、消息、APK 和用户区域。
- 默认使用浅色主题，同时保留布局设置中的明暗主题切换。
- 已处理展开、折叠和移动端 Header 宽度联动。
- 生产构建脚本已加入 Node 22/OpenSSL 3 兼容参数。
- `api.json` 已生成 27 个模块、278 个接口和 32 个模型的本地文档。

## 已创建但尚未开发业务功能的页面

| 页面 | 文件 | 菜单组件路径 | 当前状态 |
| --- | --- | --- | --- |
| 隐患审核 | `src/views/hazard/audit/index.vue` | `hazard/audit/index` | 空白页面，未封装接口 |
| 隐患台账 | `src/views/hazard/ledger/index.vue` | `hazard/ledger/index` | 已完成台账分页、筛选、详情弹窗、附件和审核入口；生产构建已通过；同步重试等待后端接口 |
| 积分管理 | `src/views/points/management/index.vue` | `points/management/index` | 空白页面，未封装接口 |
| 隐患流程配置 | `src/views/flowable/hazardConfig/index.vue` | `flowable/hazardConfig/index` | 空白页面，未封装接口 |
| 切换日志 | `src/views/flowable/switchLog/index.vue` | `flowable/switchLog/index` | 空白页面，无明确列表接口 |

以上页面均有同级 `components/` 目录，用于放页面专用组件。

## 建议开发顺序

1. 隐患流程配置：接口最完整，包含列表、详情、新增、修改和停用。
2. 隐患台账：列表、详情、附件和导出接口较完整。
3. 隐患审核：需要确认待办/已办筛选参数和审批真实响应。
4. 积分管理：先确认页面范围是账户、流水、规则中的哪些模块，并确认手动调整积分请求格式。
5. 切换日志：等待后端提供日志列表接口，或确认流程切换已经写入操作审计日志。

## 已知风险和待确认项

### 接口路径

`api.json` 路径普遍包含 `/gd_dataserver/gd_dataserver`，运行时 `BASE_API` 已包含一个 `/gd_dataserver`。新 API 封装必须核对最终 URL，避免重复三次或缺少前缀。

### 鉴权头不一致

- 当前前端：`Authorization: Bearer <token>`
- OpenAPI：`X-Access-Token`
- 商城接口另外声明 `token` 请求头

现有系统可用时优先保持当前前端行为，真实联调出现鉴权问题再与后端统一。

### 切换日志缺少接口

仅存在：

```text
POST /flowable/hazard/switchLevel
```

没有明确的切换日志列表、详情和日志模型。通用审计日志能否代替需后端确认。

### 手动积分调整定义不完整

接口描述要求指定用户并传正负积分，但 OpenAPI 请求体只声明 `application/x-www-form-urlencoded` 的单个整数，未给出用户字段名和参数结构。开发调整弹窗前必须确认。

### 分页响应过于宽泛

多个分页接口只声明返回 `object`，文字说明称 `data` 是 `PageInfo`，其中含 `list`。实现时需要用真实响应确认总数字段是 `total`、`totalCount` 还是其他名称。

## 菜单配置状态

页面文件已经准备好，但菜单是否已在后端配置、角色是否已授权无法从前端仓库判断。页面不显示时优先检查：

1. 菜单状态是否正常、显示状态是否显示。
2. 组件路径是否与上表一致。
3. 当前角色是否勾选菜单权限。
4. 是否重新登录获取了最新动态路由。