domain

type ActivateReq struct {
	InviteCode string `json:"invite_code" validate:"required"`
	InviterID  string `json:"inviter_id,omitempty"`
}

type AddGitIdentityReq struct {
	Platform    consts.GitPlatform `json:"platform" validate:"required"`
	BaseURL     string             `json:"base_url" validate:"required"`
	AccessToken string             `json:"access_token" validate:"required"`
	Username    string             `json:"username" validate:"required"`
	Email       string             `json:"email" validate:"required"`
	Remark      string             `json:"remark,omitempty"`
}

type AddGroupImageReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	ImageID uuid.UUID `param:"image_id" validate:"required" json:"-" swaggerignore:"true"`
}

type AddGroupModelReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	ModelID uuid.UUID `param:"model_id" validate:"required" json:"-" swaggerignore:"true"`
}

type AddTeamAdminReq struct {
	Email string `json:"email" validate:"required,email"` // 邮箱
	Name  string `json:"name" validate:"required"`        // 姓名
}

type AddTeamAdminResp struct {
	User *TeamUser `json:"user"`
}

type AddTeamGroupReq struct {
	Name string `json:"name" validate:"required"`
}

type AddTeamGroupUsersReq struct {
	GroupID uuid.UUID   `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	UserIDs []uuid.UUID `json:"user_ids" validate:"required"`
}

type AddTeamGroupUsersResp struct {
	Users []*User `json:"users"`
}

type AddTeamImageReq struct {
	Name     string      `json:"name" validate:"required"`
	Remark   string      `json:"remark"`
	GroupIDs []uuid.UUID `json:"group_ids" validate:"required"`
}

type AddTeamModelReq struct {
	Provider      string               `json:"provider" validate:"required"`
	APIKey        string               `json:"api_key" validate:"required"`
	BaseURL       string               `json:"base_url" validate:"required"`
	Model         string               `json:"model" validate:"required"`
	Temperature   float64              `json:"temperature"`
	GroupIDs      []uuid.UUID          `json:"group_ids" validate:"required"`
	InterfaceType consts.InterfaceType `json:"interface_type" validate:"required,oneof=openai_chat openai_responses anthropic"`
}

type AddTeamUserReq struct {
	Emails  []string  `json:"emails" validate:"required"`    // 邮箱列表
	GroupID uuid.UUID `json:"group_id" validate:"omitempty"` // 团队组ID
}

type AddTeamUserResp struct {
	Users []*TeamUser `json:"users"`
}

type ApplyPortReq struct {
	ID        string   `json:"id" param:"id" validate:"required" swaggerignore:"true"`
	HostID    string   `json:"host_id" param:"host_id" validate:"required" swaggerignore:"true"`
	Port      uint16   `json:"port" validate:"required,min=1,max=65535"`
	WhiteList []string `json:"white_list" validate:"required,dive,ip"`
	ForwardID string   `json:"forward_id" validate:"omitempty"`
}

type ArchiveOptions struct {
	Token     string
	Owner     string
	Repo      string
	Ref       string
	InstallID int64
	IsOAuth   bool
}

type Audit struct {
	ID        uuid.UUID `json:"id"`
	Operation string    `json:"operation"`
	SourceIP  string    `json:"source_ip"`
	UserAgent string    `json:"user_agent"`
	Request   string    `json:"request"`
	Response  string    `json:"response"`
	CreatedAt time.Time `json:"created_at"`
	User      *User     `json:"user"`
}

type AuditRepo interface {
	CreateAudit(ctx context.Context, audit *Audit) error
	ListAudits(ctx context.Context, teamUser *TeamUser, req *ListAuditsRequest) ([]*db.Audit, *db.Cursor, error)
}

type AuditUsecase interface {
	CreateAudit(ctx context.Context, audit *Audit) error
	ListAudits(ctx context.Context, teamUser *TeamUser, req *ListAuditsRequest) (*ListAuditsResponse, error)
}

type AuthRepository struct {
	FullName    string `json:"full_name"`
	URL         string `json:"url"`
	Description string `json:"description"`
}

type BindRepository struct {
	RepoID          string
	RepoName        string
	FullName        string
	RepoURL         string
	RepoDescription string
	IsPrivate       bool
	Platform        string
}

type BlobOptions struct {
	Token     string
	Owner     string
	Repo      string
	Ref       string
	Path      string
	InstallID int64
	IsOAuth   bool
}

type Branch struct {
	Name string `json:"name"`
}

type BranchInfo struct {
	Name string
}

type BranchesOptions struct {
	Token     string
	Owner     string
	Repo      string
	Page      int
	PerPage   int
	InstallID int64
	IsOAuth   bool
}

type ChangePasswordReq struct {
	CurrentPassword string `json:"current_password" validate:"omitempty"`         // 当前密码
	NewPassword     string `json:"new_password" validate:"required,min=8,max=32"` // 新密码
}

type ChangePasswordResp struct {
	Success bool   `json:"success"`
	Message string `json:"message"`
}

type CheckByConfigReq struct {
	Provider      consts.ModelProvider `json:"provider" validate:"required"`
	APIKey        string               `json:"api_key" validate:"required"`
	BaseURL       string               `json:"base_url" validate:"required"`
	Model         string               `json:"model" validate:"required"`
	InterfaceType consts.InterfaceType `json:"interface_type,omitempty" validate:"omitempty,oneof=openai_chat openai_responses anthropic"`
}

type CheckModelReq struct {
	ID uuid.UUID `param:"id" validate:"required"`
}

type CheckModelResp struct {
	Success bool   `json:"success"`
	Error   string `json:"error,omitempty"`
}

type CloseTerminalReq struct {
	ID         string `json:"id" query:"id" param:"id" validate:"required"`
	TerminalID string `json:"terminal_id" param:"terminal_id" validate:"required"`
}

type Collaborator struct {
	User
	Permission consts.ProjectCollaboratorRole `json:"permission"`
}

type CommitAdapter struct {
	Author     *CommitUserAdapter
	Committer  *CommitUserAdapter
	Message    string
	ParentShas []string
	Sha        string
	TreeSha    string
}

type CommitEntryAdapter struct {
	Commit *CommitAdapter
}

type CommitUserAdapter struct {
	Email string
	Name  string
	When  int64
}

type CreateAuditRequest struct {
	UserID    uuid.UUID `json:"user_id" binding:"required"`
	Operation string    `json:"operation" binding:"required"`
	SourceIP  string    `json:"source_ip" binding:"required"`
	UserAgent string    `json:"user_agent"`
	Request   string    `json:"request"`
	Response  string    `json:"response"`
}

type CreateCollaboratorItem struct {
	UserID     uuid.UUID                      `json:"user_id"`
	Permission consts.ProjectCollaboratorRole `json:"permission"`
}

type CreateGitBotReq struct {
	Platform consts.GitPlatform `json:"platform" validate:"required"`
	Name     string             `json:"name"`
	Token    string             `json:"token" validate:"required"`
	HostID   string             `json:"host_id" validate:"required"`
}

type CreateGitTaskReq struct {
	HostID               string             `json:"host_id"`
	ImageID              uuid.UUID          `json:"image_id"`
	Subject              Subject            `json:"subject"`
	Repo                 Repo               `json:"repo"`
	User                 User               `json:"user"`
	Platform             consts.GitPlatform `json:"platform"`
	Body                 string             `json:"body"`
	Time                 time.Time          `json:"time"`
	Prompt               string             `json:"prompt"`
	PromptID             string             `json:"prompt_id"`
	GithubInstallationID int64              `json:"github_installation_id"`
	Env                  map[string]string  `json:"env"`
	Git                  taskflow.Git       `json:"git"`
	Bot                  *GitBot            `json:"-"`
}

type CreateImageReq struct {
	ImageName string `json:"image_name" validate:"required"`
	Remark    string `json:"remark,omitempty"`
	IsDefault bool   `json:"is_default,omitempty"`
}

type CreateImageResp struct {
	ID uuid.UUID `json:"id"`
}

type CreateIssueCommentReq struct {
	ID       uuid.UUID  `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	IssueID  uuid.UUID  `param:"issue_id" validate:"required" json:"-" swaggerignore:"true"`
	Comment  string     `json:"comment" validate:"required"`
	ParentID *uuid.UUID `json:"parent_id,omitempty"`
}

