healthapp/TODOS/04-后端开发/03-用户认证模块.md

03-用户认证模块

目标

实现用户注册、登录、Token 刷新等认证功能。

---

前置要求

• 数据库和模型已完成
• JWT 依赖已安装

---

实施步骤

详细代码请参考原文档 02-后端开发/03-用户认证模块.md

主要任务

1. 创建统一响应工具 pkg/response/response.go
2. 创建 JWT 工具 pkg/jwt/jwt.go
3. 创建认证中间件 internal/api/middleware/auth.go
4. 创建用户 Repository internal/repository/impl/user.go
5. 创建认证 Service internal/service/auth.go
6. 创建认证 Handler internal/api/handler/auth.go
7. 创建路由配置 internal/api/router.go
8. 更新主程序启动服务

---

API 接口

方法	路径	说明
POST	/api/auth/register	用户注册
POST	/api/auth/login	用户登录

---

验收标准

• 服务启动成功，监听 8080 端口
• /health 返回 {"status": "ok"}
• 注册接口正常创建用户
• 登录接口返回有效 Token

---

预计耗时

30-40 分钟

---

下一步

完成后进入 04-后端开发/04-健康调查模块.md