forge_admin/code-copilot/changes/h5-mobile-workbench-refactor/execution-log.md

执行记录

2026-07-28 — 基线

• 范围：创建 H5 移动工作台与待办闭环重构的 Spec、任务与验证计划。
• 发现：工作区已有 .DS_Store、forge-h5-ui/src/manifest.json、锁文件及输出文档等未提交变更；本变更不会覆盖它们。
• 服务：未启动任何服务。

2026-07-28 — 实现与静态验证

• 变更：收敛全局主题、按钮、页面壳、弹层、搜索与底部导航；登录/首页/消息/我的页移除装饰性动画与多色玻璃效果；首页改用真实待办摘要；待办增加状态/分类筛选、签收和独立详情页。
• 待办安全边界：详情按 TaskFormInfo 处理同意、驳回、退回、终结、转办、必填意见和表单字段；要求签名、外部表单、仅 PC 的代码表单及不支持的动态字段配置均失败关闭，禁止跳过表单直接提交。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.。
• 警告：当前 shell 的 nvm 将 v20.19.0 解析为 N/A，但命令仍以当前 Node 工具链完成构建；未安装依赖、未启动服务。
• 静态检查：git diff --check 通过，无空白错误。
• 跳过：未启动真实 Flow/Admin 服务，未执行会改变流程运行态的 E2E；需由用户环境按 test-spec.md 回填。

2026-07-28 — 最终增量验证

• 变更：补齐共享 AiLayoutPage 的简约导航/底栏与带文字的三项底部导航；待办补充流程分类筛选，并收紧动态表单字段类型的失败关闭规则。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；同样存在 nvm N/A 警告但未阻断实际构建。
• 静态检查：git diff --check 通过；新增 pages/todo-detail.vue 使用 git diff --no-index --check 检查通过。

2026-07-28 — 待办交互与可读性修正

• 变更：删除“我的”页重复的快捷卡片；重绘底部导航为简洁图标/文字导航；修正首页、消息页的白底文字与刷新图标对比度。
• 待办：移除旧底部审批弹层，改为紧凑任务列表；候选任务先签收，已签收任务进入详情处理；详情页仅显示当前关键操作，其余操作归入“更多”。
• 路由：消息中心在有 taskId 时直达详情页，无 taskId 时切换到待办 tab；兼容消息配置中的 /pages/todo?taskId=...，不再对 tab 页调用 navigateTo。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm N/A 警告仍存在但不阻断构建。
• 静态检查：git diff --check 通过；重写后的 pages/todo.vue 使用 git diff --no-index --check 检查通过。

2026-07-28 — 待办入口最终核对

• 修正：首页后端菜单若映射到 /pages/todo，改用 switchTab，避免 tab 页被 navigateTo 误判为“页面未注册”。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；git diff --check 通过。
• 文案扫描：H5 源码中不存在“移动端待办页暂未接入”或“待办页面未注册”。

2026-07-28 — 消息可读性与首页优先事项收敛

• 变更：消息详情移除“关联业务”内部标识块，不再展示 FLOW_TODO、业务键或 UUID；保留“查看业务”作为唯一的业务跳转入口。消息页移除大号未读统计卡，筛选改为宽触达标签与独立“全部标为已读”操作。
• 首页：删除 feature-inner 里的菜单、权限、同步等技术计数，工作台改为“优先处理”两条业务行动项（待处理任务、消息提醒）；底栏取消顶部短横与悬浮卡式表现，改为带安全区的三项图标/文字导航。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 仍提示 N/A 未安装，但未阻断当前 Node 工具链构建。
• 静态检查：git diff --check -- forge-h5-ui/src/components/AiTabBar.vue forge-h5-ui/src/pages/index/index.vue forge-h5-ui/src/pages/message/index.vue 通过；源码扫描未发现待办页未接入文案，也未发现消息页关联业务标识渲染。
• 跳过：未启动真实 Flow/Admin 服务、未执行会改变流程运行态的 E2E；消息数据与真实任务跳转由用户环境按 test-spec.md 回填。

2026-07-28 — 共享控件紧凑化与真实资料展示

