api

type AssignTutorBody struct {
	UserID      string `json:"user_id"`
	Description string `json:"description" required:"false"`
}

type AuditLogFacets struct {
	Actions   []string `json:"actions"`
	Resources []string `json:"resources"`
}

type AuditLogFacetsInput struct{}

type AuditLogFacetsOutput struct {
	Body AuditLogFacets
}

type AuditLogGetInput struct {
	ID string `path:"id"`
}

type AuditLogGetOutput struct {
	Body db.AuditLog
}

type AuditLogListInput struct {
	AuditLogListQuery
}

type AuditLogListOutput struct {
	Body query.PaginatedResponse[db.AuditLog]
}

type AuditLogListParams struct {
	Search     string
	Action     string
	Resource   string
	ActorID    string
	ResourceID string
	Since      string
	Until      string
	SortBy     string
	SortDir    string
	Page       int
	PageSize   int
}

type AuditLogListQuery struct {
	Search     string `query:"search" required:"false"`
	Action     string `query:"action" required:"false"`
	Resource   string `query:"resource" required:"false"`
	ActorID    string `query:"actor_id" required:"false"`
	ResourceID string `query:"resource_id" required:"false"`
	Since      string `query:"since" required:"false"`
	Until      string `query:"until" required:"false"`
	SortBy     string `query:"sort_by" required:"false"`
	SortDir    string `query:"sort_dir" required:"false"`
	Page       int    `query:"page" default:"1"`
	PageSize   int    `query:"page_size" default:"25"`
}

