89 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			89 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| package models
 | ||
| 
 | ||
| import (
 | ||
| 	"database/sql/driver"
 | ||
| 	"encoding/json"
 | ||
| 	"errors"
 | ||
| 
 | ||
| 	"golang.org/x/crypto/bcrypt"
 | ||
| 	"gorm.io/gorm"
 | ||
| )
 | ||
| 
 | ||
| // ContactInfo 存储用户的多种联系方式
 | ||
| // 使用 jsonb 类型存入数据库
 | ||
| type ContactInfo struct {
 | ||
| 	Email  string `json:"email,omitempty"`
 | ||
| 	Phone  string `json:"phone,omitempty"`
 | ||
| 	WeChat string `json:"wechat,omitempty"`
 | ||
| 	Feishu string `json:"feishu,omitempty"`
 | ||
| }
 | ||
| 
 | ||
| // Scan 实现 sql.Scanner 接口,用于从数据库读取 JSONB 数据
 | ||
| func (ci *ContactInfo) Scan(value interface{}) error {
 | ||
| 	if value == nil {
 | ||
| 		*ci = ContactInfo{} // 如果数据库值为 NULL,则初始化为空结构体
 | ||
| 		return nil
 | ||
| 	}
 | ||
| 	bytes, ok := value.([]byte)
 | ||
| 	if !ok {
 | ||
| 		return errors.New("type assertion to []byte failed for ContactInfo")
 | ||
| 	}
 | ||
| 	return json.Unmarshal(bytes, ci)
 | ||
| }
 | ||
| 
 | ||
| // Value 实现 driver.Valuer 接口,用于将 ContactInfo 写入数据库为 JSONB 数据
 | ||
| func (ci ContactInfo) Value() (driver.Value, error) {
 | ||
| 	return json.Marshal(ci)
 | ||
| }
 | ||
| 
 | ||
| // User 代表系统中的用户模型
 | ||
| type User struct {
 | ||
| 	// gorm.Model 内嵌了 ID, CreatedAt, UpdatedAt, 和 DeletedAt
 | ||
| 	// DeletedAt 字段的存在自动为 GORM 开启了软删除模式
 | ||
| 	gorm.Model
 | ||
| 
 | ||
| 	// Username 是用户的登录名,应该是唯一的
 | ||
| 	// 修正了 gorm 标签的拼写错误 (移除了 gorm 后面的冒号)
 | ||
| 	Username string `gorm:"unique;not null" json:"username"`
 | ||
| 
 | ||
| 	// Password 存储的是加密后的密码哈希,而不是明文
 | ||
| 	// json:"-" 标签确保此字段在序列化为 JSON 时被忽略,防止密码泄露
 | ||
| 	Password string `gorm:"not null" json:"-"`
 | ||
| 
 | ||
| 	// Contact 存储用户的联系方式,以 JSONB 格式存入数据库
 | ||
| 	Contact ContactInfo `gorm:"type:jsonb" json:"contact"`
 | ||
| }
 | ||
| 
 | ||
| // TableName 自定义 User 模型对应的数据库表名
 | ||
| // GORM 默认会使用复数形式 "users",但显式定义是一种好习惯
 | ||
| func (User) TableName() string {
 | ||
| 	return "users"
 | ||
| }
 | ||
| 
 | ||
| // --- GORM Hooks ---
 | ||
| 
 | ||
| // BeforeCreate 是一个 GORM 钩子,在创建用户记录前自动调用。
 | ||
| // 这是哈希初始密码最可靠的地方。
 | ||
| func (u *User) BeforeCreate(tx *gorm.DB) (err error) {
 | ||
| 	// 如果密码不为空,则执行哈希
 | ||
| 	if u.Password != "" {
 | ||
| 		// 使用 bcrypt 对密码进行哈希
 | ||
| 		hashedPassword, err := bcrypt.GenerateFromPassword([]byte(u.Password), bcrypt.DefaultCost)
 | ||
| 		if err != nil {
 | ||
| 			return err
 | ||
| 		}
 | ||
| 		// 将明文密码替换为哈希值
 | ||
| 		u.Password = string(hashedPassword)
 | ||
| 	}
 | ||
| 	return nil
 | ||
| }
 | ||
| 
 | ||
| // --- Helper Methods ---
 | ||
| 
 | ||
| // CheckPassword 用于验证输入的明文密码是否与数据库中存储的哈希匹配
 | ||
| func (u *User) CheckPassword(plainPassword string) bool {
 | ||
| 	// bcrypt.CompareHashAndPassword 会安全地比较哈希和明文,能有效防止时序攻击
 | ||
| 	err := bcrypt.CompareHashAndPassword([]byte(u.Password), []byte(plainPassword))
 | ||
| 	return err == nil
 | ||
| }
 |