用户管理
用户管理
用户管理是欣悦互通后台的核心模块，用于管理系统用户账号、查看个人偏好、接收通知以及追溯操作记录。管理员可以在此创建用户、分配角色，普通用户则可调整个人偏好和查看通知。
本分类将围绕用户账号全生命周期展开，涵盖用户创建、角色权限、多租户管理以及 API 密钥四方面内容。
学习路径
建议按以下顺序阅读，每篇约 2-3 分钟。
1. 用户管理
管理系统用户列表，创建新用户并配置基本信息、角色，查看用户偏好、通知和活动日志。
- 文档：用户管理（本页）
2. 角色与权限
理解基于 sys_user_role 表实现的 RBAC 权限体系，创建角色、分配权限与菜单，通过版本体系管理功能范围。
- 文档：角色与权限
3. 多租户管理
管理租户和域名配置，实现多租户数据隔离与品牌定制。
- 文档：多租户管理
4. API 密钥管理
创建和管理 API 密钥，用于程序化访问欣悦互通 API。
- 文档：API 密钥管理
5. SSO 单点登录
企业版钉钉 / 企业微信 / OIDC 配置与使用。
- 文档：SSO 单点登录
6. 部门管理
企业版部门树与数据权限。
- 文档：部门管理
7. 审计日志
操作审计与变更对比。
- 文档：审计与活动日志
用户列表与搜索
登录管理后台后，进入「系统管理 → 用户管理」即可看到当前租户下的所有用户列表。
- 在用户列表页顶部搜索框中输入用户名、邮箱或手机号。
- 点击「查询」按钮筛选结果。
- 列表支持按创建时间、最近登录时间排序。
- 点击表头可切换升序/降序排列。
!TIP 列表默认按创建时间倒序展示，最新创建的用户排在最前。支持分页浏览，默认每页 20 条。
创建用户
- 在用户列表页点击右上角「新增」按钮。
- 在弹窗中填写以下信息：
- 用户名（必填，唯一）
- 邮箱（必填，唯一）
- 手机号（选填）
- 初始密码（必填）
- 角色（必选，可多选）
- 点击「确定」保存。
系统将调用 POST /api/system/users 创建用户，创建后该用户即可使用账号登录。
!WARNING 初始密码请使用强密码（至少 8 位，包含大小写字母、数字和特殊字符），建议用户首次登录后立即修改。
编辑用户信息
- 在用户列表中找到目标用户，点击操作列的「编辑」。
- 在编辑弹窗中可修改：邮箱、手机号、角色、启用状态。
- 点击「确定」保存修改。
如需重置用户密码，可在编辑弹窗中点击「重置密码」，系统将生成临时密码并发送至用户邮箱。
用户偏好设置
每个用户可在「个人中心 → 偏好设置」中调整个人偏好，包括：
- 界面语言（中文/英文）
- 主题模式（亮色/暗色/跟随系统）
- 布局偏好（侧边栏模式、顶栏模式等）
- 通知接收方式（站内、邮件、短信）
偏好设置通过 GET/PUT /api/preferences 读写，数据保存在用户维度，不影响其他用户。
!NOTE 偏好设置是用户私有的，管理员无法查看或修改其他用户的偏好设置。
通知系统
通知系统用于向用户推送系统消息、配额预警、任务完成等通知。
- 进入「个人中心 → 通知」查看通知列表。
- 单条通知可点击「标记已读」按钮标记为已读。
- 点击「全部标记已读」一次性将所有未读通知标记为已读。
- 未读通知数量会显示在顶部导航栏的铃铛图标上。
通知支持以下类型：
- 系统通知（版本更新、维护公告）
- 配额预警（API 用量接近上限）
- 任务完成（GEO 分析、内容发布完成）
- Agent 与工作流进度更新
活动日志查看
活动日志记录用户在系统中的关键操作，便于审计和追溯。
- 进入「系统管理 → 活动日志」查看日志列表。
- 支持按操作类型、操作人、时间范围筛选。
- 每条日志记录包含：操作时间、操作人、操作类型、操作内容、IP 地址。
活动日志通过 GET /api/activity-log 查询，POST /api/activity-log 由系统自动写入（前端埋点），无需手动创建。
!TIP 活动日志默认保留 90 天，超过 90 天的日志将自动归档。如需查询更早的日志，请联系系统管理员。
当前用户信息接口
调用 GET /api/user/info 可获取当前登录用户的完整身份信息，返回字段包括：
| 字段 | 说明 |
|---|---|
userType | 用户类型（个人/企业） |
tenantId | 所属租户 ID |
planId | 当前订阅套餐 ID |
agentId | 关联代理商 ID（无代理商时为空） |
companyId | 企业 ID（企业用户时有值） |
前端通过该接口获取用户身份后，可据此控制页面功能展示和权限校验。
代理商代客操作
代理商可通过 HTTP 请求头 X-Customer-User-Id 指定目标客户 ID，以该客户身份执行操作，实现代客管理功能。系统后端将自动校验代理商与客户的归属关系，确保操作合规。