youxinpai-reconciliation

# 优信拍月初对账 用于高性能处理优信拍业务保证金月初对账前的任务触发工作，并在任务完成后执行指定 SQL 查询。 本技能默认只负责触发前置任务、记录执行结果、反馈异常；不默认替代后续人工核对或财务口径确认。 ## 适用场景 当用户有以下意图时使用本技能： - 执行优信拍月初对账 - 推送某月保证金数据 - 跑优信拍保证金对账前置任务 - 检查优信拍对账依赖任务是否已触发 ## 前置条件 - 已存在可复用的登录态 - 可以访问星河任务页 `https://dp.58corp.com/data-develop/task-list` - 可以访问 SQL 页面 `https://dp.58corp.com/data-query?doc_ids=530490` - 当前目标是触发任务，而不是直接输出最终财务对账结论 - 可以访问本地工程 `/Users/a58/Desktop/code/yxp_oms_web` 如果登录失效、页面无法打开、没有权限访问，立即停止并汇报，不要自行猜测下一步。 ## 任务列表 下面 5 个任务互不依赖，可并行处理： 1. `raw_auction_guafundaccountdetail_all_d` 2. `raw_auction_auctionguafundbill_all_h` 3. `raw_auction_guarantee_withdraw_apply_all_d` 4. `ods_auction_refund_order_all_d` 5. `raw_auction_payment_order2_all_d` ## 执行原则 - 必须先完成本地单测前置步骤，再进入页面任务步骤 - 上月时间区间只计算一次，后续步骤复用同一组时间变量 - 搜索框优先使用 `placeholder="搜索任务名"` 对应的 input - 搜索出结果后，先定位“包含当前任务名的结果行”，后续所有查找都只在当前结果行内完成 - 开启状态优先使用 `<span class="ant-switch-inner">开启</span>` 判断 - 运行按钮优先使用当前结果行内的 `span.iconzanting2.iconfont` - 确认按钮优先使用 `button.ant-btn.ant-btn-primary`，并校验按钮文本包含“确定” - 除搜索框外，不要在整个页面范围内重复查找“开启”“运行”“确定” - 每个任务都要单独搜索，不要假设上一次搜索结果仍然有效 - 如果同一个任务搜索结果中有多个“开启/可运行”的实例，需要逐个触发，直到当前搜索结果中的可运行实例全部处理完成 - 每完成一个任务，都要记录结果，避免最后无法说明哪些已执行、哪些失败 - 5 个任务没有先后依赖；仅在支持独立会话时并行，否则自动降级为串行 - 不要因为某个任务先完成就提前结束；只有 `任务列表` 中 5 个任务都被检查并记录状态后，才允许结束本技能 - 页面任务全部完成后，必须继续执行 SQL 步骤：修改时间条件并点击运行 - 步骤5必须在前面所有步骤完成后额外等待 10 分钟才能触发 ## 高性能策略 - 本技能目标是“快速触发任务”，不是等待任务实际执行完成 - 每个任务只做一次搜索输入，不要反复清空、反复全页分析 - 搜索后只等待结果区变化，不做长时间固定等待 - 点击“运行”后只等待确认弹窗出现，不重新扫描任务列表 - 点击“确定”后只确认弹窗关闭或按钮状态变化，不等待任务跑完 - 并行场景下，单任务执行单元只关注自己任务的全量实例；不要等待其他任务完成 - 记录结果时使用最简表格或简短状态，不在执行过程中生成长段说明 ## 本地前置步骤（必须先完成） 在执行页面任务前，先执行下面流程： 1. 计算并保存统一时间变量： - `monthStart` = 上个月第一天 `00:00:00` - `monthEnd` = 上个月最后一天 `23:59:59` 2. 检查配置文件 `/Users/a58/Desktop/code/yxp_oms_web/src/test/resources/config/scf.config` 中 `yxpbuyerservice` 的 `host`，并记录原值到 `originalBuyerServiceHost` 3. 如果 `host` 不是 `10.192.12.236`，先修改为 `10.192.12.236` 4. 打开 `/Users/a58/Desktop/code/yxp_oms_web/src/test/java/com/bj58/che/yxp/oms/web/remote/GuaranteeFeeRemoteServiceTest.java` 5. 在 `testFindUnmatchedBillIds` 中，将两个时间参数改为 `monthStart` 和 `monthEnd` 对应值 6. 只执行 `testFindUnmatchedBillIds` 这个单测函数 7. 单测成功后，进入等待步骤；单测失败则停止整个流程并汇报 ## 固定选择器顺序 按下面顺序查找元素，前一个成功就不要继续尝试更慢的方式： 1. 搜索框：`input[placeholder="搜索任务名"]` 2. 结果行：包含当前任务名文本的结果行 3. 开启状态：当前结果行内的 `span.ant-switch-inner` 4. 运行按钮：当前结果行内的 `span.iconzanting2.iconfont` 5. 确认按钮：`button.ant-btn.ant-btn-primary` 6. 只有在上述方式失败时，才退回到基于按钮文案或页面语义的兜底判断 ## 执行状态提示规范 在关键阶段必须输出状态提示，让使用者可见当前进度。至少包含： 1. 当前步骤编号与名称 2. 当前状态（开始/执行中/等待中/等待结束/完成/中断） 3. 下一个动作 提示要求： - 进入每个步骤时，先提示“开始执行步骤X” - 遇到等待步骤时，必须提示“开始等待”与“等待剩余时间” - 等待结束后，必须提示“等待结束，继续执行下一步骤” - 发生中断时，必须提示“中断原因 + 当前步骤 + 建议下一步” ## 执行清单 开始执行前，先在内部维护下面这份进度清单，并在每处理完一个任务后立即更新： ```markdown 任务执行清单 - [ ] raw_auction_guafundaccountdetail_all_d - [ ] raw_auction_auctionguafundbill_all_h - [ ] raw_auction_guarantee_withdraw_apply_all_d - [ ] ods_auction_refund_order_all_d - [ ] raw_auction_payment_order2_all_d ``` 勾选规则： - 只要当前任务已经完成“搜索、检查、触发或确认无法触发、记录结果”这一整套动作，才能勾选 - “勾选”不等于“成功触发”，也可以表示“已检查但失败，且已记录原因” - 如果清单里还有未勾选项，不要结束，不要汇总，不要告诉用户“已完成” ## 执行流程 ### 步骤0：执行本地单测前置步骤 按 `本地前置步骤（必须先完成）` 小节逐项执行。 ### 步骤1：等待 5 分钟 - 步骤0成功结束后，立即开始计时 5 分钟 - 5 分钟未到，不得进入后续页面任务步骤 - 如果等待阶段出现环境异常，停止流程并汇报 状态提示模板： - 开始等待：`[步骤1] 已开始等待5分钟（单测后冷却期），当前状态：等待中` - 等待中：`[步骤1] 等待中，剩余 X 分 Y 秒，完成后将进入步骤2` - 等待结束：`[步骤1] 等待结束，当前状态：完成，继续执行步骤2` ### 步骤2：进入任务页 - 复用现有登录态打开星河任务页 - 确认页面已正常加载，且可以看到任务搜索区域 - 优先确认 `input[placeholder="搜索任务名"]` 存在；存在即视为页面可操作 ### 步骤3：并行处理 5 个任务（可降级串行） 1. 先判断是否可创建独立会话： - 可创建独立会话：并行执行 5 个任务 - 不可创建独立会话：改为串行逐个执行 5 个任务 2. 并行模式下，为 `任务列表` 中每个任务启动独立执行单元；串行模式下单线程逐个处理 3. 每个执行单元仅处理自己的任务名，避免互相覆盖搜索条件 4. 在各自单元中执行：搜索任务名 -> 定位匹配行 -> 判断“开启” -> 点击“运行” -> 弹窗点“确定” 5. 每个执行单元持续处理本任务的全部可运行实例，直到本任务完成 6. 每个执行单元完成后立刻记录结果并更新 `任务执行清单` 7. 等待全部 5 个任务处理结束后，再统一汇总结果 ### 步骤3.1：单任务最短路径 每个任务都遵循下面的最短路径，不要额外扩展步骤： 1. 搜索任务名 2. 找到对应结果行 3. 判断是否“开启” 4. 点击“运行” 5. 点击“确定” 6. 记录结果 7. 进入下一个实例；当前任务完成后结束该单元 禁止出现以下低效行为： - 将 5 个任务强制串行排队执行 - 搜索一次后反复全页查找按钮 - 每点击一次都重新理解整个页面结构 - 点击“确定”后长时间等待任务跑完 - 在全部任务未完成前提前汇总 ### 步骤4：处理异常 出现以下情况时，停止当前任务并明确汇报： - 本地配置修改失败 - 单测执行失败 - 步骤1等待未完成就进入后续步骤 - 步骤5触发前 10 分钟等待未完成就执行 SQL - 并行执行环境不可用但未降级为串行 - 搜索不到任务 - 页面没有可操作的“运行”入口 - 点击后没有出现确认弹窗 - 弹窗确认失败 - SQL 页面不可访问 - SQL 执行失败 - 页面报错、权限异常、登录失效 异常处理规则： - 如果步骤0的配置检查/修改或单测失败，停止整个流程，不进入步骤1之后的页面任务 - 步骤1的 5 分钟等待未完成前，禁止开始步骤2和步骤3 - 前面步骤完成后未满足额外 10 分钟等待，禁止触发步骤5 - 并行能力不可用时必须降级串行，不得直接跳过任务 - 如果是“当前任务级别”的异常，记录原因并结束该任务单元，其他并行任务继续执行 - 如果 SQL 步骤失败，停止流程并汇报，不输出“执行完成” - 如果是“页面整体不可继续操作”的异常，例如登录失效、页面崩溃、权限缺失，则停止整个流程并汇报 - 不要在异常状态下自行跳过并假设成功 - 如果只是 class 选择器短暂失效，先在当前结果行内用文本语义做一次兜底，不要立刻回退到全页面扫描 ### 步骤5：执行 SQL 并运行 在步骤0-步骤3全部完成后，先额外等待 10 分钟，再执行以下流程： 1. 打开 `https://dp.58corp.com/data-query?doc_ids=530490` 2. 定位 SQL 编辑器（包含 `t1.BillCreateTime` 和 `t3.pay_time` 的查询语句） 3. 将 SQL 里 `t1.BillCreateTime` 和 `t3.pay_time` 的时间范围统一改为 `monthStart` 和 `monthEnd` 4. 校验两处时间都已替换完成，再点击“运行” 5. 等待 SQL 执行结果状态返回（成功/完成），并确认无报错提示 6. 记录 SQL 执行结果（成功/失败、失败原因） 执行限制： - 不得只改其中一个字段，`t1.BillCreateTime` 与 `t3.pay_time` 必须同时改 - 10 分钟等待未完成前，不得进入本步骤 - SQL 未修改完成前，不得点击“运行” - 如果 SQL 页面不可访问或运行失败，停止流程并汇报 状态提示模板： - 开始等待：`[步骤5] 已开始等待10分钟（SQL触发前冷却期），当前状态：等待中` - 等待中：`[步骤5] 等待中，剩余 X 分 Y 秒，完成后将修改SQL并运行` - 等待结束：`[步骤5] 等待结束，当前状态：执行中，开始修改 t1.BillCreateTime 与 t3.pay_time` - SQL运行成功：`[步骤5] SQL已运行成功，当前状态：完成，继续执行步骤6` ### 步骤6：恢复本地配置（如有改动） 1. 检查 `originalBuyerServiceHost` 与当前 `yxpbuyerservice.host` 是否一致 2. 如果步骤0中修改过 host，则将 `yxpbuyerservice.host` 恢复为 `originalBuyerServiceHost` 3. 记录恢复结果（成功/失败）；恢复失败需要明确汇报并提示人工处理 ## 结果记录要求 执行过程中，至少记录以下信息： - 本地配置检查结果（`yxpbuyerservice.host` 是否已修正） - 本地配置原值（`originalBuyerServiceHost`） - 单测时间参数（上个月开始/结束） - 单测执行结果 - 5 分钟等待是否完成 - 步骤5触发前 10 分钟等待是否完成 - 任务执行模式（并行/串行降级） - 任务名 - 是否找到任务 - 是否成功触发 - 如果有多个实例，触发了几个 - 异常原因 - SQL 时间参数修改结果（`t1.BillCreateTime`、`t3.pay_time`） - SQL 运行结果 - 本地配置恢复结果 建议按下面格式维护结果表： ```markdown 任务结果表 | 任务名 | 是否找到 | 是否触发 | 触发实例数 | 备注 | | --- | --- | --- | --- | --- | | raw_auction_guafundaccountdetail_all_d | 是 | 是 | 2 | 全部已触发 | | raw_auction_auctionguafundbill_all_h | 是 | 否 | 0 | 无可运行实例 | ``` ## 完成判定 只有同时满足以下条件，才可以输出“执行完成”： 1. 步骤0已完成（配置检查/修正 + 单测执行成功） 2. 步骤1已完成（等待 5 分钟） 3. `任务执行清单` 中 5 个任务都已勾选 4. `任务结果表` 中 5 个任务都有对应记录 5. 已明确区分哪些任务“成功触发”、哪些任务“检查完成但未触发” 6. 步骤5触发前额外等待 10 分钟已完成 7. 步骤5已完成（SQL 时间已更新并点击运行成功） 8. 步骤6已完成（配置已恢复或确认无需恢复） 如果不满足以上条件，只能输出“执行中断”或“部分完成”，不能输出“已完成”。 ## 输出格式 完成后按下面格式输出结果： ```markdown 优信拍月初对账前置任务执行结果 - 执行页面：星河任务页 - 已成功触发： - 任务A - 任务B - 未成功触发： - 任务C：原因 - 需要人工关注： - 是否存在权限/登录/页面异常 - 是否可以继续进入下一步对账 ``` ## 注意事项 - 本技能的目标是“触发并汇报”，不是“静默执行” - 本地单测前置步骤属于强门槛，未完成前不得进入页面任务步骤 - 如果页面元素与预期不一致，应先在当前结果行范围内做兜底判断，不要立刻扩大到全页面 - 如果用户明确要求继续产出对账结果，先完成本技能中的任务触发，再进入后续数据核对流程 - 整个执行过程中，优先级始终是：固定选择器 > 当前结果行局部查找 > 文案兜底 > 全页面语义分析 - 所有页面任务完成后，必须执行 SQL 修改与运行步骤，不得省略 - 默认优先并行；并行条件不满足时必须串行降级，不得跳过任务 - 若步骤0中修改过本地配置，流程结束必须恢复原值