feat: 支持管理员自助修改密码 (#57)

admin/service/auth.go

@@ -32,7 +32,10 @@ var (
 	dummyPasswordHash, _ = bcrypt.GenerateFromPassword([]byte("not-a-real-password"), bcrypt.DefaultCost)
 )
 
-type validationError struct{ message string }
+type validationError struct {
+	field   string
+	message string
+}
 
 func (e *validationError) Error() string { return e.message }
 
@@ -42,10 +45,23 @@ func IsValidationError(err error) bool {
 	return errors.As(err, &target)
 }
 
+// ValidationField 返回表单错误对应的字段名，供页面把焦点放到需要修正的位置。
+func ValidationField(err error) string {
+	var target *validationError
+	if errors.As(err, &target) {
+		return target.field
+	}
+	return ""
+}
+
 func invalidInput(message string, args ...any) error {
 	return &validationError{message: fmt.Sprintf(message, args...)}
 }
 
+func invalidFieldInput(field, message string, args ...any) error {
+	return &validationError{field: field, message: fmt.Sprintf(message, args...)}
+}
+
 // HasUsers 判断首次初始化入口是否已经永久关闭。
 func HasUsers(db *sql.DB) (bool, error) {
 	count, err := repository.CountUsers(db)
@@ -86,15 +102,15 @@ func validateUsername(username string) error {
 
 func hashConfirmedPassword(password, confirmation string) ([]byte, error) {
 	if len([]rune(password)) < minimumPasswordLen {
-		return nil, invalidInput("密码至少需要 %d 个字符", minimumPasswordLen)
+		return nil, invalidFieldInput("new_password", "密码至少需要 %d 个字符", minimumPasswordLen)
 	}
 	// bcrypt 最多接受 72 字节。中文等字符可能占多个字节，因此不能只靠
 	// HTML 的 maxlength；服务端需要在哈希前给出可理解的校验错误。
 	if len([]byte(password)) > 72 {
-		return nil, invalidInput("密码不能超过 72 个字节")
+		return nil, invalidFieldInput("new_password", "密码不能超过 72 个字节")
 	}
 	if password != confirmation {
-		return nil, invalidInput("两次输入的密码不一致")
+		return nil, invalidFieldInput("password_confirm", "两次输入的密码不一致")
 	}
 	hash, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
 	if err != nil {
@@ -103,6 +119,22 @@ func hashConfirmedPassword(password, confirmation string) ([]byte, error) {
 	return hash, nil
 }
 
+// ChangeAdminPassword 校验当前管理员密码，更新新密码并撤销该账号全部 Session。
+func ChangeAdminPassword(db *sql.DB, actor *model.User, currentPassword, newPassword, confirmation string, now time.Time) error {
+	if actor == nil || !actor.IsAdmin() {
+		return ErrAdminRequired
+	}
+	if bcrypt.CompareHashAndPassword([]byte(actor.PasswordHash), []byte(currentPassword)) != nil {
+		return invalidFieldInput("current_password", "当前密码错误，请重新输入")
+	}
+	hash, err := hashConfirmedPassword(newPassword, confirmation)
+	if err != nil {
+		return err
+	}
+	return repository.ChangePasswordAndRevokeSessions(
+		db, actor.UserID, actor.PasswordHash, string(hash), now.UTC().Format(model.TimeLayout))
+}
+
 // Login 校验统一凭据并创建一个固定 12 小时有效的 Session。
 // 返回的 token 原文只交给 Cookie，数据库仅保存 SHA-256。
 func Login(db *sql.DB, username, password string, now time.Time) (token string, user *model.User, expiresAt time.Time, err error) {