v3.1 + 批次0: 智能回复重构基线 - ApprovalMatcher + 关键词降级 + 文档速修 + v4.0任务书面化
This commit is contained in:
Simon
+158
-58
@@ -1,71 +1,171 @@
|
||||
# 代办事项类图
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class TodoSourceService {
|
||||
<<abstract>>
|
||||
+agent_userid: str
|
||||
+redis: aioredis.Redis
|
||||
+get_todo_list() List~TodoItemData~*
|
||||
+get_todo_detail(item_id: str) TodoItemData*
|
||||
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 ApprovalTodoService {
|
||||
-redis: aioredis.Redis
|
||||
-agent_userid: str
|
||||
-semaphore: asyncio.Semaphore
|
||||
+get_todo_list() List~TodoItemData~
|
||||
+get_todo_detail(sp_no: str) TodoItemData
|
||||
-_fetch_approval_sp_no_list() List~str~
|
||||
-_fetch_approval_details(sp_no_list: List~str~) List~dict~
|
||||
-_filter_by_current_approver(details: List~dict~) List~dict~
|
||||
-_map_to_todo_item(detail: dict) TodoItemData
|
||||
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
|
||||
+datetime created_at
|
||||
}
|
||||
|
||||
class ITSMService {
|
||||
-base_url: str
|
||||
-app_id: str
|
||||
-app_secret: str
|
||||
-redis: aioredis.Redis
|
||||
-agent_userid: str
|
||||
+get_todo_list() List~TodoItemData~
|
||||
+get_todo_detail(workitem_id: str) TodoItemData
|
||||
-_do_post(url: str, body: dict) dict
|
||||
-_get_workitem_detail(process_instance_id: int, executor: str) dict
|
||||
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 ITSMSigner {
|
||||
+compute_signature(app_id: str, timestamp: str, app_secret: str, biz_data: dict) str
|
||||
-_get_signature_compatible(params: dict) str
|
||||
class HistoryMessageListResponse {
|
||||
+List~MessageResponse~ items
|
||||
+bool has_more
|
||||
+Dict~str,str~ conversation_summaries
|
||||
}
|
||||
|
||||
class TodoAggregatorService {
|
||||
-redis: aioredis.Redis
|
||||
-cache_ttl: int
|
||||
+get_todo_list(agent_userid: str, todo_type: Optional~str~) dict
|
||||
+get_todo_detail(agent_userid: str, item_id: str, todo_type: str) dict
|
||||
-_get_from_cache(agent_userid: str, todo_type: Optional~str~) Optional~dict~
|
||||
-_set_to_cache(agent_userid: str, todo_type: Optional~str~, data: dict) void
|
||||
-_invalidate_cache(agent_userid: str) void
|
||||
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 TodoItemData {
|
||||
+id: str
|
||||
+type: str
|
||||
+title: str
|
||||
+priority: str
|
||||
+description: dict
|
||||
+status: str
|
||||
+assigned_agent_id: Optional~str~
|
||||
+corp_id: str
|
||||
+created_at: str
|
||||
+updated_at: str
|
||||
%% 后端关系
|
||||
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~
|
||||
}
|
||||
|
||||
TodoSourceService <|-- ApprovalTodoService
|
||||
TodoSourceService <|-- ITSMService
|
||||
TodoAggregatorService o-- ApprovalTodoService : creates
|
||||
TodoAggregatorService o-- ITSMService : creates
|
||||
ITSMService --> ITSMSigner : uses
|
||||
TodoSourceService ..> TodoItemData : returns
|
||||
```
|
||||
class HistoryMessageListData {
|
||||
<<TypeScript interface>>
|
||||
+Message[] items
|
||||
+bool has_more
|
||||
+Record~str,str~ conversation_summaries
|
||||
}
|
||||
|
||||
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
|
||||
}
|
||||
|
||||
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
|
||||
}
|
||||
|
||||
%% 组件关系
|
||||
ChatArea ..> ConversationStore : uses
|
||||
ChatArea ..> UserInfoBar : contains
|
||||
ChatArea ..> ConversationSeparator : renders
|
||||
ChatArea ..> MessageBubble : renders
|
||||
UserInfoBar --|> ChatArea : child component
|
||||
ConversationSeparator --|> ChatArea : child component
|
||||
|
||||
Reference in New Issue
Block a user