type CreateIssueReq struct {
	ID                  uuid.UUID                   `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Title               string                      `json:"title"`
	RequirementDocument string                      `json:"requirement_document"`
	AssigneeID          *uuid.UUID                  `json:"assignee_id,omitempty"`
	Priority            consts.ProjectIssuePriority `json:"priority,omitempty"`
}

type CreateModelReq struct {
	Provider      string               `json:"provider" validate:"required"`
	APIKey        string               `json:"api_key" validate:"required"`
	BaseURL       string               `json:"base_url" validate:"required"`
	Model         string               `json:"model" validate:"required"`
	Temperature   float32              `json:"temperature"`
	IsDefault     bool                 `json:"is_default"`
	InterfaceType consts.InterfaceType `json:"interface_type" validate:"required,oneof=openai_chat openai_responses anthropic"`
}

type CreateModelResp struct {
	ID uuid.UUID `json:"id"`
}

type CreateNotifyChannelReq struct {
	Name       string                   `json:"name" validate:"required,max=64"`
	Kind       consts.NotifyChannelKind `json:"kind" validate:"required,oneof=dingtalk feishu wecom webhook"`
	WebhookURL string                   `json:"webhook_url" validate:"required,url"`
	Secret     string                   `json:"secret,omitempty"`
	Headers    map[string]string        `json:"headers,omitempty"`
	EventTypes []consts.NotifyEventType `json:"event_types" validate:"required,min=1"`
}

type CreateNotifySendLogReq struct {
	SubscriptionID uuid.UUID               `json:"subscription_id"`
	ChannelID      uuid.UUID               `json:"channel_id"`
	EventType      consts.NotifyEventType  `json:"event_type"`
	EventRefID     string                  `json:"event_ref_id"`
	Status         consts.NotifySendStatus `json:"status"`
	Error          string                  `json:"error"`
}

type CreateProjectReq struct {
	Name          string             `json:"name"`
	Description   string             `json:"description"`
	Platform      consts.GitPlatform `json:"platform"`
	RepoURL       string             `json:"repo_url"`
	GitIdentityID uuid.UUID          `json:"git_identity_id"`
	ImageID       uuid.UUID          `json:"image_id,omitempty"`
	EnvVariables  map[string]any     `json:"env_variables,omitempty"`
}

type CreateTaskReq struct {
	Content       string             `json:"content" validate:"required"`
	HostID        string             `json:"host_id" validate:"required"`
	ImageID       uuid.UUID          `json:"image_id" validate:"required"`
	ModelID       string             `json:"model_id" validate:"required"`
	GitIdentityID uuid.UUID          `json:"git_identity_id" validate:"omitempty"`
	RepoReq       TaskRepoReq        `json:"repo" validate:"required"`
	CliName       consts.CliName     `json:"cli_name"`
	Resource      *VMResource        `json:"resource" validate:"required"`
	Extra         TaskExtraConfig    `json:"extra" validate:"omitempty"`
	SystemPrompt  string             `json:"system_prompt"`
	Type          consts.TaskType    `json:"task_type"`
	SubType       consts.TaskSubType `json:"sub_type"`
	Now           time.Time          `json:"-"`
	UsePublicHost bool               `json:"-"`
}

type CreateVMReq struct {
	HostID              string       `json:"host_id" validate:"required"`
	Name                string       `json:"name" validate:"required"`
	ImageID             uuid.UUID    `json:"image_id" validate:"required"`
	ModelID             string       `json:"model_id" validate:"required"`
	Life                int64        `json:"life"`
	Resource            *Resource    `json:"resource" validate:"required"`
	InstallCodingAgents bool         `json:"install_coding_agents,omitempty"`
	RepoReq             *TaskRepoReq `json:"repo,omitempty"`
	GitIdentityID       uuid.UUID    `json:"git_identity_id"`
	Now                 time.Time    `json:"-"`
	UsePublicHost       bool         `json:"-"`
}

type CreateWebhookOptions struct {
	Token       string
	RepoURL     string
	WebhookURL  string
	SecretToken string
	Events      []string
	IsOAuth     bool
}

type CursorReq struct {
	Cursor string `query:"cursor"`
	Limit  int    `query:"limit"`
}

type DeleteGitIdentityReq struct {
	ID uuid.UUID `param:"id" validate:"required"`
}

type DeleteGroupImageReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	ImageID uuid.UUID `param:"image_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteGroupModelReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	ModelID uuid.UUID `param:"model_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteImageReq struct {
	ID uuid.UUID `param:"id" validate:"required"`
}

type DeleteModelConfigReq struct {
	ID uuid.UUID `param:"id" validate:"required"`
}

type DeleteTeamGroupReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteTeamGroupUserReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	UserID  uuid.UUID `param:"user_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteTeamHostReq struct {
	HostID string `param:"host_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteTeamImageReq struct {
	ImageID uuid.UUID `param:"image_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteTeamModelReq struct {
	ModelID uuid.UUID `param:"model_id" validate:"required" json:"-" swaggerignore:"true"`
}

type DeleteVirtualMachineReq struct {
	ID     string `json:"id" query:"id" param:"id" validate:"required"`
	HostID string `json:"host_id" query:"host_id" param:"host_id" validate:"required"`
}

type EmailSender interface {
	SendResetPasswordEmail(ctx context.Context, to, username, resetURL string) error
	SendBindEmailVerification(ctx context.Context, to, username, verifyURL string) error
}

type FileChangeReq struct {
	ID     string `json:"id" query:"id" validate:"required"`         // 虚拟机 id
	Source string `json:"source" query:"source" validate:"required"` // 来源
	Target string `json:"target" query:"target" validate:"required"` // 目标
}

type FilePathReq struct {
	ID   string `json:"id" query:"id" validate:"required"`     // 虚拟机 id
	Path string `json:"path" query:"path" validate:"required"` // 文件/目录路径
}

type FileSaveReq struct {
	ID      string `json:"id" validate:"required"`   // 虚拟机 id
	Path    string `json:"path" validate:"required"` // 文件路径
	Content string `json:"content"`                  // 文件内容
}

type FireExpiredVMItem struct {
	ID      string `json:"id"`
	Message string `json:"message"`
}

type GetAccountInfoReq struct {
	Token string `param:"token" validate:"required"`
}

type GetBlobResp struct {
	Content  []byte
	IsBinary bool
	Sha      string
	Size     int
}

type GetGitIdentityReq struct {
	ID uuid.UUID `param:"id" validate:"required"`
}

type GetGitLogsResp struct {
	Count   int
	Entries []*GitCommitEntry
}

type GetProjectArchiveReq struct {
	ID  uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Ref string    `query:"ref" validate:"omitempty"`
}

type GetProjectArchiveResp struct {
	ContentLength int64
	ContentType   string
	Reader        io.ReadCloser
}

type GetProjectBlobReq struct {
	ID   uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Path string    `query:"path" validate:"required"`
	Ref  string    `query:"ref" validate:"omitempty"`
}

type GetProjectLogsReq struct {
	ID     uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Ref    string    `query:"ref" validate:"omitempty"`
	Path   string    `query:"path" validate:"omitempty"`
	Limit  int       `query:"limit" validate:"omitempty"`
	Offset int       `query:"offset" validate:"omitempty"`
}

type GetProjectTreeReq struct {
	ID        uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Recursive bool      `query:"recursive" validate:"omitempty"`
	Ref       string    `query:"ref" validate:"omitempty"`
	Path      string    `query:"path" validate:"omitempty"`
}

type GetProviderModelListReq struct {
	Provider  consts.ModelProvider `` /* 166-byte string literal not displayed */
	BaseURL   string               `json:"base_url" query:"base_url" validate:"required"`
	APIKey    string               `json:"api_key" query:"api_key" validate:"required"`
	APIHeader string               `json:"api_header" query:"api_header"`
}

type GetProviderModelListResp struct {
	Models []ProviderModelListItem `json:"models"`
	Error  *OpenAIError            `json:"error,omitempty"`
}

type GetRepoArchiveResp struct {
	ContentLength int64
	ContentType   string
	Reader        io.ReadCloser
}

type GetRepoTreeResp struct {
	Entries []*TreeEntry
	SHA     string
}

type GitBot struct {
	ID          uuid.UUID          `json:"id"`
	Platform    consts.GitPlatform `json:"platform"`
	Name        string             `json:"name"`
	Token       string             `json:"token"`
	SecretToken string             `json:"secret_token"`
	Host        *Host              `json:"host"`
	WebhookURL  string             `json:"webhook_url"`
	Users       []*User            `json:"users"`
	CreatedAt   int64              `json:"created_at"`
}

type GitBotRepo interface {
	GetByID(ctx context.Context, id uuid.UUID) (*db.GitBot, error)
	GetInstallationID(ctx context.Context, botID uuid.UUID) (int64, error)
	GetGitIdentityID(ctx context.Context, botID uuid.UUID) (uuid.UUID, error)
	List(ctx context.Context, uid uuid.UUID) ([]*db.GitBot, error)
	Create(ctx context.Context, uid uuid.UUID, req CreateGitBotReq) (*db.GitBot, error)
	Update(ctx context.Context, uid uuid.UUID, req UpdateGitBotReq) (*db.GitBot, error)
	Delete(ctx context.Context, uid, id uuid.UUID) error
	ListTask(ctx context.Context, uid uuid.UUID, req ListGitBotTaskReq) ([]*db.GitBotTask, *db.PageInfo, error)
	ShareBot(ctx context.Context, uid uuid.UUID, req ShareGitBotReq) error
}

type GitBotTask struct {
	ID          uuid.UUID         `json:"id"`
	PullRequest PullRequest       `json:"pull_request"`
	Repo        GitRepository     `json:"repo"`
	Status      consts.TaskStatus `json:"status"`
	Bot         *GitBot           `json:"bot"`
	CreatedAt   int64             `json:"created_at"`
}

type GitBotUsecase interface {
	GetByID(ctx context.Context, id uuid.UUID) (*GitBot, error)
	GetInstallationID(ctx context.Context, botID uuid.UUID) (int64, error)
	GetAccessToken(ctx context.Context, botID uuid.UUID) (string, error)
	List(ctx context.Context, uid uuid.UUID) (*ListGitBotResp, error)
	Create(ctx context.Context, uid uuid.UUID, req CreateGitBotReq) (*GitBot, error)
	Update(ctx context.Context, uid uuid.UUID, req UpdateGitBotReq) (*GitBot, error)
	Delete(ctx context.Context, uid, id uuid.UUID) error
	ListTask(ctx context.Context, uid uuid.UUID, req ListGitBotTaskReq) (*ListGitBotTaskResp, error)
	ShareBot(ctx context.Context, uid uuid.UUID, req ShareGitBotReq) error
}

type GitClienter interface {
	// 认证
	CheckPAT(ctx context.Context, token, repoURL string) (bool, *BindRepository, error)
	UserInfo(ctx context.Context, token string) (*PlatformUserInfo, error)
	Repositories(ctx context.Context, opts *RepositoryOptions) ([]AuthRepository, error)

	// 仓库操作
	Tree(ctx context.Context, opts *TreeOptions) (*GetRepoTreeResp, error)
	Blob(ctx context.Context, opts *BlobOptions) (*GetBlobResp, error)
	Logs(ctx context.Context, opts *LogsOptions) (*GetGitLogsResp, error)
	Archive(ctx context.Context, opts *ArchiveOptions) (*GetRepoArchiveResp, error)
	Branches(ctx context.Context, opts *BranchesOptions) ([]*BranchInfo, error)

	// Webhook
	DeleteWebhook(ctx context.Context, opts *WebhookOptions) error
	CreateWebhook(ctx context.Context, opts *CreateWebhookOptions) error
}

type GitCommit struct {
	Author     *GitUser
	Committer  *GitUser
	Message    string
	ParentShas []string
	Sha        string
	TreeSha    string
}

type GitCommitEntry struct {
	Commit *GitCommit
}

type GitCredentialInfo struct {
	UserID        uuid.UUID
	ProjectID     uuid.UUID
	GitIdentityID uuid.UUID
	Platform      consts.GitPlatform
	GitUsername   string
}

type GitIdentity struct {
	ID                     uuid.UUID          `json:"id"`
	Platform               consts.GitPlatform `json:"platform"`
	BaseURL                string             `json:"base_url"`
	AccessToken            string             `json:"access_token"`
	Username               string             `json:"username"`
	Email                  string             `json:"email"`
	Remark                 string             `json:"remark"`
	IsInstallationApp      bool               `json:"is_installation_app"`
	AuthorizedRepositories []AuthRepository   `json:"authorized_repositories"`
	CreatedAt              time.Time          `json:"created_at"`
}

type GitIdentityRepo interface {
	Get(ctx context.Context, id uuid.UUID) (*db.GitIdentity, error)
	GetByUserID(ctx context.Context, uid uuid.UUID, id uuid.UUID) (*db.GitIdentity, error)
	List(ctx context.Context, uid uuid.UUID) ([]*db.GitIdentity, error)
	Create(ctx context.Context, uid uuid.UUID, req *AddGitIdentityReq) (*db.GitIdentity, error)
	Update(ctx context.Context, uid uuid.UUID, id uuid.UUID, req *UpdateGitIdentityReq) error
	Delete(ctx context.Context, uid uuid.UUID, id uuid.UUID) error
	CountProjectsByGitIdentityID(ctx context.Context, id uuid.UUID) (int, error)
}

type GitIdentityUsecase interface {
	List(ctx context.Context, uid uuid.UUID) ([]*GitIdentity, error)
	Get(ctx context.Context, uid uuid.UUID, id uuid.UUID) (*GitIdentity, error)
	Add(ctx context.Context, uid uuid.UUID, req *AddGitIdentityReq) (*GitIdentity, error)
	Update(ctx context.Context, uid uuid.UUID, req *UpdateGitIdentityReq) error
	Delete(ctx context.Context, uid uuid.UUID, id uuid.UUID) error
	ListBranches(ctx context.Context, uid uuid.UUID, identityID uuid.UUID, repoFullName string, page, perPage int) ([]*Branch, error)
}

type GitRepository struct {
	URL      string             `json:"url"`
	RepoName string             `json:"repo_name"`
	Owner    string             `json:"owner"`
	Platform consts.GitPlatform `json:"platform"`
}

type GitTask struct {
	ID                   uuid.UUID          `json:"id"`
	TaskID               uuid.UUID          `json:"task_id"`
	SubjectURL           string             `json:"subject_url"`
	PromptID             string             `json:"prompt_id"`
	GithubInstallationID int64              `json:"github_installation_id"`
	Platform             consts.GitPlatform `json:"platform"`
	Repo                 *GitTaskRepo       `json:"repo,omitempty"`
}

type GitTaskRepo struct {
	URL      string             `json:"url"`
	Platform consts.GitPlatform `json:"platform"`
}

type GitTaskRepoInterface interface {
	Create(ctx context.Context, req CreateGitTaskReq, fn func(user *db.User, t *db.Task, m *db.Model, i *db.Image) (*taskflow.VirtualMachine, error)) (*db.Task, error)
}

type GitTaskUsecase interface {
	Create(ctx context.Context, req CreateGitTaskReq) (*GitTask, error)
}

type GitUser struct {
	Email string
	Name  string
	When  int64
}

type GroupImageListReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	CursorReq
}

type GroupImageListResp struct {
	Images []*Image   `json:"images"`
	Page   *db.Cursor `json:"page"`
}

type GroupModelListReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	CursorReq
}

type GroupModelListResp struct {
	Models []*Model   `json:"models"`
	Page   *db.Cursor `json:"page"`
}

type Host struct {
	ID              string            `json:"id"`
	Arch            string            `json:"arch"`
	Cores           int               `json:"cores"`
	OS              string            `json:"os"`
	Status          consts.HostStatus `json:"status"`
	Memory          uint64            `json:"memory"`
	Name            string            `json:"name"`
	ExternalIP      string            `json:"external_ip"`
	Default         bool              `json:"default"`
	Version         string            `json:"version"`
	VirtualMachines []*VirtualMachine `json:"virtualmachines,omitempty"`
	IsDefault       bool              `json:"is_default"`
	Owner           *Owner            `json:"owner,omitempty"`
	Groups          []*TeamGroup      `json:"groups,omitempty"`
	Remark          string            `json:"remark,omitempty"`
	Weight          int               `json:"weight"`
	InternalID      string            `json:"-"`
}

type HostListResp struct {
	Hosts []*Host `json:"hosts"`
}

type HostRepo interface {
	List(ctx context.Context, uid uuid.UUID) ([]*db.Host, error)
	GetHost(ctx context.Context, uid uuid.UUID, id string) (*Host, error)
	GetByID(ctx context.Context, id string) (*db.Host, error)
	GetVirtualMachine(ctx context.Context, id string) (*db.VirtualMachine, error)
	GetVirtualMachineByEnvID(ctx context.Context, envID string) (*db.VirtualMachine, error)
	GetVirtualMachineWithUser(ctx context.Context, uid uuid.UUID, id string) (*db.VirtualMachine, error)
	CreateVirtualMachine(ctx context.Context, user *User, req *CreateVMReq, getRepoToken func(context.Context) (string, error), fn func(*db.Model, *db.Image) (*VirtualMachine, error)) (*VirtualMachine, error)
	PastHourVirtualMachine(ctx context.Context) ([]*db.VirtualMachine, error)
	AllCountDownVirtualMachine(ctx context.Context) ([]*db.VirtualMachine, error)
	DeleteVirtualMachine(ctx context.Context, uid uuid.UUID, hostID, id string, fn func(*db.VirtualMachine) error) error
	UpsertVirtualMachine(ctx context.Context, vm *taskflow.VirtualMachine) error
	UpdateVirtualMachine(ctx context.Context, id string, fn func(*db.VirtualMachineUpdateOne) error) error
	UpsertHost(ctx context.Context, h *taskflow.Host) error
	DeleteHost(ctx context.Context, uid uuid.UUID, id string) error
	UpdateHost(ctx context.Context, uid uuid.UUID, req *UpdateHostReq) error
	UpdateVM(ctx context.Context, req UpdateVMReq, fn func(*db.VirtualMachine) error) (*db.VirtualMachine, int64, error)
	GetGitCredentialByTask(ctx context.Context, taskID string) (*GitCredentialInfo, error)
}

type HostUsecase interface {
	GetInstallCommand(ctx context.Context, user *User) (string, error)
	InstallScript(ctx context.Context, token *InstallReq) (string, error)
	List(ctx context.Context, uid uuid.UUID) (*HostListResp, error)
	VMInfo(ctx context.Context, uid uuid.UUID, id string) (*VirtualMachine, error)
	ConnectVMTerminal(ctx context.Context, uid uuid.UUID, req TerminalReq) (taskflow.Sheller, error)
	TerminalList(ctx context.Context, id string) ([]*Terminal, error)
	CloseTerminal(ctx context.Context, id, terminalID string) error
	ShareTerminal(ctx context.Context, user *User, req *ShareTerminalReq) (*ShareTerminalResp, error)
	JoinTerminal(ctx context.Context, req *JoinTerminalReq) (taskflow.Sheller, *SharedTerminal, error)
	WithVMPermission(ctx context.Context, uid uuid.UUID, id string, fn func(*VirtualMachine) error) error
	CreateVM(ctx context.Context, user *User, req *CreateVMReq) (*VirtualMachine, error)
	DeleteVM(ctx context.Context, uid uuid.UUID, hostID, vmID string) error
	DeleteHost(ctx context.Context, uid uuid.UUID, id string) error
	UpdateHost(ctx context.Context, uid uuid.UUID, req *UpdateHostReq) error
	RefreshIdleTimers(ctx context.Context, vmID string) error
	FireExpiredVM(ctx context.Context, fire bool) ([]FireExpiredVMItem, error)
	UpdateVM(ctx context.Context, req UpdateVMReq) (*VirtualMachine, error)
	ApplyPort(ctx context.Context, uid uuid.UUID, req *ApplyPortReq) (*VMPort, error)
	RecyclePort(ctx context.Context, uid uuid.UUID, req *RecyclePortReq) error
	ListPorts(ctx context.Context, uid uuid.UUID, vid string) ([]*VMPort, error)
}

type IDReq[T any] struct {
	ID T `json:"id" query:"id" param:"id" validate:"required"`
}

type Image struct {
	ID        uuid.UUID `json:"id"`
	Name      string    `json:"name"`
	Remark    string    `json:"remark"`
	IsDefault bool      `json:"is_default"`
	CreatedAt int64     `json:"created_at"`
	Owner     *Owner    `json:"owner"`
}

type ImageRepo interface {
	List(ctx context.Context, uid uuid.UUID, cursor CursorReq) ([]*db.Image, *db.Cursor, error)
	Create(ctx context.Context, uid uuid.UUID, req *CreateImageReq) (*db.Image, error)
	Delete(ctx context.Context, uid, id uuid.UUID) error
	Update(ctx context.Context, uid, id uuid.UUID, req *UpdateImageReq) (*db.Image, error)
	GetByID(ctx context.Context, id uuid.UUID, uid uuid.UUID) (*db.Image, error)
}

type ImageUsecase interface {
	List(ctx context.Context, uid uuid.UUID, cursor CursorReq) (*ListImageResp, error)
	Create(ctx context.Context, uid uuid.UUID, req *CreateImageReq) (*Image, error)
	Delete(ctx context.Context, uid uuid.UUID, id uuid.UUID) error
	Update(ctx context.Context, uid uuid.UUID, id uuid.UUID, req *UpdateImageReq) (*Image, error)
}

type InstallCommand struct {
	Command string `json:"command"`
}

type InstallReq struct {
	Token string `json:"token" query:"token"`
}

type InternalHook interface {
	// OnAgentAuth agent 认证成功后获取关联的 TaskID
	OnAgentAuth(ctx context.Context, vmID string) uuid.UUID
	// OnVmReady VM 就绪回调（如任务状态转换）
	OnVmReady(ctx context.Context, vmID string) error
	// OnVmConditionFailed VM 条件失败回调（如任务状态转换）
	OnVmConditionFailed(ctx context.Context, vmID string) error
}

type InviteLinkReq struct {
	GroupID  uuid.UUID  `param:"group_id" validate:"required" json:"-" swaggerignore:"true"` // 团队组ID
	ExpireAt *time.Time `json:"expire_at" validate:"omitempty"`                              // 邀请链接过期时间
}

type InviteLinkToken struct {
	TeamID  uuid.UUID `json:"team_id"`
	GroupID uuid.UUID `json:"group_id"`
}

type JoinGroupReq struct {
	InviteCode string `query:"invite_code" validate:"required"` // 邀请码
}

type JoinGroupResp struct {
	Message string `json:"message"`
	Success bool   `json:"success"`
}

type JoinTerminalReq struct {
	TerminalID string `json:"terminal_id" query:"terminal_id"`
	Password   string `json:"password" query:"password"`
	Col        int    `json:"col" query:"col"`
	Row        int    `json:"row" query:"row"`
}

type ListAuditsRequest struct {
	UserID         uuid.UUID `query:"user_id" json:"user_id,omitempty"`
	Operation      string    `query:"operation" json:"operation,omitempty"`
	SourceIP       string    `query:"source_ip" json:"source_ip,omitempty"`
	UserAgent      string    `query:"user_agent" json:"user_agent,omitempty"`
	Request        string    `query:"request" json:"request,omitempty"`
	Response       string    `query:"response" json:"response,omitempty"`
	CreatedAtStart time.Time `query:"created_at_start" json:"created_at_start"`
	CreatedAtEnd   time.Time `query:"created_at_end" json:"created_at_end"`
	CursorReq
}

type ListAuditsResponse struct {
	Audits []*Audit   `json:"audits"`
	Page   *db.Cursor `json:"page"`
}

type ListBranchesReq struct {
	IdentityID          uuid.UUID `param:"identity_id" validate:"required" json:"-" swaggerignore:"true"`
	EscapedRepoFullName string    `param:"escaped_repo_full_name" validate:"required" json:"-" swaggerignore:"true"`
	Page                int       `query:"page" json:"-"`
	PerPage             int       `query:"per_page" json:"-"`
}

type ListCollaboratorsReq struct {
	ID uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
}

type ListCollaboratorsResp struct {
	Collaborators []*Collaborator `json:"collaborators"`
}

type ListGitBotResp struct {
	Bots []*GitBot `json:"bots"`
}

type ListGitBotTaskReq struct {
	ID   uuid.UUID `json:"id" query:"id" validate:"omitempty"`
	Page int       `json:"page" query:"page"`
	Size int       `json:"size" query:"size"`
}

type ListGitBotTaskResp struct {
	Tasks []*GitBotTask `json:"tasks"`
	Page  int64         `json:"page"`
	Size  int64         `json:"size"`
	Total int64         `json:"total"`
}

type ListImageResp struct {
	Images []*Image   `json:"images"`
	Page   *db.Cursor `json:"page"`
}

type ListIssueCommentsReq struct {
	ID      uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	IssueID uuid.UUID `param:"issue_id" validate:"required" json:"-" swaggerignore:"true"`
	CursorReq
}

type ListIssueCommentsResp struct {
	Comments []*ProjectIssueComment `json:"comments"`
	Page     *db.Cursor             `json:"page"`
}

type ListIssuesReq struct {
	ID uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	CursorReq
}

type ListIssuesResp struct {
	Issues []*ProjectIssue `json:"issues"`
	Page   *db.Cursor      `json:"page"`
}

type ListModelResp struct {
	Models []*Model   `json:"models"`
	Page   *db.Cursor `json:"page"`
}

type ListPortsReq struct {
	ID     string `json:"id" param:"id" validate:"required" swaggerignore:"true"`
	HostID string `json:"host_id" param:"host_id" validate:"required" swaggerignore:"true"`
}

type ListProjectResp struct {
	Projects []*Project `json:"projects"`
	Page     *db.Cursor `json:"page"`
}

type ListTaskResp struct {
	Tasks    []*ProjectTask `json:"tasks"`
	PageInfo *db.PageInfo   `json:"page_info,omitempty"`
}

type ListTeamGroupUsersReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
}

type ListTeamGroupUsersResp struct {
	Users []*User `json:"users"`
}

type ListTeamGroupsReq struct{}

type ListTeamGroupsResp struct {
	Groups []*TeamGroup `json:"groups"`
}

type ListTeamHostsResp struct {
	Hosts []*Host `json:"hosts"`
}

type ListTeamImagesResp struct {
	Images []*TeamImage `json:"images"`
}

type ListTeamModelsResp struct {
	Models []*TeamModel `json:"models"`
}

type LogsOptions struct {
	Token     string
	Owner     string
	Repo      string
	Ref       string
	Path      string
	Limit     int
	Offset    int
	InstallID int64
	IsOAuth   bool
}

type MemberListReq struct {
	Role consts.TeamMemberRole `query:"role" validate:"omitempty"`
}

type MemberListResp struct {
	Members     []*TeamMemberInfo `json:"members"`
	MemberLimit int               `json:"member_limit"`
}

type Model struct {
	ID               uuid.UUID            `json:"id"`
	Provider         string               `json:"provider"`
	APIKey           string               `json:"api_key,omitempty"`
	BaseURL          string               `json:"base_url"`
	Model            string               `json:"model"`
	Temperature      float64              `json:"temperature"`
	IsDefault        bool                 `json:"is_default"`
	CreatedAt        int64                `json:"created_at"`
	UpdatedAt        int64                `json:"updated_at"`
	Owner            *Owner               `json:"owner,omitempty"`
	InterfaceType    consts.InterfaceType `json:"interface_type"`
	IsFree           bool                 `json:"is_free"`
	AccessLevel      string               `json:"access_level"` // 访问级别 basic | pro
	LastCheckAt      int64                `json:"last_check_at"`
	LastCheckSuccess bool                 `json:"last_check_success"`
	LastCheckError   string               `json:"last_check_error"`
}

type ModelConfig struct {
	URL  string `json:"url"`
	Key  string `json:"key"`
	Name string `json:"name"`
}

type ModelHook interface {
	ListPublic(ctx context.Context, uid uuid.UUID) ([]*Model, error)
	ValidateAccess(ctx context.Context, uid uuid.UUID, modelID string) error
}

type ModelRepo interface {
	Get(ctx context.Context, uid, id uuid.UUID) (*db.Model, error)
	List(ctx context.Context, uid uuid.UUID, cursor CursorReq) ([]*db.Model, *db.Cursor, error)
	Create(ctx context.Context, uid uuid.UUID, req *CreateModelReq) (*db.Model, error)
	Delete(ctx context.Context, uid, id uuid.UUID) error
	Update(ctx context.Context, uid, id uuid.UUID, req *UpdateModelReq) error
	UpdateCheckResult(ctx context.Context, id uuid.UUID, success bool, errMsg string) error
}

type ModelUsecase interface {
	List(ctx context.Context, uid uuid.UUID, cursor CursorReq) (*ListModelResp, error)
	Create(ctx context.Context, uid uuid.UUID, req *CreateModelReq) (*Model, error)
	Delete(ctx context.Context, uid uuid.UUID, id uuid.UUID) error
	Update(ctx context.Context, uid, id uuid.UUID, req *UpdateModelReq) error
	Check(ctx context.Context, uid, id uuid.UUID) (*CheckModelResp, error)
	CheckByConfig(ctx context.Context, req *CheckByConfigReq) (*CheckModelResp, error)
	GetProviderModelList(ctx context.Context, req *GetProviderModelListReq) (*GetProviderModelListResp, error)
}

type NotifyChannel struct {
	ID         uuid.UUID                `json:"id"`
	OwnerID    uuid.UUID                `json:"owner_id"`
	OwnerType  consts.NotifyOwnerType   `json:"owner_type"`
	Name       string                   `json:"name"`
	Kind       consts.NotifyChannelKind `json:"kind"`
	WebhookURL string                   `json:"webhook_url"`
	Enabled    bool                     `json:"enabled"`
	Scope      string                   `json:"scope"`
	EventTypes []consts.NotifyEventType `json:"event_types"`
	CreatedAt  int64                    `json:"created_at"`
}

type NotifyChannelRepo interface {
	Create(ctx context.Context, ownerID uuid.UUID, ownerType consts.NotifyOwnerType, req *CreateNotifyChannelReq) (*db.NotifyChannel, error)
	Update(ctx context.Context, id uuid.UUID, req *UpdateNotifyChannelReq) (*db.NotifyChannel, error)
	Delete(ctx context.Context, id uuid.UUID) error
	Get(ctx context.Context, id uuid.UUID) (*db.NotifyChannel, error)
	ListByOwner(ctx context.Context, ownerID uuid.UUID, ownerType consts.NotifyOwnerType) ([]*db.NotifyChannel, error)
	FindMatchingChannels(ctx context.Context, subjectUserID uuid.UUID, teamIDs []uuid.UUID, eventType consts.NotifyEventType) ([]*db.NotifyChannel, error)
}

type NotifyChannelUsecase interface {
	Create(ctx context.Context, ownerID uuid.UUID, ownerType consts.NotifyOwnerType, req *CreateNotifyChannelReq) (*NotifyChannel, error)
	Update(ctx context.Context, ownerID uuid.UUID, id uuid.UUID, req *UpdateNotifyChannelReq) (*NotifyChannel, error)
	Delete(ctx context.Context, ownerID uuid.UUID, id uuid.UUID) error
	List(ctx context.Context, ownerID uuid.UUID, ownerType consts.NotifyOwnerType) ([]*NotifyChannel, error)
	Test(ctx context.Context, ownerID uuid.UUID, id uuid.UUID) error
}

type NotifyEvent struct {
	EventType     consts.NotifyEventType `json:"event_type"`
	SubjectUserID uuid.UUID              `json:"subject_user_id"`
	RefID         string                 `json:"ref_id"`
	OccurredAt    time.Time              `json:"occurred_at"`
	Payload       NotifyEventPayload     `json:"payload"`
}

type NotifyEventPayload struct {
	TaskID      string     `json:"task_id,omitempty"`
	TaskContent string     `json:"task_content,omitempty"`
	TaskStatus  string     `json:"task_status,omitempty"`
	RepoURL     string     `json:"repo_url,omitempty"`
	ModelName   string     `json:"model_name,omitempty"`
	UserName    string     `json:"user_name,omitempty"`
	TaskURL     string     `json:"task_url,omitempty"`
	VMID        string     `json:"vm_id,omitempty"`
	VMStatus    string     `json:"vm_status,omitempty"`
	HostID      string     `json:"host_id,omitempty"`
	ExpiresAt   *time.Time `json:"expires_at,omitempty"`
	VMName      string     `json:"vm_name,omitempty"`
	VMArch      string     `json:"vm_arch,omitempty"`
	VMCores     int        `json:"vm_cores,omitempty"`
	VMMemory    int64      `json:"vm_memory,omitempty"`
	VMOS        string     `json:"vm_os,omitempty"`
}

type NotifySendLogRepo interface {
	Create(ctx context.Context, log *CreateNotifySendLogReq) error
	Exists(ctx context.Context, subscriptionID uuid.UUID, eventType consts.NotifyEventType, eventRefID string) (bool, error)
}

type NotifySubscriptionRepo interface {
	Upsert(ctx context.Context, channelID uuid.UUID, scope string, eventTypes []consts.NotifyEventType) (*db.NotifySubscription, error)
	Delete(ctx context.Context, id uuid.UUID) error
	ListByChannel(ctx context.Context, channelID uuid.UUID) ([]*db.NotifySubscription, error)
}

type OAuthSiteConfig struct {
	ClientID     string
	ClientSecret string
	RedirectURL  string
	Scope        string
	BaseURL      string
}

type OpenAIData struct {
	ID string `json:"id"`
}

type OpenAIError struct {
	Message string `json:"message"`
	Type    string `json:"type"`
}

type OpenAIResp struct {
	Object string        `json:"object"`
	Data   []*OpenAIData `json:"data"`
	Error  *OpenAIError  `json:"error,omitempty"`
}

type Owner struct {
	ID   string           `json:"id"`
	Type consts.OwnerType `json:"type"`
	Name string           `json:"name"`
}

type PlatformUserInfo struct {
	Name string
}

type PrivilegeChecker interface {
	IsPrivileged(ctx context.Context, uid uuid.UUID) (bool, error)
}

type Project struct {
	ID                uuid.UUID          `json:"id"`
	Name              string             `json:"name"`
	RepoURL           string             `json:"repo_url"`
	FullName          string             `json:"full_name"`
	Description       string             `json:"description"`
	Platform          consts.GitPlatform `json:"platform"`
	CreatedAt         int64              `json:"created_at"`
	UpdatedAt         int64              `json:"updated_at"`
	User              *User              `json:"user"`
	Issues            []*ProjectIssue    `json:"issues"`
	Collaborators     []*Collaborator    `json:"collaborators"`
	ImageID           uuid.UUID          `json:"image_id"`
	GitIdentityID     uuid.UUID          `json:"git_identity_id"`
	EnvVariables      map[string]any     `json:"env_variables"`
	Tasks             []*ProjectTask     `json:"tasks"`
	AutoReviewEnabled bool               `json:"auto_review_enabled"` // 是否开启自动审查
}

type ProjectBlob struct {
	Content  []byte `json:"content"`
	IsBinary bool   `json:"is_binary"`
	Sha      string `json:"sha"`
	Size     int    `json:"size"`
}

type ProjectCommit struct {
	Author     *ProjectCommitUser `json:"author"`
	Committer  *ProjectCommitUser `json:"committer"`
	Message    string             `json:"message"`
	ParentShas []string           `json:"parent_shas"`
	Sha        string             `json:"sha"`
	TreeSha    string             `json:"tree_sha"`
}

type ProjectCommitEntry struct {
	Commit *ProjectCommit `json:"commit"`
}

type ProjectCommitUser struct {
	Email string `json:"email"`
	Name  string `json:"name"`
	When  int64  `json:"when"`
}

type ProjectHook interface {
	// GenerateIssueSummary 生成问题摘要
	GenerateIssueSummary(ctx context.Context, issueID uuid.UUID) error
	// GetInternalRepoToken 获取内部仓库 token
	GetInternalRepoToken(ctx context.Context, userID uuid.UUID, projectID uuid.UUID) (string, error)
}

type ProjectIssue struct {
	ID                  uuid.UUID                   `json:"id"`
	Title               string                      `json:"title"`
	RequirementDocument string                      `json:"requirement_document"`
	DesignDocument      string                      `json:"design_document"`
	Summary             string                      `json:"summary"`
	Status              consts.ProjectIssueStatus   `json:"status"`
	Priority            consts.ProjectIssuePriority `json:"priority"`
	CreatedAt           int64                       `json:"created_at"`
	User                *User                       `json:"user"`
	Assignee            *User                       `json:"assignee"`
}

type ProjectIssueComment struct {
	ID        uuid.UUID              `json:"id"`
	Comment   string                 `json:"comment"`
	Parent    *ProjectIssueComment   `json:"parent"`
	Replies   []*ProjectIssueComment `json:"replies"`
	Creator   *User                  `json:"creator"`
	CreatedAt int64                  `json:"created_at"`
}

type ProjectLogs struct {
	Count   int                   `json:"count"`
	Entries []*ProjectCommitEntry `json:"entries"`
}

type ProjectRepo interface {
	Get(ctx context.Context, uid, id uuid.UUID) (*db.Project, error)
	GetByID(ctx context.Context, id uuid.UUID) (*db.Project, error)
	List(ctx context.Context, uid uuid.UUID, cursor CursorReq) ([]*db.Project, *db.Cursor, error)
	Create(ctx context.Context, uid uuid.UUID, req *CreateProjectReq) (*db.Project, error)
	Update(ctx context.Context, user *User, req *UpdateProjectReq) (*db.Project, error)
	Delete(ctx context.Context, uid, id uuid.UUID) error
	ListIssues(ctx context.Context, uid uuid.UUID, req *ListIssuesReq) ([]*db.ProjectIssue, *db.Cursor, error)
	CreateIssue(ctx context.Context, uid uuid.UUID, req *CreateIssueReq) (*db.ProjectIssue, error)
	UpdateIssue(ctx context.Context, uid uuid.UUID, req *UpdateIssueReq) (*db.ProjectIssue, error)
	UpdateIssueDoc(ctx context.Context, req *UpdateIssueDocReq) (*db.ProjectIssue, error)
	GetIssue(ctx context.Context, uid uuid.UUID, projectID, issueID uuid.UUID) (*db.ProjectIssue, error)
	UpdateIssueSummary(ctx context.Context, issueID uuid.UUID, summary string) error
	ListCollaborators(ctx context.Context, uid uuid.UUID, req *ListCollaboratorsReq) ([]*db.ProjectCollaborator, error)
	ListIssueComments(ctx context.Context, uid uuid.UUID, req *ListIssueCommentsReq) ([]*db.ProjectIssueComment, *db.Cursor, error)
	CreateIssueComment(ctx context.Context, uid uuid.UUID, req *CreateIssueCommentReq) (*db.ProjectIssueComment, error)
	HasReadWritePerm(ctx context.Context, uid uuid.UUID, projectID uuid.UUID) bool
	GetProjectIDByTask(ctx context.Context, taskID string) (*db.Project, error)
	GetIssueByTaskID(ctx context.Context, taskID string) (*db.ProjectIssue, error)
	GetUserProjectPerm(ctx context.Context, uid uuid.UUID, projectID uuid.UUID) (consts.ProjectCollaboratorRole, error)
}

type ProjectTask struct {
	ID           uuid.UUID        `json:"id" validate:"required"`
	Model        *Model           `json:"model,omitempty"`
	Image        *Image           `json:"image,omitempty"`
	Branch       string           `json:"branch,omitempty"`
	CliName      consts.CliName   `json:"cli_name,omitempty"`
	RepoURL      string           `json:"repo_url,omitempty"`
	FullName     string           `json:"full_name,omitempty"`
	RepoFilename string           `json:"repo_filename,omitempty"`
	Extra        *TaskExtraConfig `json:"extra,omitempty"`
	*Task
}

type ProjectTree []*ProjectTreeEntry

type ProjectTreeEntry struct {
	Mode           int    `json:"mode"`
	Name           string `json:"name"`
	Path           string `json:"path"`
	Sha            string `json:"sha"`
	Size           int    `json:"size"`
	LastModifiedAt int64  `json:"last_modified_at"`
}

type ProjectUsecase interface {
	Get(ctx context.Context, uid, id uuid.UUID) (*Project, error)
	List(ctx context.Context, uid uuid.UUID, cursor CursorReq) (*ListProjectResp, error)
	Create(ctx context.Context, uid uuid.UUID, req *CreateProjectReq) (*Project, error)
	Update(ctx context.Context, user *User, req *UpdateProjectReq) (*Project, error)
	Delete(ctx context.Context, uid, id uuid.UUID) error
	ListIssues(ctx context.Context, uid uuid.UUID, req *ListIssuesReq) (*ListIssuesResp, error)
	CreateIssue(ctx context.Context, uid uuid.UUID, req *CreateIssueReq) (*ProjectIssue, error)
	UpdateIssue(ctx context.Context, uid uuid.UUID, req *UpdateIssueReq) (*ProjectIssue, error)
	UpdateIssueDoc(ctx context.Context, req *UpdateIssueDocReq) (*ProjectIssue, error)
	ListCollaborators(ctx context.Context, uid uuid.UUID, req *ListCollaboratorsReq) (*ListCollaboratorsResp, error)
	ListIssueComments(ctx context.Context, uid uuid.UUID, req *ListIssueCommentsReq) (*ListIssueCommentsResp, error)
	CreateIssueComment(ctx context.Context, uid uuid.UUID, req *CreateIssueCommentReq) (*ProjectIssueComment, error)
	GetProjectIDByTask(ctx context.Context, taskID string) (*Project, error)
	GetIssueByTaskID(ctx context.Context, taskID string) (*ProjectIssue, error)
	GetProjectTree(ctx context.Context, uid uuid.UUID, req *GetProjectTreeReq) (ProjectTree, error)
	GetProjectBlob(ctx context.Context, uid uuid.UUID, req *GetProjectBlobReq) (*ProjectBlob, error)
	GetProjectLogs(ctx context.Context, uid uuid.UUID, req *GetProjectLogsReq) (*ProjectLogs, error)
	GetProjectArchive(ctx context.Context, uid uuid.UUID, req *GetProjectArchiveReq) (*GetProjectArchiveResp, error)
	GetRepoToken(ctx context.Context, userID, projectID, gitIdentityID uuid.UUID, platform consts.GitPlatform) (string, error)
}

type ProviderModelListItem struct {
	Model string `json:"model"`
}

type PublicHostRepo interface {
	All(ctx context.Context) ([]*db.Host, error)
}

type PublicHostUsecase interface {
	PickHost(ctx context.Context) (*Host, error)
}

type PullRequest struct {
	Title string `json:"title"`
	URL   string `json:"url"`
}

type RecyclePortReq struct {
	ID        string `json:"id" param:"id" validate:"required" swaggerignore:"true"`
	HostID    string `json:"host_id" param:"host_id" validate:"required" swaggerignore:"true"`
	ForwardID string `json:"forward_id" validate:"required"`
}

type RedeemCaptchaReq struct {
	Token     string  `json:"token"`
	Solutions []int64 `json:"solutions"`
}

type Repo struct {
	ID        string  `json:"id"`
	Name      string  `json:"name"`
	FullName  string  `json:"fullname"`
	URL       string  `json:"url"`
	Desc      string  `json:"desc"`
	Branch    *string `json:"branch"`
	IsPrivate bool    `json:"is_private"`
}

type RepositoryOptions struct {
	Token     string
	InstallID int64 // GitHub App 模式，其他平台忽略
	IsOAuth   bool  // GitLab/Gitea OAuth 模式，其他平台忽略
}

type ResetPasswordReq struct {
	UserIDs []uuid.UUID `json:"user_ids" validate:"required"` // 用户ID列表
}

type ResetUserPasswordEmailReq struct {
	Emails       []string `json:"emails" validate:"required"`
	CaptchaToken string   `json:"captcha_token"`
}

type ResetUserPasswordReq struct {
	NewPassword string `json:"new_password" validate:"required,min=8,max=32"`
	Token       string `json:"token" validate:"required"`
}

type Resource struct {
	CPU    int   `json:"cpu"`
	Memory int64 `json:"memory"`
}

type SendBindEmailVerificationReq struct {
	Email string `json:"email" validate:"required,email"` // 要绑定的邮箱地址
}

type ShareGitBotReq struct {
	ID      uuid.UUID   `json:"id"`
	UserIDs []uuid.UUID `json:"user_ids"`
}

type ShareTerminalReq struct {
	ID         string              `json:"id" query:"id" param:"id" validate:"required"`
	Mode       consts.TerminalMode `json:"mode" query:"mode"`
	TerminalID string              `json:"terminal_id" query:"terminal_id"`
}

type ShareTerminalResp struct {
	Password string `json:"password"`
}

type SharedTerminal struct {
	ID         string              `json:"id" query:"id" param:"id" validate:"required"`
	Mode       consts.TerminalMode `json:"mode" query:"mode"`
	TerminalID string              `json:"terminal_id" query:"terminal_id"`
	User       *User               `json:"user"`
}

type SiteResolver interface {
	// ResolveByHost 通过域名解析站点配置
	ResolveByHost(ctx context.Context, host string) (*OAuthSiteConfig, error)
	// ResolveBySiteID 通过站点 ID 解析站点配置
	ResolveBySiteID(ctx context.Context, siteID uuid.UUID) (*OAuthSiteConfig, error)
}

type SpeechRecognitionData struct {
	Type      string `json:"type" example:"result"`                       // 数据类型: result, end, error
	Text      string `json:"text,omitempty" example:"你好"`                 // 识别文本 (仅result类型)
	IsFinal   bool   `json:"is_final,omitempty" example:"false"`          // 是否为最终结果 (仅result类型)
	UserID    string `json:"user_id,omitempty" example:"uuid"`            // 用户ID (仅result类型)
	Timestamp int64  `json:"timestamp,omitempty" example:"1640995200000"` // 时间戳 (仅result类型)
	Error     string `json:"error,omitempty" example:"识别失败"`              // 错误信息 (仅error类型)
}

type SpeechRecognitionEvent struct {
	Event string                `json:"event"` // 事件类型: recognition, end, error
	Data  SpeechRecognitionData `json:"data"`  // 事件数据
}

type Subject struct {
	ID     string `json:"id"`
	Type   string `json:"type"`
	Title  string `json:"title"`
	URL    string `json:"url"`
	Number int    `json:"number"`
}

type Task struct {
	ID             uuid.UUID          `json:"id"`
	UserID         uuid.UUID          `json:"user_id"`
	Type           consts.TaskType    `json:"type"`
	SubType        consts.TaskSubType `json:"sub_type"`
	Content        string             `json:"content"`
	Summary        string             `json:"summary"`
	Status         consts.TaskStatus  `json:"status"`
	VirtualMachine *VirtualMachine    `json:"virtualmachine"`
	CreatedAt      int64              `json:"created_at"`
	CompletedAt    int64              `json:"completed_at"`
	Model          *Model             `json:"model,omitempty"`
	Image          *Image             `json:"image,omitempty"`
	Branch         string             `json:"branch,omitempty"`
	CliName        consts.CliName     `json:"cli_name,omitempty"`
	RepoURL        string             `json:"repo_url,omitempty"`
	FullName       string             `json:"full_name,omitempty"`
	RepoFilename   string             `json:"repo_filename,omitempty"`
	Extra          *TaskExtraConfig   `json:"extra,omitempty"`
	Stats          *TaskStats         `json:"stats,omitempty"`
}

type TaskChunkEntry struct {
	Data      []byte            `json:"data,omitempty"`
	Event     string            `json:"event"`
	Kind      string            `json:"kind"`
	Timestamp int64             `json:"timestamp"`
	Labels    map[string]string `json:"labels,omitempty"`
}

type TaskControlReq struct {
	ID uuid.UUID `json:"id" query:"id" validate:"required"` // 任务 id
}

type TaskExtraConfig struct {
	ProjectID uuid.UUID `json:"project_id" validate:"omitempty"`
	IssueID   uuid.UUID `json:"issue_id" validate:"omitempty"`
	SkillIDs  []string  `json:"skill_ids" validate:"omitempty"`
}

type TaskHook interface {
	// GetSystemPrompt 获取任务系统提示词
	GetSystemPrompt(ctx context.Context, taskType consts.TaskType, subType consts.TaskSubType) (string, error)
	// OnTaskCreated 任务创建后回调
	OnTaskCreated(ctx context.Context, task *ProjectTask) error
	// GitTask 获取 git 任务详情
	GitTask(ctx context.Context, id uuid.UUID) (*GitTask, error)
	// GetMaxConcurrent 获取最大运行任务
	GetMaxConcurrent(ctx context.Context, uid uuid.UUID) (int, error)
}

type TaskListReq struct {
	ProjectID  uuid.UUID `json:"project_id" query:"project_id" validate:"omitempty"`
	QuickStart bool      `json:"quick_start" query:"quick_start" validate:"omitempty"`
	Status     *string   `json:"status" query:"status"` // 状态筛选，多值用逗号分开 pending,processing,error,finished
	*web.Pagination
}

type TaskRepo interface {
	GetByID(ctx context.Context, id uuid.UUID) (*db.Task, error)
	Stat(ctx context.Context, id uuid.UUID) (*TaskStats, error)
	StatByIDs(ctx context.Context, ids []uuid.UUID) (map[uuid.UUID]*TaskStats, error)
	Info(ctx context.Context, user *User, id uuid.UUID, isPrivileged bool) (*db.Task, error)
	List(ctx context.Context, user *User, req TaskListReq) ([]*db.ProjectTask, *db.PageInfo, error)
	Create(ctx context.Context, user *User, req CreateTaskReq, token string, fn func(*db.ProjectTask, *db.Model, *db.Image) (*taskflow.VirtualMachine, error)) (*db.ProjectTask, error)
	Update(ctx context.Context, user *User, id uuid.UUID, fn func(up *db.TaskUpdateOne) error) error
	Stop(ctx context.Context, user *User, id uuid.UUID, fn func(*db.Task) error) error
	Delete(ctx context.Context, user *User, id uuid.UUID) error
}

type TaskRepoReq struct {
	RepoURL      string `json:"repo_url"`
	Branch       string `json:"branch"`
	RepoFilename string `json:"repo_filename"`
	ZipURL       string `json:"zip_url"`
}

type TaskRoundsReq struct {
	ID     uuid.UUID `json:"id" query:"id" validate:"required"` // 任务 ID
	Cursor string    `json:"cursor" query:"cursor"`             // 游标（时间戳 Unix ns，从此时间点往前查询）
	Limit  int       `json:"limit" query:"limit"`               // 返回的论次数（默认 2，上限 10）
}

type TaskRoundsResp struct {
	Chunks     []*TaskChunkEntry `json:"chunks"`
	NextCursor string            `json:"next_cursor,omitempty"` // 下一页游标（最早条目的时间戳 ns）
	HasMore    bool              `json:"has_more"`
}

type TaskSession struct {
	Task     *taskflow.CreateTaskReq `json:"task"`
	User     *User                   `json:"user"`
	Platform consts.GitPlatform      `json:"platform"`
	ShowUrl  string                  `json:"show_url"`
}

type TaskStats struct {
	InputTokens  int64 `json:"input_tokens"`
	OutputTokens int64 `json:"output_tokens"`
	TotalTokens  int64 `json:"total_tokens"`
	LLMRequests  int64 `json:"llm_requests"`
}

type TaskStream struct {
	Type      consts.TaskStreamType `json:"type"`
	Data      []byte                `json:"data"`
	Kind      string                `json:"kind"`
	Timestamp int64                 `json:"timestamp"`
}

type TaskStreamReq struct {
	ID   uuid.UUID `json:"id" query:"id" validate:"required"`
	Mode string    `json:"mode" query:"mode"` // new|attach，默认 new
}

type TaskUsecase interface {
	GetPublic(ctx context.Context, user *User, id uuid.UUID) (*Task, error)
	Info(ctx context.Context, user *User, id uuid.UUID) (*Task, bool, error)
	List(ctx context.Context, user *User, req TaskListReq) (*ListTaskResp, error)
	Continue(ctx context.Context, user *User, id uuid.UUID, content string) error
	Create(ctx context.Context, user *User, req CreateTaskReq) (*ProjectTask, error)
	Stop(ctx context.Context, user *User, id uuid.UUID) error
	Cancel(ctx context.Context, user *User, id uuid.UUID) error
	AutoApprove(ctx context.Context, user *User, id uuid.UUID, approve bool) error
	GitTask(ctx context.Context, id uuid.UUID) (*GitTask, error)
	Delete(ctx context.Context, user *User, id uuid.UUID) error
}

type Team struct {
	ID   uuid.UUID `json:"id"`
	Name string    `json:"name"`
}

type TeamGroup struct {
	ID        uuid.UUID `json:"id"`
	Name      string    `json:"name"`
	CreatedAt int64     `json:"created_at"`
	UpdatedAt int64     `json:"updated_at"`
	Users     []*User   `json:"users,omitempty"`
}

type TeamGroupHost struct {
	GroupID   uuid.UUID `json:"group_id"`
	CreatedAt int64     `json:"created_at"`
	Host      *Host     `json:"host,omitempty"`
}

type TeamGroupImage struct {
	GroupID   uuid.UUID `json:"group_id"`
	CreatedAt int64     `json:"created_at"`
	Image     *Image    `json:"image,omitempty"`
}

type TeamGroupModel struct {
	GroupID   uuid.UUID `json:"group_id"`
	CreatedAt int64     `json:"created_at"`
	Model     *Model    `json:"model,omitempty"`
}

type TeamGroupUserRepo interface {
	List(ctx context.Context, teamID uuid.UUID) ([]*db.TeamGroup, error)
	Get(ctx context.Context, groupID uuid.UUID) (*db.TeamGroup, error)
	Create(ctx context.Context, teamID uuid.UUID, req *AddTeamGroupReq) (*db.TeamGroup, error)
	CreateUsers(ctx context.Context, teamID uuid.UUID, req *AddTeamUserReq) ([]*db.User, error)
	CreateAdmin(ctx context.Context, teamID uuid.UUID, req *AddTeamAdminReq) (*db.User, error)
	Update(ctx context.Context, req *UpdateTeamGroupReq) (*db.TeamGroup, error)
	Delete(ctx context.Context, teamID, groupID uuid.UUID) error
	ListGroupUsers(ctx context.Context, groupID uuid.UUID) ([]*db.TeamGroupMember, error)
	ModifyGroupUsers(ctx context.Context, groupID uuid.UUID, userIDs []uuid.UUID) ([]*db.TeamGroupMember, error)
	DeleteGroupUser(ctx context.Context, groupID, userID uuid.UUID) error
	Login(ctx context.Context, req *TeamLoginReq) (*db.User, error)
	MemberList(ctx context.Context, teamID uuid.UUID, role consts.TeamMemberRole) ([]*db.TeamMember, error)
	ChangePassword(ctx context.Context, userID uuid.UUID, currentPassword, newPassword string) error
	GetTeam(ctx context.Context, teamID uuid.UUID) (*db.Team, error)
	UpdateUser(ctx context.Context, userID uuid.UUID, req *UpdateTeamUserReq) (*db.User, error)
	GetMembersByIDs(ctx context.Context, teamID uuid.UUID, userIDs []uuid.UUID) ([]*db.TeamMember, error)
	GetMember(ctx context.Context, teamID, userID uuid.UUID) (*db.TeamMember, error)
	InitTeam(ctx context.Context, email, name, password string) error
}

type TeamGroupUserUsecase interface {
	List(ctx context.Context, teamUser *TeamUser) (*ListTeamGroupsResp, error)
	Add(ctx context.Context, teamUser *TeamUser, req *AddTeamGroupReq) (*TeamGroup, error)
	AddUser(ctx context.Context, teamUser *TeamUser, req *AddTeamUserReq) (*AddTeamUserResp, error)
	AddAdmin(ctx context.Context, teamUser *TeamUser, req *AddTeamAdminReq) (*AddTeamAdminResp, error)
	Update(ctx context.Context, req *UpdateTeamGroupReq) (*TeamGroup, error)
	Delete(ctx context.Context, teamUser *TeamUser, req *DeleteTeamGroupReq) error
	ListGroups(ctx context.Context, req *ListTeamGroupUsersReq) (*ListTeamGroupUsersResp, error)
	ModifyGroups(ctx context.Context, req *AddTeamGroupUsersReq) (*AddTeamGroupUsersResp, error)
	DeleteGroups(ctx context.Context, req *DeleteTeamGroupUserReq) error
	Login(ctx context.Context, req *TeamLoginReq) (*User, error)
	MemberList(ctx context.Context, teamUser *TeamUser, req *MemberListReq) (*MemberListResp, error)
	ChangePassword(ctx context.Context, userID uuid.UUID, req *ChangePasswordReq) error
	UpdateUser(ctx context.Context, req *UpdateTeamUserReq) (*UpdateTeamUserResp, error)
}

type TeamHostRepo interface {
	List(ctx context.Context, teamID uuid.UUID) ([]*db.Host, error)
	Delete(ctx context.Context, teamUser *TeamUser, hostID string) error
	UpsertHost(ctx context.Context, user *User, info *taskflow.Host) error
	Update(ctx context.Context, teamUser *TeamUser, req *UpdateTeamHostReq) (*db.Host, error)
}

type TeamHostUsecase interface {
	GetInstallCommand(ctx context.Context, teamUser *TeamUser) (string, error)
	List(ctx context.Context, teamUser *TeamUser) (*ListTeamHostsResp, error)
	Delete(ctx context.Context, teamUser *TeamUser, req *DeleteTeamHostReq) error
	Update(ctx context.Context, teamUser *TeamUser, req *UpdateTeamHostReq) (*Host, error)
}

type TeamImage struct {
	ID        uuid.UUID    `json:"id"`
	Name      string       `json:"name"`
	Remark    string       `json:"remark"`
	CreatedAt int64        `json:"created_at"`
	UpdatedAt int64        `json:"updated_at"`
	Groups    []*TeamGroup `json:"groups"`
}

type TeamImageRepo interface {
	List(ctx context.Context, teamUser *TeamUser) ([]*db.Image, error)
	Get(ctx context.Context, teamID, imageID uuid.UUID) (*db.Image, error)
	Create(ctx context.Context, teamID, userID uuid.UUID, req *AddTeamImageReq) (*db.Image, error)
	Update(ctx context.Context, teamID uuid.UUID, req *UpdateTeamImageReq) (*db.Image, error)
	Delete(ctx context.Context, teamID, imageID uuid.UUID) error
}

type TeamImageUsecase interface {
	Add(ctx context.Context, teamUser *TeamUser, req *AddTeamImageReq) (*TeamImage, error)
	List(ctx context.Context, teamUser *TeamUser) (*ListTeamImagesResp, error)
	Update(ctx context.Context, teamUser *TeamUser, req *UpdateTeamImageReq) (*TeamImage, error)
	Delete(ctx context.Context, teamUser *TeamUser, req *DeleteTeamImageReq) error
}

type TeamInviteLinkResp struct {
	InviteLink string `json:"invite_link"`
}

type TeamLoginReq struct {
	Email        string `json:"email" validate:"required"`    // 用户邮箱
	Password     string `json:"password" validate:"required"` // 用户密码（MD5加密后的值）
	CaptchaToken string `json:"captcha_token"`                // 验证码Token
}

type TeamLoginResp struct {
	Success bool   `json:"success"`
	Message string `json:"message"`
	TeamUser
}

type TeamLogoutResp struct {
	Message string `json:"message"`
}

type TeamMember struct {
	TeamID   uuid.UUID             `json:"team_id"`
	UserID   uuid.UUID             `json:"user_id"`
	TeamName string                `json:"team_name"`
	TeamRole consts.TeamMemberRole `json:"team_role"`
}

type TeamMemberInfo struct {
	User         *User                 `json:"user"`
	Role         consts.TeamMemberRole `json:"role"`
	CreatedAt    int64                 `json:"created_at"`
	LastActiveAt int64                 `json:"last_active_at"`
}

type TeamMembersResp []*User

type TeamModel struct {
	ID               uuid.UUID            `json:"id"`
	Provider         string               `json:"provider"`
	APIKey           string               `json:"api_key"`
	BaseURL          string               `json:"base_url"`
	Model            string               `json:"model"`
	Temperature      float64              `json:"temperature"`
	InterfaceType    consts.InterfaceType `json:"interface_type"`
	CreatedAt        int64                `json:"created_at"`
	UpdatedAt        int64                `json:"updated_at"`
	Groups           []*TeamGroup         `json:"groups"`
	LastCheckAt      int64                `json:"last_check_at"`
	LastCheckSuccess bool                 `json:"last_check_success"`
	LastCheckError   string               `json:"last_check_error"`
}

type TeamModelRepo interface {
	List(ctx context.Context, teamID uuid.UUID) ([]*db.Model, error)
	Get(ctx context.Context, teamID, modelID uuid.UUID) (*db.Model, error)
	Create(ctx context.Context, teamID, userID uuid.UUID, req *AddTeamModelReq) (*db.Model, error)
	Update(ctx context.Context, teamID uuid.UUID, req *UpdateTeamModelReq) (*db.Model, error)
	Delete(ctx context.Context, teamID, modelID uuid.UUID) error
	UpdateCheckResult(ctx context.Context, id uuid.UUID, success bool, errMsg string) error
}

type TeamModelUsecase interface {
	Add(ctx context.Context, teamUser *TeamUser, req *AddTeamModelReq) (*TeamModel, error)
	List(ctx context.Context, teamUser *TeamUser) (*ListTeamModelsResp, error)
	Update(ctx context.Context, teamUser *TeamUser, req *UpdateTeamModelReq) (*TeamModel, error)
	Delete(ctx context.Context, teamUser *TeamUser, req *DeleteTeamModelReq) error
	Check(ctx context.Context, teamUser *TeamUser, id uuid.UUID) (*CheckModelResp, error)
	CheckByConfig(ctx context.Context, req *CheckByConfigReq) (*CheckModelResp, error)
}

type TeamUser struct {
	User *User `json:"user"`
	Team *Team `json:"team"`
}

type TeamUserInfo struct {
	User  *User         `json:"user"`
	Teams []*TeamMember `json:"teams"`
}

type TeamUserLoginResp struct {
	TeamUserInfo
}

type TeamUserStatusResp struct {
	TeamUser
	Login bool `json:"login"`
}

type Terminal struct {
	ID             string `json:"id"`
	Title          string `json:"title"`
	ConnectedCount uint32 `json:"connected_count"`
	CreatedAt      int64  `json:"created_at"`
}

type TerminalReq struct {
	ID            string `json:"id" query:"id" param:"id" validate:"required"`
	TerminalID    string `json:"terminal_id" query:"terminal_id"`
	Exec          string `json:"exec" query:"exec"`
	Col           int    `json:"col" query:"col"`
	Row           int    `json:"row" query:"row"`
	EnvironmentID string `json:"-"`
	HostID        string `json:"-"`
	VmID          string `json:"-"`
}

type TerminalSession struct {
	ID        string              `json:"id"`
	Type      consts.TerminalType `json:"type"`
	CreatedAt int64               `json:"created_at"`
	UpdatedAt int64               `json:"updated_at"`
	IsActive  bool                `json:"is_active"`
}

type TreeEntry struct {
	Mode           int
	Name           string
	Path           string
	Sha            string
	Size           int
	LastModifiedAt int64 // GitHub 特有，其他平台为 0
}

type TreeEntryAdapter struct {
	Mode           int
	Name           string
	Path           string
	Sha            string
	Size           int
	LastModifiedAt int64
}

type TreeOptions struct {
	Token     string
	Owner     string
	Repo      string
	Ref       string
	Path      string
	Recursive bool
	InstallID int64 // GitHub App 模式，其他平台忽略
	IsOAuth   bool  // GitLab/Gitea OAuth 模式，其他平台忽略
}

type UpdateGitBotReq struct {
	ID       uuid.UUID           `json:"id" validate:"required"`
	Platform *consts.GitPlatform `json:"platform"`
	HostID   *string             `json:"host_id"`
	Name     *string             `json:"name"`
	Token    *string             `json:"token"`
}

type UpdateGitIdentityReq struct {
	ID                uuid.UUID           `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Platform          *consts.GitPlatform `json:"platform,omitempty"`
	BaseURL           *string             `json:"base_url,omitempty"`
	AccessToken       *string             `json:"access_token,omitempty"`
	Username          *string             `json:"username,omitempty"`
	Email             *string             `json:"email,omitempty"`
	Remark            *string             `json:"remark,omitempty"`
	OAuthRefreshToken *string             `json:"-"` // 内部使用，OAuth 刷新 token
	OAuthExpiresAt    *time.Time          `json:"-"` // 内部使用，OAuth 过期时间
}

