flowchart TB
    subgraph EzyPlatform["EzyPlatform"]
        ADMIN["Admin plugin<br/>Cấu hình và quản trị"]
        WEB["Web plugin<br/>Web runtime"]
        SOCKET["Socket plugin<br/>Chat thời gian thực"]
        AI["EzyAI<br/>Sinh câu trả lời"]
    end

    subgraph CORE["EzyRAG SDK"]
        PIPELINE["Pipeline RAG"]
        MODELS["Mô hình dữ liệu"]
        EXTENSIONS["Các điểm mở rộng"]
    end

    EMBEDDING["Dịch vụ embedding"]
    VECTOR["Cơ sở dữ liệu vector"]
    APP_DB["Cơ sở dữ liệu ứng dụng"]
    CONTENT["Bài viết, sản phẩm,<br/>media và văn bản"]

    ADMIN --> CORE
    WEB --> CORE
    SOCKET --> CORE

    CONTENT --> PIPELINE
    PIPELINE --> EMBEDDING
    PIPELINE --> VECTOR
    PIPELINE --> APP_DB

    WEB --> AI
    SOCKET --> AI
    CORE --> AI

flowchart LR
    CLIENT["Bộ điều phối RAG"]

    CLIENT --> LOADER["Data loader"]
    CLIENT --> CLEANER["Text cleaner"]
    CLIENT --> CHUNKER["Data chunker"]
    CLIENT --> EMBEDDING["Embedding service"]
    CLIENT --> VECTOR["Vector database service"]
    CLIENT --> RETRIEVER["Data retriever"]
    CLIENT --> BUILDER["Knowledge data builder"]
    CLIENT --> SETTINGS["Setting service"]

flowchart LR
    SOURCE["Nguồn dữ liệu"] --> SELECT{"Loại nguồn"}

    SELECT -->|Văn bản| TEXT["Text loader"]
    SELECT -->|Bài viết| POST["Post loader"]
    SELECT -->|Sản phẩm| PRODUCT["Product loader"]
    SELECT -->|Media| MEDIA["Media loader"]

    TEXT --> INPUT["RAG input"]
    POST --> INPUT
    PRODUCT --> INPUT
    MEDIA --> INPUT

flowchart TD
    MEDIA["Media"] --> INFO["Đọc tiêu đề và mô tả"]
    MEDIA --> FILE{"Tệp có bộ đọc phù hợp?"}

    FILE -->|PDF| PDF["PDF reader"]
    FILE -->|DOCX| WORD["Word reader"]
    FILE -->|XLSX| EXCEL["Excel reader"]
    FILE -->|PPTX| PPT["PowerPoint reader"]
    FILE -->|Text hoặc Markdown| TEXT["Text reader"]
    FILE -->|Không| SKIP["Chỉ dùng thông tin media"]

    PDF --> BLOCKS["Các khối văn bản"]
    WORD --> BLOCKS
    EXCEL --> BLOCKS
    PPT --> BLOCKS
    TEXT --> BLOCKS

    INFO --> INPUTS["Danh sách RAG input"]
    BLOCKS --> INPUTS
    SKIP --> INPUTS

flowchart TD
    RAW["Văn bản đã làm sạch"] --> HTML["Loại bỏ HTML<br/>Giữ ranh giới khối"]
    HTML --> CHECK{"Độ dài có nằm<br/>trong giới hạn?"}

    CHECK -->|Có| SINGLE["Tạo một chunk"]
    CHECK -->|Không| PARA["Chia và ghép theo đoạn văn"]

    PARA --> LONG_PARA{"Đoạn văn quá dài?"}
    LONG_PARA -->|Không| CHUNKS["Danh sách chunk"]
    LONG_PARA -->|Có| SENTENCE["Chia và ghép theo câu"]

    SENTENCE --> LONG_SENTENCE{"Câu vẫn quá dài?"}
    LONG_SENTENCE -->|Không| CHUNKS
    LONG_SENTENCE -->|Có| HARD["Cắt theo số ký tự"]
    HARD --> CHUNKS

flowchart LR
    TEXT["Nội dung hoặc câu hỏi"] --> SERVICE["Embedding service"]
    CONFIG["Model và cấu hình"] --> SERVICE
    SIZE["Kích thước collection"] --> SERVICE
    SERVICE --> VECTOR["Vector embedding"]

