course

type ArchiveResult struct {
	CourseID         string   `json:"course_id"`
	InstancesStopped []string `json:"instances_stopped"`
	SnapshotsCreated []string `json:"snapshots_created"`
	Errors           []string `json:"errors,omitempty"`
}

type AuditAction string

type AuditEntry struct {
	Timestamp time.Time              `json:"timestamp"`
	CourseID  string                 `json:"course_id"`
	Actor     string                 `json:"actor"` // who performed the action
	Action    AuditAction            `json:"action"`
	Target    string                 `json:"target,omitempty"` // student ID, instance name, etc.
	Detail    map[string]interface{} `json:"detail,omitempty"`
}

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

type BudgetExceededError struct {
	UserID    string
	Spent     float64
	Limit     float64
	Requested float64
}

type BulkEnrollRequest struct {
	// Members is the list of members to enroll
	Members []EnrollRequest `json:"members"`

	// DefaultRole is applied to any member with no explicit role (default: student)
	DefaultRole types.ClassRole `json:"default_role,omitempty"`

	// SendInvites sends invitation emails to each enrolled member when true
	SendInvites bool `json:"send_invites,omitempty"`
}

type CourseBudgetSummary struct {
	// TotalBudget is the aggregate course cap in USD
	TotalBudget float64 `json:"total_budget"`

	// TotalSpent is the total spend across all students
	TotalSpent float64 `json:"total_spent"`

	// PerStudentDefault is the default allocation per student
	PerStudentDefault float64 `json:"per_student_default"`

	// Students lists per-student budget details
	Students []StudentBudgetInfo `json:"students"`
}

type CourseFilter struct {
	// Owner filters to courses owned by this user ID
	Owner string `json:"owner,omitempty"`

	// Status filters by course lifecycle state
	Status *types.CourseStatus `json:"status,omitempty"`

	// Semester filters by semester identifier (exact match)
	Semester string `json:"semester,omitempty"`

	// Department filters by department
	Department string `json:"department,omitempty"`

	// Tags filters to courses matching all specified tags (AND logic)
	Tags map[string]string `json:"tags,omitempty"`
}

type CourseMaterialsCreateRequest struct {
	// SizeGB is the advisory size (EFS is elastic; default 50)
	SizeGB int `json:"size_gb,omitempty"`
	// MountPath is where to mount in student instances (default "/mnt/course-materials")
	MountPath string `json:"mount_path,omitempty"`
}

type CourseOverview struct {
	CourseID         string          `json:"course_id"`
	CourseCode       string          `json:"course_code"`
	TotalStudents    int             `json:"total_students"`
	ActiveInstances  int             `json:"active_instances"`
	TotalBudgetSpent float64         `json:"total_budget_spent"`
	Students         []StudentStatus `json:"students"`
	GeneratedAt      time.Time       `json:"generated_at"`
}

type CreateCourseRequest struct {
	// Code is the institutional course code (required, e.g. "CS229")
	Code string `json:"code"`

	// Title is the full course title (required)
	Title string `json:"title"`

	// Department is the offering department (optional)
	Department string `json:"department,omitempty"`

	// Semester identifies the offering period (required, e.g. "Fall 2024")
	Semester string `json:"semester"`

	// SemesterStart is when the course begins (required)
	SemesterStart time.Time `json:"semester_start"`

	// SemesterEnd is when the course ends (required)
	SemesterEnd time.Time `json:"semester_end"`

	// GracePeriodDays is days after end before auto-cleanup (default 7)
	GracePeriodDays int `json:"grace_period_days,omitempty"`

	// Owner is the primary instructor's user ID (required)
	Owner string `json:"owner"`

	// ApprovedTemplates is the initial template whitelist (empty = all allowed)
	ApprovedTemplates []string `json:"approved_templates,omitempty"`

	// PerStudentBudget is the default per-student budget in USD (0 = unlimited)
	PerStudentBudget float64 `json:"per_student_budget,omitempty"`

	// TotalBudget is the aggregate course cap in USD (0 = unlimited)
	TotalBudget float64 `json:"total_budget,omitempty"`

	// Tags are optional metadata
	Tags map[string]string `json:"tags,omitempty"`

	// DefaultTemplate is the template slug auto-assigned to students on workspace provision.
	DefaultTemplate string `json:"default_template,omitempty"`

	// AutoProvisionOnEnroll creates a workspace for the student automatically upon
	// enrollment when true (requires DefaultTemplate to be set).
	AutoProvisionOnEnroll bool `json:"auto_provision_on_enroll,omitempty"`
}