type UpdateHostReq struct {
	ID        string `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	IsDefault bool   `json:"is_default,omitempty"`
	Remark    string `json:"remark,omitempty"`
	Weight    *int   `json:"weight,omitempty" validate:"omitempty,min=1"`
}

type UpdateImageReq struct {
	ID        uuid.UUID `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	ImageName *string   `json:"image_name,omitempty"`
	Remark    *string   `json:"remark,omitempty"`
	IsDefault *bool     `json:"is_default,omitempty"`
}

type UpdateIssueDocReq struct {
	IssueID             uuid.UUID `json:"issue_id" validate:"required"`
	RequirementDocument string    `json:"requirement_document,omitempty"`
	DesignDocument      string    `json:"design_document,omitempty"`
}

type UpdateIssueReq struct {
	ID                  uuid.UUID                   `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	IssueID             uuid.UUID                   `param:"issue_id" validate:"required" json:"-" swaggerignore:"true"`
	Title               string                      `json:"title,omitempty"`
	RequirementDocument string                      `json:"requirement_document,omitempty"`
	DesignDocument      string                      `json:"design_document,omitempty"`
	Status              consts.ProjectIssueStatus   `json:"status,omitempty"`
	AssigneeID          *uuid.UUID                  `json:"assignee_id,omitempty"`
	Priority            consts.ProjectIssuePriority `json:"priority,omitempty"`
}

type UpdateModelReq struct {
	ID            uuid.UUID             `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Provider      *string               `json:"provider,omitempty"`
	APIKey        *string               `json:"api_key,omitempty"`
	BaseURL       *string               `json:"base_url,omitempty"`
	Model         *string               `json:"model,omitempty"`
	Temperature   *float32              `json:"temperature,omitempty"`
	IsDefault     *bool                 `json:"is_default,omitempty"`
	InterfaceType *consts.InterfaceType `json:"interface_type,omitempty" validate:"omitempty,oneof=openai_chat openai_responses anthropic"`
}