flowchart LR
    CHUNK["Data chunk"] --> EMB["Embedding"]
    EMB --> POINT["Vector point"]

    POINT --> VECTOR_DB["Kho vector<br/>Vector và payload tối thiểu"]
    CHUNK --> APP_DB["Cơ sở dữ liệu ứng dụng<br/>Nội dung, hash và metadata"]

    VECTOR_DB -. "chunk ID" .-> APP_DB

sequenceDiagram
    participant A as Admin hoặc ứng dụng
    participant R as Bộ điều phối EzyRAG
    participant L as Data loader
    participant C as Cleaner và chunker
    participant D as Cơ sở dữ liệu
    participant E as Embedding service
    participant V as Kho vector

    A->>R: Lập chỉ mục nguồn vào collection
    R->>L: Nạp dữ liệu theo loại nguồn
    L-->>R: Một hoặc nhiều đầu vào

    loop Mỗi đầu vào
        R->>C: Làm sạch và chia đoạn
        C-->>R: Danh sách chunk

        loop Mỗi chunk
            R->>D: Tìm chunk cũ theo nguồn và vị trí
            D-->>R: Hash và embedding hiện có
            R->>D: Lưu nội dung cùng metadata

            alt Nội dung mới hoặc đã thay đổi
                R->>E: Tạo embedding
                E-->>R: Vector
                R->>D: Lưu embedding
            else Nội dung không đổi
                R->>R: Tái sử dụng embedding
            end

            R->>V: Upsert vector point
        end
    end

    R->>D: Xóa các chunk cũ nằm ngoài phiên bản mới

sequenceDiagram
    participant U as Người dùng
    participant AI as EzyAI
    participant R as EzyRAG
    participant Q as Query processor
    participant E as Embedding service
    participant V as Kho vector
    participant D as Cơ sở dữ liệu
    participant B as Knowledge builder

    U->>AI: Gửi câu hỏi
    AI->>R: Tìm tri thức
    R->>Q: Chuẩn hóa câu hỏi
    Q-->>R: Truy vấn đã xử lý
    R->>E: Tạo embedding truy vấn
    E-->>R: Vector truy vấn
    R->>V: Tìm kiếm trong collection
    V-->>R: Danh sách chunk ID
    R->>D: Lấy chunk và metadata
    D-->>R: Các tài liệu liên quan
    R->>B: Chuyển thành KnowledgeData
    B-->>R: Ngữ cảnh cho AI
    R-->>AI: Danh sách tri thức
    AI-->>U: Sinh câu trả lời

flowchart TB
    CONFIG["Cấu hình"] --> MANAGERS["Các manager"]

    MANAGERS --> L["Data loader"]
    MANAGERS --> C["Text cleaner"]
    MANAGERS --> H["Data chunker"]
    MANAGERS --> E["Embedding service"]
    MANAGERS --> Q["Query processor"]
    MANAGERS --> V["Vector database service"]
    MANAGERS --> R["Data retriever"]
    MANAGERS --> K["Knowledge data builder"]

    CUSTOM["Implementation mở rộng"] -. "Đăng ký qua dependency container" .-> MANAGERS

flowchart LR
    ADMIN["Quản trị viên"] --> UI["Giao diện quản trị"]
    UI --> API["API quản trị"]
    API --> SETTINGS["Cấu hình"]
    API --> COLLECTIONS["Quản lý collection"]
    API --> INDEXING["Lập chỉ mục dữ liệu"]
    API --> SEARCH["Kiểm tra tìm kiếm"]

flowchart LR
    CLIENT["Ứng dụng chat"] --> SOCKET["Socket runtime"]
    SOCKET --> AI["EzyAI"]
    AI --> SOURCE["Nguồn tri thức EzyRAG"]
    SOURCE --> SEARCH["Tìm kiếm vector"]
    SEARCH --> CONTEXT["Các đoạn liên quan"]
    CONTEXT --> AI
    AI --> SOCKET
    SOCKET --> CLIENT

flowchart LR
    CONTENT["Nội dung website"] --> RAG["EzyRAG<br/>Chuẩn bị và truy hồi tri thức"]
    QUESTION["Câu hỏi"] --> RAG
    RAG --> CONTEXT["Ngữ cảnh liên quan"]
    CONTEXT --> AI["EzyAI<br/>Điều phối LLM và sinh câu trả lời"]
    QUESTION --> AI
    AI --> ANSWER["Câu trả lời"]