财务台账：新增不保留账户处理待办 #444

shanshi · 2026-10-21T17:59:16+08:00

shanshi commented

2026-10-21 17:59:16 +08:00

任务占用与边界

任务名称：不保留账户处理待办
实际开发者：shanshi
任务来源/团队分工：用户要求在账户总表增加不保留账户数量入口，并新增独立处理待办页面
目标结果：账户是否保留为“否”的账户自动进入独立清单；提供与账户异常待办一致的筛选、排序、固定表头、列宽调整、AJAX 翻页、编辑保存和权限控制
预计修改路径：app/Http/Controllers/Business/FinanceLedger.php、app/Utilities/FinanceLedgerAccountShouldKeep.php、database/migrations/2026_10_21_170000_create_finance_ledger_account_keep_todos.php、modules/EcommerceFinance/View/FinanceLedgerPageData.php、resources/views/business/pages/financial-ledger/ledger.blade.php、resources/views/business/pages/financial-ledger/unretained-account-tasks.blade.php、routes/admin.php、tests/Feature/Business/FinanceLedgerAccountKeepTodoTest.php
将写入的公共契约：business.financial-ledger.unretained-accounts、business.financial-ledger.accounts.keep-todo、fin_account_keep_todos、unretainedAccountTasks、updateAccountKeepTodo
仅复用、不修改的公共契约：fin_accounts、fin_account_statuses、fin_account_type_overrides、FinanceLedgerAccess、现有黑金设计令牌
数据源、表/视图和字段：business_mirror.fin_accounts 的 account_should_keep/company_plan 及账户字段；关联状态与类型覆盖；新增工单表 fin_account_keep_todos
上游 source_key / scope：不适用，本页读取已接入的本地共享镜像，不新增上游查询
权限名、菜单键或共享组件：复用财务台账编辑权限与页面访问控制，不新增权限名或菜单键
明确不修改的范围：账户金额计算口径、上游同步、账户异常待办数据表、生产配置

开工碰撞检查

Codex 已执行 scripts/codex-task-preflight.ps1
已检查最新 main 和所有远程任务分支
已搜索主线既有页面、接口、Repository 和数据查询
已把“将写入”和“仅复用、不修改”的公共契约分开；仅复用项不作为单独阻断条件
未发现实际写入重叠；预检提示多个分支同样修改 routes/admin.php，已逐分支核对实际 diff，未发现财务台账路由、本任务路由名或相邻路由冲突

相关分支、重叠项与协调结论：routes/admin.php 仅为共享文件路径级提示；各分支新增路由位于其他业务区段，本任务新增于 financial-operations/ledger 既有路由区，实际 diff 无重叠。

实际改动

完成内容：新增“不保留账户数”卡片及独立待办页；13 列、6 个等宽筛选、时间排序、固定表头、可调列宽、紧凑行、AJAX 翻页、逐行保存；不保留判断与账户总表显示口径一致
Codex 实际修改的文件：上述 8 个预计路径
新增或变更的公共契约：两个路由名、Controller 方法、fin_account_keep_todos 表
与原计划的差异：补充了公司规划推导“否”的兼容逻辑，避免页面显示“否”但未进入待办

验证证据

正常流程：本地 1,065 个账户、207 个不保留账户；页面 13 列正常渲染；筛选“网商银行”得到 164 条且 50 条首页数据全部为该类型；AJAX 从 1/5 翻至 2/5，未提交的筛选值仍保留，确认未整页刷新
空数据/错误输入/无权限场景：已覆盖不存在或已保留账户 422、只读用户无保存按钮且提�� 403、空清单提示
受影响旧功能：账户异常待办、账户总表筛选/汇总、权限逻辑相关测试通过
自动测试及结果：FinanceLedgerAccountStatusTest、FinanceLedgerAccessTest、FinanceLedgerAccountKeepTodoTest 共 19 个测试、307 个断言全部通过
实际页面、接口或只读业务查询结果：本地真实登录态已验收卡片入口、页面布局、固定表头、筛选和 AJAX 翻页

风险检查

不涉及金额、权限、审批、数据库迁移、生产配置或数据修复
如涉及上述高风险内容，已在下方写明影响、回滚和所需授权
未提交 .env、密码、Token、私钥、真实财务数据、生产日志或构建产物
前端改动符合 DESIGN.md；复用 VIP 黑金设计令牌，无新增第二主题色

高风险影响、回滚和授权状态：新增 fin_account_keep_todos 独立表，不回写既有财务数据；回滚可执行该迁移 down 并恢复上一版镜像。复用现有财务台账管理员权限，未扩大权限范围。按团队规则由本任务 Codex 执行共享镜像建表迁移和发布。

合并前复查

已重新拉取远程引用并用实际修改范围再次运行碰撞检查
PR 不再是 WIP：，所有测试结果已经补齐
Codex 已重新读取原始需求和验收标准，并逐文件审核 origin/main...任务分支的完整 diff
Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果
合并顺序不会覆盖其他未合并任务
已授权当前任务的 Codex 执行 Squash merge、验证 main 并清理任务分支
如涉及生产迁移、数据修复、删除、覆盖配置或部署，已另行取得对应高风险授权

