Files
huang 984ccccc63 docs(constitution): 新增数据库设计原则(v2.4.0)
在项目宪章中新增第九条原则"数据库设计原则",明确禁止使用数据库外键约束和ORM关联标签。

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

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

版本升级:2.3.0 → 2.4.0(MINOR)
2025-11-13 13:40:19 +08:00

1.5 KiB

Specification Quality Checklist: 数据持久化与异步任务处理集成

Purpose: 在进入规划阶段前验证规格说明的完整性和质量 Created: 2025-11-12 Feature: spec.md

Content Quality

  • 无实现细节(语言、框架、API)
  • 专注于用户价值和业务需求
  • 为非技术干系人编写
  • 所有必填部分已完成

Requirement Completeness

  • 无[NEEDS CLARIFICATION]标记残留
  • 需求可测试且无歧义
  • 成功标准可衡量
  • 成功标准技术无关(无实现细节)
  • 所有验收场景已定义
  • 边界情况已识别
  • 范围边界清晰
  • 依赖和假设已识别

Feature Readiness

  • 所有功能需求都有清晰的验收标准
  • 用户场景涵盖主要流程
  • 功能满足成功标准中定义的可衡量结果
  • 无实现细节泄漏到规格说明中

Notes

所有检查项均已通过。规格说明完整且质量良好,可以进入下一阶段(/speckit.clarify/speckit.plan)。

规格说明的主要优势:

  • 用户故事按优先级清晰排序(P1核心数据持久化 → P2异步任务 → P3监控)
  • 功能需求详细且可测试,涵盖了GORM、PostgreSQL和Asynq的核心能力
  • 成功标准具体可衡量,包含响应时间、并发能力、可靠性等关键指标
  • 边界情况考虑周全,包括连接池耗尽、死锁、主从切换等场景
  • 技术需求完全遵循项目宪章(Constitution),确保架构一致性