types

type AITeammateTemplate struct {
	gorm.Model

	// Code is the globally unique business identifier for the template.
	Code string `gorm:"column:code;type:varchar(128);not null;uniqueIndex" json:"code"`
	// Name is the display name shown in the AI teammate template list.
	Name string `gorm:"column:name;type:varchar(255);not null" json:"name"`
	// Description is the short user-facing summary.
	Description string `gorm:"column:description;type:text" json:"description"`
	// Avatar stores a URL or built-in avatar resource identifier.
	Avatar string `gorm:"column:avatar;type:varchar(500)" json:"avatar"`
	// Provider records where the preset teammate profile comes from.
	Provider string `gorm:"column:provider;type:varchar(100)" json:"provider"`
	// SystemPrompt is copied to DigitalAssistant.SystemPrompt when creating from the template.
	SystemPrompt string `gorm:"column:system_prompt;type:text;not null" json:"system_prompt"`
	// Expertise stores the template's domain tags.
	Expertise SkillStringList `gorm:"column:expertise;type:jsonb" json:"expertise"`
	// Category supports filtering in the AI teammate marketplace.
	Category string `gorm:"column:category;type:varchar(100);not null;index" json:"category"`
	// Tags stores search and display labels.
	Tags SkillStringList `gorm:"column:tags;type:jsonb" json:"tags"`
	// SortOrder controls default ordering in the marketplace.
	SortOrder int `gorm:"column:sort_order;type:integer;not null;default:0;index" json:"sort_order"`
	// UseCount records successful teammate creations from this template.
	UseCount int64 `gorm:"column:use_count;type:bigint;not null;default:0" json:"use_count"`
	// RecommendCount records template recommendation exposure actions.
	RecommendCount int64 `gorm:"column:recommend_count;type:bigint;not null;default:0" json:"recommend_count"`
	// Status controls whether the template can be listed and used.
	Status string `gorm:"column:status;type:varchar(32);not null;default:active;index" json:"status"`
	// IsSystem marks templates shipped by the platform.
	IsSystem bool `gorm:"column:is_system;type:boolean;not null;default:true" json:"is_system"`
}

type Action string

type ArtifactSource string

type ArtifactStatus string

type ArtifactType string

type AssistantPromptTrace struct {
	gorm.Model

	// SessionID references the session where this prompt was assembled.
	SessionID uint `gorm:"column:session_id;type:bigint;not null;index"`
	// MessageID references the user message that triggered this prompt assembly.
	MessageID uint `gorm:"column:message_id;type:bigint;not null;index"`
	// AssistantID references the AI teammate whose persona was assembled.
	AssistantID uint `gorm:"column:assistant_id;type:bigint;not null;index"`
	// CorePromptVersion records the mandatory identity prompt version.
	CorePromptVersion int `gorm:"column:core_prompt_version;type:integer;not null;default:1"`
	// InjectedBlockIDs records prompt block IDs injected into this request.
	InjectedBlockIDs SkillStringList `gorm:"column:injected_block_ids;type:jsonb"`
	// InjectedMemoryIDs records memory IDs injected into this request.
	InjectedMemoryIDs SkillStringList `gorm:"column:injected_memory_ids;type:jsonb"`
	// PromptHash stores a stable hash of the assembled prompt for debugging without duplicating long text.
	PromptHash string `gorm:"column:prompt_hash;type:varchar(128);index"`
}

type AuthLoginAttempt struct {
	gorm.Model
	Identifier      string    `gorm:"column:identifier;type:varchar(255);uniqueIndex;not null"`
	FailureCount    int       `gorm:"column:failure_count;type:integer;default:0;not null"`
	WindowExpiresAt time.Time `gorm:"column:window_expires_at;index;not null"`
}

type AuthPhoneVerificationCode struct {
	gorm.Model
	Phone     string     `gorm:"column:phone;type:varchar(32);index;not null"`
	CodeHash  string     `gorm:"column:code_hash;type:varchar(64);not null"`
	ExpiresAt time.Time  `gorm:"column:expires_at;index;not null"`
	UsedAt    *time.Time `gorm:"column:used_at;index"`
}

type AuthRefreshToken struct {
	gorm.Model
	TokenHash string     `gorm:"column:token_hash;type:varchar(64);uniqueIndex;not null"`
	Uin       uint       `gorm:"column:uin;type:bigint;index;not null;default:0"`
	LoginWay  int        `gorm:"column:login_way;type:int;not null;default:0"`
	ExpiresAt time.Time  `gorm:"column:expires_at;index;not null"`
	RevokedAt *time.Time `gorm:"column:revoked_at;index"`
}

type AuthState int

type Automation struct {
	gorm.Model

	// automation - 自动化唯一标识，格式如：auto_xxx，VARCHAR(255)，NOT NULL，UNIQUE
	PublicID string `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`

	// automation - 所属组织ID，INTEGER，NOT NULL，INDEX
	OrgID uint `gorm:"column:org_id;type:integer;not null;index"`

	// automation - 创建者用户ID（执行身份），INTEGER，NOT NULL，INDEX
	OwnerID uint `gorm:"column:owner_id;type:integer;not null;index"`

	// automation - 自动化名称，VARCHAR(100)，NOT NULL
	Name string `gorm:"column:name;type:varchar(100);not null"`

	// automation - 每轮发送给 Agent 的完整指令，TEXT，允许为空
	Instruction string `gorm:"column:instruction;type:text"`

	// automation - 是否接受周期触发，BOOLEAN，NOT NULL，DEFAULT TRUE
	Enabled bool `gorm:"column:enabled;type:boolean;not null;default:true"`

	// automation - 调度模式（calendar/interval），只表示底层计算模式，VARCHAR(16)，NOT NULL
	ScheduleMode string `gorm:"column:schedule_mode;type:varchar(16);not null"`

	// automation - 版本化规范化调度规则，JSONB，NOT NULL，DEFAULT '{}'
	ScheduleSpec AutomationScheduleSpec `gorm:"column:schedule_spec;type:jsonb;not null;default:'{}'"`

	// automation - IANA 时区，VARCHAR(64)，NOT NULL，DEFAULT 'Asia/Shanghai'
	Timezone string `gorm:"column:timezone;type:varchar(64);not null;default:'Asia/Shanghai'"`

	// automation - 创建时固定的默认 AI 队友 ID，BIGINT，NOT NULL，INDEX
	AssistantID uint `gorm:"column:assistant_id;type:bigint;not null;index"`

	// automation - 下一次计划执行时间（UTC），TIMESTAMP，可空
	NextRunAt *time.Time `gorm:"column:next_run_at;type:timestamp"`

	// automation - 最近一次实际生成 execution 的时间（UTC），TIMESTAMP，可空
	LastRunAt *time.Time `gorm:"column:last_run_at;type:timestamp"`

	// automation - 当前自动化项目主键，BIGINT，可空，INDEX
	ProjectID *uint `gorm:"column:project_id;type:bigint;index"`

	// automation - 当前项目代数，初始为 0，INTEGER，NOT NULL，DEFAULT 0
	ProjectGeneration int `gorm:"column:project_generation;type:integer;not null;default:0"`
}

type AutomationCalendarConfig struct {
	// Preset 预设类型：daily/weekly/monthly/hourly
	Preset string `json:"preset"`
	// Hour 小时（0-23）
	Hour int `json:"hour"`
	// Minute 分钟（0-59）
	Minute int `json:"minute"`
	// DaysOfWeek 每周预设的星期集合（0=周日，6=周六），0-6
	DaysOfWeek []int `json:"days_of_week,omitempty"`
	// DaysOfMonth 每月预设的日期集合（1-31）
	DaysOfMonth []int `json:"days_of_month,omitempty"`
}

type AutomationCalendarPreset string

