登录权限返回修改

openspec/changes/archive/2026-01-30-login-response-menus-buttons/proposal.md

@@ -0,0 +1,51 @@
+## Why
+
+当前登录接口只返回扁平的权限码列表 `permissions: []`，前端需要额外处理才能渲染侧边栏菜单（需要树形结构）和控制按钮显示（需要按钮权限列表）。这导致前端需要额外请求菜单接口或在本地维护菜单配置，增加了复杂度和请求次数。通过在登录时直接返回分类好的菜单树和按钮权限，前端可以一次性获取所有必要数据并存储到 localStorage，无需二次请求，简化前端实现并提升用户体验。
+
+## What Changes
+
+- 在 `LoginResponse` DTO 中新增两个字段：
+  - `menus: []MenuNode` - 菜单树（树形结构）
+  - `buttons: []string` - 按钮权限码列表（扁平）
+- 新增 `MenuNode` DTO 结构体，包含 `id`, `perm_code`, `name`, `url`, `sort`, `children` 字段
+- 修改 `auth.Service.Login()` 方法，新增权限分类逻辑：
+  - 基于 `perm_type` 字段分类（1=菜单权限，2=按钮权限）
+  - 根据 `device` 参数过滤平台（`platform=web/h5/all`）
+  - 构建菜单树（基于 `parent_id` 字段的递归结构）
+  - 超级管理员返回所有菜单和按钮
+- 保留原有 `permissions` 字段（向后兼容，包含所有权限码）
+- `GetMe` 接口保持不变（不返回菜单，避免频繁查询）
+
+## Capabilities
+
+### New Capabilities
+
+- `login-menu-button-response`: 登录接口返回菜单树和按钮权限，支持前端直接使用无需二次处理
+
+### Modified Capabilities
+
+（无现有能力被修改，这是新增功能）
+
+## Impact
+
+**修改的文件**：
+- `internal/model/dto/auth_dto.go` - 新增 MenuNode 结构体，修改 LoginResponse 结构体
+- `internal/service/auth/service.go` - 修改 Login() 方法，新增权限分类和菜单树构建逻辑
+
+**API 变更**（向后兼容）：
+- `POST /api/admin/login` - 响应体增加 `menus` 和 `buttons` 字段
+- `POST /api/h5/login` - 响应体增加 `menus` 和 `buttons` 字段
+- `GET /api/admin/me` - 保持不变（不返回菜单）
+- `GET /api/h5/me` - 保持不变（不返回菜单）
+
+**数据库影响**：
+- 无需修改数据库 schema（复用现有 `tb_permission` 表的 `perm_type`, `parent_id`, `platform` 字段）
+
+**前端影响**：
+- 可选升级：前端可以选择使用新的 `menus` 和 `buttons` 字段，也可以继续使用 `permissions` 字段（向后兼容）
+- 推荐使用方式：登录后将 `menus` 和 `buttons` 存储到 localStorage，页面刷新时从本地读取
+
+**性能影响**：
+- 登录响应体增大（预计增加 5-10KB，取决于权限数量）
+- 菜单树构建计算量增加（O(n) 复杂度，n 为权限数量，通常 < 100）
+- 不影响 GetMe 接口性能（未修改）