zhongyouweb/docs/development/CURRENT_STATUS.md

当前开发状态

更新时间：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 请求头

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

切换日志缺少接口

仅存在：

POST /flowable/hazard/switchLevel

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

手动积分调整定义不完整

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

分页响应过于宽泛

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

菜单配置状态

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

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