type AutomationExecution struct {
	gorm.Model

	// autom_auto_exec - 对外 ID，格式如：autoexec_xxx，VARCHAR(255)，NOT NULL，UNIQUE
	PublicID string `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`

	// autom_auto_exec - 所属自动化主键，BIGINT，NOT NULL，INDEX（与 occurrence_key 组成唯一防重）
	AutomationID uint `gorm:"column:automation_id;type:bigint;not null;index;uniqueIndex:ux_auto_exec_occurrence"`

	// autom_auto_exec - 所属组织ID，BIGINT，NOT NULL，INDEX
	OrgID uint `gorm:"column:org_id;type:bigint;not null;index"`

	// autom_auto_exec - 执行身份（创建者）用户ID，BIGINT，NOT NULL，INDEX
	OwnerID uint `gorm:"column:owner_id;type:bigint;not null;index"`

	// autom_auto_exec - 触发来源：scheduled/manual，VARCHAR(16)，NOT NULL
	TriggerType AutomationExecutionTriggerType `gorm:"column:trigger_type;type:varchar(16);not null;index"`

	// autom_auto_exec - 周期防重键；周期触发用理论计划时间，手动触发用 execution public ID。
	// (automation_id, occurrence_key) 组合唯一，作为周期最终防重边界。
	OccurrenceKey string `gorm:"column:occurrence_key;type:varchar(128);not null;uniqueIndex:ux_auto_exec_occurrence"`

	// autom_auto_exec - 执行状态：queued/running/succeeded/failed/skipped，VARCHAR(16)，NOT NULL，INDEX
	Status AutomationExecutionStatus `gorm:"column:status;type:varchar(16);not null;default:'queued';index"`

	// autom_auto_exec - 理论触发时间（UTC），TIMESTAMP，NOT NULL
	ScheduledAt time.Time `gorm:"column:scheduled_at;not null;index"`

	// autom_auto_exec - Worker 最晚允许开始时间（UTC），TIMESTAMP，可空
	NotAfter *time.Time `gorm:"column:not_after;type:timestamp"`

	// autom_auto_exec - 实际开始时间（UTC），TIMESTAMP，可空
	StartedAt *time.Time `gorm:"column:started_at;type:timestamp"`

	// autom_auto_exec - 实际完成时间（UTC），TIMESTAMP，可空
	FinishedAt *time.Time `gorm:"column:finished_at;type:timestamp"`

	// autom_auto_exec - 自动化名称快照，VARCHAR(100)，NOT NULL
	NameSnapshot string `gorm:"column:name_snapshot;type:varchar(100);not null"`

	// autom_auto_exec - 指令快照，TEXT，允许为空
	InstructionSnapshot string `gorm:"column:instruction_snapshot;type:text"`

	// autom_auto_exec - 固定 AI 队友快照，BIGINT，NOT NULL
	AssistantIDSnapshot uint `gorm:"column:assistant_id_snapshot;type:bigint;not null"`

	// autom_auto_exec - 被折叠的更早遗漏数量，INTEGER，NOT NULL，DEFAULT 0
	MissedCount int `gorm:"column:missed_count;type:integer;not null;default:0"`

	// autom_auto_exec - 已创建项目主键，BIGINT，可空，INDEX
	ProjectID *uint `gorm:"column:project_id;type:bigint;index"`
	// autom_auto_exec - 已创建任务主键，BIGINT，可空，INDEX
	TaskID *uint `gorm:"column:task_id;type:bigint;index"`
	// autom_auto_exec - 已创建会话主键，BIGINT，可空，INDEX
	SessionID *uint `gorm:"column:session_id;type:bigint;index"`
	// autom_auto_exec - 已创建首条消息主键，BIGINT，可空，INDEX
	MessageID *uint `gorm:"column:message_id;type:bigint;index"`

	// autom_auto_exec - Worker Run 标识，VARCHAR(255)，可空，INDEX
	RunID string `gorm:"column:run_id;type:varchar(255);index"`

	// autom_auto_exec - Dispatcher 投递尝试次数，INTEGER，NOT NULL，DEFAULT 0
	AttemptCount int `gorm:"column:attempt_count;type:integer;not null;default:0"`

	// autom_auto_exec - 多实例执行领取租约持有者，VARCHAR(64)，可空
	LeaseOwner string `gorm:"column:lease_owner;type:varchar(64)"`
	// autom_auto_exec - 领取租约到期时间（UTC），TIMESTAMP，可空
	LeaseUntil *time.Time `gorm:"column:lease_until;type:timestamp"`

	// autom_auto_exec - 稳定错误码，VARCHAR(64)，可空
	ErrorCode string `gorm:"column:error_code;type:varchar(64)"`
	// autom_auto_exec - 可展示失败信息（入库前截断并清理敏感字段），TEXT，可空
	ErrorMsg string `gorm:"column:error_msg;type:text"`

	// autom_auto_exec - 命令成功写入 JetStream 的时间（UTC），TIMESTAMP，可空
	DispatchedAt *time.Time `gorm:"column:dispatched_at;type:timestamp"`
}

type AutomationExecutionStatus string

type AutomationExecutionTriggerType string

type AutomationIntervalConfig struct {
	// IntervalSeconds 间隔秒数
	IntervalSeconds int64 `json:"interval_seconds,omitempty"`
	// AnchorAt 本地时区锚点时间（ISO8601，不带时区偏移，解释为指定时区）
	AnchorAt string `json:"anchor_at,omitempty"`
	// IntervalMinutes 间隔分钟数（表单友好字段，服务端换算为秒并生成 interval_seconds）
	IntervalMinutes int `json:"interval_minutes,omitempty"`
	// IntervalUnit 间隔单位，只用于回显：minute/hour/day
	IntervalUnit string `json:"interval_unit,omitempty"`
}

type AutomationScheduleFormConfig struct {
	// Mode 调度模式（calendar/interval），与 Automation 的 schedule_mode 保持一致
	Mode string `json:"mode"`
	// Calendar 日历类预设配置（mode == "calendar" 时有效）
	Calendar *AutomationCalendarConfig `json:"calendar,omitempty"`
	// Interval 固定间隔配置（mode == "interval" 时有效）
	Interval *AutomationIntervalConfig `json:"interval,omitempty"`
	// Timezone 表单发起时的 IANA 时区
	Timezone string `json:"timezone,omitempty"`
}

type AutomationScheduleMode string

type AutomationSchedulePolicy struct {
	// MonthDayOverflow 当日历配置的日期超过目标月份实际天数时的处理方式
	// 取值为 last_day（月末回退），默认 last_day
	MonthDayOverflow string `json:"month_day_overflow,omitempty"`
}

type AutomationScheduleSpec struct {
	// FormConfig 前端表单编辑模型，用于编辑回显
	FormConfig *AutomationScheduleFormConfig `json:"form_config"`
	// Spec 编译后的规范化规则
	Spec AutomationScheduleSpecItem `json:"spec"`
}

type AutomationScheduleSpecItem struct {
	// Version 规则版本
	Version int `json:"version"`
	// Mode 底层计算模式：calendar/interval
	Mode string `json:"mode"`
	// Expression 日历模式下的 cron 表达式（mode == "calendar" 时有效）
	Expression string `json:"expression,omitempty"`
	// Policy 边界策略（月末回退等）
	Policy *AutomationSchedulePolicy `json:"policy,omitempty"`
	// AnchorAt 固定间隔模式的本地锚点时间
	AnchorAt string `json:"anchor_at,omitempty"`
	// IntervalSeconds 固定间隔模式的间隔秒数
	IntervalSeconds int64 `json:"interval_seconds,omitempty"`
	// Timezone 规则生效时区
	Timezone string `json:"timezone"`
}

type Caller struct {
	Uin      uint       `json:"uin"`
	OrgID    uint       `json:"org_id"`
	WorkerID uint       `json:"worker_id,omitempty"`
	Kind     CallerKind `json:"kind,omitempty"`
	State    AuthState  `json:"state"`
}

type CallerKind string

type ChannelType string

type Department struct {
	gorm.Model

	Name      string `` /* 134-byte string literal not displayed */
	ParentID  uint   `` /* 133-byte string literal not displayed */
	ParentIDs []uint `gorm:"column:parent_ids;type:jsonb;serializer:json;comment:祖先部门ID链，从根到直接父部门"`
	Sort      uint   `gorm:"column:sort;type:bigint;not null;default:0;comment:同级排序"`
	OrgID     uint   `` /* 150-byte string literal not displayed */
}

type DepartmentList []Department