• 变更：AiSearchBar 调整为 68rpx 高度，AiField 调整为 80rpx 高度；二者改用实体白底、清晰边框和三态焦点/错误反馈，移除模糊与弱边界效果。
• 页面：消息列表的审批提醒卡片改为 58rpx 图标、单行摘要的紧凑卡片；首页优先处理项压缩为 98rpx 行高。快捷入口不再注入“组件演示”。
• 资料：个人页删除顶部账号/手机/权限统计；安全中心的账号、手机、邮箱仅在后端有实际值时显示，不再以 - 作为联系方式占位。
• 导航：底栏选中项升级为单色图标底板与浅蓝边界，保持三项导航和安全区，同时避免普通的纯文本/短横表现。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 仍提示 N/A 未安装，但未阻断实际构建。
• 跳过：未启动真实服务与浏览器 E2E；后端联系方式字段和真实消息数据由用户环境按 test-spec.md 进行页面验收。

2026-07-28 — 快捷入口注册校验与胶囊导航回退

• 变更：首页恢复固定“组件演示”入口，flattenMenus 与全部应用菜单仅保留 pages.json 已注册的 H5 路由；未注册的“联系方式”等后端菜单不会再显示为可点击卡片，因此不会触发“页面未注册”。
• 视觉：AiTabBar 回退为原有浮动胶囊导航，保留三项任务导航；workbench-panel 移除辅助说明并缩短刷新按钮、图标、行高和内边距，进一步降低首屏占用。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 仍提示 N/A 未安装，但未阻断实际构建。
• 跳过：未启动真实服务与浏览器 E2E；用户环境需确认后端菜单路径与 pages.json 注册路由一致。

2026-07-28 — 待办列表统一与查询骨架屏

• 变更：新增共享 AiListSkeleton，使用低对比度静态占位和仅加载期间的轻微透明度反馈；消息、待办、通用 AiPagingPage、转办人员和租户切换列表均接入首次查询骨架屏。
• 待办：改用 AiSearchBar，将页面收敛为与消息页一致的标题、搜索、横向筛选和白底边框卡片层级；首页 priority-item 保持仅两条、84rpx 行高的紧凑工作入口。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 仍提示 N/A 未安装，但未阻断实际构建。
• 跳过：未启动真实服务及浏览器 E2E；骨架屏的网络节流、真实待办和转办人员数据需要由用户环境按 test-spec.md 回填。

2026-07-28 — 首页处理中心重新设计

• 变更：移除旧 priority-item 行项目，首页处理区改为两张明确的行动卡（待办、消息）。卡片只呈现可执行的数量、当前状态和对应入口，不再沿用缩小后的列表行布局。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；git diff --check -- forge-h5-ui/src/pages/index/index.vue 通过。

2026-07-28 — 后端菜单保留与全部应用重构

• 变更：恢复所有后端授权的 H5 菜单展示；例如 /pages/test 的“联系方式”保留在首页和全部应用中。若专属 H5 页面未编译，统一跳转到新增的 pages/app-entry 承接页，避免“页面未注册”且不隐藏正式菜单。
• 全部应用：移除左侧分类栏与三列小方格，改为按业务模块纵向分组、双列行动卡与单一搜索入口；最新提醒在无后端数据时仅展示空状态，不再注入默认系统消息。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 提示 N/A 未安装，但未阻断实际构建。

2026-07-28 — 公共空状态图片化

• 变更：公共 AiEmpty 改用用户提供的 src/static/images/no-data.png，去除灰色图标框；消息空状态移除无意义的刷新按钮，保留标题与筛选结果说明。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；git diff --check -- forge-h5-ui/src/components/AiEmpty.vue forge-h5-ui/src/pages/message/index.vue 通过。

2026-07-28 — Sa-Token Redis 配置统一

• 变更：按部署要求，将 Admin、App、Flow、Report 服务中 sa-token.alone-redis.database 的显式值由 1 统一为 0。
• 静态检查：全仓 YAML/Properties 扫描未发现遗留 database: 1；git diff --check 通过。
• 跳过：本轮仅修改运行时配置，未启动服务或执行登录/待办接口；生产环境需重启相关服务并重新登录后验证。

2026-07-28 — 待办列表与详情信息补齐

• 列表：重做 /pages/todo 的待办卡片，展示与 PC 一致的当前节点、申请人、流程分类、提交时间和流程名称；名称、分类、状态三项查询条件保留，流程分类改为公共 AiSelect。
• 详情：公共 AiTabs 调整为小圆角胶囊样式并接入待办详情；补充发起部门、流程分类等基础信息。节点没有配置字段时，改从真实业务记录补只读字段，并展示已配置的业务明细；移除“该节点没有需要展示的业务字段”提示。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 仍提示 N/A，未阻断当前 Node 环境构建。
• 静态检查：待办相关已跟踪文件 git diff --check 通过；构建确认新增详情页模板可编译。

2026-07-28 — 待办详情紧凑化与分类选择修复