type AuditLogListResult struct {
	Items      []db.AuditLog
	Total      int64
	Page       int
	PageSize   int
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type AutoDistributeResult struct {
	Assigned int `json:"assigned"`
	Tutors   int `json:"tutors"`
}

type BulkAssignTutorBody struct {
	UserIDs []string `json:"user_ids" required:"true"`
	TutorID *uint    `json:"tutor_id" required:"false"`
}

type BulkAssignTutorResult struct {
	Assigned int `json:"assigned"`
}

type CLIVersionInput struct{}

type CLIVersionOutput struct {
	Body cliVersionResponse
}

type ChartsCSVOutput struct {
	ContentType        string `header:"Content-Type"`
	ContentDisposition string `header:"Content-Disposition"`
	Body               []byte
}

type ChartsInput struct {
	CourseID uint64 `query:"course_id" required:"false"`
}

type ChartsOutput struct {
	Body ChartsResponse
}

type ChartsResponse struct {
	UsersByFaculty        []LabelCount       `json:"users_by_faculty"`
	RegistrationsOverTime []TimeSeriesPoint  `json:"registrations_over_time"`
	LoginsByDay           []TimeSeriesPoint  `json:"logins_by_day"`
	LoginsByHour          []LabelCount       `json:"logins_by_hour"`
	LoginsByWeekday       []LabelCount       `json:"logins_by_weekday"`
	AuditActivityOverTime []TimeSeries       `json:"audit_activity_over_time"`
	ForgejoOverTime       []ForgejoTimePoint `json:"forgejo_over_time"`
	CoursesPerSemester    []LabelCount       `json:"courses_per_semester"`
	StudentsPerTutor      []LabelCount       `json:"students_per_tutor"`
	GradeDistPerExercise  []GradeBucket      `json:"grade_distribution_per_exercise"`
	AvgScorePerExercise   []LabelCount       `json:"average_score_per_exercise"`
	GradedVsUngraded      []GradedUngraded   `json:"graded_vs_ungraded_per_exercise"`
	GradesByWeek          []TimeSeriesPoint  `json:"grades_by_week"`
	AttendancePerWeek     []TimeSeriesPoint  `json:"attendance_per_week"`
	PresentedVsAttended   []LabelCount       `json:"presented_vs_attended"`
	EnrollmentsByFaculty  []LabelCount       `json:"enrollments_by_faculty"`
}

type CourseAccessForCourseGrantInput struct {
	ID     string `path:"id"`
	UserID string `path:"userID"`
}

type CourseAccessForCourseGrantOutput struct {
	Body CourseAccessOut
}

type CourseAccessForCourseListInput struct {
	ID string `path:"id"`
}

type CourseAccessForCourseListOutput struct {
	Body []CourseAccessOut
}

type CourseAccessForCourseRevokeInput struct {
	ID     string `path:"id"`
	UserID string `path:"userID"`
}

type CourseAccessForCourseRevokeOutput struct {
	Status int
}

type CourseAccessOut struct {
	ID        uint   `json:"id"`
	CourseID  uint   `json:"course_id"`
	UserID    string `json:"user_id"`
	GrantedBy string `json:"granted_by"`
}

type CourseBody struct {
	Name         string `json:"name"`
	Semester     string `json:"semester"`
	DisplayName  string `json:"display_name" required:"false"`
	Website      string `json:"website" required:"false"`
	BuilderImage string `json:"builder_image" required:"false"`
	GraderImage  string `json:"grader_image" required:"false"`
	AllowPush    bool   `json:"allow_push" required:"false"`
	AllowJoin    bool   `json:"allow_join" required:"false"`
	RepoAccess   string `json:"repo_access" required:"false"`
	OwnerID      string `json:"owner_id" required:"false"`
}

type CourseBrief struct {
	ID          uint   `json:"id"`
	Name        string `json:"name"`
	Semester    string `json:"semester"`
	DisplayName string `json:"display_name"`
}

type CourseListQuery struct {
	Search    string `query:"search" required:"false"`
	AllowJoin string `query:"allow_join" required:"false"`
	AllowPush string `query:"allow_push" required:"false"`
	Archived  string `query:"archived" required:"false"`
	Name      string `query:"name" required:"false"`
	Display   string `query:"display_name" required:"false"`
	Semester  string `query:"semester" required:"false"`
	SortBy    string `query:"sort_by" required:"false"`
	SortDir   string `query:"sort_dir" required:"false"`
	Page      int    `query:"page" default:"1"`
	PageSize  int    `query:"page_size" default:"25"`
}

type CourseStudentGradesInput struct {
	CourseSlug string `path:"courseSlug"`
	Username   string `path:"username"`
}

type CourseStudentGradesOutput struct {
	Body []GradeItem
}

type CourseStudentListParams struct {
	Search   string
	TutorID  string
	SortBy   string
	SortDir  string
	Page     int
	PageSize int
}

type CourseStudentListQuery struct {
	Search   string `query:"search" required:"false"`
	TutorID  string `query:"tutor_id" required:"false"`
	SortBy   string `query:"sort_by" required:"false"`
	SortDir  string `query:"sort_dir" required:"false"`
	Page     int    `query:"page" default:"1"`
	PageSize int    `query:"page_size" default:"25"`
}

type CourseStudentListResult struct {
	Items      []StudentOut
	Page       int
	PageSize   int
	TotalItems int64
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type CourseTutorListQuery struct {
	SortBy   string `query:"sort_by" required:"false" sort:"id,created_at" default_sort:"id asc"`
	SortDir  string `query:"sort_dir" required:"false"`
	Page     int    `query:"page" default:"1"`
	PageSize int    `query:"page_size" default:"25"`
}

type CoursesCreateInput struct {
	Body CourseBody
}

type CoursesCreateOutput struct {
	Body db.Course
}

type CoursesDeleteInput struct {
	ID string `path:"id"`
}

type CoursesDeleteOutput struct {
	Status int
}

type CoursesGetInput struct {
	ID string `path:"id"`
}

type CoursesGetOutput struct {
	Body db.Course
}

type CoursesHardDeleteInput struct {
	ID string `path:"id"`
}

type CoursesHardDeleteOutput struct {
	Status int
}

type CoursesJoinInput struct {
	ID string `path:"id"`
}

type CoursesJoinOutput struct {
	Body db.Student
}

type CoursesListInput struct {
	CourseListQuery
}

type CoursesListOutput struct {
	Body query.PaginatedResponse[db.Course]
}

type CoursesListParams struct {
	Search    string
	AllowJoin *bool
	AllowPush *bool
	Archived  *bool
	Name      string
	Display   string
	Semester  string
	SortBy    string
	SortDir   string
	Page      int
	PageSize  int
}

type CoursesListResult struct {
	Items      []db.Course
	Total      int64
	Page       int
	PageSize   int
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type CoursesRestoreInput struct {
	ID string `path:"id"`
}

type CoursesRestoreOutput struct {
	Body db.Course
}

type CoursesStudentsAssignTutorBulkInput struct {
	ID   string `path:"id"`
	Body BulkAssignTutorBody
}

type CoursesStudentsAssignTutorBulkOutput struct {
	Body BulkAssignTutorResult
}

type CoursesStudentsAutoDistributeInput struct {
	ID string `path:"id"`
}

type CoursesStudentsAutoDistributeOutput struct {
	Body AutoDistributeResult
}

type CoursesStudentsListInput struct {
	ID string `path:"id"`
	CourseStudentListQuery
}

type CoursesStudentsListOutput struct {
	Body query.PaginatedResponse[StudentOut]
}

type CoursesStudentsMineInput struct {
	ID string `path:"id"`
}

type CoursesStudentsMineOutput struct {
	Body []StudentOut
}

type CoursesStudentsSetTutorInput struct {
	ID     string `path:"id"`
	UserID string `path:"userID"`
	Body   SetStudentTutorBody
}

type CoursesStudentsSetTutorOutput struct {
	Body StudentOut
}

type CoursesStudentsUnassignInput struct {
	ID     string `path:"id"`
	UserID string `path:"userID"`
}

type CoursesStudentsUnassignOutput struct {
	Status int
}

type CoursesTutorForUserInput struct {
	CourseID string `path:"course_id"`
	UserID   string `path:"user_id"`
}

type CoursesTutorForUserOutput struct {
	Body TutorAssignmentOut
}

type CoursesTutorMineInput struct {
	CourseID string `path:"course_id"`
}

type CoursesTutorMineOutput struct {
	Body TutorAssignmentOut
}

type CoursesTutorsAssignInput struct {
	ID   string `path:"id"`
	Body AssignTutorBody
}

type CoursesTutorsAssignOutput struct {
	Body TutorOut
}

type CoursesTutorsListInput struct {
	ID string `path:"id"`
	CourseTutorListQuery
}

type CoursesTutorsListOutput struct {
	Body query.PaginatedResponse[TutorOut]
}

type CoursesTutorsUnassignInput struct {
	ID     string `path:"id"`
	UserID string `path:"userID"`
}

type CoursesTutorsUnassignOutput struct {
	Status int
}

type CoursesUpdateInput struct {
	ID   string `path:"id"`
	Body CourseBody
}

type CoursesUpdateOutput struct {
	Body db.Course
}

type CreateUserBody struct {
	Email             string  `json:"email" required:"false"`
	Name              string  `json:"name"`
	Subject           string  `json:"subject" required:"false"`
	PreferredUsername string  `json:"preferred_username" required:"false"`
	StudentID         string  `json:"student_id" required:"false"`
	AccountType       string  `json:"account_type" required:"false"`
	Faculty           string  `json:"faculty" required:"false"`
	EnrolledSubject   string  `json:"enrolled_subject" required:"false"`
	ExtraClaims       string  `json:"extra_claims" required:"false"`
	Role              db.Role `json:"role" required:"false"`
}

type CronJobResponse struct {
	ID                 string      `json:"id"`
	Name               string      `json:"name"`
	Tags               []string    `json:"tags"`
	IsRunning          bool        `json:"is_running"`
	LastRunStartedAt   *time.Time  `json:"last_run_started_at,omitempty"`
	LastRunCompletedAt *time.Time  `json:"last_run_completed_at,omitempty"`
	NextRun            *time.Time  `json:"next_run,omitempty"`
	NextRuns           []time.Time `json:"next_runs,omitempty"`
	Schedule           any         `json:"schedule,omitempty"` // optional, see below
}

type CronListInput struct{}

type CronListOutput struct {
	Body []CronJobResponse
}

type CronRunInput struct {
	ID string `path:"id"`
}

type CronRunOutput struct {
	Body CronJobResponse
}

type ExerciseAllRow struct {
	ID            uint      `json:"id"`
	Name          string    `json:"name"`
	CourseID      uint      `json:"course_id"`
	CourseName    string    `json:"course_name"`
	Semester      string    `json:"semester"`
	Start         time.Time `json:"start"`
	End           time.Time `json:"end"`
	Points        *float64  `json:"points"`
	UngradedCount int64     `json:"ungraded_count"`
}

type ExerciseOut struct {
	ID       uint      `json:"id"`
	Name     string    `json:"name"`
	Start    time.Time `json:"start"`
	End      time.Time `json:"end"`
	Points   *float64  `json:"points"`
	CourseID uint      `json:"course_id"`
}

type ExercisesAllListParams struct {
	Search   string
	CourseID string
	SortBy   string
	SortDir  string
	Page     int
	PageSize int
}

type ExercisesAllListResult struct {
	Items      []ExerciseAllRow
	Total      int64
	Page       int
	PageSize   int
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type ExercisesListInput struct {
	ID string `path:"id"`
}

type ExercisesListOutput struct {
	Body []ExerciseOut
}

type ForgejoRequestFacets struct {
	Sources []string `json:"sources"`
	Methods []string `json:"methods"`
}

type ForgejoRequestListParams struct {
	Search    string
	Source    string
	Method    string
	MinStatus string
	MaxStatus string
	Since     string
	Until     string
	SortBy    string
	SortDir   string
	Page      int
	PageSize  int
}

type ForgejoRequestListQuery struct {
	Search    string `query:"search" required:"false"`
	Source    string `query:"source" required:"false"`
	Method    string `query:"method" required:"false"`
	MinStatus string `query:"min_status" required:"false"`
	MaxStatus string `query:"max_status" required:"false"`
	Since     string `query:"since" required:"false"`
	Until     string `query:"until" required:"false"`
	SortBy    string `query:"sort_by" required:"false"`
	SortDir   string `query:"sort_dir" required:"false"`
	Page      int    `query:"page" default:"1"`
	PageSize  int    `query:"page_size" default:"25"`
}

type ForgejoRequestListResult struct {
	Items      []db.ForgejoRequest
	Total      int64
	Page       int
	PageSize   int
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type ForgejoRequestsFacetsInput struct{}

type ForgejoRequestsFacetsOutput struct {
	Body ForgejoRequestFacets
}

type ForgejoRequestsListInput struct {
	ForgejoRequestListQuery
}

type ForgejoRequestsListOutput struct {
	Body query.PaginatedResponse[db.ForgejoRequest]
}

type ForgejoTimePoint struct {
	Date       string `json:"date"`
	Success    int64  `json:"success"`
	Error      int64  `json:"error"`
	AvgLatency int64  `json:"avg_latency_ms"`
}

type GradeBucket struct {
	Exercise string `json:"exercise"`
	Bucket   string `json:"bucket"`
	Count    int64  `json:"count"`
}

type GradeItem struct {
	ExerciseName string     `json:"exercise_name"`
	CourseName   string     `json:"course_name"`
	CourseSlug   string     `json:"course_slug"`
	CourseID     uint       `json:"course_id"`
	Points       *float64   `json:"points"`
	MaxPoints    *float64   `json:"max_points"`
	GradedAt     *time.Time `json:"graded_at"`
	Start        time.Time  `json:"start"`
	End          time.Time  `json:"end"`
}

type GradedUngraded struct {
	Exercise string `json:"exercise"`
	Graded   int64  `json:"graded"`
	Ungraded int64  `json:"ungraded"`
}

type Handler struct {
	// contains filtered or unexported fields
}

type HealthBeszelContainer struct {
	Name       string  `json:"name"`
	CPUPercent float64 `json:"cpu_percent"`
	MemMB      float64 `json:"mem_mb"`
	NetUpMBs   float64 `json:"net_up_mbs"`
	NetDownMBs float64 `json:"net_down_mbs"`
}

type HealthBeszelInfo struct {
	HostStatus    string                  `json:"host_status"`
	HostUptimeSec float64                 `json:"host_uptime_sec"`
	AgentVersion  string                  `json:"agent_version"`
	LastHeartbeat time.Time               `json:"last_heartbeat"`
	CPUPercent    float64                 `json:"cpu_percent"`
	MemUsedGB     float64                 `json:"mem_used_gb"`
	MemTotalGB    float64                 `json:"mem_total_gb"`
	MemPercent    float64                 `json:"mem_percent"`
	DiskUsedGB    float64                 `json:"disk_used_gb"`
	DiskTotalGB   float64                 `json:"disk_total_gb"`
	DiskPercent   float64                 `json:"disk_percent"`
	LoadAvg       [3]float64              `json:"load_avg"`
	NetUpMBs      float64                 `json:"net_up_mbs"`
	NetDownMBs    float64                 `json:"net_down_mbs"`
	Containers    []HealthBeszelContainer `json:"containers"`
}

type HealthCheckItem struct {
	Name                string         `json:"name"`
	Group               string         `json:"group"`
	Status              string         `json:"status"`
	Message             string         `json:"message"`
	LatencyMS           int64          `json:"latency_ms"`
	ConsecutiveFailures int            `json:"consecutive_failures"`
	CheckedAt           time.Time      `json:"checked_at"`
	Detail              map[string]any `json:"detail,omitempty"`
}

type HealthCheckRunInput struct {
	Name string `path:"name"`
}

type HealthCheckRunOutput struct {
	Body HealthCheckItem
}

type HealthStatusInput struct{}

type HealthStatusOutput struct {
	Body struct {
		Checks      []HealthCheckItem      `json:"checks"`
		Summary     HealthSummary          `json:"summary"`
		Beszel      *HealthBeszelInfo      `json:"beszel"`
		System      HealthSystemInfo       `json:"system"`
		Warnings    []config.ConfigWarning `json:"warnings"`
		GeneratedAt time.Time              `json:"generated_at"`
	}
}

type HealthSummary struct {
	Total   int `json:"total"`
	OK      int `json:"ok"`
	Warn    int `json:"warn"`
	Fail    int `json:"fail"`
	Unknown int `json:"unknown"`
}

type HealthSystemInfo struct {
	GoVersion string    `json:"go_version"`
	UptimeSec int64     `json:"uptime_sec"`
	StartedAt time.Time `json:"started_at"`
}

type Huma struct {
	API huma.API
	// contains filtered or unexported fields
}

type LabelCount struct {
	Label string `json:"label"`
	Count int64  `json:"count"`
}

type MyCourseItem struct {
	db.Course
	Role string `json:"role"` // "student" or "tutor"
}

type RecentGradeItem struct {
	ExerciseName string    `json:"exercise_name"`
	CourseName   string    `json:"course_name"`
	CourseSlug   string    `json:"course_slug"`
	CourseID     uint      `json:"course_id"`
	Points       *float64  `json:"points"`
	MaxPoints    *float64  `json:"max_points"`
	GradedAt     time.Time `json:"graded_at"`
}

type SemesterCount struct {
	Semester string `json:"semester"`
	Count    int64  `json:"count"`
}

type SessionBrief struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
	ExpiresAt time.Time `json:"expires_at"`
}

type SetStudentTutorBody struct {
	TutorID *uint `json:"tutor_id" required:"false"`
}

type SettingBody struct {
	Key    string `json:"key"`
	Value  string `json:"value"`
	Type   string `json:"type" required:"false"`
	Access string `json:"access" required:"false"`
}

type SettingListQuery struct {
	Key      string `query:"key" required:"false" filter:"key"`
	Type     string `query:"type" required:"false" filter:"type"`
	Access   string `query:"access" required:"false" filter:"access"`
	Search   string `query:"search" required:"false" search:"key,value"`
	SortBy   string `query:"sort_by" required:"false" sort:"key,access,created_at,updated_at"`
	SortDir  string `query:"sort_dir" required:"false"`
	Page     int    `query:"page" default:"1"`
	PageSize int    `query:"page_size" default:"25"`
}

type SettingsCreateInput struct {
	Body SettingBody
}

type SettingsCreateOutput struct {
	Body db.Setting
}

type SettingsDeleteInput struct {
	Key string `path:"key"`
}

type SettingsDeleteOutput struct {
	Status int
}

type SettingsGetInput struct {
	Key string `path:"key"`
}

type SettingsGetOutput struct {
	Body db.Setting
}

type SettingsListInput struct {
	SettingListQuery
}

type SettingsListOutput struct {
	Body query.PaginatedResponse[db.Setting]
}

type SettingsUpdateInput struct {
	Key  string `path:"key"`
	Body SettingBody
}

type SettingsUpdateOutput struct {
	Body db.Setting
}

type StaffStatsResponse struct {
	MyCourses         int64           `json:"my_courses"`
	JoinableCourses   int64           `json:"joinable_courses"`
	ArchivedCourses   int64           `json:"archived_courses"`
	SemesterBreakdown []SemesterCount `json:"semester_breakdown"`
	MyStudents        int64           `json:"my_students"`
	MyTutors          int64           `json:"my_tutors"`
	MyExercises       int64           `json:"my_exercises"`
}

type StatsInput struct{}

type StatsOutput struct {
	Body StatsResponse
}

type StatsResponse struct {
	TotalUsers        int64           `json:"total_users"`
	StaffUsers        int64           `json:"total_staff"`
	AdminUsers        int64           `json:"admin_users"`
	TotalCourses      int64           `json:"total_courses"`
	JoinableCourses   int64           `json:"joinable_courses"`
	ArchivedCourses   int64           `json:"archived_courses"`
	TotalStudents     int64           `json:"total_students"`
	TotalTutors       int64           `json:"total_tutors"`
	TotalAuditLogs    int64           `json:"total_audit_logs"`
	TotalExercises    int64           `json:"total_exercises"`
	ActiveSessions    int64           `json:"active_sessions"`
	TotalTasks        int64           `json:"total_tasks"`
	TotalCronJobs     int64           `json:"total_cron_jobs"`
	OrphanOrgs        int64           `json:"orphan_orgs"`
	SemesterBreakdown []SemesterCount `json:"semester_breakdown"`
}

type StudentOut struct {
	ID             uint       `json:"id"`
	Matrikelnummer *int       `json:"matrikelnummer"`
	CourseID       uint       `json:"course_id"`
	UserID         string     `json:"user_id"`
	TutorID        *uint      `json:"tutor_id"`
	User           *UserBrief `json:"user,omitempty"`
	// Email is only populated by ListCourseStudents, which is reachable
	// exclusively by callers who may manage the course. Other constructors
	// (studentsToOut, the set-tutor handler) leave it empty, keeping the
	// tutor-facing endpoints trimmed to the UserBrief identity fields.
	Email string      `json:"email,omitempty"`
	Tutor *TutorBrief `json:"tutor,omitempty"`
}

type TaskGetInput struct {
	Name string `path:"name"`
}

type TaskGetOutput struct {
	Body tasks.Task
}

type TaskListInput struct{}

type TaskListOutput struct {
	Body []tasks.Task
}

type TaskRunInput struct {
	Name string `path:"name"`
}

type TaskRunOutput struct {
	Body map[string]string
}

type TimeSeries struct {
	Label  string            `json:"label"`
	Points []TimeSeriesPoint `json:"points"`
}

type TimeSeriesPoint struct {
	Date  string `json:"date"`
	Count int64  `json:"count"`
}

type TutorAssignmentBrief struct {
	Name              string `json:"name"`
	PreferredUsername string `json:"preferred_username"`
	Email             string `json:"email"`
}

type TutorAssignmentOut struct {
	Tutor *TutorAssignmentBrief `json:"tutor"`
}

type TutorBrief struct {
	ID     uint   `json:"id"`
	UserID string `json:"user_id"`
	Name   string `json:"name"`
}

type TutorOut struct {
	ID           uint       `json:"id"`
	Description  string     `json:"description"`
	CreatedAt    time.Time  `json:"created_at"`
	UpdatedAt    time.Time  `json:"updated_at"`
	CourseID     uint       `json:"course_id"`
	UserID       string     `json:"user_id"`
	StudentCount int64      `json:"student_count"`
	User         *UserBrief `json:"user,omitempty"`
}

type TutorUserSearchResult struct {
	Items      []db.User
	Page       int
	PageSize   int
	TotalItems int64
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type UpdateUserBody struct {
	Subject           string  `json:"subject" required:"false"`
	PreferredUsername string  `json:"preferred_username" required:"false"`
	StudentID         string  `json:"student_id" required:"false"`
	AccountType       string  `json:"account_type" required:"false"`
	Faculty           string  `json:"faculty" required:"false"`
	EnrolledSubject   string  `json:"enrolled_subject" required:"false"`
	Role              db.Role `json:"role" required:"false"`
}

type UserAdminItem struct {
	db.User `json:"user"`

	SessionCount int            `json:"session_count"`
	LastLogin    *time.Time     `json:"last_login"`
	Sessions     []SessionBrief `json:"sessions"`

	OwnedCourses    []CourseBrief `json:"owned_courses"`
	TutoredCourses  []CourseBrief `json:"tutored_courses"`
	EnrolledCourses []CourseBrief `json:"enrolled_courses"`
	GrantedCourses  []CourseBrief `json:"granted_courses"`

	APIKeys []db.ApiKey `json:"api_keys"`

	Grades []RecentGradeItem `json:"grades"`

	IsProtectedAdmin bool `json:"is_protected_admin"`
}

type UserBrief struct {
	ID                string `json:"id"`
	Name              string `json:"name"`
	PreferredUsername string `json:"preferred_username"`
}

type UserListQuery struct {
	ID        string `query:"id" required:"false" filter:"id"`
	Email     string `query:"email" required:"false" filter:"email"`
	Subject   string `query:"subject" required:"false" filter:"subject"`
	StudentID string `query:"student_id" required:"false" filter:"student_id"`
	Role      string `query:"role" required:"false" filter:"role"`
	Search    string `query:"search" required:"false" search:"name,email"`
	SortBy    string `query:"sort_by" required:"false" sort:"id,name,email,created_at,updated_at,student_id,role" default_sort:"created_at desc"`
	SortDir   string `query:"sort_dir" required:"false"`
	Page      int    `query:"page" default:"1"`
	PageSize  int    `query:"page_size" default:"25"`
}

type UsersAdminListInput struct {
	UsersAdminListQuery
}

type UsersAdminListOutput struct {
	Body query.PaginatedResponse[UserAdminItem]
}

type UsersAdminListParams struct {
	Search         string
	Role           string
	Matrikelnummer string
	Tutor          bool
	SortBy         string
	SortDir        string
	Page           int
	PageSize       int
}

type UsersAdminListQuery struct {
	Search         string `query:"search" required:"false"`
	Role           string `query:"role" required:"false"`
	Matrikelnummer string `query:"matrikelnummer" required:"false"`
	Tutor          bool   `query:"tutor" required:"false"`
	SortBy         string `query:"sort_by" required:"false"`
	SortDir        string `query:"sort_dir" required:"false"`
	Page           int    `query:"page" default:"1"`
	PageSize       int    `query:"page_size" default:"25"`
}

type UsersAdminListResult struct {
	Items      []UserAdminItem
	Total      int64
	Page       int
	PageSize   int
	TotalPages int
	HasNext    bool
	HasPrev    bool
}

type UsersCreateInput struct {
	Body CreateUserBody
}

type UsersCreateOutput struct {
	Body db.User
}

type UsersDeleteInput struct {
	ID string `path:"id"`
}

type UsersDeleteOutput struct {
	Status int
}

type UsersDeleteSessionsInput struct {
	ID string `path:"id"`
}

type UsersDeleteSessionsOutput struct {
	Body struct {
		DeletedCount int64 `json:"deleted_count"`
	}
}

type UsersGetInput struct {
	ID string `path:"id"`
}

type UsersGetOutput struct {
	Body db.User
}

type UsersListInput struct {
	UserListQuery
}

type UsersListOutput struct {
	Body query.PaginatedResponse[db.User]
}

type UsersMeCoursesInput struct{}

type UsersMeCoursesOutput struct {
	Body []MyCourseItem
}

type UsersMeGradesInput struct{}

type UsersMeGradesOutput struct {
	Body []GradeItem
}

type UsersMeInput struct{}

type UsersMeOutput struct {
	Body db.User
}

type UsersMeRecentGradesInput struct{}

type UsersMeRecentGradesOutput struct {
	Body []RecentGradeItem
}

type UsersUpdateInput struct {
	ID   string `path:"id"`
	Body UpdateUserBody
}

type UsersUpdateOutput struct {
	Body db.User
}