type DigitalAssistant struct {
	gorm.Model
	// digital_assistant - 公开标识符，在组织内唯一标识数字助手，VARCHAR(255)，NOT NULL
	PublicID string `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`

	// digital_assistant - 所属组织ID，INTEGER，NOT NULL
	OrgID uint `gorm:"column:org_id;type:integer;not null;index"`
	// digital_assistant - 拥有者ID，INTEGER，NOT NULL
	OwnerID uint `gorm:"column:owner_id;type:integer;not null;index"`

	// digital_assistant - 数字助手名称，VARCHAR(255)，NOT NULL
	Name string `gorm:"column:name;type:varchar(255);not null"`
	// digital_assistant - 对外展示的角色名称，VARCHAR(255)，允许为空以兼容历史数据
	RoleName string `gorm:"column:role_name;type:varchar(255)"`

	// digital_assistant - 描述信息，TEXT，允许为空
	Description string `gorm:"column:description;type:text"`
	// digital_assistant - 头像URL地址，VARCHAR(500)，允许为空
	Avatar string `gorm:"column:avatar;type:varchar(500)"`

	// digital_assistant - 状态，表示数字助手当前运行状态，VARCHAR(50)，NOT NULL
	Status string `gorm:"column:status;type:varchar(50);not null"`
	// digital_assistant - 版本号，跟踪配置变动版本，INTEGER，默认值0
	Version int `gorm:"column:version;type:integer;default:0"`
	// digital_assistant - 系统提示词，定义数字助手的角色和行为，TEXT，允许为空
	SystemPrompt string `gorm:"column:system_prompt;type:text"`
	// digital_assistant - 擅长领域列表，JSONB，允许为空
	Expertise SkillStringList `gorm:"column:expertise;type:jsonb"`
	// digital_assistant - 来源模板ID，INTEGER，允许为空
	TemplateID *uint `gorm:"column:template_id;type:integer;index"`
	// digital_assistant - 创建来源，VARCHAR(32)，NOT NULL
	Source string `gorm:"column:source;type:varchar(32);not null;default:custom;index"`
}

type DigitalAssistantMemory struct {
	gorm.Model

	// AssistantID references the AI teammate that owns this memory.
	AssistantID uint `gorm:"column:assistant_id;type:bigint;not null;index:idx_da_memory_assistant_type"`
	// MemoryType identifies the memory category, such as preference, experience, template, fact, or rule.
	MemoryType string `gorm:"column:memory_type;type:varchar(32);not null;index:idx_da_memory_assistant_type"`
	// Content stores the memory text that can be retrieved and injected later.
	Content string `gorm:"column:content;type:text;not null"`
	// SourceType records where the memory came from, such as user_confirmed, task_summary, or manual.
	SourceType string `gorm:"column:source_type;type:varchar(64);not null;default:manual;index"`
	// SourceID optionally links the memory to a task, session, message, or external artifact.
	SourceID string `gorm:"column:source_id;type:varchar(255);index"`
	// Confidence records trust in this memory before it is used for prompt assembly.
	Confidence float64 `gorm:"column:confidence;type:double precision;not null;default:0.8;index"`
	// EmbeddingID stores the vector-store identifier when retrieval is enabled.
	EmbeddingID string `gorm:"column:embedding_id;type:varchar(255);index"`
	// Enabled controls whether the memory can participate in retrieval.
	Enabled bool `gorm:"column:enabled;type:boolean;not null;default:true;index"`
}

type DigitalAssistantPromptBlock struct {
	gorm.Model

	// AssistantID references the AI teammate that owns this prompt block.
	AssistantID uint `gorm:"column:assistant_id;type:bigint;not null;index:idx_da_prompt_block_assistant_type"`
	// BlockType identifies the prompt layer, such as identity, capability, boundary, style, or example.
	BlockType string `gorm:"column:block_type;type:varchar(32);not null;index:idx_da_prompt_block_assistant_type"`
	// Title is a short management label for the block.
	Title string `gorm:"column:title;type:varchar(255);not null"`
	// Content stores the prompt fragment that can be injected when this layer is selected.
	Content string `gorm:"column:content;type:text;not null"`
	// Priority controls deterministic ordering when multiple blocks are injected.
	Priority int `gorm:"column:priority;type:integer;not null;default:0;index"`
	// Enabled controls whether the block can participate in prompt assembly.
	Enabled bool `gorm:"column:enabled;type:boolean;not null;default:true;index"`
	// Version tracks prompt block edits for traceability.
	Version int `gorm:"column:version;type:integer;not null;default:1"`
}

type DigitalAssistantStatus string

type Event struct {
	gorm.Model

	MessageID string // 消息唯一标识符
	TraceID   string // 分布式追踪 ID
	Source    string // 事件来源
	Type      string // 事件类型（建议使用 types.EventType 定义的常量值）
	Action    string // 事件动作（建议使用 types.EventAction 定义的常量值）

	Actor  string // 事件触发者
	Target string // 事件目标

	Payload map[string]interface{} `gorm:"type:jsonb"` // 事件负载数据

	Timestamp int64 // 事件时间戳
}

type EventAction string

type EventType string

type ExecutionMode string

type FileUpload struct {
	gorm.Model
	PublicID     string         `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`
	OwnerScope   OwnerScope     `` /* 237-byte string literal not displayed */
	OrgID        uint           `gorm:"column:org_id;type:integer;not null;index"`
	OwnerID      uint           `gorm:"column:owner_id;type:integer;not null;index"`
	Filename     string         `gorm:"column:filename;type:varchar(500)"`
	OriginalName string         `gorm:"column:original_name;type:varchar(500)"`
	MimeType     string         `gorm:"column:mime_type;type:varchar(100)"`
	FileSize     int64          `gorm:"column:file_size;type:bigint"`
	StorageURI   string         `gorm:"column:storage_uri;type:varchar(500);not null"`
	Sha256       string         `gorm:"column:sha256;type:varchar(64);index"`
	Purpose      string         `gorm:"column:purpose;type:varchar(50);index"`
	Status       string         `gorm:"column:status;type:varchar(50);not null;default:'active';index"`
	Metadata     ObjectMetadata `gorm:"column:metadata;type:jsonb"`
}

type Filter struct {
	Field      string   `json:"field"`
	Value      []string `json:"value"`
	ExactMatch bool     `json:"exact_match"`
}

type IdentityContext struct {
	Caller *Caller `json:"caller"`
	Trace  *Trace  `json:"trace"`
}

type KnowledgeType string

