• 简体中文

      • Delta Force Guide API

      后端 API 概览

      后端是基于 Spring Boot 3 的应用程序，代码组织在基础包 com.onixbyte.deltaforceguide 下：

      包描述
      controllerREST API 端点控制器
      service业务逻辑层
      repositoryMyBatis 数据访问层
      domainJPA 实体与领域对象
      configSpring 配置（安全、缓存等）
      properties配置属性类
      enumeration枚举类型
      shared共享工具类

      API 端点

      认证

      方法路径描述认证
      POST/api/auth/login使用凭证登录否
      POST/api/auth/refresh刷新 access token否
      GET/api/auth/profile获取当前用户信息是

      枪械

      方法路径描述
      GET/api/firearms枪械列表（分页，可按类型筛选）
      GET/api/firearms/:id按 ID 获取枪械详情
      POST/api/firearms创建新枪械
      PUT/api/firearms/:id更新枪械信息
      DELETE/api/firearms/:id删除枪械

      改装

      方法路径描述
      GET/api/modifications改装列表（分页，可按枪械和标签筛选）
      GET/api/modifications/:id按 ID 获取改装详情
      POST/api/modifications创建改装
      POST/api/modifications/batch批量创建改装
      PUT/api/modifications/:id更新改装
      DELETE/api/modifications/:id删除改装
      DELETE/api/modifications/batch-delete批量删除改装

      标签

      方法路径描述
      GET/api/tags获取所有标签

      前端路由

      路径布局页面描述
      /主布局枪械浏览首页 — 枪械列表
      /firearms主布局枪械浏览枪械详情与搜索
      /mod-codes主布局改装代码改装代码库
      /legal主布局法律信息法律与隐私信息
      /login空白布局登录用户认证页面

      前端状态管理

      Redux Toolkit 结合 Redux Persist 管理以下状态：

      • 认证状态 — Access token、refresh token、用户信息
      • 设置状态 — 用户偏好，持久化至本地存储

      API 客户端

      前端使用基于 Axios 封装的共享 WebClient，提供以下能力：

      • 基础 URL 配置（指向后端 API）
      • 通过请求拦截器自动注入 JWT access token
      • 在收到 401 响应时自动刷新 token

      基础设施

      组件技术
      数据库PostgreSQL（使用 Flyway 进行数据库迁移）
      缓存Redis（会话和 token 存储）
      文件存储AWS S3（枪械图片）
      容器化Docker
      部署Docker Compose + Nginx