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

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

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

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

版本升级：2.3.0 → 2.4.0（MINOR）

internal/model/base.go

@@ -0,0 +1,15 @@
+package model
+
+import (
+	"time"
+
+	"gorm.io/gorm"
+)
+
+// BaseModel 基础模型，包含通用字段
+type BaseModel struct {
+	ID        uint           `gorm:"primarykey" json:"id"`
+	CreatedAt time.Time      `json:"created_at"`
+	UpdatedAt time.Time      `json:"updated_at"`
+	DeletedAt gorm.DeletedAt `gorm:"index" json:"-"` // 软删除
+}

internal/model/order.go

@@ -0,0 +1,30 @@
+package model
+
+import (
+	"time"
+)
+
+// Order 订单实体
+type Order struct {
+	BaseModel
+
+	// 业务唯一键
+	OrderID string `gorm:"uniqueIndex:uk_order_order_id;not null;size:50" json:"order_id"`
+
+	// 关联关系 (仅存储 ID,不使用 GORM 关联)
+	UserID uint `gorm:"not null;index:idx_order_user_id" json:"user_id"`
+
+	// 订单信息
+	Amount int64  `gorm:"not null" json:"amount"` // 金额（分）
+	Status string `gorm:"not null;size:20;default:'pending';index:idx_order_status" json:"status"`
+	Remark string `gorm:"size:500" json:"remark,omitempty"`
+
+	// 时间字段
+	PaidAt      *time.Time `gorm:"column:paid_at" json:"paid_at,omitempty"`
+	CompletedAt *time.Time `gorm:"column:completed_at" json:"completed_at,omitempty"`
+}
+
+// TableName 指定表名
+func (Order) TableName() string {
+	return "tb_order"
+}

internal/model/order_dto.go

@@ -0,0 +1,43 @@
+package model
+
+import (
+	"time"
+)
+
+// CreateOrderRequest 创建订单请求
+type CreateOrderRequest struct {
+	OrderID string `json:"order_id" validate:"required,min=10,max=50"`
+	UserID  uint   `json:"user_id" validate:"required,gt=0"`
+	Amount  int64  `json:"amount" validate:"required,gte=0"`
+	Remark  string `json:"remark" validate:"omitempty,max=500"`
+}
+
+// UpdateOrderRequest 更新订单请求
+type UpdateOrderRequest struct {
+	Status *string `json:"status" validate:"omitempty,oneof=pending paid processing completed cancelled"`
+	Remark *string `json:"remark" validate:"omitempty,max=500"`
+}
+
+// OrderResponse 订单响应
+type OrderResponse struct {
+	ID          uint          `json:"id"`
+	OrderID     string        `json:"order_id"`
+	UserID      uint          `json:"user_id"`
+	Amount      int64         `json:"amount"`
+	Status      string        `json:"status"`
+	Remark      string        `json:"remark,omitempty"`
+	PaidAt      *time.Time    `json:"paid_at,omitempty"`
+	CompletedAt *time.Time    `json:"completed_at,omitempty"`
+	CreatedAt   time.Time     `json:"created_at"`
+	UpdatedAt   time.Time     `json:"updated_at"`
+	User        *UserResponse `json:"user,omitempty"` // 可选的用户信息
+}
+
+// ListOrdersResponse 订单列表响应
+type ListOrdersResponse struct {
+	Orders     []OrderResponse `json:"orders"`
+	Page       int             `json:"page"`
+	PageSize   int             `json:"page_size"`
+	Total      int64           `json:"total"`
+	TotalPages int             `json:"total_pages"`
+}

internal/model/user.go

@@ -0,0 +1,26 @@
+package model
+
+import (
+	"time"
+)
+
+// User 用户实体
+type User struct {
+	BaseModel
+
+	// 基本信息
+	Username string `gorm:"uniqueIndex:uk_user_username;not null;size:50" json:"username"`
+	Email    string `gorm:"uniqueIndex:uk_user_email;not null;size:100" json:"email"`
+	Password string `gorm:"not null;size:255" json:"-"` // 不返回给客户端
+
+	// 状态字段
+	Status string `gorm:"not null;size:20;default:'active';index:idx_user_status" json:"status"`
+
+	// 元数据
+	LastLoginAt *time.Time `gorm:"column:last_login_at" json:"last_login_at,omitempty"`
+}
+
+// TableName 指定表名
+func (User) TableName() string {
+	return "tb_user"
+}

internal/model/user_dto.go

@@ -0,0 +1,38 @@
+package model
+
+import (
+	"time"
+)
+
+// CreateUserRequest 创建用户请求
+type CreateUserRequest struct {
+	Username string `json:"username" validate:"required,min=3,max=50,alphanum"`
+	Email    string `json:"email" validate:"required,email"`
+	Password string `json:"password" validate:"required,min=8"`
+}
+
+// UpdateUserRequest 更新用户请求
+type UpdateUserRequest struct {
+	Email  *string `json:"email" validate:"omitempty,email"`
+	Status *string `json:"status" validate:"omitempty,oneof=active inactive suspended"`
+}
+
+// UserResponse 用户响应
+type UserResponse struct {
+	ID          uint       `json:"id"`
+	Username    string     `json:"username"`
+	Email       string     `json:"email"`
+	Status      string     `json:"status"`
+	CreatedAt   time.Time  `json:"created_at"`
+	UpdatedAt   time.Time  `json:"updated_at"`
+	LastLoginAt *time.Time `json:"last_login_at,omitempty"`
+}
+
+// ListUsersResponse 用户列表响应
+type ListUsersResponse struct {
+	Users      []UserResponse `json:"users"`
+	Page       int            `json:"page"`
+	PageSize   int            `json:"page_size"`
+	Total      int64          `json:"total"`
+	TotalPages int            `json:"total_pages"`
+}