Đặc tả Yêu cầu Phần mềm

Module Quản lý Tệp tin

FILE

Phiên bản	1.0
Hệ thống	Hệ thống Cổng Thông tin Tuyển dụng
Module	FILE - Quản lý Tệp tin
Cơ sở dữ liệu	file_db
Ngày	2026-08-17
Tác giả	Nam Nguyen
Trạng thái	Bản nháp

Mục lục

1. Giới thiệu
2. Tổng quan Module
3. Yêu cầu Chức năng
4. Trường hợp Sử dụng
5. Yêu cầu Phi chức năng
6. Ma trận Truy xuất Nguồn gốc

1. Giới thiệu

1.1 Mục đích

Tài liệu này định nghĩa các yêu cầu phần mềm cho module Quản lý Tệp tin của Hệ thống Cổng Thông tin Tuyển dụng.

1.2 Phạm vi

1.3 Phụ thuộc Module

1.4 Định nghĩa

2. Tổng quan Module

3. Yêu cầu Chức năng

4. Trường hợp Sử dụng

4.1 Sơ đồ Trường hợp Sử dụng

Module	Loại Phụ thuộc	Mô tả
AUTH	Đồng bộ (Gọi API)	Xác thực danh tính người dùng và quyền RBAC
LOG	Bất đồng bộ (RabbitMQ)	Phát sự kiện vòng đời tệp tin (đã tải lên, đã xóa)

Thuật ngữ	Định nghĩa
FR	Yêu cầu Chức năng
NFR	Yêu cầu Phi chức năng
UC	Trường hợp Sử dụng
MIME Type	Multipurpose Internet Mail Extensions - định danh loại tệp tin
RBAC	Kiểm soát Truy cập Dựa trên Vai trò
Tải lên Hàng loạt	Tải lên nhiều tệp tin trong một yêu cầu duy nhất
Kế thừa Quyền	Quyền kế thừa từ thư mục cha đến các tệp tin/thư mục con
Hạn ngạch Lưu trữ	Giới hạn lưu trữ tối đa cho mỗi người dùng hoặc tổ chức
Chính sách Lưu trữ	Các quy tắc cấu hình cho danh mục tệp tin (loại được phép, giới hạn kích thước, thời gian lưu trữ)
OpenSearch	Công cụ tìm kiếm và phân tích được sử dụng để lưu trữ nhật ký và tìm kiếm toàn văn

Khía cạnh	Giá trị
Mã Module	FILE
Tên Module	Quản lý Tệp tin
Mô tả	Tải lên, tải xuống, liệt kê, quản lý thư mục, quyền và quản lý vòng đời tệp tin với local filesystem
Cơ sở dữ liệu	file_db
Bảng	sys_files, sys_file_permissions, sys_storage_usage, sys_storage_quotas, sys_storage_policies
Stack Công nghệ	NestJS, Drizzle ORM, PostgreSQL, Multer + fs (local filesystem)