type UpdateNotifyChannelReq struct {
	Name       string                   `json:"name,omitempty"`
	WebhookURL string                   `json:"webhook_url,omitempty"`
	Secret     string                   `json:"secret,omitempty"`
	Headers    map[string]string        `json:"headers,omitempty"`
	Enabled    *bool                    `json:"enabled,omitempty"`
	EventTypes []consts.NotifyEventType `json:"event_types,omitempty"`
}

type UpdateProjectReq struct {
	ID           uuid.UUID                 `param:"id" validate:"required" json:"-" swaggerignore:"true"`
	Name         string                    `json:"name,omitempty"`
	Description  string                    `json:"description,omitempty"`
	Collaborator []*CreateCollaboratorItem `json:"collaborators,omitempty"`
	ImageID      uuid.UUID                 `json:"image_id,omitempty"`
	EnvVariables map[string]any            `json:"env_variables,omitempty"`
}

type UpdateTeamGroupReq struct {
	GroupID uuid.UUID `param:"group_id" validate:"required" json:"-" swaggerignore:"true"`
	Name    string    `json:"name" validate:"required"`
}

type UpdateTeamHostReq struct {
	HostID   string      `param:"host_id" validate:"required" json:"-" swaggerignore:"true"`
	GroupIDs []uuid.UUID `json:"group_ids" validate:"omitempty"`
	Remark   string      `json:"remark,omitempty"`
}

