chore(config): 同步 src/ 路径迁移 + nginx SPA 路由 + 文档图简化
**src/ 路径迁移配套**：
- docker-compose.yml: backend context ./backend → ./src/backend
- docker-compose.yml: bind mount ./app → ./src/backend/app
- docker-compose.dev.yml: 3 个 bind mount 同步调整
- Dify 双路径超时从 12s 提到 20s（2026-07-20 用户反馈高峰期超时）
**nginx SPA 路由修复**（前端路由 /itagent/x → /itagent/index.html）：
- nginx/nginx.conf: 加 try_files $uri /itagent/index.html
**生产环境 nginx 反代重写**：
- deploy-server/nginx.conf: 从 33 行 localhost 模板改为 357 行完整反代
- 新增 /itdesk /itagent /itadmin /itportal /itterminal/itportal/meetingroom
路由规则
- 反代到 backend:8000 (API + WS)
- / 根路径反代到数据查询平台
**架构图简化**（精简但保留关键类/时序）：
- docs/class-diagram.mermaid: 215 行 → 59 行
- docs/sequence-diagram.mermaid: 115 行 → 35 行
合计 6 文件 + 470 行 / - 293 行
This commit is contained in:
Simon
+59
-156
@@ -1,171 +1,74 @@
|
||||
classDiagram
|
||||
direction TB
|
||||
|
||||
%% ===================== 后端 =====================
|
||||
|
||||
class SessionQueryService {
|
||||
+AsyncSession db
|
||||
+__init__(db: AsyncSession)
|
||||
+get_conversations(status, agent_id, page, page_size) Tuple~List~Conversation~, int~
|
||||
+get_agent_conversations(agent_id, page, page_size) Tuple~List~Conversation~, int~
|
||||
+get_conversation(conversation_id, include_messages) Conversation
|
||||
+get_employee_history_messages(employee_id, limit, before, current_conversation_id) Tuple~List~Message~, bool, Dict~str,str~~
|
||||
class OptionSelectPayload {
|
||||
+string conversation_id
|
||||
+string option_label
|
||||
+string option_value
|
||||
+string selected_from_message_id
|
||||
+UUID client_msg_id
|
||||
+string question_id
|
||||
+string option_id
|
||||
+validate() bool
|
||||
}
|
||||
|
||||
class Message {
|
||||
+str id
|
||||
+str conversation_id
|
||||
+str sender_type
|
||||
+str sender_id
|
||||
+str sender_name
|
||||
+str content
|
||||
+str msg_type
|
||||
+Optional~str~ reply_to_id
|
||||
+Optional~str~ media_url
|
||||
+Optional~str~ file_name
|
||||
+Optional~int~ file_size
|
||||
+Optional~Dict~ extra_data
|
||||
+bool ai_suggestion
|
||||
+str status
|
||||
+bool is_read
|
||||
+string id
|
||||
+string conversation_id
|
||||
+string sender_type
|
||||
+string sender_id
|
||||
+string content
|
||||
+string msg_type
|
||||
+dict extra_data
|
||||
+datetime created_at
|
||||
+__init__(...)
|
||||
}
|
||||
|
||||
class Conversation {
|
||||
+str id
|
||||
+str employee_id
|
||||
+str employee_name
|
||||
+str status
|
||||
+str assigned_agent_id
|
||||
+datetime last_message_at
|
||||
+str last_message_summary
|
||||
+datetime created_at
|
||||
class OptionSelectHandler {
|
||||
+__init__(session_factory, ws_manager)
|
||||
+handle(payload, employee_id) Message
|
||||
-acquire_advisory_lock(db, key) void
|
||||
-find_duplicate(db, payload) Message
|
||||
-persist(db, payload, employee_id) Message
|
||||
-to_message_dict(message, masked) dict
|
||||
}
|
||||
|
||||
class HistoryMessageListResponse {
|
||||
+List~MessageResponse~ items
|
||||
+bool has_more
|
||||
+Dict~str,str~ conversation_summaries
|
||||
class SensitiveMask {
|
||||
+mask_sensitive_text(text) string
|
||||
+mask_sensitive_value(value) string
|
||||
}
|
||||
|
||||
class MessageResponse {
|
||||
+str id
|
||||
+str conversation_id
|
||||
+str sender_type
|
||||
+str sender_id
|
||||
+str sender_name
|
||||
+str content
|
||||
+str msg_type
|
||||
+bool ai_suggestion
|
||||
+bool is_read
|
||||
+datetime created_at
|
||||
+Optional~str~ sender_avatar
|
||||
class DifyFeedbackContext {
|
||||
+string feedback_type
|
||||
+string question_id
|
||||
+string option_id
|
||||
+string option_value
|
||||
+string option_label
|
||||
+to_inputs() dict
|
||||
}
|
||||
|
||||
%% 后端关系
|
||||
SessionQueryService ..> Message : 查询
|
||||
SessionQueryService ..> Conversation : 查询
|
||||
HistoryMessageListResponse *-- MessageResponse : contains
|
||||
Message }--|| Conversation : belongs to
|
||||
|
||||
%% ===================== 前端 API 层 =====================
|
||||
|
||||
class MessageAPI {
|
||||
<<module: frontend-agent/src/api/message.ts>>
|
||||
+getMessages(conversationId, params) Promise~MessageListData~
|
||||
+sendMessage(conversationId, content, msgType, options) Promise~Message~
|
||||
+pollMessages(conversationId, afterMessageId) Promise~MessageListData~
|
||||
+getHistoryMessages(employeeId, params) Promise~HistoryMessageListData~
|
||||
class SelectedOptionsSnapshotBuilder {
|
||||
+__init__(db)
|
||||
+build(conversation_id) list
|
||||
}
|
||||
|
||||
class HistoryMessageListData {
|
||||
<<TypeScript interface>>
|
||||
+Message[] items
|
||||
+bool has_more
|
||||
+Record~str,str~ conversation_summaries
|
||||
class ConnectionManager {
|
||||
+dict active_connections
|
||||
+dict employee_connections
|
||||
+__init__()
|
||||
+broadcast(data) void
|
||||
+broadcast_to_employees(ids, data) void
|
||||
}
|
||||
|
||||
MessageAPI ..> HistoryMessageListData : returns
|
||||
MessageAPI ..> BackendAPI : HTTP GET
|
||||
|
||||
%% ===================== 前端 Store 层 =====================
|
||||
|
||||
class ConversationStore {
|
||||
<<Pinia Store>>
|
||||
%% 现有状态
|
||||
+Ref~Conversation[]~ conversations
|
||||
+Ref~str~ currentConversationId
|
||||
+Ref~Message[]~ messages
|
||||
+Ref~bool~ loadingMessages
|
||||
|
||||
%% 新增：历史模式状态
|
||||
+Ref~bool~ historyMode
|
||||
+Ref~Message[]~ historyMessages
|
||||
+Ref~bool~ historyLoading
|
||||
+Ref~bool~ historyHasMore
|
||||
+Ref~Record~str,str~~ historyConversationSummaries
|
||||
+Ref~str~ historyCursor
|
||||
|
||||
%% 新增：计算属性
|
||||
+Computed~Message[]~ displayMessages
|
||||
+Computed~bool~ isHistoryReadonly
|
||||
|
||||
%% 现有方法
|
||||
+fetchConversations() void
|
||||
+selectConversation(conversationId) void
|
||||
+fetchMessages(conversationId) void
|
||||
+sendReply(content, replyToId) void
|
||||
|
||||
%% 新增：历史模式方法
|
||||
+enableHistoryMode() Promise~void~
|
||||
+disableHistoryMode() void
|
||||
+loadMoreHistory() Promise~void~
|
||||
+resetHistoryState() void
|
||||
+Message[] messages
|
||||
+sendOptionSelect(selection) void
|
||||
+handleNewMessage(data) void
|
||||
+latestSelection(question_id) Message
|
||||
}
|
||||
|
||||
ConversationStore ..> MessageAPI : calls
|
||||
ConversationStore ..> Message : manages
|
||||
|
||||
%% ===================== 前端组件层 =====================
|
||||
|
||||
class UserInfoBar {
|
||||
<<Vue Component>>
|
||||
+Props: conversation, availableAgents, canInviteCollaborator
|
||||
+Emits: assign, resolve, toggle-pin, toggle-todo, transfer, invite
|
||||
+Emits: toggle-history %% 新增
|
||||
+resetForNewConversation() void
|
||||
%% 新增：历史开关三态
|
||||
+historyToggleClass: Computed~string~
|
||||
}
|
||||
|
||||
class ChatArea {
|
||||
<<Vue Component>>
|
||||
+conversationStore: ConversationStore
|
||||
+messageListRef: Ref~HTMLElement~
|
||||
%% 新增：渲染逻辑
|
||||
+renderedItems: Computed~Array~
|
||||
+handleToggleHistory() void
|
||||
+handleScrollUp() void
|
||||
%% 修改：displayMessages 替代 messages
|
||||
}
|
||||
|
||||
class ConversationSeparator {
|
||||
<<Vue Component — 新增>>
|
||||
+Props: summary: string
|
||||
+Props: isCurrent: boolean
|
||||
%% 纯展示组件，无 emit
|
||||
}
|
||||
|
||||
class MessageBubble {
|
||||
<<Vue Component — 已存在>>
|
||||
+Props: message: Message
|
||||
+Emits: reply, scroll-to-message
|
||||
+Message message
|
||||
+isLatestSelection() bool
|
||||
+maskedContent() string
|
||||
}
|
||||
|
||||
%% 组件关系
|
||||
ChatArea ..> ConversationStore : uses
|
||||
ChatArea ..> UserInfoBar : contains
|
||||
ChatArea ..> ConversationSeparator : renders
|
||||
ChatArea ..> MessageBubble : renders
|
||||
UserInfoBar --|> ChatArea : child component
|
||||
ConversationSeparator --|> ChatArea : child component
|
||||
OptionSelectHandler --> OptionSelectPayload : validates
|
||||
OptionSelectHandler --> Message : creates/returns
|
||||
OptionSelectHandler --> SensitiveMask : masks outbound data
|
||||
OptionSelectHandler --> ConnectionManager : broadcasts
|
||||
OptionSelectHandler --> DifyFeedbackContext : creates after commit
|
||||
SelectedOptionsSnapshotBuilder --> Message : queries latest per question
|
||||
ConversationStore o-- Message : stores
|
||||
MessageBubble --> ConversationStore : derives latest
|
||||
MessageBubble --> Message : renders
|
||||
|
||||
Reference in New Issue
Block a user