This feature allows API Keys to have their own quota limits and expiration times, independent of the user's balance. Backend: - Add quota, quota_used, expires_at fields to api_key schema - Implement IsExpired() and IsQuotaExhausted() checks in middleware - Add ResetQuota and ClearExpiration API endpoints - Integrate quota billing in gateway handlers (OpenAI, Anthropic, Gemini) - Include quota/expiration fields in auth cache for performance - Expiration check returns 403, quota exhausted returns 429 Frontend: - Add quota and expiration inputs to key create/edit dialog - Add quick-select buttons for expiration (+7, +30, +90 days) - Add reset quota confirmation dialog - Add expires_at column to keys list - Add i18n translations for new features (en/zh) Migration: - Add 045_add_api_key_quota.sql for new columns
103 lines
2.4 KiB
Go
103 lines
2.4 KiB
Go
package schema
|
|
|
|
import (
|
|
"github.com/Wei-Shaw/sub2api/ent/schema/mixins"
|
|
"github.com/Wei-Shaw/sub2api/internal/domain"
|
|
|
|
"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"
|
|
)
|
|
|
|
// APIKey holds the schema definition for the APIKey entity.
|
|
type APIKey struct {
|
|
ent.Schema
|
|
}
|
|
|
|
func (APIKey) Annotations() []schema.Annotation {
|
|
return []schema.Annotation{
|
|
entsql.Annotation{Table: "api_keys"},
|
|
}
|
|
}
|
|
|
|
func (APIKey) Mixin() []ent.Mixin {
|
|
return []ent.Mixin{
|
|
mixins.TimeMixin{},
|
|
mixins.SoftDeleteMixin{},
|
|
}
|
|
}
|
|
|
|
func (APIKey) Fields() []ent.Field {
|
|
return []ent.Field{
|
|
field.Int64("user_id"),
|
|
field.String("key").
|
|
MaxLen(128).
|
|
NotEmpty().
|
|
Unique(),
|
|
field.String("name").
|
|
MaxLen(100).
|
|
NotEmpty(),
|
|
field.Int64("group_id").
|
|
Optional().
|
|
Nillable(),
|
|
field.String("status").
|
|
MaxLen(20).
|
|
Default(domain.StatusActive),
|
|
field.JSON("ip_whitelist", []string{}).
|
|
Optional().
|
|
Comment("Allowed IPs/CIDRs, e.g. [\"192.168.1.100\", \"10.0.0.0/8\"]"),
|
|
field.JSON("ip_blacklist", []string{}).
|
|
Optional().
|
|
Comment("Blocked IPs/CIDRs"),
|
|
|
|
// ========== Quota fields ==========
|
|
// Quota limit in USD (0 = unlimited)
|
|
field.Float("quota").
|
|
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}).
|
|
Default(0).
|
|
Comment("Quota limit in USD for this API key (0 = unlimited)"),
|
|
// Used quota amount
|
|
field.Float("quota_used").
|
|
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}).
|
|
Default(0).
|
|
Comment("Used quota amount in USD"),
|
|
// Expiration time (nil = never expires)
|
|
field.Time("expires_at").
|
|
Optional().
|
|
Nillable().
|
|
Comment("Expiration time for this API key (null = never expires)"),
|
|
}
|
|
}
|
|
|
|
func (APIKey) Edges() []ent.Edge {
|
|
return []ent.Edge{
|
|
edge.From("user", User.Type).
|
|
Ref("api_keys").
|
|
Field("user_id").
|
|
Unique().
|
|
Required(),
|
|
edge.From("group", Group.Type).
|
|
Ref("api_keys").
|
|
Field("group_id").
|
|
Unique(),
|
|
edge.To("usage_logs", UsageLog.Type),
|
|
}
|
|
}
|
|
|
|
func (APIKey) Indexes() []ent.Index {
|
|
return []ent.Index{
|
|
// key 字段已在 Fields() 中声明 Unique(),无需重复索引
|
|
index.Fields("user_id"),
|
|
index.Fields("group_id"),
|
|
index.Fields("status"),
|
|
index.Fields("deleted_at"),
|
|
// Index for quota queries
|
|
index.Fields("quota", "quota_used"),
|
|
index.Fields("expires_at"),
|
|
}
|
|
}
|