type LLMHistory struct {
	gorm.Model

	// 组织ID，用于隔离不同组织的调用记录
	OrgID uint `gorm:"column:org_id;type:integer;not null;index:idx_llm_call_org_started;sort:desc"`
	// 调用所使用的模型ID，关联LLMModel表
	ModelID uint `gorm:"column:model_id;type:integer;index:idx_llm_call_model"`
	// 模型供应商标识，例如 openai、anthropic、deepseek
	Provider string `gorm:"column:provider;type:varchar(64);not null"`
	// 实际调用的模型名称
	ModelName string `gorm:"column:model_name;type:varchar(255);not null"`
	// 模型供应商（与 provider 一致，单独存储便于检索）
	ModelProvider string `gorm:"column:model_provider;type:varchar(50);not null;default:''"`
	// 调用入口协议，如 openai_chat、anthropic_messages、openai_responses、gemini
	EntryProtocol string `gorm:"column:entry_protocol;type:varchar(32)"`
	// 是否为流式调用
	IsStream bool `gorm:"column:is_stream;type:boolean;default:false"`
	// 输入Token数量
	InputTokens int `gorm:"column:input_tokens;type:integer;default:0"`
	// 输出Token数量
	OutputTokens int `gorm:"column:output_tokens;type:integer;default:0"`
	// 总Token数量
	TotalTokens int `gorm:"column:total_tokens;type:integer;default:0"`
	// 调用耗时，单位毫秒
	LatencyMS int64 `gorm:"column:latency_ms;type:bigint;default:0"`
	// Prompt Token 用量（大整型）
	PromptTokens int64 `gorm:"column:prompt_tokens;type:bigint;default:0"`
	// 缓存命中 Token 数
	CacheHitTokens int64 `gorm:"column:cache_hit_tokens;type:bigint;default:0"`
	// 缓存未命中 Token 数
	CacheMissTokens int64 `gorm:"column:cache_miss_tokens;type:bigint;default:0"`
	// HTTP状态码或供应商返回的业务状态码
	StatusCode int `gorm:"column:status_code;type:integer;default:0"`
	// 调用是否成功
	Success bool `gorm:"column:success;type:boolean;default:false;index:idx_llm_call_success"`
	// 调用状态字符串：success / error
	Status string `gorm:"column:status;type:varchar(50);not null;default:''"`
	// 失败时的错误信息
	Message string `gorm:"column:message;type:text"`
	// 调用方类型，如 worker、api、skill
	CallerType string `gorm:"column:caller_type;type:varchar(64);not null;index:idx_llm_call_caller"`
	// 业务请求标识，用于串联链路上的 LLM 调用与业务事件
	ReqID string `gorm:"column:req_id;type:varchar(255);default:''"`
	// 追踪ID
	TraceID string `gorm:"column:trace_id;type:varchar(255);not null;default:''"`
	// 重试次数
	RetryTimes int64 `gorm:"column:retry_times;type:bigint;default:1"`
	// 输入长度
	InputLen int `gorm:"column:input_len;type:integer;default:0"`
	// 输出长度
	OutputLen int `gorm:"column:output_len;type:integer;default:0"`
	// 输入是否被截断
	InputTruncated bool `gorm:"column:input_truncated;type:boolean;default:false"`
	// 输出是否被截断
	OutputTruncated bool `gorm:"column:output_truncated;type:boolean;default:false"`
	// 客户端IP
	ClientIP string `gorm:"column:client_ip;type:varchar(64);default:''"`
	// 项目ID，关联 leros_leros_project 表
	ProjectID uint `gorm:"column:project_id;type:integer;not null;default:0;index:idx_llm_call_project"`
	// 会话ID，关联 leros_leros_session 表
	SessionID uint `gorm:"column:session_id;type:integer;not null;default:0;index:idx_llm_call_session"`
	// 消息ID，关联 leros_leros_session_message 表
	MessageID uint `gorm:"column:message_id;type:integer;not null;default:0"`
	// 数字助理ID，关联 leros_leros_assistant 表
	AssistantID uint `gorm:"column:assistant_id;type:integer;not null;default:0;index:idx_llm_call_assistant"`
	// 用户ID，关联 leros_leros_user 表
	Uin uint `gorm:"column:uin;type:integer;not null;default:0;index:idx_llm_call_uin"`
	// 模型调用时的完整输入数据（messages / prompt）
	Input string `gorm:"column:input;type:text"`
	// 模型调用时的完整输出数据（response body / assistant message）
	Output string `gorm:"column:output;type:text"`
	// 调用开始时间
	StartedAt time.Time `gorm:"column:started_at;type:timestamp;not null;index:idx_llm_call_org_started;sort:desc"`
	// 调用结束时间
	FinishedAt time.Time `gorm:"column:finished_at;type:timestamp"`
}

type LLMLimitFields struct {
	Context int `json:"context,omitempty"`
	Output  int `json:"output,omitempty"`
}

type LLMModel struct {
	gorm.Model

	// 模型所属组织ID，用于隔离不同组织的模型配置
	OrgID uint `` /* 168-byte string literal not displayed */
	// 模型配置编码，在组织内唯一，用于业务配置引用
	Code string `gorm:"column:code;type:varchar(128);not null;uniqueIndex:idx_llm_model_org_code"`
	// 模型展示名称，用于前端列表和选择器展示
	Name string `gorm:"column:name;type:varchar(255);not null"`
	// 模型描述，用于记录用途、额度、注意事项等说明
	Description string `gorm:"column:description;type:text"`

	// 模型供应商标识，例如 openai、anthropic、deepseek、custom
	Provider string `gorm:"column:provider;type:varchar(64);not null;index"` // 建议使用 types.LLMProviderType 定义的常量值
	// 实际传递给供应商API或CLI的模型名称
	ModelName string `gorm:"column:model;type:varchar(255);not null"`
	// API基础地址，官方默认地址可为空，自定义网关或兼容接口需填写
	BaseURL string `gorm:"column:base_url;type:varchar(500)"`
	// 是否已确认基础地址包含 /v1 前缀，记录连通性探测结果。默认 true 以兼容已有数据。
	BaseURLHasV1 bool `gorm:"column:base_url_has_v1;type:boolean;default:true"`

	// API Key密文，业务读取时需要通过统一密钥服务解密
	APIKeyEncrypted string `gorm:"column:api_key_encrypted;type:text"`
	// API Key脱敏展示值，仅用于前端展示，禁止用于真实调用
	APIKeyMasked string `gorm:"column:api_key_masked;type:varchar(128)"`

	// 默认最大输出Token数，运行请求可按需覆盖
	MaxTokens int `gorm:"column:max_tokens;type:integer;default:4096"`
	// 默认采样温度，运行请求可按需覆盖
	Temperature float64 `gorm:"column:temperature;type:decimal(4,3);default:0.7"`
	// 默认请求超时时间，单位秒
	TimeoutSec int `gorm:"column:timeout_sec;type:integer;default:120"`

	// 模型状态，inactive状态下不应被新任务选择
	Status string `gorm:"column:status;type:varchar(32);not null;default:active;index"` // 建议使用 types.LLMModelStatus 定义的常量值
	// 是否为组织默认模型，业务未显式选择模型时可回退到该模型
	IsDefault bool `gorm:"column:is_default;type:boolean;default:false;index"`
	// 是否为系统内置配置，内置配置可用于初始化或演示场景
	IsSystem bool `gorm:"column:is_system;type:boolean;default:false"`

	// 扩展配置，保存能力标记、上下文窗口、价格、额外Header等非核心字段
	Config LLMModelConfig `gorm:"column:config;type:jsonb"`
}

type LLMModelConfig map[string]interface{}

type LLMModelStatus string

type LLMProviderType string

type LLMSamplingParams struct {
	TopP             *float64        `json:"top_p,omitempty"`
	FrequencyPenalty *float64        `json:"frequency_penalty,omitempty"`
	PresencePenalty  *float64        `json:"presence_penalty,omitempty"`
	Limit            *LLMLimitFields `json:"limit,omitempty"`
}

type MCPChannel struct {
	gorm.Model

	Channel     string                   `gorm:"column:channel;type:varchar(64);not null;uniqueIndex:ux_mcp_channel_channel"`
	Name        string                   `gorm:"column:name;type:varchar(255);not null"`
	Description string                   `gorm:"column:description;type:text"`
	SkillCode   string                   `gorm:"column:skill_code;type:varchar(128);not null;default:''"`
	Transport   string                   `gorm:"column:transport;type:varchar(32);not null;default:''"`
	URL         string                   `gorm:"column:url;type:varchar(2000);not null;default:''"`
	Headers     MCPChannelHeaders        `gorm:"column:headers;type:jsonb;not null;default:'{}'"`
	AuthType    string                   `gorm:"column:auth_type;type:varchar(32);not null;default:'none'"`
	AuthConfig  MCPChannelAuthConfigJSON `gorm:"column:auth_config;type:jsonb;not null;default:'{}'"`
	Status      string                   `gorm:"column:status;type:varchar(32);not null;default:'active';index"`
}

type MCPChannelAuthBindings struct {
	SkillEnv       map[string]string `json:"skill_env,omitempty"`
	MCPBearerToken string            `json:"mcp_bearer_token,omitempty"`
	MCPHeaders     map[string]string `json:"mcp_headers,omitempty"`
	MCPEnv         map[string]string `json:"mcp_env,omitempty"`
	MCPQuery       map[string]string `json:"mcp_query,omitempty"`
}

type MCPChannelAuthConfig struct {
	Fields   []MCPChannelAuthField  `json:"fields,omitempty"`
	Bindings MCPChannelAuthBindings `json:"bindings,omitempty"`
	Handler  string                 `json:"handler,omitempty"`
	OAuth    *MCPChannelOAuthConfig `json:"oauth,omitempty"`
}

type MCPChannelAuthConfigJSON MCPChannelAuthConfig

