Để theo dõi hoặc sửa đổi hệ thống, hãy tham chiếu đến các tệp mã nguồn chính sau trong thư mục `backend/`:

### 1. Luồng V1 (Data Analyst)
- **Routing API:** `api/api_sql/sql_chat_route.py`
  Chứa Prompt quy định 25 loại biểu đồ và JSON Output. Chứa hàm SSE Stream `sql_dashboard_stream`.
- **Agent Trace Routing:** `api/api_sql/ai_sql_trace_route.py`
  Xử lý luồng Multi-step (Max 4 chu kỳ) và kết hợp phê duyệt của người dùng (Approve/Reject).
- **Core Logic:** `agent/sql_agent/core.py`
  Chứa hàm `validate_sql` (phòng chống SQL Injection), trình tóm tắt kết quả bảng `summarize_results` và bộ thực thi công cụ `exec_tool`.

### 2. Luồng V2 (Vector RAG Chatbot)
- **Agent Logic:** `agent/text_to_sql.py`
  Chứa luồng 3 bước: `embed_question`, `vector_search` trên StarRocks và `generate_response` bằng model LLM tối ưu độ trễ (`gemini-3.1-flash-lite-preview`).
- **Routing V2:** `api/api_sql/text_to_sql_route.py`
  Bọc lại agent V2 thành REST API.

### 3. Database
- **StarRocks Wrapper:** `common/starrocks_connection.py`
- **Postgres Wrapper:** `common/postgres_readonly.py`
- **Embedding:** `common/embedding_service.py`