feat(login/register): 实现用户注册登录handler以及用户模型

backend/internal/handler/login.go

@@ -0,0 +1,38 @@
+package handler
+
+import (
+	"net/http"
+
+	"gen2d/internal/model"
+
+	"github.com/gin-gonic/gin"
+)
+
+// LoginRequest 登录请求参数。
+type LoginRequest struct {
+	Username string `json:"username" binding:"required"` // 用户名
+	Password string `json:"password" binding:"required"` // 密码
+}
+
+// LoginResponse 登录成功返回的凭证及用户信息。
+type LoginResponse struct {
+	Token     string     `json:"token"`     // 访问令牌
+	ExpiresIn int64      `json:"expiresIn"` // 过期时间（秒）
+	User      model.User `json:"user"`      // 用户信息
+}
+
+// Login 用户登录接口，校验用户名/密码并返回访问令牌。
+func Login(c *gin.Context) {
+	var req LoginRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, model.Fail(http.StatusBadRequest, "参数错误: "+err.Error()))
+		return
+	}
+
+	// TODO: 调用 service 层校验用户凭证并签发 token
+	c.JSON(http.StatusOK, model.OK(LoginResponse{
+		Token:     "placeholder-token",
+		ExpiresIn: 7200,
+		User:      model.User{Username: req.Username},
+	}))
+}

backend/internal/handler/register.go

@@ -0,0 +1,37 @@
+package handler
+
+import (
+	"net/http"
+
+	"gen2d/internal/model"
+
+	"github.com/gin-gonic/gin"
+)
+
+// RegisterRequest 注册请求参数。
+type RegisterRequest struct {
+	Username string `json:"username" binding:"required,min=3,max=32"` // 用户名
+	Password string `json:"password" binding:"required,min=6,max=64"` // 密码
+	Email    string `json:"email" binding:"omitempty,email"`           // 邮箱（可选）
+}
+
+// RegisterResponse 注册成功返回的用户信息。
+type RegisterResponse struct {
+	ID       uint   `json:"id"`
+	Username string `json:"username"`
+}
+
+// Register 用户注册接口，创建新用户账号。
+func Register(c *gin.Context) {
+	var req RegisterRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, model.Fail(http.StatusBadRequest, "参数错误: "+err.Error()))
+		return
+	}
+
+	// TODO: 调用 service 层创建用户
+	c.JSON(http.StatusCreated, model.OK(RegisterResponse{
+		ID:       0,
+		Username: req.Username,
+	}))
+}

backend/internal/model/user.go

@@ -0,0 +1,13 @@
+package model
+
+import "time"
+
+// User 用户实体。
+type User struct {
+	ID        uint      `json:"id"`
+	Username  string    `json:"username"`
+	Password  string    `json:"-"` // 密码哈希，JSON 序列化时忽略
+	Email     string    `json:"email,omitempty"`
+	CreatedAt time.Time `json:"createdAt"`
+	UpdatedAt time.Time `json:"updatedAt"`
+}