types

type AISummary struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	// OwnerID 摘要所属对象的 ID，主要为 Analysis.ID 或 AnalysisNode.ID。
	OwnerID int64 `json:"owner_id,string" gorm:"column:owner_id;type:bigint;index:idx_ai_summaries_owner"`
	// OwnerType 摘要所属对象的类型：analysis 或 analysis_node。
	OwnerType SummaryOwnerType `json:"owner_type" gorm:"column:owner_type;type:varchar(32);index:idx_ai_summaries_owner"`
	// ProjectID 摘要所属项目 ID（t_project.id），创建时由创建者的激活项目推导。
	ProjectID int64  `json:"project_id,string" gorm:"column:project_id;type:bigint;index:idx_ai_summaries_project"`
	Title     string `json:"title" gorm:"column:title;type:varchar(255)"`
	// Content AI 生成的摘要内容。正文不再落库，而是以文件形式存放在
	// GetAISummaryFile（<baseDir>/data/<projectId>/AiSummary/<summaryId>/summary.md）。
	// 读取详情 / 列表时由 aiSummaryService 按需从文件填充；写入（生成、编辑、失败）
	// 由 AISummaryWorker / aiSummaryService 落盘。非持久化字段。
	Content string `json:"content" gorm:"-"`
	// Status 生成状态：生成中 / 生成成功 / 生成失败。
	Status SummaryStatus `json:"status" gorm:"column:status;type:varchar(32);default:generating"`
	// ProfileID 生成该摘要使用的 Agent Profile ID（agent_profiles.id），用于按 ID 解析 Profile。
	// 为 0 时由 AISummaryWorker 回退到内置 summary Profile。
	ProfileID int64 `json:"profile_id,string" gorm:"column:profile_id;type:bigint;index"`
	// Profile 生成该摘要使用的 Agent Profile 展示名（仅用于展示，不参与查询；
	// 为空表示使用内置 summary Profile）。
	Profile string `json:"profile" gorm:"column:profile;type:varchar(64)"`
	// TaskID 生成该摘要的 Agent 任务 ID（agent_tasks 表）。
	TaskID int64 `json:"task_id,string" gorm:"column:task_id;type:bigint;index"`

	CreatedAt time.Time `json:"created_at" gorm:"column:created_at"`
	UpdatedAt time.Time `json:"updated_at" gorm:"column:updated_at"`

	// Prefix 是摘要所属对象输出目录对应的 /data-analysis URL 前缀，便于前端拼接
	// 该输出目录下结果文件的访问地址。非持久化字段，查询时按需填充
	// （见 aiSummaryService.ListAISummariesByOwner）。
	Prefix string `json:"prefix" gorm:"-"`
}

type AISummaryGeneratePayload struct {
	SummaryID int64 `json:"summary_id,string"`
}

type AISummaryInput struct {
	// Title 是摘要标题的候选值。
	Title string `json:"title"`
	// ProfileName 是生成该摘要使用的 AgentProfile 展示名（取自摘要记录，为空回退内置 summary Profile）。
	ProfileName string `json:"profile,omitempty"`
	ProfileID   int64  `json:"profile_id,omitempty,string"`
	// SystemPrompt 是用 Profile 模板 + Vars 渲染后的真实系统提示词。
	SystemPrompt string `json:"system_prompt,omitempty"`
	// Vars 是渲染系统提示词模板所用的变量（业务上下文）。
	Vars map[string]any `json:"vars,omitempty"`
	// WorkingDir 是 Agent 执行任务时的工作目录。
	WorkingDir string `json:"working_dir"`
}

type AISummaryStatusEvent struct {
	SummaryID int64            `json:"summary_id,string"`
	OwnerType SummaryOwnerType `json:"owner_type"`
	OwnerID   int64            `json:"owner_id,string"`
	Status    SummaryStatus    `json:"status"`
}

type AddFileToDatasetRequest struct {
	DatasetID      int64  `json:"dataset_id,string" binding:"required"`
	ProjectID      int64  `json:"-"`
	AnalysisNodeID int64  `json:"analysis_node_id,string,omitempty"` // optional, if provided, the file will be linked to the analysis node
	Path           string `json:"path" binding:"required"`
	Role           string `json:"role"`
	FileName       string `json:"file_name" gorm:"type:varchar(255)"`
	IsCopy         bool   `json:"is_copy"`   // if true, copy the file to the dataset, otherwise just link it
	IsPrefix       bool   `json:"is_prefix"` // if true, the path is a prefix, and all files under the prefix will be added to the dataset
	// data analysis external
	Source string `json:"source"`
}

type AddFileToDatasetResponse struct {
	File        *File        `json:"file"`
	DatasetFile *DatasetFile `json:"dataset_file"`
}

type AgentProfileInfo struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Model       string `json:"model,omitempty"`
	Provider    string `json:"provider,omitempty"`
	IsDefault   bool   `json:"is_default"`
	IsBuiltin   bool   `json:"is_builtin"`
}

type Analysis struct {
	// ID uint `json:"id" gorm:"primaryKey;autoIncrement"`
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	// ProjectID   string `json:"project" gorm:"column:project;type:varchar(255)"`
	ProjectID   int64  `json:"project_id,string" gorm:"column:project_id;type:bigint"`
	AnalysisID  string `json:"analysis_id" gorm:"column:analysis_id;type:varchar(255)"`
	ComponentID string `json:"component_id" gorm:"column:component_id;type:varchar(255)"`
	// WorkflowID 是工作流主键（pipeline_components_relation.id），不再是 relation_id UUID。
	// 列名 workflow_id（历史列名为 relation_id，迁移见 migrations/2026-09-21-analysis-workflow-id）。
	WorkflowID int64 `json:"workflow_id,string" gorm:"column:workflow_id;type:bigint;index:idx_nextflow_workflow_id"`
	// AnalysisType        string    `json:"analysis_type" gorm:"column:analysis_type;type:varchar(255)"`
	AnalysisName   string `json:"analysis_name" gorm:"column:analysis_name;type:varchar(255)"`
	InputFile      string `json:"input_file" gorm:"column:input_file;type:varchar(255)"`
	AnalysisMethod string `json:"analysis_method" gorm:"column:analysis_method;type:varchar(255)"`
	// WorkspaceDir 是本次分析的根目录。落库时相对 storage.base_dir 存储，
	// 读取时由 repository 还原成绝对路径，因此 base_dir 变更只需拷贝目录，
	// 无需回写数据库。其余路径全部由它派生（见下方 gorm:"-" 字段）。
	WorkspaceDir        string `json:"workspace_dir" gorm:"column:workspace_dir;type:varchar(255)"`
	RequestParam        string `json:"request_param" gorm:"column:request_param;type:longtext"`
	OutputFormat        string `json:"output_format" gorm:"column:output_format;type:longtext"`
	PipelineScript      string `json:"pipeline_script" gorm:"column:pipeline_script;type:varchar(255)"`
	ParseAnalysisModule string `json:"parse_analysis_module" gorm:"column:parse_analysis_module;type:varchar(255)"`
	ProcessID           string `json:"process_id" gorm:"column:process_id;type:varchar(255)"`
	ScriptConfigFile    string `json:"script_config_file" gorm:"column:script_config_file;type:varchar(255)"`
	JobID               string `json:"job_id" gorm:"column:job_id;type:varchar(255)"`
	Ports               string `json:"ports" gorm:"column:ports;type:varchar(255)"`
	URL                 string `json:"url" gorm:"column:url;type:varchar(255)"`
	JobStatus           string `json:"job_status" gorm:"column:job_status;type:varchar(255)"`
	// ServerStatus        string `json:"server_status" gorm:"column:server_status;type:varchar(255)"`
	// SchedulerMode 记录推进本次分析的调度器，用于进程重启后把分析交回正确的调度器恢复。
	// 历史数据该列为空，按 legacy DAG 调度器处理（见 NormalizeSchedulerMode）。
	SchedulerMode    string    `json:"scheduler_mode" gorm:"column:scheduler_mode;type:varchar(64);default:''"`
	IsReport         bool      `json:"is_report" gorm:"column:is_report;default:false"`
	CacheType        int       `json:"cache_type" gorm:"column:cache_type;default:1"`
	Used             bool      `json:"used" gorm:"column:used;default:true"`
	DataComponentIDs string    `json:"data_component_ids" gorm:"column:data_component_ids;type:text"`
	ExtraProjectIDs  string    `json:"extra_project_ids" gorm:"column:extra_project_ids;type:longtext"`
	CreatedAt        time.Time `json:"created_at" gorm:"column:created_at"`
	UpdatedAt        time.Time `json:"updated_at" gorm:"column:updated_at"`

	// 以下是 WorkspaceDir 的派生路径，一律不落库（gorm:"-"）。
	// repository 在读取时通过 HydrateDerivedPaths 填充，保证磁盘布局只有一处定义。
	ParamsPath      string `json:"params_path" gorm:"-"`
	CommandPath     string `json:"command_path" gorm:"-"`
	CommandLogPath  string `json:"command_log_path" gorm:"-"`
	TraceFile       string `json:"trace_file" gorm:"-"`
	WorkflowLogFile string `json:"workflow_log_file" gorm:"-"`
	ExecutorLogFile string `json:"executor_log_file" gorm:"-"`
}

