# 用户中心

## 1. 功能模块

- 用户注册与登录

  - 支持邮箱、手机号注册
  - 支持用户名/手机号/邮箱+密码登录
  - 支持验证码登录
  - 支持第三方登录（如微信、QQ、钉钉、GitHub 等）

- 用户信息管理

  - 个人信息查看与修改（昵称、头像、联系方式等）
  - 密码修改
  - 绑定/解绑第三方账号
  - 实名认证（可选）

- 权限与角色管理

  - 用户分组与角色分配
  - 权限点管理
  - 角色权限分配
  - 支持多租户

- 安全与认证

  - JWT Token 认证
  - Session 管理
  - 登录日志与安全审计
  - 登录设备管理
  - 密码找回与重置（邮箱/短信验证码）

- 用户状态管理

  - 启用/禁用用户
  - 注销/删除账号
  - 黑名单管理

- 通知与消息
  - 站内信
  - 邮件/短信通知
  - 消息推送

## 2. 数据库设计（简要）

- 用户表（users）
- 用户扩展信息表（user_profiles）
- 角色表（roles）
- 权限表（permissions）
- 用户-角色关联表（user_roles）
- 角色-权限关联表（role_permissions）
- 第三方账号表（user_oauth）
- 登录日志表（login_logs）

## 3. API 设计

### 用户注册与登录

- POST `/api/user/register` 用户注册
- POST `/api/user/login` 用户登录
- POST `/api/user/login/code` 验证码登录
- POST `/api/user/login/oauth` 第三方登录
- POST `/api/user/logout` 用户登出

### 用户信息管理

- GET `/api/user/profile` 获取个人信息
- PUT `/api/user/profile` 修改个人信息
- POST `/api/user/password/change` 修改密码
- POST `/api/user/password/reset` 密码重置
- POST `/api/user/bind_oauth` 绑定第三方账号
- POST `/api/user/unbind_oauth` 解绑第三方账号
- POST `/api/user/verify_identity` 实名认证

### 权限与角色管理

- GET `/api/user/roles` 获取当前用户角色
- GET `/api/user/permissions` 获取当前用户权限点
- GET `/api/roles` 获取所有角色列表
- POST `/api/role` 新增角色
- POST `/api/role/assign` 分配角色给用户
- GET `/api/permissions` 获取所有权限点
- POST `/api/permission` 新增权限点
- POST `/api/role/permission/assign` 分配权限点给角色

### 安全与认证

- GET `/api/user/login_logs` 获取登录日志
- GET `/api/user/devices` 获取登录设备列表
- POST `/api/user/device/logout` 注销指定设备
- POST `/api/user/blacklist/add` 加入黑名单
- POST `/api/user/blacklist/remove` 移除黑名单

### 用户状态管理

- POST `/api/user/enable` 启用用户
- POST `/api/user/disable` 禁用用户
- POST `/api/user/delete` 注销/删除账号

### 通知与消息

- GET `/api/user/messages` 获取站内信列表
- POST `/api/user/message/read` 标记消息为已读
- GET `/api/user/notifications` 获取通知列表

---

### 多租户支持（Multi-Tenancy）

#### 1. 租户管理

- GET `/api/tenants`  
  租户列表（分页、条件查询）

- POST `/api/tenants`  
  新增租户

- GET `/api/tenants/{id}`  
  获取租户详情

- POST `/api/tenants/{id}/update`  
  修改租户信息

- POST `/api/tenants/{id}/delete`  
  删除租户

- POST `/api/tenants/import`  
  批量导入租户

- GET `/api/tenants/export`  
  租户数据导出

---

#### 2. 租户下的用户与资源

- GET `/api/tenants/{tenant_id}/users`  
  获取租户下用户列表（分页）

- POST `/api/tenants/{tenant_id}/users/batch`  
  批量新增租户用户

- GET `/api/tenants/{tenant_id}/roles`  
  获取租户下角色列表

- POST `/api/tenants/{tenant_id}/roles/batch`  
  批量新增租户角色

- GET `/api/tenants/{tenant_id}/permissions`  
  获取租户下权限点列表

- 其他资源（如机构、部门、日志等）均可按 `/api/tenants/{tenant_id}/resource` 方式设计

---

#### 3. 用户与租户关系

- GET `/api/users/{id}/tenants`  
  获取用户所属租户列表

- POST `/api/users/{id}/tenants/assign`  
  分配用户到租户  
  Body: 租户 ID 数组

---

#### 4. 说明

- 所有与租户相关的资源操作均以 `/api/tenants/{tenant_id}/...` 作为前缀，确保数据隔离。
- 超级管理员可管理所有租户，租户管理员仅能管理本租户下资源。
- 用户登录后，需带上当前租户 ID（如 Header: `X-Tenant-Id`）进行资源访问。

如需继续细化某一模块或添加其他接口，请随时告知！

## 4. 安全与合规

- 密码加密存储（如 bcrypt）
- 防止暴力破解（登录限流、验证码）
- 敏感操作二次验证
- 数据合规（如 GDPR，用户可导出/删除个人数据）

## 5. 其他建议

- 支持多语言
- 支持多终端（Web、App、小程序）
- 详细的接口文档（Swagger/OpenAPI）
- 单元测试与接口测试覆盖

---

如需详细到每个接口的参数、返回值、流程图或数据库表结构设计，请告知！