qipai/docs/db-changelog/2026-08-11-M09-C-cleaning-settlement-integrity.md

2026-08-11 M09-C 保洁结算完整性

• 版本：2026081006_m09c_cleaning_settlement_integrity。
• 新增 qipai_cleaning_settlement_reversals：按结算单保存唯一冲正号、BIGINT 有符号整数分变动、原因、操作人和时间；零元历史取消单允许基线变动为 0。
• 新增 qipai_cleaning_settlement_events：保存结算状态迁移、动作、USER / SYSTEM 操作类型、操作人、traceId、备注和 JSON 元数据。
• 扩展 qipai_cleaning_settlements：新增取消人/时间、稳定 payout_request_no 和生成请求键；租户、渠道、请求号建立唯一约束。
• 扩展 qipai_cleaning_settlement_items：新增冲正关联和时间；生成 active_share_key=task_id:cleaner_user_id，只对未冲正明细生效，同一租户同一任务成员份额最多一条有效明细。
• 历史 CANCELLED 结算自动建立基线冲正、标记明细已冲正、清空未付款成员的 settled_at 并把没有已付款份额的任务回退为 COMPLETED。
• down：先消解同一份额可能存在的多条冲正历史，优先保留当前有效明细，否则保留最新历史明细；再恢复旧成员份额唯一键，移除新列、索引、事件/冲正表和迁移版本。
• 2026062627_m08b_cleaning_collaboration.down.sql 在移除成员列前按任务去重，保证协作数据可完整执行全量 down；对应 verify 同时接受 M09-C 活动份额唯一键。
• MySQL 8.4.10 原生临时副本已完成 160 up、132 verify、154 down 的往返，并覆盖历史取消、历史多次冲正、活动份额并发唯一和再次应用迁移。