Kho lưu trữ: hạn mức, sổ dung lượng, chia sẻ

Cài đặt → Chung → Kho lưu trữ và Người dùng → Kho lưu trữ trong khu quản trị (/admin).

Module UserStorage cho mọi người dùng một kho riêng (thư mục, file, link, thùng rác, chia sẻ). Người dùng thấy ở Kho lưu trữ trong Learnspace. Vai trò của quản trị viên là đặt hạn mức, theo dõi dung lượng, và xử lý kho của người đã nghỉ.

Mô hình một câu

Ai đăng nhập cũng có kho; vai trò chỉ quyết định được bao nhiêu dung lượng và được chia sẻ tới đâu. Gỡ vai trò không xoá gì — chỉ hạ hạn mức, kho vượt mức thì không thêm được cho tới khi dọn.

Bật cho tổ chức

Bật module UserStorage. Tắt module thì mọi trang, link tải và link công khai của nó trả 404 ngay; dữ liệu giữ nguyên, bật lại là dùng tiếp. Phạm vi chia sẻ "lớp" chỉ hiện khi tổ chức có module tương ứng đang bật (TrainingManagement cho lớp/chương trình, K12Management cho lớp chủ nhiệm/lớp môn học, CorporateOrg cho đơn vị/vị trí, nhóm người dùng luôn có).

Bản đồ màn hình

Màn hình	Dùng để
Cài đặt → Chung → Kho lưu trữ	Mức chung, hạn mức theo vai trò, trần một file, đuôi cho phép, thùng rác tự dọn
Người dùng → Kho lưu trữ	Sổ dung lượng từng người (đã dùng, hạn mức hiệu lực, số file), bộ lọc Vượt hạn mức, Chuyển quyền sở hữu, hai nút xử lý kho mồ côi
Dashboard → widget "Dung lượng kho lưu trữ"	Tổng đã dùng so với trần của gói, số người có kho, người dùng nhiều nhất
Vai trò & quyền	Cấp/thu các quyền chia sẻ và quản trị kho (xem bảng dưới)

Hạn mức

Hạn mức hiệu lực của một người = mức cao nhất trong các vai trò họ mang mà bạn có đặt dòng riêng; không vai trò nào có dòng riêng thì lấy mức chung. Tính lúc dùng, không lưu vào tài khoản — đổi vai trò là hạn mức đổi ngay.

Ô	Mặc định	Ghi chú
Mức chung	20 MB	Áp cho mọi người không có dòng theo vai trò. 0 = không cho tải lên
Theo vai trò	(trống)	Chỉ liệt kê vai trò muốn nâng/hạ. Tick Không giới hạn để bỏ trần. Admin cũng không có ngoại lệ ngầm — muốn admin không giới hạn thì thêm dòng
Trần một file	100 MB	Tối đa 100 (trần tải lên của hệ thống)
Thùng rác tự dọn sau	30 ngày	Để trống = giữ tới khi người dùng tự xoá vĩnh viễn. File trong thùng rác vẫn tính dung lượng
Đuôi cho phép	pdf, doc(x), xls(x), ppt(x), odt/ods/odp, txt, md, csv, rtf, zip/rar/7z, ảnh, mp4/webm/mp3/m4a/wav, sb3, ggb, ipynb	Để trống = mọi đuôi trừ mã chạy được (php, exe, sh, …) — danh sách cấm này không đổi được

Khi một người vượt hạn mức (thường do đổi vai trò hoặc bạn hạ mức): không gì bị xoá; họ vẫn xem/tải/chia sẻ/xoá, chỉ không tải lên, không khôi phục từ thùng rác, không sao chép vào kho. Bộ lọc Vượt hạn mức ở trang sổ dung lượng liệt kê những người này.

Trần của gói

Ngoài hạn mức cá nhân còn trần của gói (max_storage_mb do quản trị central đặt cho tổ chức): tổng dung lượng kho của cả tổ chức không vượt số này, kể cả với người "không giới hạn" cá nhân. Đầy thì mọi lượt thêm bị chặn với thông báo "toàn hệ thống đã dùng … trên trần của gói" — chỉ nâng gói (central) hoặc dọn bớt mới gỡ được. Widget dashboard và dòng đầu trang sổ dung lượng hiện số này. Trần này chỉ đếm byte của kho lưu trữ, không đếm media khoá học hay kho tài nguyên.

Trước khi bật trần của gói cho tổ chức đang chạy