type AnalysisControllerSaveInput struct {
	RequestParam        map[string]any
	ParseAnalysisResult map[string]any
	DagRuntime          map[string]any
	Project             *Project
	IsRunNode           bool
	IsReport            bool
	// SchedulerMode 由各控制入口显式声明，标识谁来推进这次分析。
	// 为空时保持库中原值不变（更新路径）或按 legacy 处理（新建路径）。
	SchedulerMode string
}

type AnalysisEdge struct {
	ID             uint   `json:"id" gorm:"primaryKey;autoIncrement"`
	AnalysisEdgeID string `json:"analysis_edge_id" gorm:"column:analysis_edge_id;type:varchar(255)"`
	// AnalysisID     string `json:"analysis_id" gorm:"column:analysis_id;type:varchar(255);index:idx_analysis_edges_analysis_id"`
	AnalysisID int64 `json:"analysis_id,string" gorm:"column:analysis_id;type:bigint"`

	SourceNode   string    `json:"source_node" gorm:"column:source_node;type:varchar(255)"`
	TargetNode   string    `json:"target_node" gorm:"column:target_node;type:varchar(255)"`
	SourceHandle string    `json:"source_handle" gorm:"column:source_handle;type:varchar(255)"`
	TargetHandle string    `json:"target_handle" gorm:"column:target_handle;type:varchar(255)"`
	CreatedAt    time.Time `json:"created_at" gorm:"column:created_at"`
	UpdatedAt    time.Time `json:"updated_at" gorm:"column:updated_at"`
}

type AnalysisNode struct {
	// ID                     uint       `json:"id" gorm:"primaryKey;autoIncrement"`
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	AnalysisNodeID string `json:"analysis_node_id" gorm:"column:analysis_node_id;type:varchar(255)"`
	// ProjectID      string `json:"project_id" gorm:"column:project_id;type:varchar(255);index:idx_analysis_nodes_project_id"`
	ProjectID int64 `json:"project_id,string" gorm:"column:project_id;type:bigint"`
	// AnalysisID string `json:"analysis_id" gorm:"column:analysis_id;type:varchar(255);index:idx_analysis_nodes_analysis_id;index:idx_analysis_nodes_analysis_id_status,priority:1;index:idx_analysis_nodes_analysis_id_node_id,priority:1"`
	AnalysisID int64  `json:"analysis_id,string" gorm:"column:analysis_id;type:bigint"`
	NodeID     string `json:"node_id" gorm:"column:node_id;type:varchar(255);index:idx_analysis_nodes_analysis_id_node_id,priority:2"`
	NodeName   string `json:"node_name" gorm:"column:node_name;type:varchar(255)"`
	SampleID   string `json:"sample_id" gorm:"column:sample_id;type:varchar(255)"`
	// ScriptID       string `json:"script_id" gorm:"column:script_id;type:varchar(255)"`
	ScriptID int64 `json:"script_id,string" gorm:"column:script_id;type:bigint"`
	// ContainerTemplateID 是节点级容器模板（go_container_template_definition 主键）。
	//
	// 由 Agent 创建的「命令节点」没有脚本，直接用它启动容器；由脚本创建的节点保持 0，
	// 沿用脚本绑定的 container_template_id（见 dag/executor.ContainerExecutor）。
	ContainerTemplateID int64 `json:"container_template_id,string" gorm:"column:container_template_id;type:bigint"`
	// ScriptName 不是 analysis_nodes 的列，而是按 ScriptID join pipeline_components
	// 取到的脚本名称（component_name 列）。只有显式 join 的查询才会填充，
	// 因此用 gorm:"-" 排除在 schema 之外，避免其他查询误选该列。
	ScriptName             string    `json:"script_name" gorm:"-"`
	InputsPatterns         JSONMap   `json:"inputs_patterns" gorm:"column:inputs_patterns;type:json"`
	ResolvedInputs         JSONMap   `json:"resolved_inputs" gorm:"column:resolved_inputs;type:json"`
	OutputPatterns         JSONMap   `json:"output_patterns" gorm:"column:output_patterns;type:json"`
	ResolvedOutputs        JSONMap   `json:"resolved_outputs" gorm:"column:resolved_outputs;type:json"`
	OutputFileIDs          JSONMap   `json:"output_file_ids" gorm:"column:output_file_ids;type:json"` // 输出句柄 -> go_file id，供下游 SelectAssay 输入还原为 {"files": "<id>"}
	RequestParam           string    `json:"request_param" gorm:"column:request_param;type:longtext"`
	CPU                    int       `json:"cpu" gorm:"column:cpu"`
	Memory                 string    `json:"memory" gorm:"column:memory;type:varchar(64)"`
	Disk                   string    `json:"disk" gorm:"column:disk;type:varchar(64)"`
	GPU                    int       `json:"gpu" gorm:"column:gpu"`
	Status                 string    `json:"status" gorm:"column:status;type:varchar(64);index:idx_analysis_nodes_analysis_id_status,priority:2"`
	ServerStatus           string    `json:"server_status" gorm:"column:server_status;type:varchar(64)"`
	PID                    int       `json:"pid" gorm:"column:pid"`
	JobID                  string    `json:"job_id" gorm:"column:job_id;type:varchar(255)"`
	Executor               string    `json:"executor" gorm:"column:executor;type:varchar(64)"`
	Retry                  int       `json:"retry" gorm:"column:retry;default:0"`
	MaxRetry               int       `json:"max_retry" gorm:"column:max_retry;default:3"`
	ExitCode               int       `json:"exit_code" gorm:"column:exit_code"`
	ErrorMessage           string    `json:"error_message" gorm:"column:error_message;type:text"`
	RerunReason            string    `json:"rerun_reason" gorm:"column:rerun_reason;type:text"`
	InputHash              string    `json:"input_hash" gorm:"column:input_hash;type:varchar(255)"`
	CacheHit               bool      `json:"cache_hit" gorm:"column:cache_hit"`
	UpstreamIDs            JSONSlice `json:"upstream_ids" gorm:"column:upstream_ids;type:json"`
	DownstreamIDs          JSONSlice `json:"downstream_ids" gorm:"column:downstream_ids;type:json"`
	InputValidationErrors  JSONSlice `json:"input_validation_errors" gorm:"column:input_validation_errors;type:json"`
	OutputValidationErrors JSONSlice `json:"output_validation_errors" gorm:"column:output_validation_errors;type:json"`
	// WorkspaceDir 是节点根目录。落库时相对 storage.base_dir 存储，
	// 读取时由 repository 还原成绝对路径。其余路径全部由它派生。
	WorkspaceDir   string     `json:"workspace_dir" gorm:"column:workspace_dir;type:varchar(255)"`
	CommandMD5     string     `json:"command_md5" gorm:"column:command_md5;type:varchar(64)"`
	ParamsMD5      string     `json:"params_md5" gorm:"column:params_md5;type:varchar(64)"`
	CreationSource string     `json:"creation_source" gorm:"column:creation_source;type:varchar(32)"`
	StartedAt      *time.Time `json:"started_at" gorm:"column:started_at"`
	FinishedAt     *time.Time `json:"finished_at" gorm:"column:finished_at"`
	CreatedAt      time.Time  `json:"created_at" gorm:"column:created_at"`
	UpdatedAt      time.Time  `json:"updated_at" gorm:"column:updated_at"`

	// 以下是 WorkspaceDir 的派生路径，一律不落库（gorm:"-"）。
	// repository 在读取时通过 HydrateDerivedPaths 填充。
	LogPath     string `json:"log_path" gorm:"-"`
	OutputDir   string `json:"output_dir" gorm:"-"`
	CacheDir    string `json:"cache_dir" gorm:"-"`
	CommandPath string `json:"command_path" gorm:"-"`
	ParamsPath  string `json:"params_path" gorm:"-"`
}

type AnalysisQuery = AnalysisQuey

type AnalysisQuey struct {
	IDs []int64 `json:"ids,omitempty"`

	ID *int64 `json:"id,string,omitempty"`

	ProjectID int64 `json:"project_id,string,omitempty"`

	AnalysisID string `json:"analysis_id,omitempty"`

	AnalysisName string `json:"analysis_name,omitempty"`

	// WorkflowID 过滤条件，取值是工作流主键（pipeline_components_relation.id）。
	WorkflowID int64 `json:"workflow_id,string,omitempty"`

	JobStatus string `json:"job_status,omitempty"`

	ServerStatus string `json:"server_status,omitempty"`

	IsReport *bool `json:"is_report,omitempty"`

	CacheType *int `json:"cache_type,omitempty"`

	SortBy string `json:"sort_by,omitempty"`

	SortOrder string `json:"sort_order,omitempty"`
}

