Documents & Knowledge Base

Knowledge Base lưu tài liệu nội bộ để AI dùng làm context khi viết bài. Mỗi tài liệu được chia nhỏ (chunk), tạo embedding và truy vấn khi sinh bài.

/dashboard/documents — upload, rename, archive, xóa

Tự động chunk + embed sau khi upload xong

AI tự tìm top chunks liên quan khi viết

Bạn tìm thấy gì ở đâu

Trang	Đường dẫn	Mô tả
Documents	`/dashboard/documents`	Danh sách tài liệu, filter `status/fileType/search`, xem stats

Không có trang chi tiết riêng — mọi thao tác là Dialog/menu ngay trên trang Documents.

Giới hạn 10MB mỗi file, bucket private tenant-documents. Đường dẫn luôn chứa org_id để cô lập tenant. Quá hạn sẽ báo lỗi ngay.

Upload: chọn file → hệ thống tạo record và trả signed upload URL.

Xác nhận: sau khi upload xong, hệ thống tính SHA-256, reserve credit và gọi ingestion.

Parse: đọc PDF/DOCX/HTML.

Chunk: chia 1000 tokens, overlap 200.

Embed: mỗi chunk tạo embedding 1536-dim, lưu vào doc_chunks.

Sẵn sàng: status → Ready, có thể dùng cho Jobs/Chat.

Pipeline là idempotent: upload lại cùng content_hash không tạo chunk trùng. Có versioning qua document_versions.

Hành động	Quyền	Ghi chú
Tạo, Rename, Archive, Retry, Update status	`org:member` trở lên	`updateKnowledgeMetadata` để đánh dấu quan trọng
Xóa, Bulk Delete, Bulk Update status	`org:admin`	Soft delete (`deleted_at`)
Xem stats, Get content	Mọi member	`getContent` tự fallback từ Storage sang `doc_chunks`

Tài liệu Archived sẽ không được AI trích dẫn nữa nhưng vẫn lưu để khôi phục
Chỉ xóa khi chắc chắn không còn Job nào đang tham chiếu — hệ thống không chặn nhưng AI sẽ mất context
Nếu ingestion Failed, bấm Retry Ingestion — không cần upload lại
Tài liệu dạng brief_only (không có evidence) vẫn được chấp nhận cho manual items trong Monthly Plans