• 详情：顶部导航背景跟随页面底色；加载任务时显示列表骨架屏；底部审批按钮改为 sm 尺寸并收紧操作栏安全区内边距；紧急优先级标识由红色改为琥珀色。
• 分类：公共 AiSelect 不再依赖未注册的 uni-popup，改为复用 AiPopupSheet；点击“全部流程”可打开分类列表，选择后立即更新筛选结果。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm use 的 N/A 提示未影响实际构建。

2026-07-28 — H5/Flow Token 活跃状态一致性修复

• 根因：H5 登录按 sys_client.token_activity_timeout=-1 修改 App 进程内的 Sa-Token 全局配置；Flow 独立进程仍按自身全局活跃超时校验同一 Token，找不到 last-active 记录时返回 TOKEN_FREEZE（token 已被冻结）。这与账号封禁、Nginx 代理和 Redis database 无关。
• 变更：启用 Sa-Token 的动态活跃超时，将客户端的 token 总超时与活跃超时写入每枚 Token 的登录模型；不再在单次登录时修改进程级全局超时配置。Flow 和 App 随后从共享 Redis 的同一 last-active 记录读取配置。
• 命令：JAVA_HOME=/Users/yaominliang/Library/Java/JavaVirtualMachines/ms-17.0.19/Contents/Home PATH=/Users/yaominliang/Library/Java/JavaVirtualMachines/ms-17.0.19/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-system -am compile -DskipTests
• 结果：通过，Reactor 25 个模块均为 BUILD SUCCESS。
• 静态检查：git diff --check 通过。
• 跳过：未连接生产 Redis，未启动 App/Flow 服务验证真实登录和待办接口；部署含 forge-starter-auth 与 forge-plugin-system 的新构件后，需要重启 App 与 Flow 并重新登录验证。

2026-07-28 — H5 待办表单与 PC 字段对齐

• 根因：H5 待办详情将 business-code 表单无条件标记为“请在 PC 端处理”，而 PC 使用 FlowBusinessForm 动态加载 PC Vue 组件。采购申请等代码表单实际已由后端 BusinessTaskFormContextVO 返回字段、记录数据和节点级读写权限，因此不应被拦截。
• 变更：H5 直接依据后端字段上下文渲染业务代码表单，执行可见、只读和必填规则；新增选择、单选、日期、只读附件展示。动态表单不再仅因选择/日期字段而被拒绝。无移动端字段描述的 PC 私有外部组件，以及 H5 尚未支持的可编辑字段，仍失败关闭，禁止绕过表单直接流转。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm 仍显示 N/A，未阻断当前 Node 工具链构建。
• 跳过：未启动真实 App/Flow 服务，需以采购申请待办验证字段权限、暂存和审批提交流程。

2026-07-28 — 待办分类弹层与 PC 表单动作对齐

• 变更：流程分类选择器从横向 scroll-view 内移至页面根部弹层，避免 H5 固定定位层被滚动容器裁剪或拦截点击；选择、遮罩和关闭按钮均由页面状态控制。
• 表单：待办详情改为先仅凭 taskId 请求 /ai/business/flow/task-form-context，与 PC 端一致。业务对象/代码表单直接渲染后端返回的字段、记录值与节点读写权限，不再依赖普通 TaskFormInfo 携带业务标识。
• 动作：同意/驳回在业务表单场景使用 /ai/business/flow/task-action；转办、退回、终结保留 Flow 接口，转办参数与 PC 端保持 taskId/userId/targetUserId/comment 一致。业务表单增加“暂存修改”。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；当前 nvm 仍提示 N/A，但未阻断实际构建。
• 静态检查：git diff --check -- forge-h5-ui/src/pages/todo.vue forge-h5-ui/src/pages/todo-detail.vue 通过。
• 跳过：未启动真实 App/Flow 服务、未执行会修改任务状态的 E2E；需以采购申请待办验证分类弹层、字段渲染、暂存、同意/驳回、转办、退回和终结。

2026-07-28 — 业务表单代理与转办交互修正

