forge_admin/code-copilot/changes/定时任务开放API/execution-log.md

定时任务开放 API 执行记录

version: V7 status: complete baseline-created: 2026-07-20

2026-07-20 实施启动

• 变更范围：V7 Spec、实施任务和增量测试基线。
• 结果：三个安全门禁已确认，spec.md 已切换为 apply，tasks.md 已修正为 V7。
• 基线：复用 V6 Job 106/106、前端 18/18、Admin Reactor 42/42 成功记录。
• 警告：工作区包含 V1-V6 未提交改动，本阶段仅叠加 V7，不回退、不重写历史成果。
• 服务：本轮尚未启动 MySQL、Redis、Admin、Quartz 或 Vite。

2026-07-20 V7 实施完成

• 数据库：新增 V1.0.46__add_job_open_api_credentials.sql，创建 Token 和幂等表、逻辑删除生成列唯一键、Scope/状态字典、细粒度权限资源及隐藏路由；业务内置数据使用 tenant_id=1 和防重复写入。
• 后端：新增专用 Bearer Token 认证、HMAC Hash、Scope/资源交集授权、Redisson 限流与幂等锁、预留执行 ID 和真实 HTTP 错误边界；Redis 故障失败关闭，Quartz 复用预留日志推进执行生命周期。
• 安全：数据库不保存明文 Token 或原始幂等键；创建和轮换只在一次性加密响应返回 Token，审计不保存响应正文；开放响应只投影任务和执行摘要。
• 前端：新增 Token 管理工作台，支持分页筛选、创建、吊销、轮换、资源选项、字典 Scope 和一次性 Token 复制；关闭弹窗后清除明文状态，入口和操作按权限裁剪。

2026-07-20 自动化验证

• Java 17：mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-job -am test，Job 137/137 通过，0 failure、0 error、0 skipped，Reactor BUILD SUCCESS。Quartz 测试中的预期异常日志来自故障分支断言，不是测试失败。
• Java 17：mvn -pl forge-admin-server -am package -DskipTests，Admin Reactor 42/42 模块成功，BUILD SUCCESS，生成 forge-admin-server.jar；既有 EmployeeServiceImpl deprecated API 提示不阻断。
• Node 20.19.0：pnpm test，57 个测试文件、463/463 通过，V7 job-api-token.test.js 为 3/3。流程设计器组件 stub 和 Sass legacy API 警告不阻断。
• Node 20.19.0：V7 目标 pnpm exec eslint 无输出通过。
• Node 20.19.0：NODE_OPTIONS=--max-old-space-size=8192 pnpm build 通过，8721 个模块完成转换，生成 job-api-token 产物；保留仓库既有组件命名冲突、动态/静态导入、CSS 注释和大包体提示。
• 静态检查：rg -n '\$\{[^}]+\}' forge-server/db/migration 无输出；四个 Job Mapper XML 通过 xmllint --noout；V1.0.46 版本唯一；敏感字段扫描未发现明文 Token 持久化或开放响应泄露；git diff --check 通过。
• 服务清理：本轮未启动 MySQL、Redis、Admin、Quartz、Vite 或其它常驻服务，无需清理端口或 PID。
• 用户侧验收：真实 Flyway、Bearer 请求、Redis 并发竞争和 Quartz 端到端执行按既有分工由开发环境验证，本轮不将这些未执行项表述为已通过。

2026-07-21 V8 调用示例实施启动

• 变更范围：服务账号工作台常驻调用说明、一次性 Token 弹窗 Scope 感知 cURL、示例生成单元测试。
• 复用基线：V7 前端 463/463、目标 Token helper 3/3、生产构建通过。
• 不变范围：开放 API 后端协议、认证、限流、幂等、数据库和权限资源不变。
• 环境：本轮不启动 Admin、MySQL、Redis、Quartz 或 Vite 常驻服务。

2026-07-21 V8 调用示例实施完成

• 前端：服务账号工作台增加常驻“调用说明”按钮；创建和轮换成功弹窗复用同一说明组件，并按当前 Scope 裁剪查询任务、触发任务和查询执行结果示例。
• 安全：实际 Token 只进入既有 issuedToken 一次性内存状态，示例不写浏览器存储或日志；关闭弹窗后继续由 clearIssuedToken() 清理。常驻说明使用 ${TOKEN} 环境变量占位并提示从 Secret/环境变量读取。
• 协议：触发 cURL 带 Authorization: Bearer、${JOB_ID} 和 Idempotency-Key: $(uuidgen)；服务地址可编辑并自动去除末尾 /。
• TDD：新增用例首次执行得到 2 failed / 3 passed，失败原因为 buildJobOpenApiExamples is not a function；实现后两个目标测试文件最终 2/2、7/7 通过。
• ESLint：Node 20.19.0 下对六个目标文件执行 ESLint，无输出通过。
• 构建：Node 20.19.0 下执行 NODE_OPTIONS=--max-old-space-size=8192 pnpm build，8725 个模块完成转换，BUILD 成功并生成 job-api-token 产物。
• 警告：保留仓库既有组件命名冲突、动态/静态导入、CSS // 注释和大包体提示，均不由本轮引入且不阻断。
• 静态检查：目标生成命令人工输出核对通过；敏感信息扫描无命中；git diff --check 及新增文件逐项空白检查无输出。
• 服务清理：本轮未启动 Admin、MySQL、Redis、Quartz、Vite 或其它常驻服务，无需清理端口或 PID。