Quản trị central chạy php artisan storage:cap-audit để đối chiếu đã dùng / trần của từng tổ chức. Tổ chức đang vượt (trần đặt từ trước nhỏ hơn thực dùng) sẽ chết mọi lượt tải lên và khôi phục ngay khi trần có hiệu lực — null trần hoặc nâng gói trước.

Sổ dung lượng

Người dùng → Kho lưu trữ: mỗi dòng một người — đã dùng, hạn mức hiệu lực (đỏ khi vượt), số file, số trong thùng rác. Không liệt kê từng file của người khác: quản dung lượng không cần đọc nội dung.

Chuyển quyền sở hữu (quyền transfer_storage_account): toàn bộ thư mục và file (kể cả thùng rác) của một người chuyển sang gốc kho của người nhận; thư mục gốc trùng tên được đánh số "(2)". Dùng cho ca nhân sự nghỉ việc — kể cả khi tài khoản đã bị xoá mềm, dòng sổ vẫn còn để chuyển. Không kiểm hạn mức người nhận (từ chối bằng cách để mất dữ liệu là sai); kho nhận có thể vượt mức và chỉ-đọc-cho-việc-thêm như mọi kho khác. Mọi lượt chia sẻ và link công khai của chủ cũ bị thu hồi — chủ mới tự chia sẻ lại.

Kho mồ côi

Xoá cứng tài khoản (không phải xoá mềm) thì kho của người đó thành kho mồ côi: không ai thấy ngoài quản trị viên có quyền manage_orphan_storage, không bị dọn tự động. Trang sổ dung lượng có hai nút ở đầu trang khi có kho mồ côi:

• Giao kho mồ côi (N file) — chuyển toàn bộ cho một người được chọn.
• Xoá vĩnh viễn kho mồ côi — có xác nhận, không lấy lại.

Chia sẻ và quyền

Quyền	Cho phép	Cấp mặc định
share_storage	Chia sẻ cho người cụ thể (cùng lớp/nhóm) và cho lớp/nhóm mình thuộc về hoặc phụ trách	Mọi vai trò, kể cả học viên
share_storage_tenant_wide	Chia sẻ cho mọi người trong hệ thống	Giảng viên, quản lý đào tạo, giáo vụ, giáo viên, nhân sự, marketing
share_storage_any_target	Chia sẻ tới bất kỳ lớp/nhóm, không cần thuộc về	Quản lý đào tạo, giáo vụ, nhân sự
share_storage_public_link	Tạo link công khai có hạn (không cần đăng nhập, tối đa 30 ngày)	Cùng tập với share_storage_tenant_wide
view_any_storage_account, view_storage_account	Xem sổ dung lượng	Quản lý đào tạo, nhân sự
transfer_storage_account	Chuyển quyền sở hữu	Admin
manage_orphan_storage	Giao / xoá kho mồ côi	Admin
configure_storage	Sửa pane cấu hình	Admin
widget_StorageUsageWidget	Thấy widget dung lượng trên dashboard	Admin, quản lý đào tạo, nhân sự

Mấy điều đáng biết khi cấp quyền:

• Học viên không liệt kê được danh bạ qua ô tìm người: họ chỉ thấy người cùng lớp/nhóm với mình, và không thấy email. Người có quyền chia sẻ toàn hệ thống mới tìm được mọi người.
• Quyền chia sẻ không mở cửa khu quản trị: cửa đó do vai trò panel_user/super_admin quyết.
• Người bị thu quyền share_storage_public_link vẫn thu hồi được link đã tạo — chỉ không tạo mới.

Vận hành

Lệnh	Việc
storage:purge-trash [--tenant=] [--pretend]	Xoá vĩnh viễn file quá hạn giữ trong thùng rác; chạy theo lịch hằng ngày lúc 03:15. --pretend chỉ đếm
storage:reconcile [--tenant=]	Tính lại sổ dung lượng từ file thật; chạy sau khi khôi phục backup
storage:cap-audit	(central) Đối chiếu đã dùng / trần của gói từng tổ chức; báo lỗi khi có tổ chức vượt

File nằm trên đĩa riêng tư của tổ chức, chỉ ra ngoài qua link có kiểm quyền hoặc link công khai có hạn. PDF và file Office xem/trình chiếu ngay trong trang (xem Kho lưu trữ → Xem và trình chiếu); bản PDF của file Office do dịch vụ chuyển đổi chung với công cụ CV và với tài liệu khoá học dựng, cache cạnh file gốc (không tính vào dung lượng). Chưa cấu hình dịch vụ thì trang xem báo "không hiển thị được" kèm nút tải về, không lỗi. Trần chuyển đổi 25 MB một file.