type AppSession struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	UserID    int64 `json:"user_id,string" gorm:"type:bigint;index;not null"`
	ProjectID int64 `json:"project_id,string" gorm:"column:project_id;type:bigint"`

	AnalysisNodeID int64 `json:"analysis_node_id,string" gorm:"index"`

	ContainerTemplateID int64 `json:"container_template_id,string" gorm:"index;not null"`

	Name string `json:"name" gorm:"type:varchar(255);not null"`

	Status string `json:"status" gorm:"type:varchar(32);index;not null;default:PENDING"`

	WorkspacePath string `json:"workspace_path" gorm:"type:varchar(1024)"`

	// AgentSessionID 记录创建该会话的 Agent 会话 ID（agent_sessions.id）。
	//
	// 0 表示用户从 UI 手动创建；>0 表示由 Agent 的 terminal_exec / 容器 coder bash 创建，
	// 同一 (container_template_id, agent_session_id) 唯一，保证同一 Agent 会话在同一模板上
	// 只复用一个终端会话（同一个容器与 PTY）。
	AgentSessionID int64 `json:"agent_session_id,string" gorm:"index;not null;default:0"`

	// Persistent 标记会话是否为「持久会话」。
	//
	// true  = 只能由空闲 TTL 到期或用户显式关闭（DELETE /container/terminal/session/{id}）回收；
	// false = 一次性会话：最后一个订阅者（terminal_exec / WS）离开后立即回收容器与会话。
	//
	// 用户从 UI 创建的会话一律持久；Agent 创建的一次性会话经前端打开后也会被置为 true，
	// 并且此后不会再退回 false（只增不减）。
	Persistent bool `json:"persistent" gorm:"not null;default:false"`

	// SessionKind 标记会话的「种类」，取值见 AppSessionKind*：
	//   - web      ：ContainerService.CreateAppSessionByTemplate（容器跑模板命令，前端经网关访问应用）；
	//   - terminal ：终端会话注册表 createOrAdopt（容器常驻，交互式 shell 由运行时 exec 打开）。
	//
	// 它描述会话本身，而不是「谁创建的」：创建者见 AgentSessionID，生命周期策略见 Persistent。
	// 历史行在加列之前就已存在，回填见 migrations/2026-11-06-app-session-kind；
	// 仍为空时读取方用 NormalizedSessionKind 兜底。
	SessionKind string `json:"session_kind" gorm:"column:session_kind;type:varchar(32);index;not null;default:web"`

	LastAccessAt *time.Time `json:"last_access_at"`

	StartedAt *time.Time `json:"started_at"`

	StoppedAt *time.Time `json:"stopped_at"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type AppSessionEvent struct {
	// AppSessionID 是会话主键（= types.AppSession.ID）。
	AppSessionID int64
	// UserID 是接收推送的用户；0 表示无接收者，handler 直接丢弃。
	UserID    int64
	ProjectID int64
	// ContainerTemplateID 是会话使用的容器模板（终端标签按模板分组时使用）。
	ContainerTemplateID int64
	// Status 是会话最新状态（RUNNING / STOPPED / ...），为空时沿用数据库里的值。
	Status string
	// Method 是前端 component.invoke 的 method：sessionCreated / sessionDeleted /
	// sessionRunning / sessionIdle / sessionAttached / sessionDetached。
	Method string
	// Action 为空表示 component.invoke；其它值（如 terminal.exec）作为 action 直接推送。
	Action string
	// Args 是随事件一起推给前端的参数（busy / subscribers / persistent / command ...）。
	Args map[string]any
}

type AppSessionPageQuery struct {
	AnalysisNodeID *int64 `json:"analysis_node_id,string,omitempty"`
	ProjectID      *int64 `json:"project_id,omitempty"`
}

type ArticleCursor struct {
	SortBy string `json:"sort_by"`
	// Value stores the current sort field's value as string.
	Value string `json:"value"`
	// ID is the tiebreaker for stable ordering.
	ID int64 `json:"id"`
}

type Assay struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	// SampleName 是样本的业务编号兼展示名（列 go_assay.sample_name），例如
	// S-001 / 脾脏-6。无需全局唯一，只在同一个 dataset 下唯一（经
	// go_dataset_assay 绑定判定）；同一个名字可以出现在不同 dataset。
	SampleName string `json:"sample_name" gorm:"type:varchar(255);index;not null"`

	AssayType string `json:"assay_type" gorm:"type:varchar(64);index"`

	Platform string `json:"platform" gorm:"type:varchar(128)"`

	LibraryID string `json:"library_id" gorm:"type:varchar(255)"`

	// Role 是该 assay 的角色（列 go_assay.role），例如 DEFAULT / TABLE；
	// input_type=assay 的表单输入用 resolver.accept_formats 与之匹配（与
	// go_file.role 对文件的口径一致）。空表示不参与角色过滤。
	Role string `json:"role" gorm:"type:varchar(64);index"`

	Metadata string `json:"metadata" gorm:"type:text"`

	Description string `json:"description" gorm:"type:text"`

	CreatedAt time.Time `json:"created_at"`

	UpdatedAt time.Time `json:"updated_at"`
}

type AssayWithDatasetInfo struct {
	ID int64 `json:"id,string"`

	SampleName string `json:"sample_name"`

	AssayType string `json:"assay_type"`

	Platform string `json:"platform"`

	LibraryID string `json:"library_id"`

	// Role 是该 assay 的角色（go_assay.role），例如 DEFAULT / TABLE；
	// input_type=assay 的表单输入用 resolver.accept_formats 与之匹配，
	// resolveFormAnalysisResult 据此把 assay 分组挂到 analysis_result[role]。
	Role string `json:"role"`

	Metadata string `json:"metadata"`

	Description string `json:"description"`

	CreatedAt time.Time `json:"created_at"`

	UpdatedAt time.Time `json:"updated_at"`

	DatasetID string `json:"dataset_id"`

	DatasetName string `json:"dataset_name"`
}

type AuthToken struct {
	// Unique identifier of the token
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	// User ID that owns this token
	UserID int64 `json:"user_id,string" gorm:"type:bigint;index;not null"`
	// Token value (JWT or other format)
	Token string `json:"token"      gorm:"type:text;not null"`
	// Token type (access_token, refresh_token)
	TokenType string `json:"token_type" gorm:"type:varchar(50);not null"`
	// Token expiration time
	ExpiresAt time.Time `json:"expires_at"`
	// Whether the token is revoked
	IsRevoked bool `json:"is_revoked" gorm:"default:false"`
	// Creation time of the token
	CreatedAt time.Time `json:"created_at"`
	// Last updated time of the token
	UpdatedAt time.Time `json:"updated_at"`

	// Association relationship
	User *User `json:"user,omitempty" gorm:"foreignKey:UserID"`
}

type ContainerEvent struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	ContainerInstanceID int64 `json:"container_instance_id,string" gorm:"index;not null"`

	Event string `json:"event" gorm:"type:varchar(64);index;not null"`

	Message string `json:"message" gorm:"type:text"`

	CreatedAt time.Time `json:"created_at"`
}

type ContainerInstance struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	TemplateID int64 `json:"template_id,string" gorm:"index;not null"`

	OwnerType ContainerOwnerType `json:"owner_type" gorm:"type:varchar(30);index;not null"`

	OwnerID int64 `json:"owner_id,string" gorm:"index;not null"`

	// Kind 是容器的运行形态（取值见 ContainerInstanceKind*），决定创建时如何组装运行时
	// spec。它独立于 OwnerType：终端会话容器的 owner 也是 app_session。
	// 历史数据该列为空，读取方用 NormalizedKind 兜底（按 OwnerType 推断）。
	Kind ContainerInstanceKind `json:"kind" gorm:"column:kind;type:varchar(32);index;not null;default:web"`

	RuntimeName string `json:"runtime_name" gorm:"type:varchar(255);index;not null"`

	RuntimeID string `json:"runtime_id" gorm:"type:varchar(255);index"`

	Name string `json:"name" gorm:"type:varchar(255);not null;index"`

	Status ContainerStatus `json:"status" gorm:"type:varchar(30);index;not null;default:pending"`

	IPAddress       string `json:"ip_address" gorm:"type:varchar(128)"`
	RuntimeNodeName string `json:"runtime_node_name" gorm:"type:varchar(255);index"`

	// HostPort 是容器端口发布到宿主机后的实际端口（0 表示未发布）。
	// 只有 container.network_mode=host_port 时非 0；由运行时 Inspect 读回，
	// 供路由层用「宿主机 + HostPort」代替「容器 IP + 容器端口」。
	HostPort int `json:"host_port" gorm:"not null;default:0"`

	ExitCode *int `json:"exit_code"`

	StartedAt *time.Time `json:"started_at"`

	FinishedAt *time.Time `json:"finished_at"`

	CreatedAt time.Time `json:"created_at"`

	UpdatedAt time.Time `json:"updated_at"`
}

type ContainerInstanceKind string

type ContainerOwnerType string

type ContainerSchedulingConstraint struct {
	Type     string   `json:"type"`
	Key      string   `json:"key"`
	Operator string   `json:"operator"`
	Values   []string `json:"values,omitempty"`
}

type ContainerSchedulingSelector struct {
	Constraints []ContainerSchedulingConstraint `json:"constraints"`
}

type ContainerSpec struct {
	Image                string
	Entrypoint           []string
	Command              []string
	Env                  map[string]string
	Volumes              []ContainerVolume
	SupplementalGroups   []int64
	SchedulingConstraint *ContainerSchedulingSelector
	User                 string
	Labels               map[string]string

	// HomeDir 非空时作为容器的 HOME（容器内绝对路径），由 runtime 落到环境变量
	// HOME 上（docker: -e HOME=...，k8s: env HOME=...）。
	//
	// 以非 root 用户运行时（User 非空）镜像里的 HOME 往往不可写（例如 /root），
	// 需要同时配合 Tmpfs 把 HOME 挂成可写的内存盘。
	HomeDir string
	// Tmpfs 是以内存盘（tmpfs）挂载的容器内路径，落地方式由 runtime 决定：
	// docker 映射 HostConfig.Tmpfs，kubernetes 映射 EmptyDir{Medium: Memory}。
	//
	// 典型用法是给非 root 用户挂一个可写的 HOME：
	//
	//	docker run --user "$UID:$GID" -e HOME=/home/app \
	//	  --tmpfs /home/app:rw,uid=$UID,gid=$GID,mode=700
	Tmpfs []ContainerTmpfs

	// PullPolicy 来自容器模板绑定行（ContainerTemplateDefinition.PullPolicy），
	// 取值 Always / IfNotPresent / Never，空值按 IfNotPresent 处理。落地方式由 runtime 决定：
	// docker 没有 imagePullPolicy 概念，在 create 前按策略决定是否 pull；
	// kubernetes 直接映射为 container.imagePullPolicy。
	PullPolicy string

	CPU    float64
	Memory int64

	WorkDir          string
	RuntimeName      string
	RuntimeNamespace string
	WorkloadKind     string
	ExposedPort      int
	ExposeService    bool

	// PublishPort 为 true 时把 ExposedPort 以随机宿主机端口发布（-p 0.0.0.0:0:<port>），
	// 供 gobrave 之外的进程（如 Windows 宿主浏览器）访问。
	//
	// docker 与 k8s 语义不同：docker 由 docker runtime 落地为 PortBindings；
	// k8s 的 ExposeService 已经通过 Service/Ingress 暴露，不读取本字段。
	PublishPort bool
}

type ContainerStatus string

type ContainerTemplate struct {
	ID     int64 `json:"id,string"`
	SpecID int64 `json:"spec_id,string"`

	Name        string `json:"name"`
	Description string `json:"description"`
	// ImageName / PullPolicy 原样取自绑定行 ContainerTemplateDefinition。
	ImageName  string `json:"image_name"`
	PullPolicy string `json:"pull_policy"`
	// DisplayName 原样取自绑定行 ContainerTemplateDefinition.DisplayName（不做回退）。
	// Name 才是对外展示名：DisplayName 非空时覆盖共享配置名，否则回退到 spec.Name。
	// 编辑表单必须读写 DisplayName，否则会把回退出来的配置名误固化成绑定行展示名。
	DisplayName string `json:"display_name"`
	// DefinitionDescription 原样取自绑定行 ContainerTemplateDefinition.Description（长文本）。
	// 与 Description（共享运行配置 spec 的描述）相互独立，编辑表单需读写本字段。
	DefinitionDescription string `json:"definition_description"`
	// IsDefault 原样取自绑定行 ContainerTemplateDefinition.IsDefault。
	IsDefault bool `json:"is_default"`

	Command string  `json:"command"`
	CPU     float64 `json:"cpu"`
	Memory  int64   `json:"memory"`

	Port    int    `json:"port"`
	AppType string `json:"app_type"`

	Env                  datatypes.JSON `json:"env"`
	Mounts               datatypes.JSON `json:"mounts"`
	SchedulingConstraint datatypes.JSON `json:"scheduling_constraint"`
	Labels               datatypes.JSON `json:"labels"`
	ChangeUID            bool           `json:"change_uid"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type ContainerTemplateBundle struct {
	ContainerTemplateSpecs       []ContainerTemplateSpec       `json:"container_template_specs"`
	ContainerTemplateDefinitions []ContainerTemplateDefinition `json:"container_template_definitions"`
}

