package model import "time" type UserSendMessageRequest struct { ConversationID string `json:"conversation_id,omitempty"` Message string `json:"message" binding:"required"` Model string `json:"model,omitempty"` Thinking bool `json:"thinking,omitempty"` Extra map[string]any `json:"extra,omitempty"` // 附加参数(如 task_class_id),供 agent 分支链路使用 } // ChatHistoryPersistPayload 是“聊天消息持久化请求”业务 DTO。 // // 职责边界: // 1. 只描述聊天业务需要落库的核心字段; // 2. 可被同步直写路径与异步事件路径复用; // 3. 不包含 outbox/kafka 协议字段(这些字段由 infra 层统一封装)。 type ChatHistoryPersistPayload struct { UserID int `json:"user_id"` ConversationID string `json:"conversation_id"` Role string `json:"role"` Message string `json:"message"` TokensConsumed int `json:"tokens_consumed"` } // ChatTokenUsageAdjustPayload 是“会话 token 账本增量调整”事件载荷。 // // 职责边界: // 1. 只表达“对哪个用户/会话增加多少 token”; // 2. 不承载 chat_histories 落库语义(消息正文由聊天持久化事件负责); // 3. 不包含 outbox/kafka 协议字段(由基础设施层统一封装)。 type ChatTokenUsageAdjustPayload struct { UserID int `json:"user_id"` ConversationID string `json:"conversation_id"` TokensDelta int `json:"tokens_delta"` Reason string `json:"reason"` TriggeredAt time.Time `json:"triggered_at"` } // GetConversationMetaResponse 是会话元信息查询接口的返回结构。 // 说明: // 1) title 可能为空字符串(表示标题尚未生成); // 2) has_title 便于前端快速判断是否需要展示默认占位文案; // 3) 保留 message_count/last_message_at,方便前端后续扩展会话列表排序或角标。 type GetConversationMetaResponse struct { ConversationID string `json:"conversation_id"` Title string `json:"title"` HasTitle bool `json:"has_title"` MessageCount int `json:"message_count"` LastMessageAt *time.Time `json:"last_message_at,omitempty"` Status string `json:"status"` } // GetConversationListItem 是“会话列表”中的单项数据。 // // 职责边界: // 1. 仅承载列表展示所需的轻量字段,不承载具体消息正文; // 2. title 允许为空字符串,has_title 用于前端快速判断占位文案; // 3. message_count/last_message_at 用于排序展示与角标扩展。 type GetConversationListItem struct { ConversationID string `json:"conversation_id"` Title string `json:"title"` HasTitle bool `json:"has_title"` MessageCount int `json:"message_count"` LastMessageAt *time.Time `json:"last_message_at,omitempty"` Status string `json:"status"` CreatedAt *time.Time `json:"created_at,omitempty"` } // GetConversationListResponse 是“获取用户会话列表”接口的统一响应体。 // // 职责边界: // 1. list 承载当前页数据; // 2. page/page_size/total/has_more 承载分页语义; // 3. 不负责返回会话正文明细(正文仍由聊天历史接口承担)。 type GetConversationListResponse struct { List []GetConversationListItem `json:"list"` Page int `json:"page"` PageSize int `json:"page_size"` Total int64 `json:"total"` HasMore bool `json:"has_more"` } type SSEResponse struct { Event string `json:"event"` ID int `json:"id,omitempty"` Retry int64 `json:"retry,omitempty"` Data SSEMessageData `json:"data"` } type SSEMessageData struct { Step int `json:"step,omitempty"` Message string `json:"message,omitempty"` } type AgentChat struct { ID int64 `gorm:"column:id;primaryKey;autoIncrement;comment:自增ID"` ChatID string `gorm:"column:chat_id;type:varchar(36);not null;uniqueIndex:uk_chat_id;comment:会话UUID"` UserID int `gorm:"column:user_id;not null;index:idx_user_last,priority:1;index:idx_user_status,priority:1;comment:所属用户ID"` Title *string `gorm:"column:title;type:varchar(255);comment:会话标题"` SystemPrompt *string `gorm:"column:system_prompt;type:text;comment:系统提示词"` Model *string `gorm:"column:model;type:varchar(100);comment:模型标识"` MessageCount int `gorm:"column:message_count;not null;default:0;comment:消息总数"` TokensTotal int `gorm:"column:tokens_total;not null;default:0;comment:累计Token"` LastMessageAt *time.Time `gorm:"column:last_message_at;comment:最后消息时间"` Status string `gorm:"column:status;type:varchar(32);not null;default:active;index:idx_user_status,priority:2;comment:会话状态"` CreatedAt *time.Time `gorm:"column:created_at;autoCreateTime"` UpdatedAt *time.Time `gorm:"column:updated_at;autoUpdateTime"` DeletedAt *time.Time `gorm:"column:deleted_at;comment:软删除时间"` } func (AgentChat) TableName() string { return "agent_chats" } type ChatHistory struct { ID int `gorm:"column:id;primaryKey;autoIncrement"` ChatID string `gorm:"column:chat_id;type:varchar(36);not null;index:idx_user_chat,priority:2;index:idx_chat_id;comment:会话UUID"` UserID int `gorm:"column:user_id;not null;index:idx_user_chat,priority:1"` MessageContent *string `gorm:"column:message_content;type:text;comment:消息内容"` Role *string `gorm:"column:role;type:varchar(32);comment:消息角色"` TokensConsumed int `gorm:"column:tokens_consumed;not null;default:0;comment:本轮消耗Token"` CreatedAt *time.Time `gorm:"column:created_at;autoCreateTime"` // 只保留从聊天记录到会话的单向关联,避免迁移时出现循环依赖。 Chat AgentChat `gorm:"foreignKey:ChatID;references:ChatID;constraint:OnUpdate:CASCADE,OnDelete:CASCADE"` } func (ChatHistory) TableName() string { return "chat_histories" }