type MCPChannelAuthField struct {
	Key         string `json:"key"`
	Label       string `json:"label"`
	Type        string `json:"type"`
	Required    bool   `json:"required"`
	Placeholder string `json:"placeholder,omitempty"`
	Description string `json:"description,omitempty"`
}

type MCPChannelHeaders map[string]string

type MCPChannelOAuthConfig struct {
	AppKey      string   `json:"app_key,omitempty"`
	SecretKey   string   `json:"secret_key,omitempty"`
	RedirectURI string   `json:"redirect_uri,omitempty"`
	Scopes      []string `json:"scopes,omitempty"`
}

type MemberDepartment struct {
	gorm.Model

	Uin          uint `gorm:"column:uin;type:bigint;not null;index;comment:组织成员Uin"`
	OrgID        uint `gorm:"column:org_id;type:bigint;not null;comment:组织ID"`
	DepartmentID uint `gorm:"column:department_id;type:bigint;not null;index;comment:部门ID"`
	IsPrimary    bool `gorm:"column:is_primary;type:boolean;not null;default:false;comment:是否为主部门"`
}

type MemberDepartmentList []MemberDepartment

type MemberInput struct {
	// TargetUin 被操作用户的 Uin（与 TargetAssistantID 互斥）。
	TargetUin uint
	// TargetAssistantID 被操作助手的 ID（与 TargetUin 互斥）。
	TargetAssistantID *uint
	// RequestedRole 本次操作希望赋予目标的角色。
	RequestedRole ResourceRole
}

type MemberRole string

type MemberType string

type MemoryType string

type MessageArtifact struct {
	ArtifactID   string    `json:"artifact_id,omitempty"`
	Title        string    `json:"title,omitempty"`
	Filename     string    `json:"filename,omitempty"`
	Description  string    `json:"description,omitempty"`
	MimeType     string    `json:"mime_type,omitempty"`
	ArtifactType string    `json:"artifact_type,omitempty"`
	FileSize     int64     `json:"file_size,omitempty"`
	StorageURI   string    `json:"storage_uri,omitempty"`
	Sha256       string    `json:"sha256,omitempty"`
	CreatedAt    time.Time `json:"created_at,omitempty"`
	VersionNo    int       `json:"version_no,omitempty"`
}

type MessageArtifactSlice []MessageArtifact

type MessageAttachment struct {
	FileUploadID string `json:"file_upload_id"`
	Name         string `json:"name"`
	MimeType     string `json:"mime_type"`
	Size         int64  `json:"size"`
	Purpose      string `json:"purpose,omitempty"`
	PublicURL    string `json:"PublicURL"`
	RelativePath string `json:"relative_path"`
}

type MessageAttachmentSlice []MessageAttachment

type MessageChunk struct {
	Seq         int64           `json:"seq,omitempty"`
	LastSeq     int64           `json:"last_seq,omitempty"`
	Type        string          `json:"type"`
	Timestamp   int64           `json:"timestamp,omitempty"`
	Payload     json.RawMessage `json:"payload,omitempty" swaggertype:"object"`
	AssistantID string          `json:"assistant_id,omitempty"`
}

type MessageChunkSlice []MessageChunk

type MessageResource struct {
	gorm.Model
	ResourceID   string `gorm:"column:resource_id;type:varchar(255);not null;index"`  // DB primary key of the resource (empty if not found)
	MessageID    uint   `gorm:"column:message_id;type:bigint;not null;index"`         // FK to leros_session_message.id
	SessionID    uint   `gorm:"column:session_id;type:bigint;not null;index"`         // FK to leros_session.id
	OrgID        uint   `gorm:"column:org_id;type:integer;not null;default:0;index"`  // org isolation
	Uin          uint   `gorm:"column:uin;type:bigint;default:0;index"`               // user isolation
	ResourceType string `gorm:"column:resource_type;type:varchar(50);not null;index"` // skill / MCP / tool / ...
	ResourceKey  string `gorm:"column:resource_key;type:varchar(255);not null;index"` // {source}:{skill_id} composite key
	ResourceName string `gorm:"column:resource_name;type:varchar(255);not null"`      // resource display name
	InvokeType   string `gorm:"column:invoke_type;type:varchar(50);not null"`         // slash_command / mention / auto / ...
	Seq          int    `gorm:"column:seq;type:integer;not null;default:0"`           // order within the same message
}

type MessageRole string

type MessageStatus string

type MessageType string

type MessageUsage struct {
	TotalTokens       int `json:"total_tokens"`
	InputTokens       int `json:"input_tokens"`
	OutputTokens      int `json:"output_tokens"`
	CacheInputTokens  int `json:"cache_input_tokens"`
	CacheOutputTokens int `json:"cache_output_tokens"`
}

type ObjectMetadata struct {
	// 元数据 - 项目标签
	Tags []string `json:"tags,omitempty"`
	// 元数据 - 项目类型/模板标识
	Type string `json:"type,omitempty"`
	// 元数据 - 对象存储桶
	Bucket string `json:"bucket,omitempty"`
	// 元数据 - 对象存储键
	Key string `json:"key,omitempty"`
	// 元数据 - 其他扩展字段
	Extra map[string]interface{} `json:"extra,omitempty"`
}

type Organization struct {
	gorm.Model
	ExternalCompanyID uint   `gorm:"column:external_company_id;index"`                                  // identity-platform Company.ID
	PublicID          string `gorm:"column:public_id;type:varchar(64);uniqueIndex;not null;default:''"` // 组织公开ID
	Type              string `gorm:"column:type;type:varchar(50);default:'company'"`                    // 组织类型: company/team/project
	Code              string `gorm:"column:code;type:varchar(255);unique_index;not null"`               // 组织代码（唯一）
	Name              string `gorm:"column:name;type:varchar(255);not null"`                            // 组织名称
	Status            string `gorm:"column:status;type:varchar(20);default:'active'"`                   // 状态: active/inactive
	Description       string `gorm:"column:description;type:varchar(256)"`                              // 组织描述
	Logo              string `gorm:"column:logo;type:varchar(256)"`                                     // 组织 Logo URL
	Address           string `gorm:"column:address;type:varchar(256)"`                                  // 联系地址
	Website           string `gorm:"column:website;type:varchar(256)"`                                  // 官网地址
	CreatedByUin      uint   `gorm:"column:created_by_uin;type:bigint;default:0"`                       // 创建者 Uin
}

type OwnerScope string

type PageQuery struct {
	Filters    []Filter `json:"filters,omitempty"`
	OrderBy    []string `json:"order_by,omitempty"`
	ProjectIDs []uint   `json:"-"`
	Caller     `json:"-"`
	Pagination `json:",inline"`
}

type Pagination struct {
	Offset  int  `json:"offset,omitempty"`
	Limit   int  `json:"limit,omitempty"`
	ListAll bool `json:"list_all,omitempty"`
}

type PermissionCaller struct {
	OrgID       uint
	Uin         uint
	AssistantID uint
}

type PermissionDecision struct {
	Allowed           bool
	Reason            string
	Role              ResourceRole
	ResourceID        uint
	MatchedBindingID  uint
	MatchedResourceID uint
}

type PermissionExplainDecision struct {
	PermissionDecision
	Inherited bool
}

type Plugin struct {
	gorm.Model

	PublicID        string     `gorm:"column:public_id;type:varchar(255);not null"`
	OwnerScope      OwnerScope `` /* 198-byte string literal not displayed */
	OrgID           uint       `gorm:"column:org_id;type:bigint;not null"`
	Code            string     `gorm:"column:code;type:varchar(128);not null"`
	Kind            string     `gorm:"column:kind;type:varchar(32);not null"`
	Name            string     `gorm:"column:name;type:varchar(255);not null"`
	Description     string     `gorm:"column:description;type:text"`
	Status          string     `gorm:"column:status;type:varchar(32);not null;default:'active'"`
	Origin          string     `gorm:"column:origin;type:varchar(32);not null;default:'org'"`
	CurrentRevision int        `gorm:"column:current_revision;type:integer;not null;default:0"`
	CreatedBy       uint       `gorm:"column:created_by;type:bigint;not null"`
	UpdatedBy       uint       `gorm:"column:updated_by;type:bigint;not null"`
}