type ContainerTemplateDefinition struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	SpecID int64 `json:"spec_id,string" gorm:"index;not null"`

	// ImageName 是完整镜像名（含 registry / namespace / tag），如 docker.io/rocker/rstudio:4.4。
	// 同一运行配置下不允许重复绑定同一镜像由服务层校验（不用唯一索引，便于旧数据迁移）。
	ImageName string `json:"image_name" gorm:"type:varchar(512);index"`

	// PullPolicy 是该绑定行的镜像拉取策略，取值 Always / IfNotPresent / Never，空值按 IfNotPresent 处理。
	// 落地方式由 runtime 决定：docker 在 create 前按策略决定是否 pull；kubernetes 直接映射为
	// container.imagePullPolicy。
	PullPolicy string `json:"pull_policy" gorm:"type:varchar(32);index;not null;default:IfNotPresent"`

	// DisplayName 为空时，对外名称回退到 ContainerTemplateConfig.Name。
	DisplayName string `json:"display_name" gorm:"type:varchar(255)"`

	// Description 是绑定行自身的描述（长文本），与共享运行配置 ContainerTemplateSpec.Description
	// 相互独立：spec 描述“怎么跑”，这里描述“这个可运行模板是做什么的 / 适用什么场景”。
	// Agent 工具 get_container_template 会把 DisplayName 与 Description 一起回传给模型。
	Description string `json:"description" gorm:"type:longtext"`

	// IsDefault 标记「默认容器模板」：只能有一行处于默认状态，由服务层在写入时互斥维护。
	// 创建脚本（create_script）未显式指定 container_template_id 时，优先取这一行。
	// 导出时会置为 false（omitempty 使其不出现在导出文件里）。
	IsDefault bool `json:"is_default,omitempty" gorm:"not null;default:false;index"`

	// 指针类型是为了让导出可以显式清空（omitempty 也因此生效）；接口响应仍会带上时间字段。
	CreatedAt *time.Time `json:"created_at,omitempty"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type ContainerTemplateSpec struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	Name        string `json:"name" gorm:"type:varchar(255);not null;index"`
	Description string `json:"description" gorm:"type:text"`

	Command string `json:"command" gorm:"type:text"`

	CPU    float64 `json:"cpu"`
	Memory int64   `json:"memory"`

	Port    int    `json:"port" gorm:"not null;default:8787"`
	AppType string `json:"app_type" gorm:"type:varchar(32);index"`

	Env                  datatypes.JSON `json:"env" gorm:"type:json"`
	Mounts               datatypes.JSON `json:"mounts" gorm:"type:json"`
	SchedulingConstraint datatypes.JSON `json:"scheduling_constraint" gorm:"type:json"`
	Labels               datatypes.JSON `json:"labels" gorm:"type:json"`
	ChangeUID            bool           `json:"change_uid" gorm:"default:false"`

	// 指针类型是为了让导出可以显式清空（omitempty 也因此生效）；接口响应仍会带上时间字段。
	CreatedAt *time.Time `json:"created_at,omitempty"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type ContainerTmpfs struct {
	// Target 是容器内的挂载路径（绝对路径）。
	Target string
	// Mode 是挂载权限，默认 1777，可写为 700 等。
	Mode string
	// UID/GID 是挂载点（tmpfs 根目录）的属主；为空时使用运行时默认（root）。
	//
	// 以非 root 用户运行并挂 HOME 时必须设置，否则容器用户无法写入 HOME。
	UID string
	GID string
}

type ContainerVolume struct {
	Source string
	Target string
	Mode   string
	// Type 可选：值为 "file" 时源路径按文件创建，否则按目录创建。
	Type  string
	Owner string
}

type ContextKey string

type CreateDatasetRequest struct {
	DatasetName string `json:"dataset_name" binding:"required"`
	// DatasetKey is optional; leave it empty for ordinary user datasets.
	DatasetKey  string `json:"dataset_key"`
	Description string `json:"description"`
	Metadata    string `json:"metadata"`
}

type CursorPageResult struct {
	Data       interface{} `json:"data"`
	PageSize   int         `json:"page_size"`
	NextCursor string      `json:"next_cursor,omitempty"`
	HasMore    bool        `json:"has_more"`
	SortBy     string      `json:"sort_by,omitempty"`
}

