e06284d0b0
后端： - ♻️ 将 `taskquery` 模块迁移至 `agent2`，并完成与 `agent2` 业务链路及整体结构的正式接入 前端： - 🧱 已完成基础框架搭建，并完成了登录、注册、主页等页面并对接了对应接口；但整体功能实现仍在完善中
190 lines
9.2 KiB
Go
190 lines
9.2 KiB
Go
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"`
|
||
Limit int `json:"limit"`
|
||
Total int64 `json:"total"`
|
||
HasMore bool `json:"has_more"`
|
||
}
|
||
|
||
// GetConversationHistoryItem 是“按会话读取聊天历史”接口的单条消息响应。
|
||
//
|
||
// 职责边界：
|
||
// 1. role/content：承载前端渲染消息气泡所需的核心字段；
|
||
// 2. id/created_at：仅在回源 DB 时可稳定提供，命中 Redis 时允许为空；
|
||
// 3. reasoning_content：兼容模型推理内容，缓存命中时可直接透传。
|
||
type GetConversationHistoryItem struct {
|
||
ID int `json:"id,omitempty"`
|
||
Role string `json:"role"`
|
||
Content string `json:"content"`
|
||
CreatedAt *time.Time `json:"created_at,omitempty"`
|
||
ReasoningContent string `json:"reasoning_content,omitempty"`
|
||
}
|
||
|
||
// SchedulePlanPreviewCache 是“排程预览”在 Redis 中的缓存结构。
|
||
//
|
||
// 职责边界：
|
||
// 1. 负责承载排程完成后的结构化预览快照（summary + candidate_plans）；
|
||
// 2. 通过 user_id 做查询归属校验，避免跨用户越权读取；
|
||
// 3. 仅用于缓存层读写，不表示已落库或已应用到正式日程；
|
||
// 4. 通过 trace_id 标识本次预览来源，便于排查链路问题。
|
||
type SchedulePlanPreviewCache struct {
|
||
UserID int `json:"user_id"`
|
||
ConversationID string `json:"conversation_id"`
|
||
TraceID string `json:"trace_id,omitempty"`
|
||
Summary string `json:"summary"`
|
||
CandidatePlans []UserWeekSchedule `json:"candidate_plans"`
|
||
// TaskClassIDs 记录本次预览对应的任务类集合。
|
||
// 作用：
|
||
// 1. 连续对话微调时，若本轮请求未显式传 task_class_ids，可用该字段兜底；
|
||
// 2. 仅用于会话内上下文承接，不表示用户最终确认后的持久化状态。
|
||
TaskClassIDs []int `json:"task_class_ids,omitempty"`
|
||
// HybridEntries 保存“可优化的混合日程底板”。
|
||
// 作用：
|
||
// 1. 连续对话微调时复用上轮结果作为起点，避免每轮都从粗排重算；
|
||
// 2. 仅缓存态，生命周期受 Redis TTL 控制。
|
||
HybridEntries []HybridScheduleEntry `json:"hybrid_entries,omitempty"`
|
||
// AllocatedItems 保存建议任务块的当前分配状态。
|
||
// 作用：
|
||
// 1. 保证 final_check 的数量核对口径在连续微调场景下可持续；
|
||
// 2. return_preview 节点可继续回填 embedded_time。
|
||
AllocatedItems []TaskClassItem `json:"allocated_items,omitempty"`
|
||
GeneratedAt time.Time `json:"generated_at"`
|
||
}
|
||
|
||
// GetSchedulePlanPreviewResponse 是“按会话查询排程预览”接口返回结构。
|
||
//
|
||
// 职责边界：
|
||
// 1. conversation_id：标识该预览属于哪个会话；
|
||
// 2. summary：给用户展示的终审自然语言总结；
|
||
// 3. candidate_plans：给前端渲染课表/时间轴用的结构化 JSON；
|
||
// 4. generated_at：预览生成时间，便于前端判断是否是最新结果。
|
||
type GetSchedulePlanPreviewResponse struct {
|
||
ConversationID string `json:"conversation_id"`
|
||
TraceID string `json:"trace_id,omitempty"`
|
||
Summary string `json:"summary"`
|
||
CandidatePlans []UserWeekSchedule `json:"candidate_plans"`
|
||
GeneratedAt time.Time `json:"generated_at"`
|
||
}
|
||
|
||
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" }
|