# 当前开发状态

更新时间：2026-10-15

## 已完成的基础改造

- 已完成管理后台原型视觉统一第一阶段：移除固定 1920×1080 全局缩放，后台恢复流式布局。
- 登录页已移除固定 1920×1080 登录画布和负边距定位，登录框改为视口 Flex 居中，并补充窄屏安全边距和低高度滚动。
- Token 过期、获取用户信息失败和主动退出已不再回跳废弃的 `/index`；登录页会过滤历史无效回跳地址，默认进入 `/hazard/ledger`。
- 默认浅色布局已统一为 212px 左侧栏、52px Header、`#F0F2F5` 页面背景和紧凑型菜单密度。
- 新增共享原型主题样式，统一 Card、Table、Form、Input、Button、Tag、Dialog、Switch 和 Pagination；默认表格字号改为 12px。
- 积分管理、隐患台账和隐患审核页面已同步修正旧的 84px 顶部高度、背景色和局部文字颜色；隐患台账主列表已进一步切换为新版 `DataListPanel` Card Table，保留全部业务并支持列宽拖拽。
- 用户管理已完成 Card 列表试点：保留左侧部门树，右侧使用顶部筛选和批量操作、无竖向单元格线、紧凑分页、统一按钮和状态标签。
- 角色管理列表已完成 Card 列表改造：保留原有全宽列表结构和全部功能，不增加用户管理的左侧部门树；筛选、批量操作、表格、状态开关、行内操作和分页与用户管理统一。
- 角色管理行末已恢复省略号“更多操作”入口，继续提供数据权限和分配用户；`DataListPanel` 新增默认关闭的 `modern-table` 模式，隐患台账加入后共 17 个新版 Card 主列表显式开启并保持无竖线视觉及表头拖拽，旧表格默认样式不受影响。
- 系统监控下未改新版 UI 的在线用户、定时任务、调度日志和缓存列表已显式恢复 Element UI 旧式竖线及表头列宽拖拽；操作日志和登录日志继续使用新版无竖线模式。
- 菜单、部门、岗位、字典、参数、通知公告、操作日志、登录日志已完成 Card 列表 UI 替换；各页面原有树形层级、分页、排序、缓存刷新、清空、解锁、详情、弹窗和权限逻辑均保持不变。
- 积分管理的积分规则列表已统一为 `DataListPanel` Card 风格；规则匹配说明位于标题下，底部版本按钮及档位标准说明已按确认稿完成布局和主次配色，按钮仍为未接接口提示。
- 积分规则现支持厂区管理员新增、启停和删除本厂区规则；新增弹窗展示并锁定当前厂区，后端自动填充归属，规则名称为必填。列表已增加厂区列，超级管理员原厂区筛选和选择逻辑保持不变。
- 流程管理下流程监听、流程定义、表单配置、流程表达式的主列表已统一为 `DataListPanel` Card 风格；原筛选、分页、操作、权限、弹窗及流程定义页子表格保持不变。
- 隐患流程配置已完成 `DataListPanel` Card 列表、厂区/等级/状态筛选、分页、新增、修改和删除；列表状态使用绿色/灰色 Tag 展示，超级管理员可选择全部厂区，二级管理员展示并锁定所属厂区。
- 隐患台账单位筛选已按角色分流：超级管理员显示单位下拉并用 `GET /system/dept/factoryList`，非管理员隐藏单位筛选并按 `GET /system/dept/myFactory` 静默过滤本厂区，不再请求非管理员无权限的 `/system/user/deptTree`；`/system/dept/factoryList`、`/system/dept/myFactory` 封装已归位到 `src/api/system/dept.js` 并去重。
- 新增跨业务 `DataListPanel` 公共组件，后续系统管理列表可以直接复用筛选、操作、列表和分页插槽结构。
- 页面布局已改为左侧导航：一级、二级菜单都在左侧。
- Logo 已移动到左侧菜单顶部。
- Header 保留折叠按钮、面包屑、消息、APK 和用户区域。
- 默认使用浅色主题，同时保留布局设置中的明暗主题切换。
- 已处理展开、折叠和移动端 Header 宽度联动。
- 生产构建脚本已加入 Node 22/OpenSSL 3 兼容参数。
- `api.json` 已生成 28 个模块、278 个接口和 32 个模型的本地文档（2026-09-08 重新生成）。
- 登录成功且无指定回跳地址时，默认进入隐患台账 `/hazard/ledger`；根路径也统一重定向至该页面，并以隐藏基础路由保证首次登录时可解析。