type CursorPagination struct {
	// Cursor for next page, empty means first page.
	Cursor string `form:"cursor" json:"cursor" binding:"omitempty"`
	// Sort field, for example: published_at, created_at, updated_at.
	SortBy string `form:"sort_by" json:"sort_by" binding:"omitempty"`
	// Page size.
	PageSize int `form:"page_size" json:"page_size" binding:"omitempty,min=1,max=1000"`
}

type Dataset struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	DatasetName string `json:"dataset_name" gorm:"type:varchar(255)"`

	// DatasetKey is a stable business key used to look up well-known datasets
	// the system provisions on demand, e.g. DatasetKeyDatabases ("DATABASES")
	// for the project's reference database directory. User-created datasets
	// leave it empty. In practice it is unique per project (go_dataset itself
	// has no project column; the binding lives in go_project_dataset).
	DatasetKey string `json:"dataset_key" gorm:"type:varchar(64);index"`

	Description string `json:"description" gorm:"type:text"`

	Metadata string `json:"metadata" gorm:"type:text"`

	// Path is the dataset workspace directory (utils.GetDatasetDir). It is
	// derived at read time from the active project and is never persisted.
	Path string `json:"path,omitempty" gorm:"-"`

	CreatedAt time.Time `json:"created_at"`

	UpdatedAt time.Time `json:"updated_at"`
}

type DatasetAssay struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	DatasetID int64 `json:"dataset_id,string" gorm:"index;not null"`

	AssayID int64 `json:"assay_id,string" gorm:"index;not null"`

	CreatedAt time.Time `json:"created_at"`
}

type DatasetDirFile struct {
	// Name is the file's base name.
	Name string `json:"name"`
	// RelativePath is the path relative to the dataset directory, using "/" as
	// the separator so the value is stable across platforms.
	RelativePath string `json:"relative_path"`
	// Path is the absolute path stored on go_file.path when the file is
	// imported.
	Path string `json:"path"`
	// Format is the lower-cased extension without the leading dot.
	Format string `json:"format"`
	Size   int64  `json:"size"`
	// ModTime is the physical file's modification time.
	ModTime string `json:"mod_time"`
	// Added reports whether a file with this path is already bound to the
	// dataset (go_file.path + go_dataset_file.dataset_id).
	Added bool `json:"added"`
}

type DatasetDirFilesResponse struct {
	Path  string            `json:"path"`
	Files []*DatasetDirFile `json:"files"`
}

type DatasetFile struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	DatasetID int64 `json:"dataset_id,string" gorm:"index;not null"`

	FileID int64 `json:"file_id,string" gorm:"index;not null"`

	CreatedAt time.Time `json:"created_at"`
}

type File struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	FileName string `json:"file_name" gorm:"type:varchar(255)"`

	Path string `json:"path" gorm:"type:text;not null"`

	Format string `json:"format" gorm:"type:varchar(64)"`

	// AssayID owns the file (int64 PK of go_assay). 0 means the file is not
	// owned by any assay.
	AssayID int64 `json:"assay_id,string" gorm:"type:bigint;index"`

	// FileKey is the file's key inside its owning assay, e.g. FASTQ_R1 or BAM.
	// Analysis form inputs use it to map the file onto the matching key of
	// their resolver.accept_formats (see buildParseAnalysisResult).
	FileKey string `json:"file_key" gorm:"type:varchar(64)"`
	// Role is the role the file is published under in the workflow form's
	// analysis_result map, e.g. BAM / VCF / DEFAULT. A node output file takes it
	// from its output_patterns entry (see NodeCompletionCoordinator.recordNodeOutputFiles),
	// defaulting to dag.DefaultNodeOutputRole ("DEFAULT") when the pattern declares
	// none; resolveFormAnalysisResult groups the node output files by it so the
	// frontend reads them as dataMap[role] just like dataset files.
	Role           string `json:"role" gorm:"type:varchar(64);index"`
	AnalysisNodeID int64  `json:"analysis_node_id" gorm:"type:bigint;index"`

	Size int64 `json:"size"`

	MD5 string `json:"md5" gorm:"type:varchar(64);index"`

	Storage string `json:"storage" gorm:"type:varchar(32);default:LOCAL"`

	Description string `json:"description" gorm:"type:text"`

	CreatedAt time.Time `json:"created_at"`

	UpdatedAt time.Time `json:"updated_at"`
}

type FileByProjectRoleGroup struct {
	Role string `json:"role"`

	Items []*FileWithDatasetInfo `json:"items"`
}

type FileWithDatasetInfo struct {
	ID int64 `json:"id,string"`

	// FileID mirrors the file's own primary key (go_file.id). It is kept so list
	// responses still carry a "file_id" the frontend can pass straight to the
	// by-id sheet endpoints; the entity no longer has a separate business id.
	FileID int64 `json:"file_id,string"`

	FileName string `json:"file_name"`

	Path string `json:"path"`

	Format string `json:"format"`

	AnalysisNodeID int64 `json:"analysis_node_id,string,omitempty"`

	Size int64 `json:"size"`

	MD5 string `json:"md5"`

	Storage string `json:"storage"`

	Description string `json:"description"`

	CreatedAt time.Time `json:"created_at"`

	UpdatedAt time.Time `json:"updated_at"`

	DatasetID string `json:"dataset_id"`

	DatasetName string `json:"dataset_name"`

	Role string `json:"role"`
}

