feat: #1775 默认项目/素材库幂等化（DB 唯一约束兜底） #1783

Merged

xiaoxia merged 2 commits from feature/default-project-idempotent-1775 into develop 2026-09-08 08:43:31 +08:00

Conversation 2 Commits 2 Files Changed 11

+518 -28

xiaoxia commented 2026-09-08 07:19:20 +08:00

Owner

Copy Link

Copy Source

背景

小程序端 getOrCreateDefaultProject 在重试、并发、前端重复调用下，仅靠"先查再插"会给同一用户重复创建默认项目和默认素材库。

改动

• ProjectModel 新增 is_default: bool + 部分唯一索引 uq_projects_owner_default（WHERE is_default=true，每用户至多一个默认项目）
• asset_library_repository.get_or_create_default_library 用 IntegrityError 回滚重查，替代先查后插（修复并发 500）
• project_repository.get_or_create_default_project 同上
• 新增组合接口 POST /projects/ensure-default，一次拿到 project_id + image/video/voice 三类 library_id
• 迁移 069：存量回填（每用户最早"默认项目"标 is_default=true）+ 创建部分唯一索引
• schema 快照增量更新

测试

15 个新测试 + 99 个旧测试全过。覆盖：并发 10 次只建 1 个、跨用户/跨 kind 独立、IntegrityError 回滚重查、字段语义。

数据清理

存量重复数据清单 SQL 见 discussion，禁止自动删除，由主人/灵应确认后执行。

## 背景 小程序端 `getOrCreateDefaultProject` 在重试、并发、前端重复调用下，仅靠"先查再插"会给同一用户重复创建默认项目和默认素材库。 ## 改动 - `ProjectModel` 新增 `is_default: bool` + 部分唯一索引 `uq_projects_owner_default`（`WHERE is_default=true`，每用户至多一个默认项目） - `asset_library_repository.get_or_create_default_library` 用 IntegrityError 回滚重查，替代先查后插（修复并发 500） - `project_repository.get_or_create_default_project` 同上 - 新增组合接口 `POST /projects/ensure-default`，一次拿到 project_id + image/video/voice 三类 library_id - 迁移 069：存量回填（每用户最早"默认项目"标 is_default=true）+ 创建部分唯一索引 - schema 快照增量更新 ## 测试 15 个新测试 + 99 个旧测试全过。覆盖：并发 10 次只建 1 个、跨用户/跨 kind 独立、IntegrityError 回滚重查、字段语义。 ## 数据清理 存量重复数据清单 SQL 见 discussion，**禁止自动删除**，由主人/灵应确认后执行。

xiaoxia added 2 commits 2026-09-08 07:19:20 +08:00

feat: #1775 默认项目/默认素材库幂等化（DB 唯一约束兜底） ... 6b1966ce90

问题：小程序端 getOrCreateDefaultProject 在重试/并发/重复调用下，
仅靠应用层"先查后插"不保证幂等，会给同一用户重复创建默认项目。
素材库虽有唯一约束 uq_asset_libraries_project_kind（迁移058），
但 ensure-default 接口未捕获冲突，并发下直接 500。

改动：
1. projects 表新增 is_default 列 + 部分唯一索引
   uq_projects_owner_default（owner_user_id WHERE is_default=true），
   保证每用户至多一个默认项目（迁移069，存量"默认项目"最早一条回填）
2. Project 实体/Model/Repository 增加 is_default 字段
3. 新增 get_or_create_default_project / find_default_by_owner：
   INSERT 冲突时捕获 IntegrityError 回滚重查，返回已有记录不报500
4. 素材库仓储新增 get_or_create_default_library（同上幂等语义）
5. 新增 POST /projects/ensure-default 组合接口：
   一次请求幂等返回默认项目 + 三类默认素材库ID
6. ensure-default 素材库接口改用幂等仓储方法（修复并发500）
7. in-memory 仓储同步幂等方法

测试：15 个新测试（并发10次只建1个、跨用户独立、IntegrityError恢复、
字段语义），99 个相关旧测试全过。

chore: schema 快照仅增量 is_default 列+部分唯一索引（修正缩进格式） f6c18b3aa9

gitea-actions bot commented 2026-09-08 07:21:04 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

xiaoxia merged commit 9c0474ef9c into develop 2026-09-08 08:43:31 +08:00

gitea-actions bot commented 2026-09-08 08:43:50 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

🗑️ **预览环境已清理** PR #1783 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 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#1783