feat: #1776 素材库 asset_count 自动同步维护 #1787

Merged

auto-approve-bot merged 2 commits from feature/asset-count-sync-1776 into develop 2026-09-08 10:30:21 +08:00

Conversation 2 Commits 2 Files Changed 9

+636 -32

xiaoxia commented 2026-09-08 10:05:43 +08:00

Owner

Copy Link

Copy Source

Issue #1776: 素材上传后 asset_libraries.asset_count 同步维护

改动概要

核心方案：在 asset_repository 层自动维护计数，同一事务内原子更新

• asset_repository.create() → 自动 asset_count + 1，total_size + file_size
• asset_repository.delete() → 硬删除时自动 asset_count - 1（已 deleted 的不重复扣减）
• asset_repository.batch_delete() → 软删除时按库分组批量扣减，只减非 deleted 的
• 计数下限 0，不会出现负数
• 使用 CASE WHEN 兼容 SQLite（测试）和 PostgreSQL（生产）

接口层改动：

• increment_asset_count / decrement_asset_count 从 async 改为 sync（修复 bug：实际用的同步 session）
• 新增 recount_assets(library_id) 方法：查询实际数量并修正

管理脚本：

• scripts/recount_asset_counts.py：支持 --dry-run 输出差异清单，确认后执行修正

测试覆盖（13 个新测试）：

• ✅ 创建素材计数 +1
• ✅ 多个素材累加计数
• ✅ 硬删除计数 -1
• ✅ 已删除素材再硬删除不重复扣
• ✅ 批量软删除计数 -N
• ✅ 批量删除已删除素材不重复扣
• ✅ 计数不低于 0
• ✅ prepare→complete 幂等不重复计数
• ✅ complete 重试不重复计数
• ✅ recount 修正漂移计数
• ✅ recount 排除 deleted 素材
• ✅ 递增原子性
• ✅ 递减下限保护

## Issue #1776: 素材上传后 asset_libraries.asset_count 同步维护 ### 改动概要 **核心方案：在 asset_repository 层自动维护计数，同一事务内原子更新** - `asset_repository.create()` → 自动 `asset_count + 1`，`total_size + file_size` - `asset_repository.delete()` → 硬删除时自动 `asset_count - 1`（已 deleted 的不重复扣减） - `asset_repository.batch_delete()` → 软删除时按库分组批量扣减，只减非 deleted 的 - 计数下限 0，不会出现负数 - 使用 `CASE WHEN` 兼容 SQLite（测试）和 PostgreSQL（生产） **接口层改动：** - `increment_asset_count` / `decrement_asset_count` 从 async 改为 sync（修复 bug：实际用的同步 session） - 新增 `recount_assets(library_id)` 方法：查询实际数量并修正 **管理脚本：** - `scripts/recount_asset_counts.py`：支持 `--dry-run` 输出差异清单，确认后执行修正 **测试覆盖（13 个新测试）：** - ✅ 创建素材计数 +1 - ✅ 多个素材累加计数 - ✅ 硬删除计数 -1 - ✅ 已删除素材再硬删除不重复扣 - ✅ 批量软删除计数 -N - ✅ 批量删除已删除素材不重复扣 - ✅ 计数不低于 0 - ✅ prepare→complete 幂等不重复计数 - ✅ complete 重试不重复计数 - ✅ recount 修正漂移计数 - ✅ recount 排除 deleted 素材 - ✅ 递增原子性 - ✅ 递减下限保护

xiaoxia added 1 commit 2026-09-08 10:05:44 +08:00

feat: #1776 素材库 asset_count 自动同步维护 ... 775d1a6cff

- asset_repository.create() 自动递增素材库计数（同事务内原子更新）
- asset_repository.delete() 自动递减计数（硬删除场景）
- asset_repository.batch_delete() 按库分组批量递减计数（软删除场景）
- 计数下限为0，防止出现负数
- 使用 CASE WHEN 兼容 SQLite（测试）和 PostgreSQL（生产）
- increment/decrement_asset_count 改为同步方法，支持自定义 count_delta 和 size_delta
- 新增 recount_assets() 方法用于重算修正
- 新增 scripts/recount_asset_counts.py 管理脚本（支持 dry-run 模式）
- 新增 13 个单元测试覆盖：创建/删除/批量/幂等/重试/recount/并发场景
- 更新 InMemory 仓储和端口接口签名保持同步

gitea-actions bot commented 2026-09-08 10:07:59 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1787
预览链接	https://pr-1787.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1787 | | 预览链接 | [https://pr-1787.preview.xiaoxiajianji.com](https://pr-1787.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 1 commit 2026-09-08 10:24:32 +08:00

style: fix isort import ordering in asset_library_repository 6062600fb8

auto-approve-bot merged commit 5678779232 into develop 2026-09-08 10:30:21 +08:00

auto-approve-bot deleted branch feature/asset-count-sync-1776 2026-09-08 10:30:21 +08:00

gitea-actions bot commented 2026-09-08 10:30:55 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1787 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1787 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1787