type GatewayRoute struct {
	RouteKey string `json:"route_key" gorm:"primaryKey;type:varchar(255)"`

	ContainerInstanceID int64 `json:"container_instance_id,string" gorm:"index"`

	PathPrefix   string `json:"path_prefix" gorm:"type:varchar(512);not null;uniqueIndex"`
	IsTrimPrefix *bool  `json:"is_trim_prefix" gorm:"not null;default:true"`
	BackendHost  string `json:"backend_host" gorm:"type:varchar(255);not null"`
	BackendPort  int    `json:"backend_port" gorm:"not null"`

	Metadata datatypes.JSON `json:"metadata" gorm:"type:json"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type ImportAssayTSVRequest struct {
	DatasetID int64  `json:"dataset_id,string" binding:"required"`
	Content   string `json:"content" binding:"required"`
	ProjectID int64  `json:"-"`
}

type ImportAssayTSVResult struct {
	Rows          int `json:"rows"`
	AssaysCreated int `json:"assays_created"`
	AssaysUpdated int `json:"assays_updated"`
	FilesCreated  int `json:"files_created"`
	FilesUpdated  int `json:"files_updated"`
}

type ImportDatasetDirFilesResult struct {
	Total    int      `json:"total"`
	Imported int      `json:"imported"`
	Skipped  int      `json:"skipped"`
	Failed   int      `json:"failed"`
	Errors   []string `json:"errors,omitempty"`
}

type JSONMap map[string]any

type JSONSlice []any

type LLMConversation struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	ConversationID string `json:"conversation_id" gorm:"type:varchar(64);uniqueIndex;not null"`

	LLMSessionID int64 `json:"llm_session_id,string" gorm:"index;not null"`

	Role string `json:"role" gorm:"type:varchar(32);index;not null"`

	Content string `json:"content" gorm:"type:longtext"`

	Model string `json:"model" gorm:"type:varchar(255)"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type LLMSession struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	ProjectID int64 `json:"project_id" gorm:"type:bigint;index;not null"`

	Title string `json:"title" gorm:"type:varchar(255)"`

	Status string `json:"status" gorm:"type:varchar(32);index;not null;default:ACTIVE"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type Literature struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	Title     string    `json:"title" gorm:"type:varchar(255)"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type LiteratureDetail struct {
	Literature *Literature
	Content    string
}

type LiteraturePoolItem struct {
	Literature
	Bound bool `json:"bound"`
}

type LoginRequest struct {
	Email    string `json:"email"    binding:"required,email"`
	Password string `json:"password" binding:"required,min=6"`
}

type LoginResponse struct {
	Success      bool   `json:"success"`
	Message      string `json:"message,omitempty"`
	User         *User  `json:"user,omitempty"`
	Token        string `json:"token,omitempty"`
	RefreshToken string `json:"refresh_token,omitempty"`
}

type OIDCAuthURLResponse struct {
	Success             bool   `json:"success"`
	ProviderDisplayName string `json:"provider_display_name,omitempty"`
	AuthorizationURL    string `json:"authorization_url,omitempty"`
	State               string `json:"state,omitempty"`
}

type OIDCCallbackResponse struct {
	Success      bool   `json:"success"`
	Message      string `json:"message,omitempty"`
	User         *User  `json:"user,omitempty"`
	Token        string `json:"token,omitempty"`
	RefreshToken string `json:"refresh_token,omitempty"`
	IsNewUser    bool   `json:"is_new_user,omitempty"`
}

type OIDCConfigResponse struct {
	Success             bool   `json:"success"`
	Enabled             bool   `json:"enabled"`
	ProviderDisplayName string `json:"provider_display_name,omitempty"`
}

type OIDCUserInfo struct {
	Subject  string                 `json:"subject,omitempty"`
	Username string                 `json:"username,omitempty"`
	Email    string                 `json:"email,omitempty"`
	Claims   map[string]interface{} `json:"claims,omitempty"`
}

type OperationType string

type OutboxEvent struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	Type string `json:"type" gorm:"type:varchar(128);index;not null"`

	Payload datatypes.JSON `json:"payload" gorm:"type:json;not null"`

	Status string `json:"status" gorm:"type:varchar(32);index;not null;default:pending"` // pending / sent

	SentAt *time.Time `json:"sent_at"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type PageResult struct {
	Total    int64       `json:"total"`     // Total number of records
	Page     int         `json:"page"`      // Current page number
	PageSize int         `json:"page_size"` // Page size
	Data     interface{} `json:"data"`      // Data
}

type Pagination struct {
	// Page
	Page int `form:"page"      json:"page"      binding:"omitempty,min=1"`
	// Page size
	PageSize int `form:"page_size" json:"page_size" binding:"omitempty,min=1,max=1000"`
}

type PermissionDecision string

type Project struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	// ID           uint           `json:"id" gorm:"primaryKey;autoIncrement"`
	ProjectName  string         `json:"project_name" gorm:"type:varchar(255)"`
	MetadataForm string         `json:"metadata_form" gorm:"type:text"`
	Research     string         `json:"research" gorm:"type:text"`
	Parameter    string         `json:"parameter" gorm:"type:text"`
	Mounts       datatypes.JSON `json:"mounts" gorm:"type:json"`
	Env          datatypes.JSON `json:"env" gorm:"type:json"`

	Description string    `json:"description" gorm:"type:text"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

type ProjectDataset struct {
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`

	ProjectID int64 `json:"project_id,string" gorm:"index;not null"`

	DatasetID int64 `json:"dataset_id,string" gorm:"index;not null"`

	// Path is the bound dataset's workspace directory
	// (utils.GetDatasetDir(baseDir, project_id, dataset_id)). It is derived at
	// read time and is never persisted.
	Path string `json:"path,omitempty" gorm:"-"`

	CreatedAt time.Time `json:"created_at"`
}

type ProjectListItem struct {
	Project
	ShareCode    string `json:"share_code"`
	ShareEnabled bool   `json:"share_enabled"`
}

type ProjectLiterature struct {
	ID           uint      `json:"id" gorm:"primaryKey;autoIncrement"`
	ProjectID    int64     `` /* 142-byte string literal not displayed */
	LiteratureID int64     `` /* 148-byte string literal not displayed */
	CreatedAt    time.Time `json:"created_at"`
}

type ProjectReport struct {
	ID        int64     `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	ProjectID int64     `json:"project_id,string" gorm:"type:bigint;not null;index"`
	Title     string    `json:"title" gorm:"type:varchar(255)"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type ProjectReportCommitResult struct {
	ReportID  string `json:"report_id"`
	ProjectID string `json:"project_id"`
	// Committed 本次是否真的产生了新提交（工作区干净时为 false，不产生空提交）。
	Committed bool `json:"committed"`
	// Commit 提交后的 HEAD hash。
	Commit string `json:"commit,omitempty"`
	// CommitMessage 本次提交实际使用的 message（入参为空时为后端默认文案）。
	CommitMessage string `json:"commit_message"`
}

type ProjectReportGitDiff struct {
	// ReportID / ProjectID 是报告与项目的数值主键（对外统一为字符串）。
	ReportID  string `json:"report_id"`
	ProjectID string `json:"project_id"`
	// RepoDir 是报告工作目录（绝对路径）。
	RepoDir string `json:"repo_dir"`
	// Initialized 报告目录是否已是 git 仓库；false 时没有可展示的 diff。
	Initialized bool `json:"initialized"`
	// HeadCommit 本地 HEAD 提交 hash（尚无提交时为空）。
	HeadCommit string `json:"head_commit,omitempty"`
	// HasChanges 工作区是否有未提交改动。
	HasChanges bool `json:"has_changes"`
	// Worktree 工作区相对本地 HEAD 的未提交改动（含未跟踪文件）。
	Worktree utils.GitDiffSection `json:"worktree"`
	// GitState 实时的本地 git 状态（是否初始化 / 是否有未提交改动）。
	GitState utils.ReportWorktreeGitState `json:"git_state"`
}

type ProjectReportItem struct {
	ID              int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	ProjectReportID int64 `json:"project_report_id,string" gorm:"column:project_report_id;type:bigint;index:idx_project_report_items_report"`
	// ParentID 指向同一报告下的父条目 ID，0 表示根节点。用于组织树形结构。
	ParentID  int64                      `json:"parent_id,string" gorm:"column:parent_id;type:bigint;index:idx_project_report_items_parent"`
	OwnerType ProjectReportItemOwnerType `json:"owner_type" gorm:"column:owner_type;type:varchar(32);index:idx_project_report_items_owner"`
	// OwnerID 指向 OwnerType 对应的主键。
	OwnerID   int64     `json:"owner_id,string" gorm:"column:owner_id;type:bigint;index:idx_project_report_items_owner"`
	SortOrder int       `json:"sort_order" gorm:"column:sort_order;default:0"`
	CreatedAt time.Time `json:"created_at" gorm:"column:created_at"`
	UpdatedAt time.Time `json:"updated_at" gorm:"column:updated_at"`

	// Title 是展示用标题。仅 OwnerType=custom 时由用户编辑并持久化；
	// 其他引用类型的标题由 owner 推导（读取时派生），写入时会清空，不落库。
	Title string `json:"title" gorm:"type:varchar(255)"`
	// Content 是自定义 markdown 正文，仅 OwnerType=custom 时持久化；
	// 其他引用类型不存储内容。
	Content string `json:"content" gorm:"type:longtext"`
}

type ProjectReportItemContent struct {
	Title     string                     `json:"title"`
	Content   string                     `json:"content"`
	OwnerType ProjectReportItemOwnerType `json:"owner_type"`
}

type ProjectReportItemOrder struct {
	ID        int64
	ParentID  int64
	SortOrder int
}

type ProjectReportItemOwnerType string

type QueryDataset struct {
	ID *int64 `json:"id,string,omitempty"`

	DatasetName string `json:"dataset_name,omitempty"`

	DatasetKey string `json:"dataset_key,omitempty"`

	Description string `json:"description,omitempty"`

	Metadata string `json:"metadata,omitempty"`
}

type RegisterRequest struct {
	Username string `json:"username" binding:"required,min=2,max=50"`
	Email    string `json:"email"    binding:"required,email"`
	Password string `json:"password" binding:"required,min=6"`
}

type RegisterResponse struct {
	Success bool   `json:"success"`
	Message string `json:"message,omitempty"`
	User    *User  `json:"user,omitempty"`
}

type RequestContext struct {
	User *User
}

type RuntimeVariable struct {
	Name        string                  `json:"name"`
	Value       string                  `json:"value"`
	Category    RuntimeVariableCategory `json:"category"`
	Description string                  `json:"description"`
	Source      RuntimeVariableSource   `json:"source"`
}

type RuntimeVariableCategory string

type RuntimeVariableDefinition struct {
	Name        string                  `json:"name"`
	Category    RuntimeVariableCategory `json:"category"`
	Description string                  `json:"description"`
	Source      RuntimeVariableSource   `json:"source"`
}

type RuntimeVariableSource string

type Script struct {
	// ID                  uint      `json:"id" gorm:"primaryKey;autoIncrement"`
	ID            int64  `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	StoreID       int64  `json:"store_id,string" gorm:"column:store_id;type:bigint"`
	ProjectID     int64  `json:"project_id,string" gorm:"column:project_id;type:bigint"`
	ScriptID      string `json:"component_id" gorm:"column:component_id;type:varchar(255)"`
	InstallKey    string `json:"install_key" gorm:"type:varchar(255)"`
	ComponentType string `json:"component_type" gorm:"type:varchar(255)"`
	// Name 是组件名称。Go / JSON 侧统一叫 name（列名暂不改动，仍为 component_name），
	// 因此这里必须显式指定 column，避免 gorm 按字段名推导出 name 列。
	Name                string `json:"name" gorm:"column:component_name;type:varchar(255)"`
	Description         string `json:"description" gorm:"type:longtext"`
	ComponentIDs        string `json:"component_ids" gorm:"type:longtext"`
	Img                 string `json:"img" gorm:"type:varchar(255)"`
	ContainerTemplateID int64  `json:"container_template_id,string" gorm:"column:container_template_id;type:bigint"`
	// IOSchema            string `json:"io_schema" gorm:"column:io_schema;type:longtext"`
	Tags       string `json:"tags" gorm:"type:varchar(255)"`
	FileType   string `json:"file_type" gorm:"type:varchar(255)"`
	ScriptType string `json:"script_type" gorm:"type:varchar(255)"`
	Category   string `json:"category" gorm:"type:varchar(255);default:default"`
	// Content        string `json:"content" gorm:"type:text"`
	OrderIndex int `json:"order_index"`

	// Version   string    `json:"version" gorm:"type:varchar(255)"`
	// Message   string    `json:"message" gorm:"type:longtext"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type ScriptContainerSnapshot struct {
	ScriptID      string `json:"script_id" gorm:"column:script_id"`
	ContainerID   int64  `json:"container_id,string" gorm:"column:container_id"`
	ContainerName string `json:"container_name" gorm:"column:container_name"`
	ImageName     string `json:"image_name" gorm:"column:image_name"`
}

type ScriptJSONExportResponse struct {
	// Version 是导出文件格式版本（取值见 internal/exportcodec，如 exportcodec.VersionV1），
	// 写入 script.json 顶层；安装侧（InstallScript）据此路由到对应版本的 Codec。
	// 历史产物没有该字段，反序列化后为空字符串。
	Version  string         `json:"version"`
	ScriptID string         `json:"script_id"`
	Script   map[string]any `json:"script"`
	// 容器资产与 workflow.json 完全一致：两个按主键去重的平铺列表。
	// 脚本的 container_template_id 引用的是绑定行主键，绑定行通过 spec_id 引用运行配置，
	// 镜像名与拉取策略直接挂在绑定行上。两者均不含时间字段。
	ContainerTemplateSpecs       []ContainerTemplateSpec       `json:"container_template_specs,omitempty"`
	ContainerTemplateDefinitions []ContainerTemplateDefinition `json:"container_template_definitions,omitempty"`
}

type ScriptPageQuery struct {
	IDs []int64 `json:"ids,omitempty"`

	ID *int64 `json:"id,string,omitempty"`

	ProjectID int64 `json:"project_id,string,omitempty"`

	ScriptID string `json:"script_id,omitempty"`

	Name string `json:"name,omitempty"`

	ScriptType string `json:"script_type,omitempty"`

	Category string `json:"category,omitempty"`

	InstallKey string `json:"install_key,omitempty"`

	Tags string `json:"tags,omitempty"`

	Keywords string `json:"keywords,omitempty"`

	ContainerTemplateID *int64 `json:"container_template_id,string,omitempty"`

	SortBy string `json:"sort_by,omitempty"`

	SortOrder string `json:"sort_order,omitempty"`
}

type ScriptVersion struct {
	Script
	// StoreVersion string `json:"store_version"`
	StorePath  string `json:"store_path"`
	ScriptPath string `json:"script_path"`
	// IOSchema 实时读取自脚本目录的 io_schema.json（不再是数据库字段）。
	IOSchema string `json:"io_schema"`
	// StoreURL string `json:"store_url"`
	// StoreMessage string `json:"store_message"`
	// GitState 由磁盘上的 git 元数据实时推导（不落库）：
	// has_local_changes=true 表示本地有未发布改动，
	// has_store_changes=true 表示 store 有本地未同步的提交。
	GitState *utils.GitSyncState `json:"git_state,omitempty"`
}

type Store struct {
	ID int64 `json:"id,string" gorm:"primaryKey;autoIncrement"`

	// StoreID string `json:"store_id" gorm:"type:varchar(255);index"`
	// AppID       string         `json:"app_id" gorm:"type:varchar(255);index"`
	// workflow script
	StoreType string `json:"store_type" gorm:"type:varchar(255);index"`
	Name      string `json:"name" gorm:"type:varchar(255)"`
	Origin    string `json:"origin" gorm:"type:varchar(255)"`
	// URL 字段已删除：store 不再保存「远程仓库地址」。
	// 发布到远程（PublishStoreRemote）只把地址写进 store 裸仓库的 git remote 配置，
	// 下载来源地址同样可以从 clone 生成的 origin remote 读回，因此地址不再落库，
	// 避免数据库与仓库真实配置两份状态漂移。
	// 需要展示时读 Remotes（由磁盘实时推导）。
	// Status    string `json:"status" gorm:"type:varchar(255);index"`
	// PathName 是 store 目录在 storage.base_dir/store 下的相对标识，只在首次创建 store 时
	// 由 utils.GenerateStorePathName 生成随机串并固定下来：既不随 workflow_id / script_id 变化，
	// 也不来自下载源地址（历史数据可能仍是 workflow/script ID 或 "<owner>/<repo>"，原样沿用）。
	// 绝对路径一律不落库，需要时用 utils.GetWorkflowOrScriptStoreDir(baseDir, PathName) 解析。
	PathName string `json:"path_name" gorm:"type:varchar(255)"`
	// StorePath 是 PathName 按当前 storage.base_dir 解析出的绝对目录，只在响应里返回。
	// 不落库（gorm:"-"），既避免 base_dir 迁移后库内路径失效，也保证与 PathName 单一来源一致。
	StorePath string `json:"store_path,omitempty" gorm:"-"`
	// Remotes 是 store 裸仓库上配置的远程仓库列表（github / gitee / origin ...），
	// 与 StorePath 一样只在响应里返回、不落库（gorm:"-"）：发布到远程时写入的是
	// store 仓库的 git remote 配置，读取侧统一通过 utils.ReadGitRemotes 实时推导。
	Remotes  []utils.GitRemote `json:"remotes,omitempty" gorm:"-"`
	Category string            `json:"category" gorm:"type:varchar(255);index"`
	Tags     datatypes.JSON    `json:"tags" gorm:"type:json"`
	Img      string            `json:"img" gorm:"type:varchar(255)"`
	// PublishURLs datatypes.JSON `json:"publish_urls" gorm:"column:publish_urls;type:json"`
	Log string `json:"log" gorm:"type:longtext"`

	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type StoreDTO struct {
	Store
	Installed   bool   `json:"installed"`
	InstalledID string `json:"installed_id,omitempty"`
}

type StorePageQuery struct {
	StoreType string `json:"store_type"`
	Keywords  string `json:"keywords,omitempty"`
	SortBy    string `json:"sort_by,omitempty"`
	SortOrder string `json:"sort_order,omitempty"`
}

type SummaryOwnerType string

type SummaryStatus string

type TerminalAppSessionInput struct {
	UserID              int64
	ProjectID           int64
	ContainerTemplateID int64
	AgentSessionID      int64
	Name                string
	WorkspacePath       string
	Persistent          bool
}

type TerminalSessionStatus string

type UpdateDatasetRequest struct {
	ID          int64  `json:"id,string" binding:"required"`
	DatasetName string `json:"dataset_name" binding:"required"`
	DatasetKey  string `json:"dataset_key"`
	Description string `json:"description"`
	Metadata    string `json:"metadata"`
}

type User struct {
	// Unique identifier of the user
	ID int64 `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	// Username of the user
	Username string `json:"username"   gorm:"type:varchar(100);uniqueIndex;not null"`
	// Email address of the user
	Email string `json:"email"      gorm:"type:varchar(255);uniqueIndex;not null"`
	// Hashed password of the user
	PasswordHash string `json:"-"          gorm:"type:varchar(255);not null"`
	// Avatar URL of the user
	Avatar string `json:"avatar"     gorm:"type:varchar(500)"`
	// AgentConfig 用户的 Agent 配置（Profile + 权限策略），以 JSON 形式落库。
	AgentConfig UserAgentConfig `json:"agent_config" gorm:"serializer:json"`
	// Tenant ID that the user belongs to
	// TenantID uint64 `json:"tenant_id"  gorm:"index"`
	// Whether the user is active
	IsActive bool `json:"is_active"  gorm:"default:true"`
	// Whether the user can access all tenants (cross-tenant access)
	CanAccessAllTenants bool `json:"can_access_all_tenants" gorm:"default:false"`
	// Creation time of the user
	CreatedAt time.Time `json:"created_at"`
	// Last updated time of the user
	UpdatedAt time.Time `json:"updated_at"`
	// Deletion time of the user
	DeletedAt gorm.DeletedAt `json:"deleted_at" gorm:"index"`
}

type UserAgentConfig struct {
	ProfileID   int64                                `json:"profile_id,omitempty,string"`
	Permissions map[OperationType]PermissionDecision `json:"permissions,omitempty"`
	// EnvID 是业务上下文对象 ID（如 project report id / analysis node id / analysis id）。
	EnvID string `json:"env_id,omitempty"`
	// EnvType 是业务上下文类型（见 handler 的 EnvType* 枚举，如 "projectReport" / "analysisNode"）。
	EnvType string `json:"env_type,omitempty"`
}

type UserBottomPanel struct {
	Open   bool            `json:"open"`
	Active string          `json:"active,omitempty"`
	Height int             `json:"height,omitempty"`
	Tabs   []UserBottomTab `json:"tabs,omitempty"`
}

type UserBottomTab struct {
	Key    string         `json:"key"`
	Kind   string         `json:"kind"`
	Title  string         `json:"title,omitempty"`
	Params map[string]any `json:"params,omitempty"`
}

type UserInfo struct {
	ID          int64           `json:"id,string"`
	Username    string          `json:"username"`
	Email       string          `json:"email"`
	Avatar      string          `json:"avatar"`
	AgentConfig UserAgentConfig `json:"agent_config"`
	// MenuConfig 是用户在「当前激活项目」下的菜单配置（主区域标签页 + 底部面板），
	// 数据存在 user_project.menu_config。字段名保持 menu_config 不变，前端无需改动。
	MenuConfig UserMenuConfig `json:"menu_config"`
	// AgentProfile 是 agent_config.ProfileID 对应的 Profile 摘要（DTO，按需填充，可能为空）。
	AgentProfile        *AgentProfileInfo `json:"agent_profile,omitempty"`
	TenantID            uint64            `json:"tenant_id"`
	IsActive            bool              `json:"is_active"`
	CanAccessAllTenants bool              `json:"can_access_all_tenants"`
	CreatedAt           time.Time         `json:"created_at"`
	UpdatedAt           time.Time         `json:"updated_at"`
}

type UserMenuConfig struct {
	Tabs []UserMenuTab `json:"tabs,omitempty"`
	// Bottom 为空表示底部面板没有打开的标签（前端据此不渲染面板）。
	Bottom *UserBottomPanel `json:"bottom,omitempty"`
}

type UserMenuTab struct {
	URL   string `json:"url"`
	Title string `json:"title,omitempty"`
}

type UserProject struct {
	ID     uint  `json:"id" gorm:"primaryKey;autoIncrement"`
	UserID int64 `json:"user_id,string" gorm:"type:bigint;not null;index:idx_user_project_user;uniqueIndex:idx_user_project_unique,priority:1"`
	// ProjectID 指向 t_project.id。
	ProjectID int64 `` /* 148-byte string literal not displayed */
	IsActive  bool  `json:"is_active" gorm:"default:false"`

	// ShareCode is generated when the owner enables project sharing. Other users
	// can use it to look up the project and gain access.
	ShareCode string `json:"share_code" gorm:"type:varchar(64);index"`
	// ShareEnabled toggles whether the project can be shared via ShareCode.
	ShareEnabled bool `json:"share_enabled" gorm:"default:false"`
	// MenuConfig 是「该用户在这个项目下」的菜单配置（主区域标签页 + 底部面板）。
	// 标签页、终端等界面状态都是项目维度的，所以随 user_project 一起落库。
	MenuConfig UserMenuConfig `json:"menu_config" gorm:"serializer:json"`
	CreatedAt  time.Time      `json:"created_at"`
}

type Workflow struct {
	// ID                 uint           `json:"id" gorm:"primaryKey;autoIncrement"`
	ID        int64          `json:"id,string" gorm:"primaryKey;type:bigint;autoIncrement:false"`
	ProjectID int64          `json:"project_id,string" gorm:"column:project_id;type:bigint"`
	StoreID   int64          `json:"store_id,string" gorm:"column:store_id;type:bigint"`
	Name      string         `json:"name" gorm:"type:varchar(255)"`
	Img       string         `json:"img" gorm:"type:varchar(255)"`
	Tags      datatypes.JSON `json:"tags" gorm:"type:json"`
	// URL                string         `json:"url" gorm:"column:url;type:varchar(255)"`
	Category    string `json:"category" gorm:"type:varchar(255);default:default"`
	Description string `json:"description" gorm:"type:longtext"`
	Prompt      string `json:"prompt" gorm:"type:longtext"`
	// DagDefinition      string         `json:"dag_definition" gorm:"column:dag_definition;type:longtext"`
	WorkflowID         string         `json:"workflow_id" gorm:"column:relation_id;type:varchar(255)"`
	RelationType       string         `json:"relation_type" gorm:"type:varchar(255)"`
	InstallKey         string         `json:"install_key" gorm:"type:varchar(255)"`
	ModuleID           string         `json:"component_id" gorm:"column:component_id;type:varchar(255)"`
	ContainerID        string         `json:"container_id" gorm:"type:varchar(255)"`
	ParentComponentID  string         `json:"parent_component_id" gorm:"type:varchar(255)"`
	InputComponentIDs  datatypes.JSON `json:"input_component_ids" gorm:"type:json"`
	OutputComponentIDs datatypes.JSON `json:"output_component_ids" gorm:"type:json"`
	OrderIndex         int            `json:"order_index"`
	// Version            string         `json:"version" gorm:"type:varchar(255)"`
	// Message   string    `json:"message" gorm:"type:longtext"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type WorkflowJSONExportResponse struct {
	// Version 是导出文件格式版本（取值见 internal/exportcodec，如 exportcodec.VersionV1），
	// 写入 workflow.json 顶层；安装侧（InstallWorkflow）据此路由到对应版本的 Codec。
	// 历史产物没有该字段，反序列化后为空字符串。
	Version string `json:"version"`
	// Path               string           `json:"path"`
	WorkflowID string           `json:"workflow_id"`
	Workflow   map[string]any   `json:"workflow"`
	Scripts    []map[string]any `json:"scripts"`
	// 容器资产是两个按主键去重的平铺列表，与 script.json 完全一致。
	// ContainerTemplateSpecs 是运行配置（definition.spec_id 指向它）；
	// ContainerTemplateDefinitions 是绑定行（主键即脚本 container_template_id，
	// 镜像名与拉取策略直接挂在绑定行上）。两者均不含时间字段。
	ContainerTemplateSpecs       []ContainerTemplateSpec       `json:"container_template_specs"`
	ContainerTemplateDefinitions []ContainerTemplateDefinition `json:"container_template_definitions"`
}

type WorkflowPageQuery struct {
	IDs []uint `json:"ids,omitempty"`

	ID *uint `json:"id,omitempty"`

	ProjectID int64 `json:"project_id,string,omitempty"`

	WorkflowID string `json:"workflow_id,omitempty"`

	Name string `json:"name,omitempty"`

	Category string `json:"category,omitempty"`

	InstallKey string `json:"install_key,omitempty"`

	ModuleID string `json:"module_id,omitempty"`

	RelationType string `json:"relation_type,omitempty"`

	Tags string `json:"tags,omitempty"`

	Keywords string `json:"keywords,omitempty"`

	SortBy string `json:"sort_by,omitempty"`

	SortOrder string `json:"sort_order,omitempty"`
}

type WorkflowVersion struct {
	// ID                 int64          `json:"id,string"`
	// ProjectID          int64          `json:"project_id,string"`
	// StoreID            int64          `json:"store_id,string"`
	// Name               string         `json:"name"`
	// Img                string         `json:"img"`
	// Tags               datatypes.JSON `json:"tags"`
	// URL                string         `json:"url"`
	// Category           string         `json:"category"`
	// Description        string         `json:"description"`
	// Prompt             string         `json:"prompt"`
	// DagDefinition      string         `json:"dag_definition"`
	// WorkflowID         string         `json:"relation_id"`
	// RelationType       string         `json:"relation_type"`
	// InstallKey         string         `json:"install_key"`
	// ModuleID           string         `json:"component_id"`
	// ContainerID        string         `json:"container_id"`
	// ParentComponentID  string         `json:"parent_component_id"`
	// InputComponentIDs  datatypes.JSON `json:"input_component_ids"`
	// OutputComponentIDs datatypes.JSON `json:"output_component_ids"`
	// OrderIndex         int            `json:"order_index"`
	// Version            string         `json:"version"`
	// UpdateInfo         string         `json:"update_info"`
	// CreatedAt          time.Time      `json:"created_at"`
	// UpdatedAt          time.Time      `json:"updated_at"`
	Workflow
	StorePath    string `json:"store_path"`
	WorkflowPath string `json:"workflow_path"`
	// DagDefinition 实时读取自工作流目录的 dag_definition.json（不再是数据库字段）。
	// 用于工作流可视化编辑与 DAG 运行时编译（见 GetWorkflowVisByWorkflowID / SaveWorkflow）。
	DagDefinition string `json:"dag_definition"`
	// IOSchema 实时读取自工作流目录的 io_schema.json（不再是数据库字段）。
	// 工作流级 inputs 用于运行工作流时生成 formJson（见 GetFormJSONByWorkflowID）。
	IOSchema string `json:"io_schema"`
	// StoreURL     string `json:"store_url"`
	// StoreMessage string `json:"store_message"`
	// StoreVersion string `json:"store_version"`
	// GitState 由磁盘上的 git 元数据实时推导（不落库）：
	// has_local_changes=true 表示本地有未发布改动，
	// has_store_changes=true 表示 store 有本地未同步的提交。
	GitState *utils.GitSyncState `json:"git_state,omitempty"`
}