Đặc tả Module Hợp nhất: Auto Report
Module Auto Report tự động hóa việc tạo ra các báo cáo dữ liệu và tự sự phức tạp bằng cách sử dụng LLM. Nó thu thập dữ liệu từ nhiều module satellite, xử lý thông qua các gợi ý (prompts) tùy chỉnh và phân phối các báo cáo có cấu trúc theo lịch trình hoặc theo yêu cầu.
v1.0 — Đã phê duyệtNền tảng: Shell VENI-AILĩnh vực: Tự động hóa & Thông tin chi tiết
1. Tổng quan Module
Auto Report được thiết kế để giảm thiểu nỗ lực thủ công trong các báo cáo định kỳ của tổ chức (ví dụ: Tóm tắt Nhân sự Hàng tuần, Kiểm toán Tài sản Hàng tháng). Bằng cách kết hợp dữ liệu có cấu trúc từ các module VENI-AI với khả năng tự sự của LLM, nó tạo ra các báo cáo chuyên nghiệp, sẵn sàng sử dụng.
- Mục tiêu chính: Tự động hóa việc báo cáo tự sự và phân tích định kỳ.
- Mục tiêu phụ: Cung cấp một lịch sử tập trung về các ảnh chụp nhanh và xu hướng của tổ chức.
2. Điều hướng Đặc tả
| Phần | Trọng tâm | Đối tượng |
|---|---|---|
| Đặc tả Kỹ thuật | Kiến trúc, Stack, Bảo mật | Lập trình viên, DevOps |
| Cấu trúc Dữ liệu | Bảng, ERD, Kiểu dữ liệu | Lập trình viên, DBA |
| Tham chiếu API | Điểm cuối REST, Hợp đồng | Tích hợp, Frontend Dev |
| Yêu cầu Chức năng | Tính năng, Mã REQ | BA, Kiểm thử |
3. Yêu cầu Chức năng (SRS)
3.1 Quản lý Mẫu (TEMPLATE)
- REQ-AR-001: Hệ thống PHẢI cho phép định nghĩa các Mẫu Báo cáo với tên, nguồn dữ liệu và prompt của LLM.
- REQ-AR-002: Hệ thống PHẢI hỗ trợ nhiều định dạng đầu ra: Tự sự (Narrative), Tóm tắt dạng gạch đầu dòng, và Bảng + Tự sự.
3.2 Tự động tạo (SCHEDULING)
- REQ-AR-003: Hệ thống PHẢI hỗ trợ lập lịch dựa trên cron (Hàng ngày, Hàng tuần, Hàng tháng).
- REQ-AR-004: Hệ thống PHẢI cung cấp tính năng Chạy ngay (Run Now) để tạo báo cáo một lần thủ công.
- REQ-AR-005: Hệ thống PHẢI duy trì một Lịch sử chạy đầy đủ với trạng thái thành công/thất bại và nhật ký logs.
3.3 Thu thập Dữ liệu (CONNECTORS)
- REQ-AR-006: Hệ thống PHẢI thu thập dữ liệu từ các module satellite nội bộ (HRM, Drive, Document).
- REQ-AR-007: Hệ thống PHẢI cắt bớt các ảnh chụp nhanh dữ liệu để phù hợp với Cửa sổ ngữ cảnh LLM (mặc định 16k token).
3.4 Phân phối (OUTPUT)
- REQ-AR-008: Hệ thống PHẢI phân phối báo cáo qua Thông báo trong ứng dụng và Email.
- REQ-AR-009: Hệ thống PHẢI hỗ trợ Xuất PDF giống hệt với giao diện web.
4. Đặc tả Tính năng (Chi tiết)
Đặc tả chi tiết cho từng tính năng cốt lõi:
5. Yêu cầu Phi chức năng (NFR)
5.1 Hiệu năng
- NFR-AR-PER-001: Việc tạo báo cáo PHẢI hoàn thành trong vòng 3 phút.
- NFR-AR-PER-002: Độ trễ tạo tệp PDF PHẢI < 10 giây cho các báo cáo tiêu chuẩn.
5.2 Độ tin cậy
- NFR-AR-REL-001: Các lượt chạy thất bại PHẢI thu thập và hiển thị các thông báo lỗi có thể hành động cho quản trị viên.
- NFR-AR-REL-002: Việc thu thập dữ liệu PHẢI xử lý các thất bại một phần một cách mượt mà (ví dụ: bỏ qua một tệp nếu S3 bị lỗi nhưng tiếp tục với các tệp khác).