docs(constitution): 新增数据库设计原则(v2.4.0)

在项目宪章中新增第九条原则"数据库设计原则",明确禁止使用数据库外键约束和ORM关联标签。

主要变更:
- 新增原则IX:数据库设计原则(Database Design Principles)
- 强制要求:数据库表不得使用外键约束
- 强制要求:GORM模型不得使用ORM关联标签(foreignKey、hasMany等)
- 强制要求:表关系必须通过ID字段手动维护
- 强制要求:关联数据查询必须显式编写,避免ORM魔法
- 强制要求:时间字段由GORM处理,不使用数据库触发器

设计理念:
- 提升业务逻辑灵活性(无数据库约束限制)
- 优化高并发性能(无外键检查开销)
- 增强代码可读性(显式查询,无隐式预加载)
- 简化数据库架构和迁移流程
- 支持分布式和微服务场景

版本升级:2.3.0 → 2.4.0(MINOR)
This commit is contained in:
2025-11-13 13:40:19 +08:00
parent ea0c6a8b16
commit 984ccccc63
63 changed files with 12099 additions and 83 deletions

View File

@@ -0,0 +1,41 @@
# Specification Quality Checklist: 数据持久化与异步任务处理集成
**Purpose**: 在进入规划阶段前验证规格说明的完整性和质量
**Created**: 2025-11-12
**Feature**: [spec.md](../spec.md)
## Content Quality
- [x] 无实现细节(语言、框架、API)
- [x] 专注于用户价值和业务需求
- [x] 为非技术干系人编写
- [x] 所有必填部分已完成
## Requirement Completeness
- [x] 无[NEEDS CLARIFICATION]标记残留
- [x] 需求可测试且无歧义
- [x] 成功标准可衡量
- [x] 成功标准技术无关(无实现细节)
- [x] 所有验收场景已定义
- [x] 边界情况已识别
- [x] 范围边界清晰
- [x] 依赖和假设已识别
## Feature Readiness
- [x] 所有功能需求都有清晰的验收标准
- [x] 用户场景涵盖主要流程
- [x] 功能满足成功标准中定义的可衡量结果
- [x] 无实现细节泄漏到规格说明中
## Notes
所有检查项均已通过。规格说明完整且质量良好,可以进入下一阶段(`/speckit.clarify``/speckit.plan`)。
规格说明的主要优势:
- 用户故事按优先级清晰排序(P1核心数据持久化 → P2异步任务 → P3监控)
- 功能需求详细且可测试,涵盖了GORM、PostgreSQL和Asynq的核心能力
- 成功标准具体可衡量,包含响应时间、并发能力、可靠性等关键指标
- 边界情况考虑周全,包括连接池耗尽、死锁、主从切换等场景
- 技术需求完全遵循项目宪章(Constitution),确保架构一致性