Mã Yêu cầu	Module	Yêu cầu	Trường hợp Sử dụng	Ưu tiên	Mô tả
FR-001	FILE	Tải lên Tệp tin	UC-05	Cao	Hệ thống sẽ nhận tệp tin qua multipart/form-data. Server lưu tệp tin vào local filesystem và tạo bản ghi metadata. Trả về bản ghi tệp tin cho client.
FR-002	FILE	Tải xuống Tệp tin	UC-06	Cao	Hệ thống sẽ đọc tệp tin từ local filesystem và trả về nội dung cho client. Kiểm tra quyền truy cập trước khi trả về.
FR-003	FILE	Liệt kê Tệp tin	UC-02	Trung bình	Hệ thống sẽ truy vấn tệp tin theo người dùng, nhà tuyển dụng và danh mục với hỗ trợ phân trang. Kết quả được lọc theo kiểm soát truy cập.
FR-004	FILE	Xóa Tệp tin	UC-09	Trung bình	Hệ thống sẽ xóa mềm metadata tệp tin và xóa vật lý tệp tin trên local filesystem. Trạng thái tệp tin được đặt thành DELETED.
FR-005	FILE	Kiểm soát Truy cập Tệp tin	UC-11	Cao	Hệ thống sẽ kiểm tra quyền sở hữu tệp tin hoặc quyền RBAC trước khi tạo URL tải xuống. Người dùng chỉ có thể truy cập tệp tin của riêng họ trừ khi có vai trò admin/HR trong tổ chức.
FR-006	FILE	Dọn dẹp Tệp tin Tạm	-	Trung bình	Hệ thống sẽ chạy tác vụ định kỳ (cron) để xóa các tệp tin TEMP cũ hơn 24 giờ. Xóa vật lý tệp tin trên local filesystem và xóa bản ghi metadata.
FR-007	FILE	Tải lên CV/Hồ sơ	UC-05	Cao	Hệ thống sẽ cho phép người dùng đã xác thực tải lên tệp tin CV/hồ sơ (PDF, DOC, DOCX) với kích thước tối đa 10MB. Tệp tin được lưu trữ dưới danh mục RESUME với đường dẫn theo phạm vi người dùng. Hệ thống kiểm tra loại tệp tin, lưu tệp tin vào local filesystem và tạo metadata. Chỉ cho phép một CV đang hoạt động cho mỗi người dùng - tải lên CV mới sẽ thay thế CV trước đó.
FR-008	FILE	Tạo Thư mục	UC-01	Trung bình	Hệ thống sẽ cho phép người dùng đã xác thực tạo thư mục trong cấu trúc thư mục được ủy quyền. Tên thư mục không được chứa ký tự đặc biệt (/, \, :, *, ?, ", <, >, \|). Hệ thống kiểm tra tính duy nhất của tên thư mục trong thư mục cha. Metadata thư mục được lưu trong sys_files với type=FOLDER.
FR-009	FILE	Tìm kiếm Tệp tin/Thư mục	UC-03	Trung bình	Hệ thống sẽ cung cấp tìm kiếm toàn văn trên tên và metadata tệp tin/thư mục. Tìm kiếm hỗ trợ bộ lọc: danh mục, mime_type, khoảng ngày, chủ sở hữu và trạng thái. Kết quả được phân trang và sắp xếp theo mức độ liên quan hoặc ngày. Tìm kiếm tuân theo kiểm soát truy cập - người dùng chỉ thấy các tệp tin mà họ có quyền truy cập.
FR-010	FILE	Đổi tên Tệp tin/Thư mục	UC-04	Trung bình	Hệ thống sẽ cho phép người dùng được ủy quyền đổi tên tệp tin và thư mục. Tên mới phải duy nhất trong thư mục cha. Nếu tệp tin với tên tương tự tồn tại, hệ thống sẽ thêm hậu tố số (ví dụ: file(1).pdf). Hệ thống kiểm tra định dạng tên và cập nhật metadata. Việc đổi tên được ghi nhật ký để kiểm toán.
FR-011	FILE	Tải lên Nhiều Tệp tin	UC-07	Trung bình	Hệ thống sẽ hỗ trợ tải lên hàng loạt nhiều tệp tin trong một yêu cầu. Mỗi tệp tin được kiểm tra riêng biệt về loại và kích thước. Hệ thống xử lý tất cả tệp tin và trả về kết quả tải lên dưới dạng mảng. Các tải lên thất bại không chặn các tải thành công - báo cáo một phần được cung cấp.
FR-012	FILE	Sao chép Tệp tin	UC-08	Thấp	Hệ thống sẽ cho phép người dùng được ủy quyền sao chép tệp tin sang thư mục khác. Sao chép tạo bản ghi tệp tin mới với cùng đường dẫn file vật lý (hard link hoặc copy). Thư mục đích phải nằm trong phạm vi ủy quyền của người dùng. Hệ thống xử lý tên trùng lặp tại đích bằng cách thêm hậu tố số.
FR-013	FILE	Di chuyển Tệp tin	UC-10	Trung bình	Hệ thống sẽ cho phép người dùng được ủy quyền di chuyển tệp tin giữa các thư mục. Di chuyển cập nhật metadata parent_folder_id của tệp tin. Nguồn và đích phải nằm trong phạm vi ủy quyền của người dùng. Hệ thống xử lý tên trùng lặp tại đích. Việc di chuyển được ghi nhật ký để kiểm toán.
FR-014	FILE	Quản lý Quyền	UC-13	Cao	Hệ thống sẽ cho phép quản trị viên quản lý quyền tệp tin/thư mục ở cấp người dùng, vai trò và tổ chức. Các loại quyền: XEM, TẢI XUỐNG, SỬA, XÓA. Quyền có thể kế thừa từ thư mục cha. Thay đổi quyền được ghi nhật ký để kiểm toán.
FR-015	FILE	Ghi nhật ký Lịch sử Truy cập	UC-12	Trung bình	Hệ thống sẽ ghi nhật ký tất cả sự kiện truy cập tệp tin (xem, tải xuống, sửa, xóa) với mã người dùng, thời gian, địa chỉ IP và loại hành động. Nhật ký được lưu trữ trong OpenSearch thông qua module LOG. Nhật ký truy cập được lưu giữ trong 90 ngày theo mặc định. Nhật ký hỗ trợ kiểm toán và yêu cầu tuân thủ.
FR-016	FILE	Theo dõi Sử dụng Lưu trữ	UC-14	Trung bình	Hệ thống sẽ theo dõi sử dụng lưu trữ theo người dùng, tổ chức và toàn cục. Dữ liệu sử dụng bao gồm tổng kích thước, số lượng tệp tin và phân tích theo danh mục. Hệ thống cung cấp dữ liệu sử dụng lưu trữ qua API cho bảng điều khiển quản trị. Dữ liệu sử dụng được cập nhật bất đồng bộ thông qua phương pháp sự kiện.
FR-017	FILE	Quản lý Hạn ngạch Lưu trữ	UC-16	Trung bình	Hệ thống sẽ cho phép quản trị viên đặt hạn ngạch lưu trữ cho mỗi người dùng và tổ chức. Giới hạn hạn ngạch: tổng kích thước tối đa, số lượng tệp tin tối đa. Hệ thống từ chối tải lên khi vượt quá hạn ngạch. Cảnh báo hạn ngạch được kích hoạt ở ngưỡng sử dụng 80% và 95%.
FR-018	FILE	Cấu hình Chính sách Lưu trữ	UC-17	Thấp	Hệ thống sẽ cho phép quản trị viên cấu hình chính sách lưu trữ cho mỗi danh mục: loại mime được phép, kích thước tệp tin tối đa, thời gian lưu trữ và cài đặt mã hóa. Thay đổi chính sách có hiệu lực cho các tải lên mới. Các tệp tin hiện tại giữ nguyên cài đặt chính sách ban đầu.

Hình 1: Sơ đồ Trường hợp Sử dụng Quản lý Tệp tin (Đầy đủ)

Hình 2: Sơ đồ Trường hợp Sử dụng Quản lý Tệp tin (Cốt lõi)

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực
Điều kiện tiên quyết	Người dùng đã đăng nhập; người dùng có quyền ghi trong thư mục đích
Lưu trình Chính	1. Người dùng điều hướng đến thư mục đích 2. Người dùng nhấp vào "Tạo Thư mục" và nhập tên thư mục 3. Client gửi POST /files/folders với name và parent_folder_id 4. Hệ thống kiểm tra tên thư mục (không có ký tự đặc biệt, duy nhất trong thư mục cha) 5. Hệ thống tạo bản ghi thư mục trong sys_files với type=FOLDER 6. Hệ thống trả về bản ghi thư mục với folder_id
Lưu trình Thay thế	4a. Tên không hợp lệ (ký tự đặc biệt) → Hệ thống trả về 400 "Tên thư mục không hợp lệ" 4b. Tên đã tồn tại → Hệ thống trả về 409 "Thư mục đã tồn tại" 4c. Không có quyền ghi → Hệ thống trả về 403 Forbidden
Điều kiện hậu	Thư mục được tạo trong cơ sở dữ liệu; thư mục có thể truy cập trong trình duyệt tệp tin
FR liên quan	FR-008

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực
Điều kiện tiên quyết	Người dùng đã đăng nhập
Lưu trình Chính	1. Client yêu cầu danh sách tệp tin/thư mục với bộ lọc tùy chọn (user_id, employer_id, category, parent_folder_id) 2. Hệ thống áp dụng bộ lọc kiểm soát truy cập 3. Hệ thống truy vấn sys_files với phân trang 4. Hệ thống trả về danh sách tệp tin/thư mục với tổng số, sắp xếp theo tên hoặc ngày
Lưu trình Thay thế	2a. Không có bộ lọc được cung cấp → Hệ thống trả về tệp tin của người dùng hiện tại 2b. Bộ lọc nhà tuyển dụng → Hệ thống trả về tất cả tệp tin của nhà tuyển dụng đó (chỉ admin/HR) 2c. parent_folder_id → Hệ thống trả về các mục con của thư mục đó
Điều kiện hậu	Danh sách tệp tin/thư mục phân trang được trả về với metadata (không có nội dung tệp tin)
FR liên quan	FR-003, FR-005

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực
Điều kiện tiên quyết	Người dùng đã đăng nhập
Lưu trình Chính	1. Người dùng nhập từ khóa tìm kiếm (từ khóa, bộ lọc) 2. Client gửi GET /files/search với query, category, mime_type, khoảng ngày 3. Hệ thống thực hiện tìm kiếm toàn văn trên tên tệp tin và metadata 4. Hệ thống áp dụng bộ lọc kiểm soát truy cập 5. Hệ thống trả về kết quả tìm kiếm với phân trang, sắp xếp theo mức độ liên quan
Lưu trình Thay thế	3a. Không tìm thấy kết quả → Hệ thống trả về danh sách trống với total_count=0 4a. Người dùng không có quyền truy cập bất kỳ tệp tin khớp nào → Hệ thống trả về danh sách trống
Điều kiện hậu	Kết quả tìm kiếm được trả về với metadata tệp tin
FR liên quan	FR-009, FR-005

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực (chủ sở hữu hoặc admin)
Điều kiện tiên quyết	Người dùng đã đăng nhập; tệp tin/thư mục tồn tại với trạng thái ACTIVE
Lưu trình Chính	1. Người dùng chọn tệp tin/thư mục và nhấp vào "Đổi tên" 2. Người dùng nhập tên mới 3. Client gửi PATCH /files/:id với tên mới 4. Hệ thống kiểm tra người dùng có quyền sửa 5. Hệ thống kiểm tra tên mới (duy nhất trong thư mục cha, không có ký tự đặc biệt) 6. Hệ thống cập nhật metadata tệp tin 7. Hệ thống ghi nhật ký sự kiện đổi tên để kiểm toán 8. Hệ thống trả về bản ghi tệp tin đã cập nhật
Lưu trình Thay thế	4a. Không có quyền sửa → Hệ thống trả về 403 Forbidden 5a. Tên đã tồn tại → Hệ thống thêm hậu tố số (ví dụ: file(1).pdf) 5b. Tên không hợp lệ → Hệ thống trả về 400 "Tên không hợp lệ"
Điều kiện hậu	Tệp tin/thư mục đã đổi tên; sự kiện đổi tên được ghi nhật ký để kiểm toán
FR liên quan	FR-010, FR-005

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực
Điều kiện tiên quyết	Người dùng đã đăng nhập; người dùng có token phiên hợp lệ
Lưu trình Chính	1. Người dùng chọn tệp tin để tải lên (ví dụ: hồ sơ, ảnh đại diện) 2. Client gửi yêu cầu POST /files/upload (multipart/form-data) với tệp tin và category 3. Hệ thống kiểm tra loại và kích thước tệp tin theo giới hạn danh mục 4. Hệ thống tạo tên file UUID và lưu tệp tin vào local filesystem (uploads/{user_id}/{category}/{uuid}) 5. Hệ thống tạo bản ghi metadata trong sys_files với trạng thái ACTIVE 6. Hệ thống trả về bản ghi tệp tin cho client
Lưu trình Thay thế	3a. Loại tệp tin không hợp lệ → Hệ thống trả về 400 Lỗi Xác thực 3b. Tệp tin quá lớn → Hệ thống trả về 413 Payload Too Large 4a. Lưu filesystem thất bại → Hệ thống trả về 500 Lỗi Server
Điều kiện hậu	Tệp tin đã lưu trên local filesystem; metadata tệp tin được lưu trong cơ sở dữ liệu với trạng thái ACTIVE; tệp tin có thể truy cập qua endpoint tải xuống
FR liên quan	FR-001

Đặc tả Yêu cầu Phần mềm

Mục lục

1. Giới thiệu

1.1 Mục đích

1.2 Phạm vi

1.3 Phụ thuộc Module

1.4 Định nghĩa

2. Tổng quan Module

3. Yêu cầu Chức năng

4. Trường hợp Sử dụng

4.1 Sơ đồ Trường hợp Sử dụng

4.2 UC-01: Tạo Thư mục

4.3 UC-02: Liệt kê Tệp tin/Thư mục

4.4 UC-03: Tìm kiếm Tệp tin/Thư mục

4.5 UC-04: Xem & Đổi tên Tệp tin/Thư mục

4.6 UC-05: Tải lên Tệp tin

Sơ đồ Hoạt động

Sơ đồ Tuần tự

4.7 UC-06: Tải xuống Tệp tin

Sơ đồ Hoạt động

Sơ đồ Tuần tự

4.8 UC-07: Tải lên Nhiều Tệp tin

4.9 UC-08: Sao chép Tệp tin

4.10 UC-09: Xóa Tệp tin/Thư mục

Sơ đồ Hoạt động

Sơ đồ Tuần tự

4.11 UC-10: Di chuyển Tệp tin

4.12 UC-11: Kiểm tra Quyền Truy cập

4.13 UC-12: Ghi nhật ký Lịch sử Truy cập

4.14 UC-13: Quản lý Quyền

4.15 UC-14: Theo dõi Sử dụng Lưu trữ

4.16 UC-15: Quản lý Cấu trúc Thư mục

4.17 UC-16: Quản lý Hạn ngạch Lưu trữ

4.18 UC-17: Cấu hình Chính sách Lưu trữ

4.19 UC-05 (Mở rộng): Tải lên CV/Hồ sơ

Sơ đồ Hoạt động

Sơ đồ Tuần tự

5. Yêu cầu Phi chức năng

6. Ma trận Truy xuất Nguồn gốc Yêu cầu

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực (chủ sở hữu tệp tin hoặc admin)
Điều kiện tiên quyết	Người dùng đã đăng nhập; tệp tin/thư mục tồn tại với trạng thái ACTIVE
Lưu trình Chính	1. Client yêu cầu xóa tệp tin/thư mục bằng ID 2. Hệ thống kiểm tra người dùng là chủ sở hữu hoặc có vai trò admin 3. Nếu là thư mục: Hệ thống đánh dấu đệ quy tất cả các mục con là DELETED 4. Hệ thống đặt trạng thái tệp tin thành DELETED và timestamp deleted_at 5. Hệ thống xóa vật lý tệp tin trên local filesystem (fs.unlink) 6. Hệ thống trả về phản hồi thành công
Lưu trình Thay thế	2a. Người dùng không được ủy quyền → Hệ thống trả về 403 Forbidden 2b. Tệp tin đã DELETED → Hệ thống trả về 404 Not Found 5a. Xóa filesystem thất bại → Ghi log lỗi, tệp tin vẫn đánh dấu DELETED
Điều kiện hậu	Metadata tệp tin/thư mục đã xóa mềm; tệp tin vật lý đã bị xóa trên filesystem; tệp tin không còn truy cập được
FR liên quan	FR-004, FR-005

Khía cạnh	Mô tả
Actor	Hệ thống (nội bộ)
Điều kiện tiên quyết	Nhận yêu cầu từ người dùng; tệp tin/thư mục tồn tại
Lưu trình Chính	1. Hệ thống nhận yêu cầu truy cập tệp tin 2. Hệ thống kiểm tra người dùng là chủ sở hữu tệp tin → cấp quyền truy cập 3. Hệ thống kiểm tra vai trò của người dùng trong tổ chức (admin/HR) → cấp quyền truy cập 4. Hệ thống kiểm tra quyền rõ ràng trong sys_file_permissions → cấp/từ chối 5. Hệ thống kiểm tra quyền thư mục cha (kế thừa) → cấp/từ chối 6. Hệ thống trả về quyết định truy cập (ALLOW/DENY)
Lưu trình Thay thế	2a. Người dùng không phải chủ sở hữu → Tiếp tục bước 3 3a. Người dùng không phải admin/HR → Tiếp tục bước 4 4a. Không tìm thấy quyền rõ ràng → Tiếp tục bước 5 5a. Không tìm thấy quyền thư mục → DENY truy cập
Điều kiện hậu	Quyết định truy cập được trả về; quyết định được ghi nhật ký nếu DENY
FR liên quan	FR-005

Khía cạnh	Mô tả
Actor	Quản trị viên
Điều kiện tiên quyết	Admin đã đăng nhập; admin có vai trò admin hệ thống hoặc admin tổ chức
Lưu trình Chính	1. Admin chọn tệp tin/thư mục và mở bảng "Quyền" 2. Admin thêm/cập nhật/xóa quyền cho người dùng, vai trò hoặc tổ chức 3. Admin đặt loại quyền: XEM, TẢI XUỐNG, SỬA, XÓA 4. Admin tùy chọn bật kế thừa quyền từ thư mục cha 5. Client gửi PUT /files/:id/permissions với mảng quyền 6. Hệ thống kiểm tra admin có vai trò quản lý quyền 7. Hệ thống cập nhật bảng sys_file_permissions 8. Hệ thống ghi nhật ký thay đổi quyền để kiểm toán 9. Hệ thống trả về quyền đã cập nhật
Lưu trình Thay thế	6a. Admin không được ủy quyền → Hệ thống trả về 403 Forbidden 7a. Xung đột quyền → Hệ thống áp dụng quy tắc hạn chế nhất
Điều kiện hậu	Quyền được cập nhật; thay đổi có hiệu lực ngay lập tức; nhật ký kiểm toán được ghi lại
FR liên quan	FR-014

Khía cạnh	Mô tả
Actor	Hệ thống (Tác vụ Cron)
Điều kiện tiên quyết	Hệ thống đang chạy; file_db có thể truy cập
Lưu trình Chính	1. Tác vụ cron chạy định kỳ (mỗi giờ) 2. Hệ thống tính toán sử dụng lưu trữ cho mỗi người dùng: total_size, file_count 3. Hệ thống tính toán sử dụng lưu trữ cho mỗi tổ chức 4. Hệ thống tính toán sử dụng lưu trữ toàn cục 5. Hệ thống lưu dữ liệu sử dụng trong bảng sys_storage_usage 6. Hệ thống cung cấp dữ liệu sử dụng qua API GET /files/storage-usage
Lưu trình Thay thế	2a. Tính toán thất bại → Hệ thống ghi nhật ký lỗi, thử lại ở chu kỳ tiếp theo
Điều kiện hậu	Dữ liệu sử dụng lưu trữ được cập nhật; sẵn sàng cho bảng điều khiển quản trị
FR liên quan	FR-016

Khía cạnh	Mô tả
Actor	Người dùng đã xác thực (Ứng viên)
Điều kiện tiên quyết	Người dùng đã đăng nhập; người dùng có token phiên hợp lệ
Lưu trình Chính	1. Người dùng điều hướng đến trang tải lên CV/Hồ sơ 2. Người dùng chọn tệp tin CV (PDF, DOC, DOCX) với kích thước tối đa 10MB 3. Client gửi yêu cầu tải lên với original_name, mime_type, category=RESUME 4. Hệ thống kiểm tra loại tệp tin được phép (PDF, DOC, DOCX) và kích thước <= 10MB 5. Hệ thống kiểm tra tệp tin RESUME đang hoạt động hiện có cho người dùng này 6a. Nếu tìm thấy CV hiện có: Hệ thống đặt trạng thái tệp tin cũ thành REPLACED 6b. Nếu không có CV hiện có: Hệ thống chuyển sang bước 7 7. Hệ thống lưu tệp tin vào local filesystem và tạo bản ghi tệp tin với trạng thái TEMP 8. Server lưu tệp tin vào local filesystem 9. Client xác nhận hoàn tất tải lên qua POST /files/confirm 10. 11. Hệ thống trả về bản ghi tệp tin với file_id
Lưu trình Thay thế	4a. Loại tệp tin không hợp lệ → Hệ thống trả về 400 "Chỉ cho phép tệp tin PDF, DOC, DOCX" 4b. Tệp tin quá lớn (>10MB) → Hệ thống trả về 413 "Kích thước tệp tin vượt quá giới hạn 10MB" 5a. Lưu filesystem thất bại → Client có thể thử lại 9a. Xác nhận không được nhận trong vòng 24 giờ → Dọn dẹp tệp tin tạm xóa bản ghi
Điều kiện hậu	CV đã lưu trên filesystem trong thư mục RESUME của người dùng; metadata tệp tin được lưu với trạng thái ACTIVE; CV trước đó (nếu có) được đánh dấu là REPLACED; CV có thể truy cập qua URL tải xuống
FR liên quan	FR-007, FR-001

Mã Yêu cầu	Danh mục	Yêu cầu	Mục tiêu
NFR-001	Hiệu suất	Thời gian phản hồi tải lên tệp tin	< 2000ms (p95) cho tệp tin ≤ 10MB
NFR-002	Bảo mật	Giới hạn kích thước tải lên	Theo danh mục: RESUME 10MB, AVATAR 5MB, OTHER 10MB
NFR-003	Khả dụng	Uptime dịch vụ tệp tin	99.9%
NFR-004	Khả năng mở rộng	Tải lên đồng thời	100+ tải lên đồng thời
NFR-005	Lưu trữ	Kích thước tệp tin tối đa theo danh mục	RESUME: 10MB, AVATAR: 5MB, OTHER: 10MB
NFR-006	Bảo trì	Tần suất dọn dẹp tệp tin tạm	Mỗi 1 giờ (tệp tin cũ hơn 24h)
NFR-007	Hiệu suất	Thời gian phản hồi tìm kiếm	< 1000ms (p95) cho tìm kiếm toàn văn
NFR-008	Hiệu suất	Thời gian phản hồi tải lên hàng loạt	< 2000ms để tạo multipart upload (tối đa 20 tệp tin)
NFR-009	Bảo mật	Độ trễ kiểm tra kiểm soát truy cập	< 100ms (p95) mỗi yêu cầu
NFR-010	Tuân thủ	Thời gian lưu trữ nhật ký truy cập	90 ngày (có thể cấu hình)
NFR-011	Lưu trữ	Độ chính xác theo dõi sử dụng lưu trữ	+- 1% so với sử dụng thực tế