flowchart TD
 A[用户输入自然语言查询] --> B{选择数据库连接}
 B -->|未选择| C[提示选择数据库]
 B -->|已选择| D[保存用户消息到聊天历史]
 
 D --> E[语义搜索获取相关Schema]
 E --> F[向量数据库查询]
 F --> G[相关性评分与表关联推断]
 G --> H[构建Schema上下文]
 
 H --> I[调用LLM生成SQL]
 I --> J[使用Semantic Kernel插件]
 J --> K[SQL安全检查]
 
 K -->|查询语句| L[自动执行SQL]
 K -->|操作语句| M[仅生成SQL<br/>不自动执行]
 
 L --> N{执行是否成功}
 N -->|成功| O[返回查询结果]
 N -->|失败| P[SQL优化]
 
 P --> Q[使用错误信息优化SQL]
 Q --> R[重新执行优化后SQL]
 R --> S[返回最终结果]
 
 M --> T[提示手动执行]
 O --> U[保存响应到聊天历史]
 S --> U
 T --> U
 U --> V[显示结果给用户]
 
 style A fill:#e1f5fe
 style V fill:#e8f5e8
 style K fill:#fff3e0
 style P fill:#fce4ec

flowchart TD
 A[数据库连接配置] --> B[Schema训练服务]
 B --> C[提取数据库表结构]
 C --> D[获取表/列/外键信息]
 D --> E[生成表描述文本]
 
 E --> F[文本向量化]
 F --> G[存储到向量数据库]
 
 G --> H{向量存储类型}
 H -->|SQLite| I[SQLiteMemoryStore]
 H -->|PostgreSQL| J[PostgresMemoryStore with pgvector]
 
 I --> K[Schema训练完成]
 J --> K
 
 K --> L[等待用户查询]
 L --> M[语义搜索]
 M --> N[相关性匹配]
 N --> O[返回相关表结构]
 
 style A fill:#e3f2fd
 style F fill:#f3e5f5
 style G fill:#e8f5e8
 style M fill:#fff3e0

flowchart LR
 subgraph "用户界面层"
 A[Blazor前端页面]
 B[数据库连接选择]
 C[聊天输入框]
 D[SQL结果展示]
 end
 
 subgraph "服务层"
 E[ChatService<br/>聊天服务]
 F[SchemaTrainingService<br/>Schema训练服务]
 G[SemanticService<br/>语义服务]
 H[SqlExecutionService<br/>SQL执行服务]
 I[QAExampleService<br/>问答示例服务]
 J[McpServer<br/>MCP协议服务器]
 end
 
 subgraph "数据访问层"
 K[DatabaseConnectionRepository<br/>数据库连接仓储]
 L[ChatMessageRepository<br/>聊天消息仓储]
 M[DatabaseSchemaRepository<br/>Schema仓储]
 N[SchemaEmbeddingRepository<br/>向量嵌入仓储]
 O[QAExampleRepository<br/>问答示例仓储]
 end
 
 subgraph "外部服务"
 P[OpenAI API<br/>LLM服务]
 Q[向量数据库<br/>SQLite/PostgreSQL]
 R[业务数据库<br/>多种数据库支持]
 S[MCP客户端<br/>IDE工具集成]
 end
 
 A --> E
 B --> K
 C --> E
 D --> H
 
 E --> F
 E --> G
 E --> H
 E --> L
 E --> I
 
 F --> M
 F --> N
 G --> Q
 H --> K
 H --> R
 I --> O
 J --> S
 
 E --> P
 G --> P
 
 style A fill:#e1f5fe
 style E fill:#f3e5f5
 style P fill:#fff3e0
 style Q fill:#e8f5e8
 style J fill:#fce4ec
 style I fill:#e3f2fd