type UpdateTeamImageReq struct {
	ImageID  uuid.UUID   `param:"image_id" validate:"required" json:"-" swaggerignore:"true"`
	Name     string      `json:"name" validate:"omitempty"`
	Remark   string      `json:"remark" validate:"omitempty"`
	GroupIDs []uuid.UUID `json:"group_ids" validate:"omitempty"`
}

type UpdateTeamModelReq struct {
	ModelID       uuid.UUID            `param:"model_id" validate:"required" json:"-" swaggerignore:"true"`
	Provider      string               `json:"provider" validate:"omitempty"`
	APIKey        string               `json:"api_key" validate:"omitempty"`
	BaseURL       string               `json:"base_url" validate:"omitempty"`
	Model         string               `json:"model" validate:"omitempty"`
	Temperature   float64              `json:"temperature" validate:"omitempty"`
	GroupIDs      []uuid.UUID          `json:"group_ids" validate:"omitempty"`
	InterfaceType consts.InterfaceType `json:"interface_type" validate:"omitempty,oneof=openai_chat openai_responses anthropic"`
}

type UpdateTeamUserReq struct {
	UserID    uuid.UUID `param:"user_id" validate:"required" json:"-" swaggerignore:"true"`
	IsBlocked *bool     `json:"is_blocked" validate:"omitempty"`
}