type EnrollRequest struct {
	// UserID is the member's user identifier (required unless Email is provided)
	UserID string `json:"user_id,omitempty"`

	// Email is the member's email address (used as identifier and for invitations)
	Email string `json:"email,omitempty"`

	// DisplayName is the member's human-readable name
	DisplayName string `json:"display_name,omitempty"`

	// Role is the member's role in the course (default: student)
	Role types.ClassRole `json:"role,omitempty"`

	// BudgetLimit overrides the course default for this member (0 = use course default)
	BudgetLimit float64 `json:"budget_limit,omitempty"`
}

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

type ProvisioningContext struct {
	CourseID     string
	StudentID    string
	StudentEmail string
	Template     string
	BudgetLimit  float64
	BudgetSpent  float64
}

type RosterFormat string

type RosterRow struct {
	// Email is the student's email address (required)
	Email string

	// DisplayName is the student's name
	DisplayName string

	// Budget is the per-student budget override in USD (0 = use course default)
	Budget float64

	// Role is the member role (optional; defaults to "student")
	Role string
}

type SharedMaterialsVolume struct {
	// CourseID links back to the owning course
	CourseID string `json:"course_id"`
	// EFSID is the AWS EFS filesystem ID
	EFSID string `json:"efs_id"`
	// SizeGB is the advisory provisioned size in GB (EFS is elastic)
	SizeGB int `json:"size_gb"`
	// MountPath is where the EFS is mounted inside student instances
	MountPath string `json:"mount_path"`
	// State is "creating" | "available" | "error"
	State string `json:"state"`
	// CreatedAt is when the volume was created
	CreatedAt time.Time `json:"created_at"`
	// MountedInstanceCount is how many student instances currently have it mounted
	MountedInstanceCount int `json:"mounted_instance_count"`
}

type StudentBudgetInfo struct {
	// UserID is the student's identifier
	UserID string `json:"user_id"`

	// DisplayName is the student's name
	DisplayName string `json:"display_name,omitempty"`

	// Email is the student's email
	Email string `json:"email,omitempty"`

	// BudgetLimit is the student's spending cap
	BudgetLimit float64 `json:"budget_limit"`

	// BudgetSpent is how much has been consumed
	BudgetSpent float64 `json:"budget_spent"`

	// Remaining is BudgetLimit - BudgetSpent (negative if over budget)
	Remaining float64 `json:"remaining"`
}

type StudentStatus struct {
	UserID       string           `json:"user_id"`
	Email        string           `json:"email"`
	DisplayName  string           `json:"display_name,omitempty"`
	Instances    []types.Instance `json:"instances"`
	BudgetSpent  float64          `json:"budget_spent"`
	BudgetLimit  float64          `json:"budget_limit"`
	BudgetStatus string           `json:"budget_status"` // "ok" | "warning" (>80%) | "exceeded"
	LastActive   *time.Time       `json:"last_active,omitempty"`
}

type StudentUsageRecord struct {
	UserID        string  `json:"user_id"`
	Email         string  `json:"email"`
	DisplayName   string  `json:"display_name,omitempty"`
	TotalSpent    float64 `json:"total_spent"`
	BudgetLimit   float64 `json:"budget_limit"`
	InstanceHours float64 `json:"instance_hours"`
	InstanceCount int     `json:"instance_count"`
}

type TAAccessEntry struct {
	// TAID is the user ID (or email) of the TA who connected
	TAID string `json:"ta_id"`
	// TAEmail is the TA's email for display purposes
	TAEmail string `json:"ta_email,omitempty"`
	// StudentID is the user ID (or email) of the student whose instance was accessed
	StudentID string `json:"student_id"`
	// StudentEmail is the student's email for display purposes
	StudentEmail string `json:"student_email,omitempty"`
	// Reason is a required explanation provided at access time
	Reason string `json:"reason"`
	// ConnectedAt is when the SSH session was initiated
	ConnectedAt time.Time `json:"connected_at"`
	// InstanceID is the AWS instance ID that was accessed
	InstanceID string `json:"instance_id,omitempty"`
	// PublicIP is the public IP address of the student's instance
	PublicIP string `json:"public_ip,omitempty"`
}

