mirror of
https://github.com/Wei-Shaw/sub2api.git
synced 2026-10-07 16:37:52 +08:00
shaw
dec47e8fae
审计修复，逐条如下。 H1 利润策略泄露给所有普通用户 profit_control_enabled / profit_min_margin / profit_safety_buffer 从 dto.Group 移到 dto.AdminGroup（后者内嵌前者），赋值相应从 groupFromServiceBase 移到 GroupFromServiceAdmin；前端 TS 同步从 Group 移到 AdminGroup。dto.Group 是 GET /api/v1/groups/available 的响应体，该响应本就带 rate_multiplier，相乘即可反推运营方上游采购成本上限。 api_contract_test.go 的 /groups/available golden JSON 回滚这三个字段，并把 fixture 改成非零值（require.JSONEq 是精确比对，缺字段即失败）。 新增 dto 层边界测试：普通用户 DTO 不含三字段、管理员 DTO 仍含。 M1 利润终检 continue 与 failover 503 退避互动产生活锁 FailoverState 新增 profitVetoedAccountIDs / profitVetoCount 与 RecordProfitVeto()：加入排除集 + 计数，达 maxProfitVetoAttempts(10) 返回 FailoverExhausted。HandleSelectionExhausted 的 503 清空分支改为清空后把利润 否决的账号放回排除集；若排除集已全部由利润否决贡献，清空不会带来任何新候选， 直接判定耗尽（否则 SwitchCount 永不前进、退避条件永远成立，每 2s 空转一轮）。 五个 handler 否决点（gateway_handler ×2 / responses / chat_completions / gemini_v1beta）改为经 RecordProfitVeto 决策，耗尽时按无可用账号终止。 回归测试钉死：503 之后持续利润否决必须有限步终止且不 spin；未启用利润控制的 请求退避语义完全不变。 M2 排队等槽后才终检，延迟可放大到 N × WaitPlan.Timeout OpenAI 侧选号循环（自有 failedAccountIDs map，非 FailoverState）新增 recordOpenAIProfitVeto + handleOpenAIProfitVetoExhausted，共用同一上限语义。 覆盖 responses / messages-dispatch / chat_completions / alpha_search / embeddings / images / grok_media 七处，以及 WS 两处否决分支。 M4 ws_v2 透传 ingress 绕过 per-turn 重定价（选方案 B：最小止血） 透传 relay 只回调 AfterTurn、没有任何 turn 起始回调，hooks.BeforeTurn 永远 不触发，而 handler 把 turnPricingAt 初始化成建连时刻 ⇒ 透传连接全部 turn 按 建连时刻的高峰因子结算，客户端峰前建连保活即可全程谷价——正是本 PR 想堵的 漏洞。改为 openAIWSTurnPricing 零值起步、只由 BeforeTurn 冻结；透传路径保持 零值，RecordUsage 回退记录时刻，与引入利润控制前的基线一致。 未选方案 A（给透传补 turn 起始回调）：passthrough_relay.go 是 #5167 刚修过的 取消传播/close frame 时序敏感区；且 BeforeTurn 还承担 turn>1 的并发槽位抢占， 接进去等于给透传连接引入 per-turn 抢槽，风险远超本次修复范围。透传仍有建连时 的准入门，只是没有 turn 级复核，已在两处注释写明。 测试：service 层钉死透传 ingress 不触发 BeforeTurn（含失败时的复核指引）， handler 层钉死零值语义与逐 turn 覆盖。 M5 装门读分组走了带账号计数聚合的 GetByID SchedulerSnapshotService 新增 GetGroupByIDLite，openai/gateway 两处装门改用 之。门只需要平台/倍率/利润/高峰字段，且该查询发生在「是否启用利润控制」判定 之前，未启用的分组同样付代价。两个测试 stub 的 GetByID 改成 panic 守卫。 M6 认证快照注释与真实读取路径相反 门解析优先取 ctxkey.Group，而它就是本快照物化出来的对象，直连流量走的正是这 条路。改正注释，与 api_key_repo.go 投影处的说明对齐，避免后人照旧注释删列。 M3 rate_multiplier 为 nil 时利润门 fail-closed（不改行为，加护栏） 保留 fail-closed。补 repository 层测试钉死账号调度快照的 full/metadata 两份 payload 都必须保留 RateMultiplier（含 0 值），漏列在 CI 就红。 L1 迁移号注释 191 / 191-192 改为实际的 192/193。 L2 admin group Create 的利润配置预校验改用与 CreateGroup 一致的归一化平台 （新增 service.NormalizeGroupPlatform，两边共用）。保留预校验而非删除： service 层返回的是无类型 error，经 ErrorFrom 会变成 500，删掉会把合法的 400 降级成 500。 L3 前端利润校验的上界改为判定换算后的小数（后端按小数校验 [0,1)）， 99.999% 会四舍五入进位成 1.0 而被后端 400；i18n en/zh 同步改为 0-99.99。 L4 clampProfitControlThreshold / profitControlOverThreshold 抽为共用函数， 线上装门/否决点与 profit-preview 不再各自实现，附边界语义测试。 L5 profit-preview 补「默认 D 有账号但最低有效 D 归零」的告警（两档都为 0 由 既有告警覆盖，不重复）。
286 lines
11 KiB
Go
286 lines
11 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"
|
||
)
|
||
|
||
// Group holds the schema definition for the Group entity.
|
||
type Group struct {
|
||
ent.Schema
|
||
}
|
||
|
||
func (Group) Annotations() []schema.Annotation {
|
||
return []schema.Annotation{
|
||
entsql.Annotation{Table: "groups"},
|
||
}
|
||
}
|
||
|
||
func (Group) Mixin() []ent.Mixin {
|
||
return []ent.Mixin{
|
||
mixins.TimeMixin{},
|
||
mixins.SoftDeleteMixin{},
|
||
}
|
||
}
|
||
|
||
func (Group) Fields() []ent.Field {
|
||
return []ent.Field{
|
||
// 唯一约束通过部分索引实现（WHERE deleted_at IS NULL），支持软删除后重用
|
||
// 见迁移文件 016_soft_delete_partial_unique_indexes.sql
|
||
field.String("name").
|
||
MaxLen(100).
|
||
NotEmpty(),
|
||
field.String("description").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "text"}),
|
||
field.Float("rate_multiplier").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(1.0),
|
||
// 高峰时段倍率（added by migration 158）
|
||
field.Bool("peak_rate_enabled").
|
||
Default(false).
|
||
Comment("是否启用高峰时段倍率"),
|
||
field.String("peak_start").
|
||
MaxLen(5).
|
||
Default("").
|
||
Comment("高峰开始时间 HH:MM（含），如 14:00；空表示未配置；不支持跨天"),
|
||
field.String("peak_end").
|
||
MaxLen(5).
|
||
Default("").
|
||
Comment("高峰结束时间 HH:MM（不含），必须大于 peak_start；不支持跨天，如 22:00-02:00"),
|
||
field.Float("peak_rate_multiplier").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(1.0).
|
||
Comment("高峰时段叠加倍率，仅在 peak_rate_enabled 且处于 [peak_start, peak_end) 时乘入文本倍率"),
|
||
field.Bool("is_exclusive").
|
||
Default(false),
|
||
field.String("status").
|
||
MaxLen(20).
|
||
Default(domain.StatusActive),
|
||
field.String("duplicate_operation_id").
|
||
MaxLen(64).
|
||
Optional().
|
||
Nillable().
|
||
Immutable().
|
||
Comment("内部幂等恢复标识，不对 API 暴露"),
|
||
|
||
// Subscription-related fields (added by migration 003)
|
||
field.String("platform").
|
||
MaxLen(50).
|
||
Default(domain.PlatformAnthropic),
|
||
field.String("subscription_type").
|
||
MaxLen(20).
|
||
Default(domain.SubscriptionTypeStandard),
|
||
field.Float("daily_limit_usd").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("weekly_limit_usd").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("monthly_limit_usd").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Int("default_validity_days").
|
||
Default(30),
|
||
|
||
// 图片生成计费配置（antigravity 和 gemini 平台使用）
|
||
field.Bool("allow_image_generation").
|
||
Default(false).
|
||
Comment("是否允许该分组使用图片生成能力"),
|
||
field.Bool("allow_batch_image_generation").
|
||
Default(false).
|
||
Comment("是否允许该分组使用批量图片生成能力"),
|
||
field.Bool("image_rate_independent").
|
||
Default(false).
|
||
Comment("图片生成是否使用独立倍率；false 表示共享分组有效倍率"),
|
||
field.Float("image_rate_multiplier").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(1.0).
|
||
Comment("图片生成独立倍率，仅 image_rate_independent=true 时生效"),
|
||
field.Float("image_price_1k").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("image_price_2k").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("image_price_4k").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("batch_image_discount_multiplier").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(0.5).
|
||
Comment("批量图片生成折扣倍率，最终单价会乘以该值；0 表示免费"),
|
||
field.Float("batch_image_hold_multiplier").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(0.6).
|
||
Comment("批量图片生成冻结价格比例，按普通生图原价乘以该比例冻结，结算后释放差额"),
|
||
field.Bool("video_rate_independent").
|
||
Default(false).
|
||
Comment("视频生成是否使用独立倍率；false 表示共享分组有效倍率"),
|
||
field.Float("video_rate_multiplier").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(1.0).
|
||
Comment("视频生成独立倍率，仅 video_rate_independent=true 时生效"),
|
||
field.Float("video_price_480p").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("video_price_720p").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("video_price_1080p").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}),
|
||
field.Float("web_search_price_per_call").
|
||
Optional().
|
||
Nillable().
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(20,8)"}).
|
||
Comment("Codex alpha/search 网页搜索单次价格（USD/次）；nil 表示使用默认价 0.01（官方 $10/1000 次）"),
|
||
|
||
// Claude Code 客户端限制 (added by migration 029)
|
||
field.Bool("claude_code_only").
|
||
Default(false).
|
||
Comment("是否仅允许 Claude Code 客户端"),
|
||
field.Int64("fallback_group_id").
|
||
Optional().
|
||
Nillable().
|
||
Comment("非 Claude Code 请求降级使用的分组 ID"),
|
||
field.Int64("fallback_group_id_on_invalid_request").
|
||
Optional().
|
||
Nillable().
|
||
Comment("无效请求兜底使用的分组 ID"),
|
||
|
||
// 模型路由配置 (added by migration 040)
|
||
field.JSON("model_routing", map[string][]int64{}).
|
||
Optional().
|
||
SchemaType(map[string]string{dialect.Postgres: "jsonb"}).
|
||
Comment("模型路由配置：模型模式 -> 优先账号ID列表"),
|
||
|
||
// 模型路由开关 (added by migration 041)
|
||
field.Bool("model_routing_enabled").
|
||
Default(false).
|
||
Comment("是否启用模型路由配置"),
|
||
|
||
// MCP XML 协议注入开关 (added by migration 042)
|
||
field.Bool("mcp_xml_inject").
|
||
Default(true).
|
||
Comment("是否注入 MCP XML 调用协议提示词（仅 antigravity 平台）"),
|
||
|
||
// 支持的模型系列 (added by migration 046)
|
||
field.JSON("supported_model_scopes", []string{}).
|
||
Default([]string{"claude", "gemini_text", "gemini_image"}).
|
||
SchemaType(map[string]string{dialect.Postgres: "jsonb"}).
|
||
Comment("支持的模型系列：claude, gemini_text, gemini_image"),
|
||
|
||
// 分组排序 (added by migration 052)
|
||
field.Int("sort_order").
|
||
Default(0).
|
||
Comment("分组显示排序，数值越小越靠前"),
|
||
|
||
// OpenAI Messages 调度配置 (added by migration 069)
|
||
field.Bool("allow_messages_dispatch").
|
||
Default(false).
|
||
Comment("是否允许 /v1/messages 调度到此 OpenAI 分组"),
|
||
field.Bool("allow_live").
|
||
Default(false).
|
||
Comment("是否允许此 OpenAI 分组访问 Live 接口"),
|
||
field.Bool("require_oauth_only").
|
||
Default(false).
|
||
Comment("仅允许非 apikey 类型账号关联到此分组"),
|
||
field.Bool("require_privacy_set").
|
||
Default(false).
|
||
Comment("调度时仅允许 privacy 已成功设置的账号"),
|
||
field.String("default_mapped_model").
|
||
MaxLen(100).
|
||
Default("").
|
||
Comment("默认映射模型 ID，当账号级映射找不到时使用此值"),
|
||
field.JSON("messages_dispatch_model_config", domain.OpenAIMessagesDispatchModelConfig{}).
|
||
Default(domain.OpenAIMessagesDispatchModelConfig{}).
|
||
SchemaType(map[string]string{dialect.Postgres: "jsonb"}).
|
||
Comment("OpenAI Messages 调度模型配置：按 Claude 系列/精确模型映射到目标 GPT 模型"),
|
||
field.JSON("models_list_config", domain.GroupModelsListConfig{}).
|
||
Default(domain.GroupModelsListConfig{}).
|
||
SchemaType(map[string]string{dialect.Postgres: "jsonb"}).
|
||
Comment("自定义 /v1/models 展示列表配置；仅影响模型列表响应，不影响调度"),
|
||
|
||
// 分组级每分钟请求数上限（0 = 不限制）。设置后优先于用户级兜底生效。
|
||
field.Int("rpm_limit").
|
||
Default(0).
|
||
Comment("分组 RPM 上限，0 表示不限制；设置后接管该分组用户的限流"),
|
||
|
||
// OpenAI/Codex 请求的推理强度上限（空字符串表示不限制）。
|
||
field.String("max_reasoning_effort").
|
||
MaxLen(20).
|
||
Default("").
|
||
Comment("OpenAI reasoning effort 上限；可选 minimal/low/medium/high/xhigh/max"),
|
||
field.JSON("reasoning_effort_mappings", []domain.ReasoningEffortMapping{}).
|
||
Default([]domain.ReasoningEffortMapping{}).
|
||
SchemaType(map[string]string{dialect.Postgres: "jsonb"}).
|
||
Comment("OpenAI reasoning effort 自定义精确映射；先映射再应用上限"),
|
||
|
||
// 分组利润控制（migration 192/193）：openai/anthropic/gemini/grok/antigravity
|
||
// 的 token 分组可启用，composite 分组不能直接启用。
|
||
field.Bool("profit_control_enabled").
|
||
Default(false).
|
||
Comment("是否启用利润控制：调度时仅允许账号计费倍率满足毛利率要求的账号进入候选池"),
|
||
field.Float("profit_min_margin").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(0).
|
||
Comment("最低毛利率，小数（0.30=30%）；账号准入条件为 U <= D*(1-margin-buffer)"),
|
||
field.Float("profit_safety_buffer").
|
||
SchemaType(map[string]string{dialect.Postgres: "decimal(10,4)"}).
|
||
Default(0).
|
||
Comment("安全缓冲，小数；与 margin 相加后从下游倍率中扣除，默认 0"),
|
||
}
|
||
}
|
||
|
||
func (Group) Edges() []ent.Edge {
|
||
return []ent.Edge{
|
||
edge.To("api_keys", APIKey.Type),
|
||
edge.To("redeem_codes", RedeemCode.Type),
|
||
edge.To("subscriptions", UserSubscription.Type),
|
||
edge.To("usage_logs", UsageLog.Type),
|
||
edge.From("accounts", Account.Type).
|
||
Ref("groups").
|
||
Through("account_groups", AccountGroup.Type),
|
||
edge.From("allowed_users", User.Type).
|
||
Ref("allowed_groups").
|
||
Through("user_allowed_groups", UserAllowedGroup.Type),
|
||
// 注意：fallback_group_id 直接作为字段使用，不定义 edge
|
||
// 这样允许多个分组指向同一个降级分组（M2O 关系）
|
||
}
|
||
}
|
||
|
||
func (Group) Indexes() []ent.Index {
|
||
return []ent.Index{
|
||
// name 字段已在 Fields() 中声明 Unique()，无需重复索引
|
||
index.Fields("status"),
|
||
index.Fields("platform"),
|
||
index.Fields("subscription_type"),
|
||
index.Fields("is_exclusive"),
|
||
index.Fields("deleted_at"),
|
||
index.Fields("sort_order"),
|
||
index.Fields("duplicate_operation_id").
|
||
Unique().
|
||
StorageKey("idx_groups_duplicate_operation_id_active").
|
||
Annotations(entsql.IndexWhere("duplicate_operation_id IS NOT NULL AND deleted_at IS NULL")),
|
||
}
|
||
}
|