type UpdateTeamUserResp struct {
	User *User `json:"user"`
}

type UpdateUserReq struct {
	Name      string `json:"name,omitempty" form:"name"`
	AvatarURL string `json:"avatar_url,omitempty" form:"avatar_url"`
}

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

type UpdateVMReq struct {
	ID       string    `json:"id" validate:"required"`
	HostID   string    `json:"host_id" validate:"required"`
	Life     int64     `json:"life" validate:"min=3600"`
	UID      uuid.UUID `json:"-"`
	UserName string    `json:"-"`
}

type User struct {
	ID          uuid.UUID         `json:"id"`
	Name        string            `json:"name"`
	AvatarURL   string            `json:"avatar_url"`
	Email       string            `json:"email"`
	Role        consts.UserRole   `json:"role"`
	Status      consts.UserStatus `json:"status"`
	IsBlocked   bool              `json:"is_blocked"`
	Token       string            `json:"token,omitempty"`
	Identities  []*UserIdentity   `json:"identities"`
	Team        *Team             `json:"team,omitempty"`
	HasPassword bool              `json:"has_password"`
}

type UserIdentity struct {
	ID         uuid.UUID           `json:"id"`
	AvatarURL  string              `json:"avatar_url"`
	Username   string              `json:"username"`
	IdentityID string              `json:"identity_id"`
	Platform   consts.UserPlatform `json:"platform"`
	Email      string              `json:"email"`
}