type PluginMarketplaceItem struct {
	gorm.Model

	PublicID    string           `gorm:"column:public_id;type:varchar(255);not null"`
	PluginID    uint             `gorm:"column:plugin_id;type:bigint;not null;check:chk_marketplace_plugin_id,plugin_id > 0"`
	Kind        string           `gorm:"column:kind;type:varchar(32);not null"`
	Code        string           `gorm:"column:code;type:varchar(128);not null"`
	Name        string           `gorm:"column:name;type:varchar(255);not null"`
	Description string           `gorm:"column:description;type:text"`
	Author      string           `gorm:"column:author;type:varchar(255);not null;default:''"`
	SourceType  string           `gorm:"column:source_type;type:varchar(32);not null"`
	SourceRef   string           `gorm:"column:source_ref;type:varchar(1000);not null"`
	Status      string           `gorm:"column:status;type:varchar(32);not null;default:'published'"`
	Category    string           `gorm:"column:category;type:varchar(100);not null;default:''"`
	Tags        PluginStringList `gorm:"column:tags;type:jsonb;not null;default:'[]'"`
	Icon        string           `gorm:"column:icon;type:varchar(1000)"`
	Verified    bool             `gorm:"column:verified;type:boolean;not null;default:false"`
	PublishedAt time.Time        `gorm:"column:published_at;not null"`
}

type PluginRevision struct {
	gorm.Model

	PluginID                uint            `gorm:"column:plugin_id;type:bigint;not null"`
	SourceMarketplaceItemID *uint           `gorm:"column:source_marketplace_item_id;type:bigint"`
	SourcePluginRevisionID  *uint           `gorm:"column:source_plugin_revision_id;type:bigint"`
	Revision                int             `gorm:"column:revision;type:integer;not null"`
	Status                  string          `gorm:"column:status;type:varchar(32);not null;default:'published'"`
	Definition              json.RawMessage `gorm:"column:definition;type:jsonb;not null;default:'{}'"`
	PublishedByType         string          `gorm:"column:published_by_type;type:varchar(32);not null"`
	PublishedByID           uint            `gorm:"column:published_by_id;type:bigint;not null"`
	PublishedAt             time.Time       `gorm:"column:published_at;not null"`
}

type PluginRevisionContent struct {
	gorm.Model

	PluginRevisionID  uint                   `gorm:"column:plugin_revision_id;type:bigint;not null;uniqueIndex:ux_plugin_revision_content_revision"`
	Schema            string                 `gorm:"column:schema;type:varchar(32);not null"`
	ArtifactSHA256    string                 `gorm:"column:artifact_sha256;type:varchar(64);not null"`
	EntrypointPath    string                 `gorm:"column:entrypoint_path;type:varchar(1000);not null"`
	EntrypointContent string                 `gorm:"column:entrypoint_content;type:text;not null"`
	FileIndex         PluginRevisionFileList `gorm:"column:file_index;type:jsonb;not null;default:'[]'"`
}

type PluginRevisionFile struct {
	Path      string `json:"path"`
	SizeBytes int64  `json:"size_bytes"`
	SHA256    string `json:"sha256"`
}

type PluginRevisionFileList []PluginRevisionFile

type PluginStringList []string

type Project struct {
	gorm.Model
	// project - 项目唯一标识，格式如：prj_xxx，VARCHAR(255)，NOT NULL，UNIQUE
	PublicID string `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`

	// project - 所属组织ID，INTEGER，NOT NULL，INDEX
	OrgID uint `gorm:"column:org_id;type:integer;not null;index"`

	// project - 创建者用户ID，INTEGER，NOT NULL，INDEX
	OwnerID uint `gorm:"column:owner_id;type:integer;not null;index"`

	// project - 项目名称，VARCHAR(255)，NOT NULL
	Name string `gorm:"column:name;type:varchar(255);not null"`

	// project - 项目描述，TEXT，允许为空
	Description string `gorm:"column:description;type:text"`

	// project - 项目目标，TEXT，允许为空
	Objective string `gorm:"column:objective;type:text"`

	// project - 项目状态，VARCHAR(50)，NOT NULL，DEFAULT 'active'
	Status string `gorm:"column:status;type:varchar(50);not null;default:'active';index"`

	// project - gitea 仓库全名（格式：org/repo_name），VARCHAR(255)
	GiteaRepoFullName string `gorm:"column:gitea_repo_full_name;type:varchar(255)"`

	// project - gitea 内部仓库 ID，BIGINT
	GiteaRepoID int64 `gorm:"column:gitea_repo_id;type:bigint"`

	// project - gitea 仓库默认分支名，VARCHAR(128)，DEFAULT 'main'
	GiteaDefaultBranch string `gorm:"column:gitea_default_branch;type:varchar(128);default:'main'"`

	// project - 元数据（JSON格式存储标签等扩展信息），JSONB，允许为空
	Metadata ObjectMetadata `gorm:"column:metadata;type:jsonb"`

	// project - 关联的自动化主键（自动化为该自动化创建），BIGINT，可空，INDEX
	AutomationID *uint `gorm:"column:automation_id;type:bigint;index"`
	// project - 项目代数（该自动化下第几代项目），INTEGER，可空，DEFAULT 0
	AutomationGeneration int `gorm:"column:automation_generation;type:integer;default:0"`
}

type ProjectActivity struct {
	ID         uint                   `gorm:"primaryKey" json:"id"`
	ProjectID  string                 `` /* 180-byte string literal not displayed */
	OperatorID string                 `` /* 182-byte string literal not displayed */
	ActionType ProjectActivityAction  `gorm:"column:action_type;type:varchar(64);not null;index" json:"action_type"`
	Payload    ProjectActivityPayload `gorm:"column:payload;type:jsonb;serializer:json" json:"payload"`
	RequestID  *string                `` /* 141-byte string literal not displayed */
	Version    int16                  `gorm:"column:version;type:smallint;not null;default:1" json:"version"`
	CreatedAt  time.Time              `` /* 244-byte string literal not displayed */
}

type ProjectActivityAction string

type ProjectActivityPayload struct {
	AddedSkillIDs        []string `json:"added_skill_ids"`
	RemovedSkillIDs      []string `json:"removed_skill_ids"`
	AddedMCPIDs          []string `json:"added_mcp_ids"`
	RemovedMCPIDs        []string `json:"removed_mcp_ids"`
	AddedMemberIDs       []string `json:"added_member_ids"`
	RemovedMemberIDs     []string `json:"removed_member_ids"`
	AddedAITeammateIDs   []string `json:"added_ai_teammate_ids"`
	RemovedAITeammateIDs []string `json:"removed_ai_teammate_ids"`
}

type ProjectFile struct {
	gorm.Model
	FilePublicID string                  `gorm:"column:file_public_id;type:varchar(255);not null;index"`
	OrgID        uint                    `` /* 136-byte string literal not displayed */
	ProjectID    uint                    `` /* 139-byte string literal not displayed */
	TaskID       uint                    `gorm:"column:task_id;type:bigint;index"`
	ResourceID   uint                    `gorm:"column:resource_id;type:bigint;not null;default:0;index"`
	ResourceType ProjectFileResourceType `gorm:"column:resource_type;type:varchar(50);not null;index;index:idx_project_file_path,priority:3"`
	Uin          uint                    `gorm:"column:uin;type:bigint;index"`

	RelativePath        string `gorm:"column:relative_path;type:varchar(1000);not null;default:'';index:idx_project_file_path,priority:4"`
	InitialFilePublicID string `` /* 129-byte string literal not displayed */
	VersionNo           int    `gorm:"column:version_no;type:integer;not null;default:1;index:idx_project_file_version_lookup,priority:4"`
}

type ProjectFileResourceType string

