zhongyouweb/docs/development/CURRENT_STATUS.md

当前开发状态

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

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

切换日志缺少接口

仅存在：

POST /flowable/hazard/switchLevel

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

手动积分调整定义不完整

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

分页响应过于宽泛

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

菜单配置状态

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

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