## 任务占用与边界 - 任务名称：不保留账户处理待办 - 实际开发者：shanshi - 任务来源/团队分工：用户要求在账户总表增加不保留账户数量入口，并新增独立处理待办页面 - 目标结果：账户是否保留为“否”的账户自动进入独立清单；提供与账户异常待办一致的筛选、排序、固定表头、列宽调整、AJAX 翻页、编辑保存和权限控制 - 预计修改路径：app/Http/Controllers/Business/FinanceLedger.php、app/Utilities/FinanceLedgerAccountShouldKeep.php、database/migrations/2026_10_21_170000_create_finance_ledger_account_keep_todos.php、modules/EcommerceFinance/View/FinanceLedgerPageData.php、resources/views/business/pages/financial-ledger/ledger.blade.php、resources/views/business/pages/financial-ledger/unretained-account-tasks.blade.php、routes/admin.php、tests/Feature/Business/FinanceLedgerAccountKeepTodoTest.php - 将写入的公共契约：business.financial-ledger.unretained-accounts、business.financial-ledger.accounts.keep-todo、fin_account_keep_todos、unretainedAccountTasks、updateAccountKeepTodo - 仅复用、不修改的公共契约：fin_accounts、fin_account_statuses、fin_account_type_overrides、FinanceLedgerAccess、现有黑金设计令牌 - 数据源、表/视图和字段：business_mirror.fin_accounts 的 account_should_keep/company_plan 及账户字段；关联状态与类型覆盖；新增工单表 fin_account_keep_todos - 上游 source_key / scope：不适用，本页读取已接入的本地共享镜像，不新增上游查询 - 权限名、菜单键或共享组件：复用财务台账编辑权限与页面访问控制，不新增权限名或菜单键 - 明确不修改的范围：账户金额计算口径、上游同步、账户异常待办数据表、生产配置 ## 开工碰撞检查 - [x] Codex 已执行 scripts/codex-task-preflight.ps1 - [x] 已检查最新 main 和所有远程任务分支 - [x] 已搜索主线既有页面、接口、Repository 和数据查询 - [x] 已把“将写入”和“仅复用、不修改”的公共契约分开；仅复用项不作为单独阻断条件 - [x] 未发现实际写入重叠；预检提示多个分支同样修改 routes/admin.php，已逐分支核对实际 diff，未发现财务台账路由、本任务路由名或相邻路由冲突相关分支、重叠项与协调结论：routes/admin.php 仅为共享文件路径级提示；各分支新增路由位于其他业务区段，本任务新增于 financial-operations/ledger 既有路由区，实际 diff 无重叠。 ## 实际改动 - 完成内容：新增“不保留账户数”卡片及独立待办页；13 列、6 个等宽筛选、时间排序、固定表头、可调列宽、紧凑行、AJAX 翻页、逐行保存；不保留判断与账户总表显示口径一致 - Codex 实际修改的文件：上述 8 个预计路径 - 新增或变更的公共契约：两个路由名、Controller 方法、fin_account_keep_todos 表 - 与原计划的差异：补充了公司规划推导“否”的兼容逻辑，避免页面显示“否”但未进入待办 ## 验证证据 - 正常流程：本地 1,065 个账户、207 个不保留账户；页面 13 列正常渲染；筛选“网商银行”得到 164 条且 50 条首页数据全部为该类型；AJAX 从 1/5 翻至 2/5，未提交的筛选值仍保留，确认未整页刷新 - 空数据/错误输入/无权限场景：已覆盖不存在或已保留账户 422、只读用户无保存按钮且提�� 403、空清单提示 - 受影响旧功能：账户异常待办、账户总表筛选/汇总、权限逻辑相关测试通过 - 自动测试及结果：FinanceLedgerAccountStatusTest、FinanceLedgerAccessTest、FinanceLedgerAccountKeepTodoTest 共 19 个测试、307 个断言全部通过 - 实际页面、接口或只读业务查询结果：本地真实登录态已验收卡片入口、页面布局、固定表头、筛选和 AJAX 翻页 ## 风险检查 - [x] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复 - [x] 如涉及上述高风险内容，已在下方写明影响、回滚和所需授权 - [x] 未提交 .env、密码、Token、私钥、真实财务数据、生产日志或构建产物 - [x] 前端改动符合 DESIGN.md；复用 VIP 黑金设计令牌，无新增第二主题色高风险影响、回滚和授权状态：新增 fin_account_keep_todos 独立表，不回写既有财务数据；回滚可执行该迁移 down 并恢复上一版镜像。复用现有财务台账管理员权限，未扩大权限范围。按团队规则由本任务 Codex 执行共享镜像建表迁移和发布。 ## 合并前复查 - [x] 已重新拉取远程引用并用实际修改范围再次运行碰撞检查 - [x] PR 不再是 WIP：，所有测试结果已经补齐 - [x] Codex 已重新读取原始需求和验收标准，并逐文件审核 origin/main...任务分支的完整 diff - [x] Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果 - [x] 合并顺序不会覆盖其他未合并任务 - [x] 已授权当前任务的 Codex 执行 Squash merge、验证 main 并清理任务分支 - [x] 如涉及生产迁移、数据修复、删除、覆盖配置或部署，已另行取得对应高风险授权

shanshi added 1 commit 2026-10-21 17:59:16 +08:00

财务台账：新增不保留账户处理待办 b4385bc671

shanshi merged commit cc0cdbeed7 into main

2026-10-21 17:59:29 +08:00

shanshi deleted branch feature/shanshi-account-keep-todos

2026-10-21 17:59:29 +08:00

shanshi referenced this issue from a commit

2026-10-21 17:59:31 +08:00

财务台账：新增不保留账户处理待办 (#444)

Sign in to join this conversation.