type ProjectMember struct {
	gorm.Model
	// project_member - 关联项目ID，BIGINT，NOT NULL，INDEX
	ProjectID uint `gorm:"column:project_id;type:bigint;not null;index"`

	// project_member - 成员ID（用户ID或数字助手ID），BIGINT，NOT NULL，INDEX
	MemberID uint `gorm:"column:member_id;type:bigint;not null;index"`

	// project_member - 成员类型（user/assistant），VARCHAR(50)，NOT NULL
	MemberType MemberType `gorm:"column:member_type;type:varchar(50);not null;default:'user'"`

	// project_member - 成员角色（owner/admin/member/viewer），VARCHAR(50)，NOT NULL
	MemberRole MemberRole `gorm:"column:member_role;type:varchar(50);not null;default:'member'"`

	// project_member - 是否为系统默认绑定的 AI 队友（不可被用户移除），BOOLEAN，NOT NULL，DEFAULT FALSE
	IsDefault bool `gorm:"column:is_default;type:boolean;not null;default:false"`

	// project_member - 加入时间，TIMESTAMP，NOT NULL
	JoinedAt time.Time `gorm:"column:joined_at;not null;default:CURRENT_TIMESTAMP"`
}

type ProjectPluginBinding struct {
	gorm.Model

	ProjectID uint   `gorm:"column:project_id;type:bigint;not null"`
	PluginID  uint   `gorm:"column:plugin_id;type:bigint;not null"`
	Enabled   bool   `gorm:"column:enabled;type:boolean;not null;default:true"`
	Config    []byte `gorm:"column:config;type:jsonb;not null;default:'{}'"`
	CreatedBy uint   `gorm:"column:created_by;type:bigint;not null"`
	UpdatedBy uint   `gorm:"column:updated_by;type:bigint;not null"`
}

type ProjectStatus string

type ProjectionReceipt struct {
	gorm.Model
	Consumer  string `gorm:"column:consumer;type:varchar(128);not null;uniqueIndex:ux_projection_receipt"`
	EventID   string `gorm:"column:event_id;type:varchar(255);not null;uniqueIndex:ux_projection_receipt"`
	RunID     string `gorm:"column:run_id;type:varchar(255);index"`
	SessionID string `gorm:"column:session_id;type:varchar(255);not null;index"`
	EventType string `gorm:"column:event_type;type:varchar(64);not null"`
}

type ReliableTask struct {
	gorm.Model
	TaskID        string             `gorm:"column:task_id;type:varchar(255);not null;uniqueIndex"`
	Kind          string             `gorm:"column:kind;type:varchar(64);not null;uniqueIndex:ux_reliable_task_source,priority:1"`
	Destination   string             `gorm:"column:destination;type:varchar(512);not null"`
	ContentType   string             `gorm:"column:content_type;type:varchar(64);not null;default:'application/json'"`
	Payload       []byte             `gorm:"column:payload;type:jsonb;not null"`
	SourceType    string             `` /* 140-byte string literal not displayed */
	SourceID      string             `` /* 139-byte string literal not displayed */
	PartitionKey  string             `gorm:"column:partition_key;type:varchar(255);index"`
	Status        ReliableTaskStatus `gorm:"column:status;type:varchar(32);not null;index:idx_reliable_task_ready,priority:1"`
	AttemptCount  int                `gorm:"column:attempt_count;not null;default:0"`
	NextAttemptAt time.Time          `gorm:"column:next_attempt_at;not null;index:idx_reliable_task_ready,priority:2"`
	DeadlineAt    time.Time          `gorm:"column:deadline_at;not null;index"`
	LeaseOwner    string             `gorm:"column:lease_owner;type:varchar(255)"`
	LeaseUntil    *time.Time         `gorm:"column:lease_until;index"`
	PublishedAt   *time.Time         `gorm:"column:published_at"`
	LastError     string             `gorm:"column:last_error;type:text"`
}

type ReliableTaskStatus string

type Resource struct {
	gorm.Model

	// OrgID 将资源限定在特定组织范围内。
	OrgID uint `` /* 141-byte string literal not displayed */
	// Uin 记录资源创建或归属用户，不作为最终权限来源。
	Uin uint `gorm:"column:uin;type:bigint;not null;default:0;index:idx_leros_resource_uin"`
	// Type 是资源类型，PermissionService 按资源类型和动作判断权限。
	Type ResourceType `` /* 144-byte string literal not displayed */
	// BizID 指向业务对象的内部 ID，例如 projects.id、文件 ID、artifact ID。
	BizID uint `gorm:"column:biz_id;type:bigint;not null;uniqueIndex:ux_leros_resource_active_biz,where:deleted_at IS NULL"`
	// ParentResourceID 指向父资源，用于继承权限。
	ParentResourceID *uint `gorm:"column:parent_resource_id;type:bigint;index:idx_leros_resource_parent"`
	// ParentResourcePathIDs 从根到父节点存储祖先资源 ID。
	ParentResourcePathIDs ResourcePathIDs `gorm:"column:parent_resource_path_ids;type:bigint[];not null;default:'{}'"`
}

type ResourceBinding struct {
	gorm.Model

	// OrgID 冗余组织字段，用于快速过滤和防止跨组织误查。
	OrgID uint `` /* 151-byte string literal not displayed */
	// Uin 是被绑定用户的 Uin，用户主体时非 nil 且非 0。
	Uin *uint `` /* 228-byte string literal not displayed */
	// ResourceID 是绑定的资源 ID。
	ResourceID uint `` /* 311-byte string literal not displayed */
	// AssistantID 是被绑定的助手 ID，与 Uin 互斥，助手主体时非 nil 且非 0。
	AssistantID *uint `` /* 209-byte string literal not displayed */
	// Role 是主体在该资源上的角色。
	Role ResourceRole `gorm:"column:resource_role;type:varchar(50);not null"`
}

type ResourcePathIDs []uint

type ResourceRef struct {
	Type  ResourceType
	BizID uint
}

type ResourceRole string

type ResourceType string

type RuntimeType string

type SeedExecStatus string

type SeedRecord struct {
	ID           uint           `gorm:"column:id;primarykey"`
	FileName     string         `gorm:"column:file_name;type:varchar(255);not null;index"`
	ExecStatus   SeedExecStatus `gorm:"column:exec_status;type:varchar(10);not null;index"`
	ErrorMessage string         `gorm:"column:error_message;type:text"`
	FailLineAt   int            `gorm:"column:fail_line_at;type:int;not null"`
	StartTime    time.Time      `gorm:"column:start_time"`
	EndTime      time.Time      `gorm:"column:end_time"`
	ExecTime     float64        `gorm:"column:exec_time"`
}

type Session struct {
	gorm.Model
	// session - 会话对外唯一标识，格式如：sess_xxx，VARCHAR(255)，NOT NULL，UNIQUE
	PublicID string `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`

	// session - 会话类型，VARCHAR(50)，NOT NULL
	Type SessionType `gorm:"column:type;type:varchar(50);not null"`

	// session - 关联用户UIN，0表示不关联，BIGINT，DEFAULT 0
	Uin uint `gorm:"column:uin;type:bigint;default:0;index"`

	// session - 所属组织ID，0表示未设置，INTEGER，NOT NULL，DEFAULT 0
	OrgID uint `gorm:"column:org_id;type:integer;default:0;not null;index"`

	// session - 关联数字助手ID，0表示不关联，BIGINT，DEFAULT 0
	AssistantID uint `gorm:"column:assistant_id;type:bigint;default:0;index"`

	// session - 分配的数字员工ID，0表示未分配，BIGINT，DEFAULT 0
	AllocatedAssistantID uint `gorm:"column:allocated_assistant_id;type:bigint;default:0;index"`

	// session - 关联任务ID，允许为空，BIGINT，INDEX（scope=task时绑定）
	TaskID *uint `gorm:"column:task_id;type:bigint;uniqueIndex:uni_session_project_task"`

	// session - 关联项目ID，允许为空，BIGINT，INDEX（scope=project时绑定）
	ProjectID *uint `gorm:"column:project_id;type:bigint;uniqueIndex:uni_session_project_task"`

	// session - 会话状态，VARCHAR(50)，NOT NULL，DEFAULT 'active'
	Status string `gorm:"column:status;type:varchar(50);not null;default:'active'"`

	// session - 会话标题，VARCHAR(500)，允许为空
	Title string `gorm:"column:title;type:varchar(500)"`

	// session - 用户是否手动修改过标题
	TitleManuallySet bool `gorm:"column:title_manually_set;type:boolean;default:false;not null"`

	// session - 元数据，JSON格式存储额外信息，JSONB，允许为空
	Metadata ObjectMetadata `gorm:"column:metadata;type:jsonb"`

	// session - 消息数量，INTEGER，DEFAULT 0
	MessageCount int `gorm:"column:message_count;type:integer;default:0"`

	// session - 最后消息时间，TIMESTAMP，允许为空
	LastMessageAt *time.Time `gorm:"column:last_message_at"`

	// session - 过期时间，TIMESTAMP，允许为空
	ExpiredAt *time.Time `gorm:"column:expired_at;index"`
}

