Nền tảng RAG cấp doanh nghiệp: Phân quyền theo workspace, truy hồi lai Dense + Sparse + Graph, phê duyệt văn bản BPMN 2 cấp và hồ dữ liệu Lakehouse DuckDB — Vận hành hoàn toàn trên hạ tầng của bạn.
Chọn kịch bản nghiệp vụ để kiểm tra:
Chưa chọn trích dẫn
Nhấp vào nhãn [S1] hoặc [S2] ở câu trả lời bên cạnh để xem trích đoạn và độ tin cậy.
cp .env.production.example .env.productionchmod 600 .env.production# Cấu hình khóa bảo mật TOKEN_KEY & thông số database...docker compose -f docker-compose.prod.yml --env-file .env.production up -d --build# Cổng biên APISIX sẵn sàng tại :8088 → Mở /setupGiải pháp Cốt lõi
Không quảng cáo mơ hồ: Đây là các cơ chế kỹ thuật thực tế vận hành trong repo, mỗi phát biểu đều được kiểm chứng trong tài liệu kiến trúc.
OpenVie tổng hợp câu trả lời dựa trên kho tri thức workspace của bạn, đánh dấu nguồn trích dẫn [S1] đến từng đoạn tài liệu cụ thể. Khi không tìm thấy bằng chứng đối chiếu, hệ thống kích hoạt cơ chế từ chối (Abstention) thay vì suy đoán.
Toàn bộ mô hình AI chạy cục bộ qua Ollama (chat Vylinh ~3B; embedding BGE-M3). Nền tảng tự lưu trữ trọn gói trên máy chủ vật lý hoặc hạ tầng riêng của tổ chức, không rò rỉ bất kỳ byte dữ liệu nào ra bên ngoài.
Tích hợp sẵn engine Flowable BPMN nhúng cho quy trình phê duyệt tài liệu 2 cấp: cấp 1 WORKSPACE_ADMIN, cấp 2 ORG_OWNER. Hỗ trợ thiết lập SLA tự động, chống tự phê duyệt và lưu vết audit log bất biến.
Kiến trúc & Luồng Dữ liệu
Hệ thống đa tầng chuẩn microservices: Phân tách rõ ràng giữa mặt phẳng điều khiển, mặt phẳng dữ liệu và mặt phẳng suy luận AI.
RESTful HTTP JSON, SSE StreamingLõi quản trị trạng thái nghiệp vụ, phân quyền đa tenant 3 vai trò, phiên chat bảo mật, quản lý API key M2M ovk_ và phát Webhook ký số HMAC.
Sở hữu toàn quyền PostgreSQL OLTP
✓ Tuân thủ nghiêm ngặt nguyên tắc Single Source of Truth, không xảy ra xung đột trạng thái.
Quản trị trạng thái nghiệp vụ, phân quyền RBAC đa tenant, phiên chat bảo mật và thực thi quy trình phê duyệt Flowable BPMN trên PostgreSQL.
Đảm trách truy hồi đa tầng (Vector Qdrant + Graph Kùzu) và suy luận mô hình ngôn ngữ cục bộ, tuyệt đối không giữ trạng thái nghiệp vụ.
Lưu trữ tệp gốc an toàn và đóng gói Lakehouse Parquet nén Snappy theo phân vùng tenant/năm/tháng.
Thực thi truy vấn OLAP phân tích trên hồ dữ liệu Parquet với tốc độ cao, không gây ảnh hưởng đến hiệu năng của PostgreSQL OLTP.
Chuẩn kiến trúc theo tài liệu kỹ thuật docs/ARCHITECTURE.md §1 §3
Năng lực Nền tảng
Toàn bộ tính năng được tối ưu cho ngôn ngữ tiếng Việt và tuân thủ các tiêu chuẩn lưu trữ nội bộ khắt khe.
Tương tác hỏi đáp trên kho tài liệu workspace qua luồng SSE streaming tốc độ cao. Mọi phản hồi đều gắn thẻ trích dẫn chính xác và tự động từ chối khi không có tài liệu chứng minh.
Dung hợp sức mạnh của Vector BGE-M3, tìm kiếm từ khóa BM25 và Đồ thị tri thức Kùzu. Tự động viết lại câu hỏi nối tiếp và kết hợp kết quả qua thuật toán Reciprocal Rank Fusion (RRF).
Xử lý bất đồng bộ PDF, DOCX, TXT, MD, HTML, XLSX, CSV với kiểm tra mã băm SHA-256 chống trùng lặp. Hỗ trợ kích hoạt mô-đun OCR cho tài liệu quét và ASR nhận diện âm thanh/video khi cần.
Tích hợp trực tiếp engine Flowable BPMN nhúng. Quản trị vòng đời tài liệu với SLA tự động (24h nhắc / 48h leo thang), chống tự duyệt và lưu vết audit trail hoàn chỉnh.
Đăng nhập một lần Keycloak OIDC (PKCE S256) hoặc mật khẩu/JWT. Ánh xạ vai trò IdP sang 3 cấp RBAC chuẩn: ORG_OWNER, WORKSPACE_ADMIN, MEMBER. Cấp phát API key máy (M2M) ovk_ bảo mật.
Thu thập dữ liệu thời gian thực (CDC) qua RabbitMQ ghi định dạng Snappy Parquet trên SeaweedFS S3. DuckDB nhúng cho phép chạy báo cáo và phân tích SQL chuyên sâu mà không làm chậm hệ thống chính.
100% năng lực hệ thống cung cấp qua RESTful API chuẩn /api/v1/**. Hỗ trợ Webhook ký số HMAC-SHA256 thông báo sự kiện tài liệu/quy trình với cơ chế outbox retry tự động.
Cổng biên APISIX kiểm soát tần suất truy cập theo route, thiết lập security headers (HSTS, CSP). ClamAV quét luồng byte INSTREAM cách ly mã độc ngay tại cửa ngõ trước khi lưu trữ.
Bảo mật & Chủ quyền
Được thiết kế đáp ứng các tiêu chuẩn khắt khe của doanh nghiệp, tập đoàn và khối cơ quan quản lý:
Văn bản (PDF, DOCX...) được kiểm tra mã độc ClamAV và gắn trạng thái PENDING_STAGE1.
Quản trị viên workspace rà soát nội dung. Luật chống tự phê duyệt ngăn người tải lên tự duyệt.
Chủ quản tổ chức ra quyết định cuối cùng. Bản ghi phê duyệt được ký số vào audit log.
Trạng thái đổi thành APPROVED, RabbitMQ bắn sự kiện CDC sang Lakehouse và kích hoạt tạo Vector/Graph.
100% dữ liệu, chỉ mục và mô hình ngôn ngữ vận hành trong mạng nội bộ của bạn, không rò rỉ thông tin nhạy cảm.
Bộ lọc tenant_id bắt buộc trên mọi tầng lưu trữ từ PostgreSQL, Qdrant vector đến đồ thị tri thức Kùzu.
Lưu vết toàn bộ thao tác phê duyệt, truy vấn và neo mã băm SHA-256 từng phiên bản tài liệu tải lên.
ClamAV quét sạch mã độc, virus và tệp độc hại trước khi chuyển vào hàng đợi xử lý trích xuất văn bản.
Kịch bản backup.sh và restore.sh kiểm chứng toàn vẹn SHA-256, diễn tập khôi phục nhanh chóng khi có sự cố.
Kiểm soát truy cập tài nguyên nghiêm ngặt giữa Chủ sở hữu (Owner), Quản trị viên (Admin) và Thành viên (Member).
OpenVie trao quyền kiểm soát công nghệ trọn vẹn vào tay đội ngũ IT của tổ chức: Toàn quyền cấu hình chính sách lưu trữ (retention), mô hình phân vùng mạng, chứng chỉ mã hóa TLS và tích hợp hệ thống xác thực tập trung.
API & Tích hợp
Lõi OpenVie là headless: Toàn bộ năng lực nền tảng cung cấp qua chuẩn HTTP JSON tại /api/v1/**; dễ dàng tích hợp vào ứng dụng hiện hữu, DMS, ERP hoặc cổng thông tin nội bộ.
curl -X POST "$BASE/api/v1/admin/api-keys" \ -H "Authorization: Bearer $ACCESS_TOKEN" -H 'Content-Type: application/json' \ -d '{"name":"DMS-Bridge","workspaceId":"<workspace-uuid>","role":"MEMBER"}'# → Trả về 201 Created kèm key ovk_... (hiển thị 1 lần duy nhất)curl -X POST "$BASE/api/v1/chat/sessions/$SESSION_ID/messages" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H 'Content-Type: application/json' -H 'Accept: application/json' \ -d '{"content":"Tóm tắt nội dung quy chế bảo mật này","documentIds":["<doc-uuid>"]}'curl -X POST "$BASE/api/v1/admin/webhook-endpoints" \ -H "Authorization: Bearer $ACCESS_TOKEN" -H 'Content-Type: application/json' \ -d '{"name":"DMS-Webhook","url":"https://dms.example.com/hooks","events":["document.status.changed","workflow.approved"]}'# → 201 Created kèm secret whsec_... để xác thực chữ ký gói tindocument.status.changedworkflow.startedworkflow.approvedworkflow.rejectedworkflow.escalatedwebhook.testGói tin chuẩn JSON: { id, type, occurred_at, workspace_id, data } kèm cơ chế Outbox đảm bảo gửi tin cậy và Idempotency-Key chống gửi trùng.
Tiêu chuẩn & Cam kết
Kiến trúc mở, minh bạch và trao toàn quyền tự chủ công nghệ vào tay đội ngũ kỹ sư của bạn.
“Được thiết kế cho các tổ chức coi trọng chủ quyền dữ liệu: Minh bạch, độc lập, kiểm soát toàn diện và không phụ thuộc vào bất kỳ nhà cung cấp dịch vụ đám mây nào.”
Các thành phần mở rộng như OCR nhận diện văn bản quét, ASR chuyển đổi giọng nói/video, TEI reranker và stack giám sát được thiết kế dưới dạng mô-đun tùy chọn — chỉ tiêu tốn tài nguyên máy chủ khi được kích hoạt cấu hình.
Khởi động Nhanh
Sẵn sàng chạy trên máy chủ vật lý, VPS hoặc cụm private cloud với một câu lệnh Docker Compose duy nhất.
Tạo tệp .env.production từ file mẫu, phân quyền bảo vệ chmod 600 và khởi tạo các khóa bí mật ngẫu nhiên 32-byte:
cp .env.production.example .env.productionchmod 600 .env.production# Sinh khóa bảo mật TOKEN_KEY & mật khẩu:openssl rand -hex 32Kiểm tra tính hợp lệ của cấu hình và khởi chạy các container chỉ với một câu lệnh duy nhất:
docker compose -f docker-compose.prod.yml --env-file .env.production config --quietdocker compose -f docker-compose.prod.yml --env-file .env.production up -d --buildTruy cập cổng biên APISIX, mở giao diện /setup để tạo tài khoản Quản trị tối cao (ORG_OWNER) đầu tiên:
# Mở trình duyệt: http://your-domain:8088/setup# Hỗ trợ công cụ CLI khôi phục mật khẩu owner khi cần:make -C api recover-owner ENV_FILE=../.env.productionollama pull bge-m3ollama pull hf.co/QuantFactory/Arcee-VyLinh-GGUF:Q4_K_Mollama cp hf.co/QuantFactory/Arcee-VyLinh-GGUF:Q4_K_M vylinhChúng tôi đồng hành hỗ trợ doanh nghiệp và cơ quan nhà nước triển khai hệ thống RAG an toàn trên hạ tầng on-premise & private cloud. Hãy nhắn tin trực tiếp với chúng tôi qua Facebook.
Cột mốc Phát triển
Bốn cột mốc lớn đã hoàn thành với đầy đủ tiêu chí nghiệm thu nghiêm ngặt:
Nền tảng RAG Tự lưu trữ: Spring Boot + FastAPI + Next.js, APISIX gateway, PostgreSQL/SeaweedFS/Qdrant/Kùzu, hỏi đáp có trích dẫn nguồn và cơ chế từ chối (Abstention).
Định danh Doanh nghiệp Keycloak SSO: Tích hợp Keycloak OIDC, Spring làm Resource Server, phân quyền 3 cấp (Owner/Admin/Member) và xác thực đa yếu tố.
Quy trình Phê duyệt BPMN & Đa phương thức: Nhúng engine Flowable OSS cho luồng e-Office 2 cấp, hộp thư duyệt tài liệu, trích dẫn đa phương thức và backup SHA-256.
Hồ dữ liệu Lakehouse & DuckDB OLAP: CDC streaming qua RabbitMQ lưu Snappy Parquet trên SeaweedFS S3, DuckDB nhúng thực thi SQL phân tích tức thì.
Mã nguồn Mở & Giấy phép
OpenVie là dự án mã nguồn mở thuần túy, trao quyền tự chủ công nghệ trọn vẹn cho cộng đồng và doanh nghiệp.
Tổ chức có toàn quyền kiểm tra toàn bộ mã nguồn, tùy biến giao diện, tích hợp hệ thống nội bộ và điều chỉnh luồng nghiệp vụ theo nhu cầu đặc thù mà không gặp bất kỳ rào cản pháp lý hay kỹ thuật nào.
Kiểm tra mã nguồn — Khởi chạy với một câu lệnh — Sở hữu hoàn toàn kho tri thức nội bộ.
Tổ chức cần hỗ trợ kỹ thuật & tư vấn triển khai? Liên hệ Facebook →