type TAAccessGrantRequest struct {
	// Email is the TA's email address to grant access
	Email string `json:"email"`
	// DisplayName is the TA's display name (optional)
	DisplayName string `json:"display_name,omitempty"`
}

type TADebugInfo struct {
	// CourseID is the course this debug info belongs to
	CourseID string `json:"course_id"`

	// StudentID is the user ID of the student
	StudentID string `json:"student_id"`

	// StudentEmail is the student's email
	StudentEmail string `json:"student_email,omitempty"`

	// Instances lists the student's current instances
	Instances []types.Instance `json:"instances"`

	// RecentEvents lists the last N instance state changes and errors
	RecentEvents []string `json:"recent_events,omitempty"`

	// BudgetSpent is how much of the student's budget has been consumed
	BudgetSpent float64 `json:"budget_spent"`

	// BudgetLimit is the student's spending cap (0 = unlimited)
	BudgetLimit float64 `json:"budget_limit"`
}

type TAResetRequest struct {
	// StudentID is the user ID (or email) of the student whose instance to reset
	StudentID string `json:"student_id"`

	// Reason is a required explanation for the audit log
	Reason string `json:"reason"`

	// BackupRetentionDays is how long to keep the pre-reset snapshot (default 7)
	BackupRetentionDays int `json:"backup_retention_days,omitempty"`
}

type TASSHConnectRequest struct {
	// StudentID is the user ID or email of the student to connect to
	StudentID string `json:"student_id"`
	// Reason is a mandatory explanation for the audit log
	Reason string `json:"reason"`
}

type UpdateCourseRequest struct {
	// Title updates the course title
	Title *string `json:"title,omitempty"`

	// Department updates the department
	Department *string `json:"department,omitempty"`

	// SemesterEnd extends or shortens the semester end date
	SemesterEnd *time.Time `json:"semester_end,omitempty"`

	// GracePeriodDays updates the cleanup grace period
	GracePeriodDays *int `json:"grace_period_days,omitempty"`

	// ApprovedTemplates replaces the template whitelist (nil = no change, empty slice = clear all)
	ApprovedTemplates []string `json:"approved_templates,omitempty"`

	// PerStudentBudget updates the default per-student budget
	PerStudentBudget *float64 `json:"per_student_budget,omitempty"`

	// TotalBudget updates the aggregate course budget cap
	TotalBudget *float64 `json:"total_budget,omitempty"`

	// Tags replaces the tag set
	Tags map[string]string `json:"tags,omitempty"`

	// Status manually sets the course status
	Status *types.CourseStatus `json:"status,omitempty"`

	// DefaultTemplate updates the default workspace template
	DefaultTemplate *string `json:"default_template,omitempty"`

	// AutoProvisionOnEnroll updates the auto-provision setting
	AutoProvisionOnEnroll *bool `json:"auto_provision_on_enroll,omitempty"`
}

type UsageReport struct {
	CourseID    string               `json:"course_id"`
	CourseCode  string               `json:"course_code"`
	Semester    string               `json:"semester"`
	TotalSpent  float64              `json:"total_spent"`
	TotalBudget float64              `json:"total_budget"`
	Students    []StudentUsageRecord `json:"students"`
	GeneratedAt time.Time            `json:"generated_at"`
}

type WorkspaceResetResult struct {
	// StudentID identifies whose workspace was reset
	StudentID string `json:"student_id"`
	// BackupSnapshotID is the snapshot ID created before reset (empty if --no-backup)
	BackupSnapshotID string `json:"backup_snapshot_id,omitempty"`
	// BackupDownloadURL is a pre-signed URL for the student to retrieve their backed-up work
	BackupDownloadURL string `json:"backup_download_url,omitempty"`
	// BackupExpiresAt is when the download URL expires (7 days by default)
	BackupExpiresAt *time.Time `json:"backup_expires_at,omitempty"`
	// Status is "reset_scheduled" | "reset_complete"
	Status string `json:"status"`
}