type SessionMessage struct {
	gorm.Model
	// session_message - 关联会话ID（FK -> Session.ID），BIGINT，NOT NULL，INDEX
	SessionID uint `gorm:"column:session_id;type:bigint;not null;index"`

	// session_message - 消息角色（user/assistant/system/tool），VARCHAR(50)，NOT NULL
	Role string `gorm:"column:role;type:varchar(50);not null"`

	// session_message - 消息内容，TEXT，NOT NULL
	Content string `gorm:"column:content;type:text;not null"`

	// session_message - 错误详情，TEXT，允许为空
	ErrorMsg string `gorm:"column:error_msg;type:text"`

	// session_message - 消息类型（text/image/code/file），VARCHAR(50)，DEFAULT 'text'
	MessageType string `gorm:"column:message_type;type:varchar(50);default:'text'"`

	// session_message - 消息状态（sending/streaming/complete/error），VARCHAR(50)，DEFAULT 'complete'
	Status string `gorm:"column:status;type:varchar(50);default:'complete'"`

	// session_message - 流式片段（JSON数组），JSONB，允许为空
	Chunks MessageChunkSlice `gorm:"column:chunks;type:jsonb"`

	// session_message - assistant message artifact references.
	Artifacts MessageArtifactSlice `gorm:"column:artifacts;type:jsonb"`

	// session_message - file attachment references.
	Attachments MessageAttachmentSlice `gorm:"column:attachments;type:jsonb"`

	// session_message - 消息元数据，JSONB，允许为空
	Metadata ObjectMetadata `gorm:"column:metadata;type:jsonb"`

	Usage MessageUsage `gorm:"column:usage;type:jsonb"`

	// session_message - 消息序号（用于排序），BIGINT，NOT NULL
	Sequence int64 `gorm:"column:sequence;type:bigint;not null;index"`

	// session_message - 时间戳（Unix毫秒），BIGINT，允许为空
	Timestamp int64 `gorm:"column:timestamp;type:bigint"`

	// session_message - 发送者用户ID（真人发言时有值，AI回复时为nil），BIGINT
	SenderUin *uint `gorm:"column:sender_uin;type:bigint;default:0"`

	// session_message - 发送者名称（真人=User.Name，AI=DigitalAssistant.Name），VARCHAR(255)
	SenderName string `gorm:"column:sender_name;type:varchar(255);default:''"`

	// session_message - 关联的 agent run ID（AI 回复消息时填充），VARCHAR(255)
	RunID string `gorm:"column:run_id;type:varchar(255);default:''"`

	// session_message - 关联的 AI 队友 ID（AI 回复时填充，用户消息为 0），BIGINT，DEFAULT 0，INDEX
	AssistantID uint `gorm:"column:assistant_id;type:bigint;default:0;index"`

	// session_message - 自动化执行记录主键（首条自动化指令消息），BIGINT，可空，唯一索引
	AutomationExecutionID *uint `gorm:"column:automation_execution_id;type:bigint;index"`
}

type SessionStatus string

type SessionType string

type SkillStringList []string

type Task struct {
	gorm.Model
	PublicID  string `gorm:"column:public_id;type:varchar(255);not null;uniqueIndex"`
	OrgID     uint   `gorm:"column:org_id;type:integer;not null;index"`
	OwnerID   uint   `gorm:"column:owner_id;type:integer;not null;index"`
	ProjectID uint   `gorm:"column:project_id;type:bigint;not null;index"`
	SessionID *uint  `gorm:"column:session_id;type:bigint;index"`

	// TaskType 任务类型（如：general/general、cron/定时任务等），VARCHAR(16)，NOT NULL，DEFAULT 'general'
	TaskType TaskType `gorm:"column:task_type;type:varchar(16);not null;default:'general';index"`

	AssigneeID *uint `gorm:"column:assignee_id;type:bigint;index"`

	Title       string     `gorm:"column:title;type:varchar(500);not null"`
	Description string     `gorm:"column:description;type:text"`
	Status      string     `gorm:"column:status;type:varchar(50);not null;default:'created';index"`
	Deadline    *time.Time `gorm:"column:deadline;index"`

	// cron 任务的自动化执行记录主键，BIGINT，可空，唯一索引（防止 Dispatcher 重试重复建 Task）
	AutomationExecutionID *uint `gorm:"column:automation_execution_id;type:bigint;index"`

	Metadata ObjectMetadata `gorm:"column:metadata;type:jsonb"`
}

type TaskStatus string

type TaskType string

type Trace struct {
	RequestID string   `json:"request_id"`
	TraceID   string   `json:"trace_id"`
	SpanID    []string `json:"span_id"`
}

type User struct {
	gorm.Model
	ExternalID uint   `gorm:"column:external_id;index"`                                          // identity-platform User.ID
	PublicID   string `gorm:"column:public_id;type:varchar(64);uniqueIndex;not null;default:''"` // 用户公开ID
	Password   string `gorm:"column:password;type:varchar(255)"`                                 // 密码（本地认证用）
	Name       string `gorm:"column:name;type:varchar(255)"`                                     // 用户姓名
	Email      string `gorm:"column:email;type:varchar(255)"`                                    // 用户邮箱
	Phone      string `gorm:"column:phone;type:varchar(32);uniqueIndex"`                         // 手机号
	AvatarURL  string `gorm:"column:avatar_url;type:varchar(500)"`                               // 头像 URL
}

type UserOrg struct {
	gorm.Model
	ExternalUin uint `gorm:"column:external_uin;index"`                                                 // identity-platform UIN.ID
	UserID      uint `gorm:"column:user_id;type:bigint;index;not null;uniqueIndex:uni_user_org_member"` // 用户ID
	OrgID       uint `gorm:"column:org_id;type:bigint;index;not null;uniqueIndex:uni_user_org_member"`  // 组织ID
	IsDefault   bool `gorm:"column:is_default;type:boolean;default:false"`                              // 是否为默认组织
}

type WorkbenchRecentContext struct {
	gorm.Model
	OrgID     uint      `gorm:"column:org_id;type:integer;not null;uniqueIndex:uni_workbench_recent_context"`
	Uin       uint      `gorm:"column:uin;type:integer;not null;uniqueIndex:uni_workbench_recent_context"`
	ProjectID uint      `gorm:"column:project_id;type:bigint;not null;index"`
	TaskID    *uint     `gorm:"column:task_id;type:bigint;index"`
	UsedAt    time.Time `gorm:"column:used_at;not null;index"`
}

type WorkerDeployment struct {
	gorm.Model
	PublicID           string     `gorm:"column:public_id;type:varchar(255);not null;default:'';uniqueIndex:idx_worker_deploy_public_id"`
	OrgID              uint       `gorm:"column:org_id;type:bigint;not null;index;uniqueIndex:idx_worker_deploy_org_worker"`
	DigitalAssistantID uint       `gorm:"column:digital_assistant_id;type:bigint;not null;uniqueIndex;index"`
	WorkerID           uint       `gorm:"column:worker_id;type:bigint;not null;uniqueIndex:idx_worker_deploy_org_worker"`
	DeploymentName     string     `gorm:"column:deployment_name;type:varchar(255);not null;uniqueIndex"`
	Namespace          string     `gorm:"column:namespace;type:varchar(255);not null;default:''"`
	Status             string     `gorm:"column:status;type:varchar(50);not null;default:'pending';index"`
	BootstrapTokenHash string     `gorm:"column:bootstrap_token_hash;type:varchar(64);not null;default:''"`
	WorkspacePath      string     `gorm:"column:workspace_path;type:varchar(1000);not null;default:''"`
	LastError          string     `gorm:"column:last_error;type:text"`
	LastStartedAt      *time.Time `gorm:"column:last_started_at;index"`
	LastReconciledAt   *time.Time `gorm:"column:last_reconciled_at;index"`
}

type WorkerDeploymentStatus string