## 重点业务页面状态

| 页面 | 文件 | 菜单组件路径 | 当前状态 |
| --- | --- | --- | --- |
| 工作台 | `src/views/workbench/index.vue` | `workbench/index` | 已开发（2026-10-15），待测试。6 项 KPI + 近 7 日趋势柱状图 + 待办与预警表 + 最新上报前 5 条；接口 `analysis/home/overview`、`todo-warning`、`trend-latest`。“平台同步失败”无接口，展示 `—`、重试禁用；风控预警“处理”目标页未开发，禁用 |
| 隐患审核 | `src/views/hazard/audit/index.vue` | `hazard/audit/index` | 已完成隐患详情/附件展示、平台字段补录、通过/驳回/等级切换，并接入 `getProcessDetail` 自动补齐审批 `taskId`；已在左侧菜单隐藏，仅由台账“去审核”等入口携带参数进入 |
| 隐患台账 | `src/views/hazard/ledger/index.vue` | `hazard/ledger/index` | 已完成新版 Card Table、五态筛选/Tag、分页、详情弹窗和审核入口；列表已切换为 `/flowable/hazard/todoList`；单位筛选按角色使用 `factoryList`/`myFactory`；附件九宫格支持大图预览；平台同步列暂时隐藏；同步重试等待后端接口 |
| 积分管理 | `src/views/points/management/index.vue` | `points/management/index` | 已完成积分规则 Tab、统一 Card 列表、厂区列、分页、详情、新增、启停和删除；超管可筛选/选择厂区，厂区管理员可管理本厂区规则。**流水冲正 Tab 已开发（2026-10-15，待测试）**；申诉处理 Tab 已启用（复用独立「申诉台账」页同一组件 `AppealLedgerPanel`）；手动调整 Tab 因 `balance/adjust` 接口定义不完整暂缓 |
| 申诉台账 | `src/views/points/appeal/index.vue` | `points/appeal/index` | 已开发（2026-10-15），待测试。独立页（抄隐患台账 + 审批）：列表 `appeal/todoList`、详情 `appeal/detail/{id}`、审批 `appeal/completeFlow`（taskId 由 `flowable/busiInfo/getProcessDetail` 补全）。待联调确认：completeFlow 的 taskId 来源、改判补分 `adjustPoints` 传参 |
| 安全兑换管理 | `src/views/exchange/security/index.vue` | `exchange/security/index` | 已开发（2026-10-15），待测试。安全校验总开关 + 兑换限额 + 预警与大额审批 + 防刷配置；接口 `exchange/config/*`、`anti/farm/*`。“校验配置”为前端本地一致性校验 |
| 数据分析 | `src/views/analysis/index.vue` | `analysis/index` | 已开发（2026-10-15），待测试。处理时效（按级别）与积分排行（积分/上报/兑换）左右一行；分类/级别分布用 echarts；月度运营报告 + 导出。按甲方要求无隐患热力图、无顶部筛选列；“超期未处理表”无接口未做 |
| 风控与审计 | `src/views/risk/index.vue` | `risk/index` | 部分开发（2026-10-15），待测试。审计日志 Tab 完整（`audit/log/getListByPage`）；风控预警 Tab 提供异常行为检测 / 自报自审检测，**预警列表与处置无接口保留占位** |
| 隐患流程配置 | `src/views/flowable/hazardConfig/index.vue` | `flowable/hazardConfig/index` | 已完成列表、筛选、分页、新增、修改、状态 Tag、删除和厂区权限展示；新增“流程类型”字段（`bizType`，字典 `flow_biz_type`）并在列表以 Tag 展示；分页按真实 `data.list/data.total` 解析 |
| 切换日志 | `src/views/flowable/switchLog/index.vue` | `flowable/switchLog/index` | 空白页面，无明确列表接口 |

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

## 建议开发顺序

1. 隐患审核：需要确认待办/已办筛选参数和审批真实响应。
2. 切换日志：等待后端提供日志列表接口，或确认流程切换已经写入操作审计日志。
3. 积分管理其余 Tab：确认申诉、手动调整和流水冲正的具体范围与请求结构。

## 已知风险和待确认项

### 接口路径

`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. 是否重新登录获取了最新动态路由。