Simon
400ce3ddcb
OTP首次绑定: - 新增统一 OTP 路由 /auth/otp-* (otp.py + router.py) - 坐席端 OTP 绑定面板 (OtpBindPanel.vue) - 管理端 OTP 管理列表 (MfaManage.vue) - agent_login 签发半认证 token 支持首次绑定流程 三端登录修复: - 坐席/管理端去掉'返回扫码登录'按钮 - 管理端改为二维码始终可见+轮询扫码状态 - 员工端 /itdesk/ 改为 alias 直接服务 H5 (不再301重定向) - docker-compose 添加 h5 volume 挂载 管理端权限修复: - 扫码登录改用 get_user_roles() 替代写死 roles=['agent'] - get_user_roles() 增加 agents.role 回退 - 新增 GET /admin/roles/user-roles 端点 - 角色管理页加载用户角色分配数据 文档更新: - OTP PRD + 系统设计文档 - 故障排查手册 v1.1 (新增6案例) - nginx 生产基准配置
03-技术架构 目录说明
本目录存放 IT 智能服务台项目的技术架构相关文档。
目录结构
03-技术架构/
├── 00-系统架构设计文档-v1.3.md # 主文档：系统架构总览（v1.3）
├── 01-ADRs-架构决策/ # 架构决策记录 (ADR)
├── 02-技术方案/ # 技术方案文档
├── 03-技术分析/ # 技术分析报告
├── 04-数据库设计/ # 数据库设计
├── 05-架构图/ # Mermaid 图表
└── archive/ # 归档目录：已废弃/旧版文档
文档清单
01-ADRs-架构决策/
| 文档 | 说明 |
|---|---|
| ADR-001-Gitea自托管-Funnel暴露.md | 架构决策 #001 |
| ADR-002-WS-Token-Subprotocol鉴权.md | 架构决策 #002 |
| ADR-003-nginx-access_log关闭.md | 架构决策 #003 |
| ADR-004-Token不入文件-走wincred.md | 架构决策 #004 |
02-技术方案/
| 文档 | 说明 |
|---|---|
| 技术方案-ExternalSystemAdapter抽象层.md | 外部系统适配器设计 |
| 技术方案-消息功能详细设计.md | 消息功能详细设计 |
| 技术方案-摇人协作.md | 摇人功能技术方案 |
| 技术方案-邀请功能.md | 邀请功能技术方案 |
| 技术方案-复杂场景重构.md | 复杂场景重构方案 |
03-技术分析/
| 文档 | 说明 |
|---|---|
| 技术分析-架构消息知识库迭代.md | 架构消息知识库迭代分析 |
| 技术分析-H5右侧栏动态推送评估.md | H5右侧栏动态推送评估 |
| 技术分析-jp-webcli自动化部署能力分析.md | JumpServer自动化部署分析 |
04-数据库设计/
| 文档 | 说明 |
|---|---|
| 数据库设计-ER图与环境变量清点.md | 数据库ER图与环境变量 |
05-架构图/
| 文档 | 说明 |
|---|---|
| class-diagram.mermaid | 核心类图 |
| sequence-diagram.mermaid | 核心序列图 |
| sequence-scoring.mermaid | 评分序列图 |
| sequence-polling.mermaid | 轮询序列图 |
| sequence-shake.mermaid | 摇人序列图 |
| admin-class-diagram.mermaid | 管理端类图 |
| admin-login-sequence.mermaid | 管理端登录序列图 |
| admin-config-change-sequence.mermaid | 配置变更序列图 |
| admin-quick-reply-review-sequence.mermaid | 快速回复审核序列图 |
最后更新: 2026-07-04