• 根因：/ai/business/flow/task-form-context 被 Vite 的通用 App 代理转发到 8583；该服务未引入 generator 的 BusinessFlowController，所以返回 404。Flow 服务 8081 已引入 generator，才是该接口的实际宿主。
• 变更：开发代理新增 /dev-api/ai/business/flow/** -> Flow 8081，并置于通用 App 代理前。待办操作栏把“更多”调整到前位并复用次要按钮样式；转办弹层增加清晰的选择态、已选人员回显、确认按钮禁用态与紧凑成员行。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；nvm 的 N/A 提示未阻断构建。
• 静态检查：git diff --check -- forge-h5-ui/vite.config.js forge-h5-ui/src/pages/todo-detail.vue 通过。
• 部署注意：生产 Nginx 必须将 /forge-h5-api/ai/business/flow/ 在通用 /forge-h5-api/ 前代理到 8081；本轮未改动远端 Nginx。

2026-07-29 — 移动端流程闭环补齐

• 变更：待办工作台增加“待处理 / 已处理 / 我发起的”三个 Flow 真实列表入口；已办与我发起详情使用只读业务表单上下文，并展示审批历史和 Flow 返回的节点进度；运行中的我发起流程可调用既有撤回接口。
• 表单：新增 AiSignaturePad 和 AiFileUpload。要求签名的节点会采集笔迹、上传 /api/file/upload 后以文件标识提交；可写附件字段同样上传并只向业务表单提交文件标识。日期时间、选择项无选项和未知可写字段均继续遵循“无法安全渲染即阻断”的原则。
• 转办：转办弹层独立维护转办说明、签名与成员分页检索，选择态可见，并过滤当前用户和当前办理人。
• 命令：source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-h5-ui build:h5
• 结果：通过，uni-app 输出 DONE Build complete.；shell 仍把 v20.19.0 显示为 N/A，但未阻断当前 Node 工具链完成构建。
• 静态检查：git diff --check -- forge-h5-ui/src/api/index.js forge-h5-ui/src/pages/todo.vue forge-h5-ui/src/pages/todo-detail.vue forge-h5-ui/src/components/AiFileUpload.vue forge-h5-ui/src/components/AiSignaturePad.vue code-copilot/changes/h5-mobile-workbench-refactor 通过。
• 跳过：未启动真实 App/Flow/文件服务，未执行会变更审批状态的 E2E。需要用户环境按 test-spec.md 对签名、附件、转办、已办及撤回进行回填验收。

2026-07-29 — 业务代码表单空白兜底

• 根因：实际 task-form-context 响应的顶层 fields 为空，字段元数据位于 formRef.fields；同时返回 代码表单Provider未注册: samplePurchaseOrder，因此 recordData 与节点过滤后的 fieldPermissions 也为空。
• 变更：H5 兼容从 formRef.fields / fieldCatalog 读取字段，避免“业务内容”整块空白。Provider 未注册时，字段强制只读并明确提示服务端缺少 Provider，禁止依据未过滤的通用字段元数据开放编辑或办理。
• 后续：Flow 服务需加载 samplePurchaseOrder 的 BusinessCodeFormProvider Bean，才能返回真实单据数据和节点级字段权限；这属于服务装配/部署修复，H5 不应伪造该数据。

2026-07-29 — 动态表单字段标签修正

• 现象：页面 DOM 出现 project Name 而不是配置中的 项目名称。这表示页面退回了变量键名自动拆词，而没有命中动态表单字段架构。
• 变更：字段归一化兼容 fields、fieldCatalog、formRef.fields、form.fields 与 rule；动态表单优先从 formJson、再从任务 fields/formRef/fieldCatalog 取架构。因此展示优先使用字段的 label，例如 项目名称。
• 验证：受当前执行环境命令进程被系统以 137 终止影响，未能在本次微调后重跑构建；上一轮 H5 构建已通过，需在可用 Node 环境重跑 pnpm --dir forge-h5-ui build:h5。

2026-07-29 — 移除原始业务键名兜底

• 现象：field-list 将 recordData/variables 的原始键名自动拆词后展示，如 project Name、warehouse Id，并暴露业务主键和以分存储的金额字段。这属于开发排障兜底，不是用户界面。
• 变更：删除原始对象键名的字段回退；页面仅根据已返回的表单架构展示标签和值。架构不可用时显示受控说明，不再显示内部 ID、字段编码或技术值。表单 JSON 同时支持双重 JSON 编码解析。

2026-07-29 — 流程动作失败可见化

• 现象：审批、驳回等请求在后端返回 500 时，H5 仅写浏览器控制台，用户看不到服务端的 message。
• 变更：待办详情统一提取 data.message、response.data.message、error.data.message 等错误结构，并在审批、签收、转办人员加载、暂存等失败路径显示 toast。
• 说明：数据访问异常，请联系管理员 是后端已经归一化后的 500 文案；H5 现在会如实展示，具体 SQL/Mapper 根因仍需要从对应 Flow 服务日志定位。