feat(财务台账): 支持手工动账并联动每日流水 #451

shanshi · 2026-10-22T10:54:08+08:00

shanshi commented

2026-10-22 10:54:08 +08:00

任务范围

动账明细表头下新增紧凑的手工录入入口。
账户简称只允许从账户总表选择，手工明细自动计入每日资金流水并重算账户余额。
每日资金流水覆盖账户总表中的全部账户；无期初账户按期初日生成 0 元流水。
全量同步、增量和快照导入保留手工明细，映射统计排除手工来源。

实际改动

新增手工动账保存路由与管理员权限校验，支持审计字段和幂等键。
新增账户总表简称选择项、收入/支出互斥录入、局部插入与汇总更新。
优化流水重算：按账户分组并批量回写账户及店铺余额。
新增共享镜像审计字段迁移。
新增手工动账、无期初账户、同步保留、筛选汇总、权限和错误输入测试。

验证证据

财务台账相关回归：36 tests / 481 assertions，全部通过。
手工动账专项：6 tests / 47 assertions，全部通过。
真实本地数据规模：1,011 个不同账户简称、12,152 笔动账、1,028 条重算流水。
完整重算：约 0.33 秒、17 条 SQL、峰值内存 65.5 MB；事务回滚后明细与流水行数不变。
本地页面：新增入口、录入行、账户总表下拉、窄屏独立滚动及前端错误检查通过；未提交真实测试财务数据。

风险与发布

涉及金额口径、同步保留、数据库字段和派生流水重算。
手工来源不会回写上游，并会在全量/增量同步及快照导入中保留。
合并后发布前备份受影响账户余额和每日流水；发布遵循 scripts/deploy-from-workstation.ps1，并在发布锁后核对 SHA、健康、页面和回滚镜像。
新增迁移仅为本任务共享镜像审计字段。

合并前复查

已重新 fetch 并逐文件审核 origin/main...任务分支完整 diff。
碰撞检查命中的财务写入器分支已通过 #411 squash 进入 main，文件 blob 与 main 一致。
routes/admin.php 的其他活动分支改动 hunk 均与本任务新增位置不相交。
未提交 .env、凭据、真实财务数据、日志或构建产物。

## 任务范围 - 动账明细表头下新增紧凑的手工录入入口。 - 账户简称只允许从账户总表选择，手工明细自动计入每日资金流水并重算账户余额。 - 每日资金流水覆盖账户总表中的全部账户；无期初账户按期初日生成 0 元流水。 - 全量同步、增量和快照导入保留手工明细，映射统计排除手工来源。 ## 实际改动 - 新增手工动账保存路由与管理员权限校验，支持审计字段和幂等键。 - 新增账户总表简称选择项、收入/支出互斥录入、局部插入与汇总更新。 - 优化流水重算：按账户分组并批量回写账户及店铺余额。 - 新增共享镜像审计字段迁移。 - 新增手工动账、无期初账户、同步保留、筛选汇总、权限和错误输入测试。 ## 验证证据 - 财务台账相关回归：36 tests / 481 assertions，全部通过。 - 手工动账专项：6 tests / 47 assertions，全部通过。 - 真实本地数据规模：1,011 个不同账户简称、12,152 笔动账、1,028 条重算流水。 - 完整重算：约 0.33 秒、17 条 SQL、峰值内存 65.5 MB；事务回滚后明细与流水行数不变。 - 本地页面：新增入口、录入行、账户总表下拉、窄屏独立滚动及前端错误检查通过；未提交真实测试财务数据。 ## 风险与发布 - 涉及金额口径、同步保留、数据库字段和派生流水重算。 - 手工来源不会回写上游，并会在全量/增量同步及快照导入中保留。 - 合并后发布前备份受影响账户余额和每日流水；发布遵循 scripts/deploy-from-workstation.ps1，并在发布锁后核对 SHA、健康、页面和回滚镜像。 - 新增迁移仅为本任务共享镜像审计字段。 ## 合并前复查 - 已重新 fetch 并逐文件审核 origin/main...任务分支完整 diff。 - 碰撞检查命中的财务写入器分支已通过 #411 squash 进入 main，文件 blob 与 main 一致。 - routes/admin.php 的其他活动分支改动 hunk 均与本任务新增位置不相交。 - 未提交 .env、凭据、真实财务数据、日志或构建产物。

shanshi added 1 commit 2026-10-22 10:54:09 +08:00

feat(财务台账): 支持手工动账并联动每日流水 b90c06ad2f

shanshi merged commit 446da08445 into main

2026-10-22 10:54:22 +08:00

shanshi deleted branch feature/shanshi-manual-transactions

2026-10-22 10:54:22 +08:00

shanshi referenced this issue from a commit

2026-10-22 10:54:23 +08:00

feat(财务台账): 支持手工动账并联动每日流水 (#451)

Sign in to join this conversation.