# 6.15 首页与个人中心

:::tip 概述
index 模块（无表，聚合 user/menu）提供个人中心五接口：当前用户信息（超管返回通配权限）、菜单树、修改密码、更新个人信息。路由前缀 /api/index，登录即可（无 permission 节点）。
:::

## 接口清单

| 方法 | 路由 | 权限 | 说明 |
|------|------|------|------|
| GET | /api/index/getUser | 登录即可 | 当前用户信息（超管返回 `*:*:*`） |
| GET | /api/index/getMenus | 登录即可 | 当前用户菜单树（前端 common 菜单调用） |
| GET | /api/index/getMenus/:id | 登录即可 | 同上（system/menu 页面调用） |
| PUT | /api/index/updatePassword | 登录即可 | 修改个人密码（旧密码校验） |
| PUT | /api/index/updateProfile | 登录即可 | 更新个人信息 |

## GetUser（当前用户信息）

```text
数据来源与安全边界：
  * 用户行经 dao.User.Ctx（自动过滤软删/租户）；password/salt 永不返回
  * Roles/Perms 优先取 JWT 中间件注入的 ctx（与鉴权同源），为空时回源 LoadIdentity
  * 超管强制 perms=["*:*:*"]（前端据此放开全部按钮）
  * 头像经 upload.GetFileUrl 补域名
  * 城市编码四列（province/city/district/street_code）组装为 city[] 数组；
    city_info 为空时用 ResolveCityNames 按编码回填名称
```

## GetMenus（菜单树）

```text
两条路由共用 getMenuTree：
  * 仅取 type=0（目录/菜单）且 status=0 且 hide=0 的节点
    ——按钮权限节点不进菜单树，由 GetUser.permissions 下发
  * 超管全量；其余 user→user_role→role_menu→menu.id IN(...) 授权过滤
  * 无角色返回空树（[] 非 null）
  * 挂树规则：父节点不在授权集合内（未授权/顶级）一律挂根，避免菜单丢失
  * 排序 sort,id（根级再按 sort+id 兜底稳定排序）
```

## UpdatePassword（修改密码）

```text
流程：
  1) 只取 id/password/salt 三列
  2) 旧密码 IsBcrypt + VerifyPassword 校验（错误 1012 原密码错误）
  3) 事务外 GenerateSalt + HashPassword（CPU 密集预计算）
  4) Update 覆盖 password/salt（update_user/time 由 hooks 盖章）

注意：改密后未强制下线（令牌仍有效至过期）；
     如需立即失效可配合在线用户强退（见 6.16 在线用户监控）
```

## UpdateProfile（更新个人信息）

```text
流程：
  * 头像 SaveFileField(avatar, "user") 临时转正
  * 城市优先由编码数组经 ResolveCityNames 解析名称覆盖 city_info
  * 四列编码经 cityCodeAt(req.City, i) 取值写入
安全边界：不触达 username/password/tenant 等敏感列
```

## 前端消费

```text
登录后首页 dashboard：调 getUser（头像/名称/权限）+ getMenus（侧边菜单）
路由守卫：动态路由由 getMenus 生成（见 9.5 路由与动态菜单）
个人中心页：updateProfile（资料）/ updatePassword（改密）
```

## 排障

| 症状 | 原因 |
|------|------|
| 菜单为空 | 无角色或角色未勾选菜单；超管应返回全量 |
| getUser 权限缺失 | 身份缓存异常；超管应返回 `*:*:*` |
| 改密后旧令牌仍可用 | 设计预期（不强制下线）；配合在线用户强退 |
| 头像不显示 | upload.GetFileUrl 域名配置（file.domainUrl）与静态服务根 |