type UserRepo interface {
	Get(ctx context.Context, uid uuid.UUID) (*db.User, error)
	Update(ctx context.Context, uid uuid.UUID, name, avatarURL string) error
	GetUserWithTeams(ctx context.Context, uid uuid.UUID) (*db.User, error)
	PasswordLogin(ctx context.Context, req *TeamLoginReq) (*db.User, error)
	ChangePassword(ctx context.Context, uid uuid.UUID, currentPassword, newPassword string, isReset bool) error
	GetUserByEmail(ctx context.Context, emails []string) ([]*db.User, error)
	SetEmail(ctx context.Context, userID uuid.UUID, email string) error
}

type UserUsecase interface {
	Get(ctx context.Context, uid uuid.UUID) (*User, error)
	Update(ctx context.Context, uid uuid.UUID, avatarURL string, req UpdateUserReq) (*User, error)
	GetUserWithTeams(ctx context.Context, userID uuid.UUID) (*TeamUserInfo, error)
	PasswordLogin(ctx context.Context, req *TeamLoginReq) (*User, error)
	ChangePassword(ctx context.Context, userID uuid.UUID, req *ChangePasswordReq, isReset bool) error
	SendResetPasswordEmail(ctx context.Context, req *ResetUserPasswordEmailReq) error
	GetUserByEmail(ctx context.Context, emails []string) ([]*User, error)
	SendBindEmailVerification(ctx context.Context, userID uuid.UUID, req *SendBindEmailVerificationReq) error
	VerifyBindEmail(ctx context.Context, token string) error
}

