5906f9ab98
## 数据完整性修复 (fix-critical-data-integrity) - 添加 error_translate.go 统一错误转换层 - 修复 nil 输入和 NotFound 错误处理 - 增强仓储层错误一致性 ## 仓储一致性修复 (fix-high-repository-consistency) - Group schema 添加 default_validity_days 字段 - Account schema 添加 proxy edge 关联 - 新增 UsageLog ent schema 定义 - 修复 UpdateBalance/UpdateConcurrency 受影响行数校验 ## 数据卫生修复 (fix-medium-data-hygiene) - UserSubscription 添加软删除支持 (SoftDeleteMixin) - RedeemCode/Setting 添加硬删除策略文档 - account_groups/user_allowed_groups 的 created_at 声明 timestamptz - 停止写入 legacy users.allowed_groups 列 - 新增迁移: 011-014 (索引优化、软删除、孤立数据审计、列清理) ## 测试补充 - 添加 UserSubscription 软删除测试 - 添加迁移回归测试 - 添加 NotFound 错误测试 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
95 lines
2.3 KiB
Go
95 lines
2.3 KiB
Go
package schema
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/Wei-Shaw/sub2api/internal/service"
|
|
|
|
"entgo.io/ent"
|
|
"entgo.io/ent/dialect"
|
|
"entgo.io/ent/dialect/entsql"
|
|
"entgo.io/ent/schema"
|
|
"entgo.io/ent/schema/edge"
|
|
"entgo.io/ent/schema/field"
|
|
"entgo.io/ent/schema/index"
|
|
)
|
|
|
|
// RedeemCode holds the schema definition for the RedeemCode entity.
|
|
//
|
|
// 删除策略：硬删除
|
|
// RedeemCode 使用硬删除而非软删除，原因如下：
|
|
// - 兑换码具有一次性使用特性，删除后无需保留历史记录
|
|
// - 已使用的兑换码通过 status 和 used_at 字段追踪，无需依赖软删除
|
|
// - 减少数据库存储压力和查询复杂度
|
|
//
|
|
// 如需审计已删除的兑换码，建议在删除前将关键信息写入审计日志表。
|
|
type RedeemCode struct {
|
|
ent.Schema
|
|
}
|
|
|
|
func (RedeemCode) Annotations() []schema.Annotation {
|
|
return []schema.Annotation{
|
|
entsql.Annotation{Table: "redeem_codes"},
|
|
}
|
|
}
|
|
|
|
func (RedeemCode) Fields() []ent.Field {
|
|
return []ent.Field{
|
|
field.String("code").
|
|
MaxLen(32).
|
|
NotEmpty().
|
|
Unique(),
|
|
field.String("type").
|
|
MaxLen(20).
|
|
Default(service.RedeemTypeBalance),
|
|
field.Float("value").
|
|
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}).
|
|
Default(0),
|
|
field.String("status").
|
|
MaxLen(20).
|
|
Default(service.StatusUnused),
|
|
field.Int64("used_by").
|
|
Optional().
|
|
Nillable(),
|
|
field.Time("used_at").
|
|
Optional().
|
|
Nillable().
|
|
SchemaType(map[string]string{dialect.Postgres: "timestamptz"}),
|
|
field.String("notes").
|
|
Optional().
|
|
Nillable().
|
|
SchemaType(map[string]string{dialect.Postgres: "text"}),
|
|
field.Time("created_at").
|
|
Immutable().
|
|
Default(time.Now).
|
|
SchemaType(map[string]string{dialect.Postgres: "timestamptz"}),
|
|
field.Int64("group_id").
|
|
Optional().
|
|
Nillable(),
|
|
field.Int("validity_days").
|
|
Default(30),
|
|
}
|
|
}
|
|
|
|
func (RedeemCode) Edges() []ent.Edge {
|
|
return []ent.Edge{
|
|
edge.From("user", User.Type).
|
|
Ref("redeem_codes").
|
|
Field("used_by").
|
|
Unique(),
|
|
edge.From("group", Group.Type).
|
|
Ref("redeem_codes").
|
|
Field("group_id").
|
|
Unique(),
|
|
}
|
|
}
|
|
|
|
func (RedeemCode) Indexes() []ent.Index {
|
|
return []ent.Index{
|
|
// code 字段已在 Fields() 中声明 Unique()，无需重复索引
|
|
index.Fields("status"),
|
|
index.Fields("used_by"),
|
|
index.Fields("group_id"),
|
|
}
|
|
}
|