61db646805
后端： 1. LLM 独立服务与统一计费出口落地：新增 `cmd/llm`、`client/llm` 与 `services/llm/rpc`，补齐 BillingContext、CreditBalanceGuard、价格规则解析、stream usage 归集与 `credit.charge.requested` outbox 发布，active-scheduler / agent / course / memory / gateway fallback 全部改走 llm zrpc，不再各自本地初始化模型。 2. TokenStore 收口为 Credit 权威账本：新增 credit account / ledger / product / order / price-rule / reward-rule 能力与 Redis 快照缓存，扩展 tokenstore rpc/client 支撑余额快照、消耗看板、商品、订单、流水、价格规则和奖励规则，并接入 LLM charge 事件消费完成 Credit 扣费落账。 3. 计费旧链路下线与网关切口切换：`/token-store` 语义整体切到 `/credit-store`，agent chat 移除旧 TokenQuotaGuard，userauth 的 CheckTokenQuota / AdjustTokenUsage 改为废弃，聊天历史落库不再同步旧 token 额度账本，course 图片解析请求补 user_id 进入新计费口径。 前端： 4. 计划广场从 mock 数据切到真实接口：新增 forum api/types，首页支持真实列表、标签、搜索、防抖、点赞、导入和发布计划，详情页补齐帖子详情、评论树、回复和删除评论链路，同时补上“至少一个标签”的前后端约束与默认标签兜底。 5. 商店页切到 Credit 体系并重做展示：顶部改为余额 + Credit/Token 消耗看板，支持 24h/7d/30d/all 周期切换；套餐区展示原价与当前价；历史区改为当前用户 Credit 流水并支持查看更多，整体视觉和交互同步收口。 仓库： 6. 配置与本地启动体系补齐 llm / outbox 编排：`config.example.yaml` 增加 llm rpc 和统一 outbox service 配置，`dev-common.ps1` 把 llm 纳入多服务依赖并自动建 Kafka topic，`docker-compose.yml` 同步初始化 agent/task/memory/active-scheduler/notification/taskclass-forum/llm/token-store 全量 outbox topic。
92 lines
3.0 KiB
Go
92 lines
3.0 KiB
Go
package events
|
||
|
||
import (
|
||
"errors"
|
||
"fmt"
|
||
"strings"
|
||
"time"
|
||
)
|
||
|
||
const (
|
||
// CreditChargeRequestedEventType 表示 LLM 服务已经拿到最终 usage，等待 TokenStore 异步结算。
|
||
CreditChargeRequestedEventType = "credit.charge.requested"
|
||
// CreditChargeEventVersion 是当前 Credit 扣费事件版本。
|
||
CreditChargeEventVersion = "v1"
|
||
)
|
||
|
||
// CreditChargeRequestedPayload 是 LLM -> TokenStore 的统一扣费事件。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只表达“一次已经完成的模型调用需要如何结算”，不承载准入决策；
|
||
// 2. event_id 是最终幂等键，LLM outbox 重试和 TokenStore 记账都依赖它去重；
|
||
// 3. credit_cost / rmb_cost_micros 在 LLM 侧就要算好，TokenStore 只负责权威落账。
|
||
type CreditChargeRequestedPayload struct {
|
||
EventID string `json:"event_id"`
|
||
UserID uint64 `json:"user_id"`
|
||
Scene string `json:"scene"`
|
||
RequestID string `json:"request_id"`
|
||
ConversationID string `json:"conversation_id"`
|
||
ModelAlias string `json:"model_alias"`
|
||
ProviderName string `json:"provider_name"`
|
||
ModelName string `json:"model_name"`
|
||
InputTokens int64 `json:"input_tokens"`
|
||
OutputTokens int64 `json:"output_tokens"`
|
||
CachedTokens int64 `json:"cached_tokens"`
|
||
ReasoningTokens int64 `json:"reasoning_tokens"`
|
||
TotalTokens int64 `json:"total_tokens"`
|
||
RMBCostMicros int64 `json:"rmb_cost_micros"`
|
||
CreditCost int64 `json:"credit_cost"`
|
||
TriggeredAt time.Time `json:"triggered_at"`
|
||
SkipCharge bool `json:"skip_charge,omitempty"`
|
||
}
|
||
|
||
// EventType 返回当前 payload 对应的标准事件类型。
|
||
func (p CreditChargeRequestedPayload) EventType() string {
|
||
return CreditChargeRequestedEventType
|
||
}
|
||
|
||
// MessageKey 返回 Kafka / outbox 统一消息键。
|
||
func (p CreditChargeRequestedPayload) MessageKey() string {
|
||
return strings.TrimSpace(p.EventID)
|
||
}
|
||
|
||
// AggregateID 返回扣费事件聚合键。
|
||
func (p CreditChargeRequestedPayload) AggregateID() string {
|
||
if p.UserID <= 0 {
|
||
return ""
|
||
}
|
||
return fmt.Sprintf("user:%d", p.UserID)
|
||
}
|
||
|
||
// Validate 校验扣费事件最小字段集。
|
||
func (p CreditChargeRequestedPayload) Validate() error {
|
||
if strings.TrimSpace(p.EventID) == "" {
|
||
return errors.New("credit charge event_id 不能为空")
|
||
}
|
||
if p.UserID == 0 {
|
||
return errors.New("credit charge user_id 不能为空")
|
||
}
|
||
if strings.TrimSpace(p.Scene) == "" {
|
||
return errors.New("credit charge scene 不能为空")
|
||
}
|
||
if strings.TrimSpace(p.ProviderName) == "" {
|
||
return errors.New("credit charge provider_name 不能为空")
|
||
}
|
||
if strings.TrimSpace(p.ModelName) == "" {
|
||
return errors.New("credit charge model_name 不能为空")
|
||
}
|
||
if p.TriggeredAt.IsZero() {
|
||
return errors.New("credit charge triggered_at 不能为空")
|
||
}
|
||
if p.SkipCharge {
|
||
return nil
|
||
}
|
||
if p.CreditCost < 0 {
|
||
return errors.New("credit charge credit_cost 不能为负数")
|
||
}
|
||
if p.RMBCostMicros < 0 {
|
||
return errors.New("credit charge rmb_cost_micros 不能为负数")
|
||
}
|
||
return nil
|
||
}
|