type VMPort struct {
	ForwardID    *string           `json:"forward_id,omitempty"`
	Port         uint16            `json:"port"`
	PreviewURL   *string           `json:"preview_url,omitempty"`
	Status       consts.PortStatus `json:"status,omitempty"`
	WhiteList    []string          `json:"white_list,omitempty"`
	ErrorMessage string            `json:"error_message,omitempty"`
	Success      *bool             `json:"success,omitempty"`
}

type VMResource struct {
	Core   int    `json:"core" validate:"omitempty" default:"1"`
	Memory uint64 `json:"memory" validate:"omitempty" default:"1024"`
	Life   int64  `json:"life"`
}

type VMTerminalMessage struct {
	Type VMTerminalMessageType `json:"type"`
	Data string                `json:"data"`
}

type VMTerminalMessageType string

type VMTerminalResizeData struct {
	Col int `json:"col"`
	Row int `json:"row"`
}

type VMTerminalSuccess struct {
	Username  string `json:"username"`
	Email     string `json:"email"`
	AvatarURL string `json:"avatar_url"`
}

type VerifyBindEmailReq struct {
	Token string `query:"token" validate:"required"` // 验证 token
}

type VirtualMachine struct {
	ID              string                        `json:"id"`
	Hostname        string                        `json:"hostname"`
	OS              string                        `json:"os"`
	Cores           int32                         `json:"cores"`
	Memory          uint64                        `json:"memory"`
	Status          taskflow.VirtualMachineStatus `json:"status"`
	Name            string                        `json:"name"`
	LifeTimeSeconds int64                         `json:"life_time_seconds"`
	Host            *Host                         `json:"host,omitempty"`
	Version         string                        `json:"version"`
	CreatedAt       int64                         `json:"created_at"`
	EnvironmentID   string                        `json:"environment_id,omitempty"`
	Owner           *User                         `json:"owner,omitempty"`
	Conditions      []*etypes.Condition           `json:"conditions"`
	Ports           []*VMPort                     `json:"ports,omitempty"`
}

type VmExpireInfo struct {
	UID    uuid.UUID `json:"uid"`
	VmID   string    `json:"vm_id"`
	HostID string    `json:"host_id"`
	EnvID  string    `json:"env_id"`
}

type VmIdleInfo struct {
	UID    uuid.UUID `json:"uid"`
	VmID   string    `json:"vm_id"`
	HostID string    `json:"host_id"`
	EnvID  string    `json:"env_id"`
	TaskID string    `json:"task_id,omitempty"` // 关联的任务 ID，用于通知
	Name   string    `json:"name,omitempty"`    // 任务名称，用于通知内容
}

type WebhookOptions struct {
	Token      string
	RepoURL    string
	WebhookURL string
	IsOAuth    bool
}