// ===========================================
// 多班级版班级管理系统 - Go 后端
//
// 开发者: Canglan
// 联系方式: admin@sea-studio.top
// 版权归属: Sea Network Technology Studio
// 许可证: Apache License 2.0
//
// 版权所有 © Sea Network Technology Studio
// ===========================================

package model

import "time"

// Student 学生模型，对应 students 表
type Student struct {
	StudentID       int        `gorm:"column:student_id;primaryKey;autoIncrement" json:"student_id"`
	StudentNo       string     `gorm:"column:student_no;type:varchar(20);not null" json:"student_no"`
	ClassID         int        `gorm:"column:class_id;not null;index:idx_student_class" json:"class_id"`
	Name            string     `gorm:"column:name;type:varchar(50);not null" json:"name"`
	TotalPoints     int        `gorm:"column:total_points;default:60" json:"total_points"`
	ParentAccount   *string    `gorm:"column:parent_account;type:varchar(50)" json:"parent_account"`
	DormitoryNumber *string    `gorm:"column:dormitory_number;type:varchar(20)" json:"dormitory_number"` // 格式：南0-000
	Status          int8       `gorm:"column:status;default:1" json:"status"`
	CreatedAt       time.Time  `gorm:"column:created_at;autoCreateTime" json:"created_at"`
	PointsUpdatedAt time.Time  `gorm:"column:points_updated_at;autoCreateTime" json:"points_updated_at"`
	UpdatedAt       time.Time  `gorm:"column:updated_at;autoUpdateTime" json:"updated_at"`

	// 虚拟字段（JOIN 查询时使用，不映射到数据库）
	ClassName *string `gorm:"-" json:"class_name,omitempty"`
}

// TableName 指定表名
func (Student) TableName() string {
	return "students"
}