VENI-AI

Tiếng Việt

English
English

Tiếng Việt

English
English

Appearance

Đặc tả Kỹ thuật: Auto Report ​

Tài liệu này chi tiết về kiến trúc kỹ thuật, đường ống thu thập dữ liệu và các cơ chế phân phối cho module Auto Report.

v1.0 — Đã phê duyệtNền tảng: Shell VENI-AIStack: Bun/Ignis/Hono

1. Kiến trúc Cấp cao ​

Module Auto Report hoạt động như một Hệ thống hướng Nhiệm vụ, tương tác với nhiều API satellite để thu thập ngữ cảnh trước khi gọi LLM để tạo nội dung.

Sơ đồ Thành phần ​

2. Stack Công nghệ ​

Backend (API & Worker) ​

  • Runtime: Bun
  • Framework: Ignis Framework
  • Task Runner: Mastra (Engine workflow AI-first).
  • LLM: OpenAI GPT-4o-mini.
  • Cơ sở dữ liệu: PostgreSQL.

Frontend (UI) ​

  • Thư viện: React 18
  • Công cụ Build: Vite
  • Reporting UI: Recharts để ánh xạ dữ liệu trực quan.
  • Tạo PDF: Puppeteer (Chrome không giao diện) cho các bản xuất chất lượng cao.

3. Logic Triển khai ​

3.1 Đường ống Thu thập Dữ liệu ​

  1. Khám phá Nguồn: Mẫu báo cáo định nghĩa module nào (ví dụ: HRM) và điểm cuối nào cần lấy dữ liệu.
  2. Nén Ngữ cảnh: Các payload dữ liệu lớn được tóm tắt hoặc cắt bớt để phù hợp với cửa sổ ngữ cảnh LLM bằng kỹ thuật tóm tắt phân cấp.
  3. Tiêm Prompt: Ngữ cảnh đã nén được đưa vào system prompt của mẫu báo cáo.

3.2 Lập lịch & Xử lý Hàng đợi ​

  • Các lượt chạy tự động được quản lý thông qua engine cron phân tán bên trong framework Mastra.
  • Mỗi lượt chạy được ghi lại dưới dạng một mục nhập execution_log với trạng thái của nó (pending, running, success, error).

3.3 Tính Toàn vẹn của Ảnh chụp nhanh (Snapshot) ​

Để đảm bảo tính nhất quán của báo cáo, dữ liệu thu thập được trong quá trình "Đang chạy" được lưu dưới dạng ảnh chụp nhanh JSON trong cơ sở dữ liệu. Điều này cho phép quản trị viên xem chính xác dữ liệu nào AI đã sử dụng để tạo ra một báo cáo cụ thể.

4. Bảo mật & Tuân thủ ​

  • Đa thuê bao: Trình thực thi chỉ lấy dữ liệu từ các API satellite bằng cách sử dụng thông tin xác thực dịch vụ-với-dịch vụ (S2S) của tổ chức hoặc danh tính của người dùng kích hoạt.
  • Chính sách Lưu trữ: Các tổ chức có thể cấu hình thời gian lưu trữ (ví dụ: 90 ngày), sau đó các ảnh chụp nhanh báo cáo sẽ được lưu trữ hoặc xóa bỏ.

Liên kết liên quan

© 2025-2026 VENIZIA AI