Lưu trữ tệp và quản lý nội dung

Ứng dụng của bạn có hệ thống tệp nội dung chuyên dụng để lưu trữ các tệp do người dùng tải lên như hình ảnh, tài liệu, tệp PDF và video. Hệ thống này tách biệt với mã ứng dụng của bạn và được thiết kế cho nội dung động mà người dùng tạo hoặc tải lên khi sử dụng ứng dụng của bạn.

Giới hạn và lưu ý quan trọng

  • Các tệp riêng lẻ có thể có kích thước lên tới 500 MB
  • Việc xóa tệp là vĩnh viễn — không có thùng rác hoặc thao tác hoàn tác
  • Mức sử dụng bộ nhớ được tính vào hạn mức tài khoản của bạn

Hệ thống tệp nội dung cho phép những gì

Hệ thống tệp nội dung cung cấp khả năng quản lý tệp mạnh mẽ cho ứng dụng của bạn:

  • Lưu trữ hình đại diện, ảnh hồ sơ và thư viện hình ảnh của người dùng
  • Chấp nhận tải lên tài liệu như sơ yếu lý lịch, hợp đồng hoặc PDF
  • Xây dựng tính năng chia sẻ tệp giữa những người dùng trong ứng dụng của bạn
  • Tạo các ứng dụng nặng về hình ảnh với tính năng tối ưu hóa tự động
  • Cho phép người dùng tải xuống tệp họ đã tải lên hoặc tệp thuộc về họ
  • Xây dựng các công cụ quản trị nơi bạn quản lý tệp thay mặt cho người dùng

Nó hoạt động như thế nào

Khi bạn mô tả một tính năng cần lưu trữ tệp cho AI, nó sẽ tự động xử lý toàn bộ quá trình triển khai:

Thiết lập giao diện tải lên — Tạo biểu mẫu hoặc vùng kéo và thả nơi người dùng có thể chọn tệp từ thiết bị của họ

Định cấu hình kiểm soát truy cập — Xác định ai có thể xem, tải lên hoặc xóa tệp dựa trên nội dung bạn đang xây dựng

Triển khai tối ưu hóa hình ảnh — Tự động thay đổi kích thước và hiển thị hình ảnh một cách hiệu quả để ứng dụng của bạn tải nhanh

Tạo cấu trúc lưu trữ — Sắp xếp các tệp vào các thư mục hợp lý như /content/uploads/ hoặc /content/avatars/

Xử lý backend — Quản lý việc lưu trữ, truy xuất và phân phối tệp thực tế mà bạn không cần phải suy nghĩ về điều đó

Các tệp được lưu trữ tại các đường dẫn như /content/uploads/photo.jpg và có thể được tham chiếu trực tiếp trong ứng dụng của bạn. Hệ thống theo dõi ai đã tải từng tệp lên, thời điểm tệp được tạo và thực thi các quy tắc truy cập của bạn.

Kiểm soát truy cập cho tệp

Cũng giống như các bảng cơ sở dữ liệu và các edge function, các tệp có chính sách bảo mật kiểm soát ai có thể truy cập chúng. Mặc định, tệp ở chế độ riêng tư — không ai có thể truy cập chúng cho đến khi bạn định cấu hình quyền. AI thiết lập những thứ này dựa trên những gì bạn đang xây dựng:

Tệp công khai

Bất kỳ ai cũng có thể xem chúng, ngay cả khi không đăng nhập. Người dùng đã đăng nhập có thể tải lên và chỉ người đã tải tệp lên mới có thể xóa tệp đó. Hoàn hảo cho thư viện ảnh, chia sẻ hình ảnh công khai hoặc các trang web có nội dung do người dùng tạo.

Tệp riêng tư

Chỉ người dùng đã tải tệp lên mới có thể xem hoặc xóa tệp đó. Được sử dụng cho các tài liệu nhạy cảm, ảnh riêng tư, hồ sơ y tế hoặc bất kỳ thứ gì người dùng không muốn người khác xem.

Tệp được chia sẻ bởi tổ chức

Người dùng từ cùng một tổ chức có thể xem các tệp được tải lên bởi bất kỳ ai trong tổ chức của họ. Các cá nhân chỉ có thể xóa các tệp họ đã tải lên. Tuyệt vời để chia sẻ tài liệu nhóm, tài nguyên công ty hoặc không gian làm việc cộng tác.

Quyền truy cập chỉ dành cho chủ sở hữu

Chỉ bạn (người tạo ứng dụng) mới có thể truy cập các tệp này chứ không phải người dùng cuối của bạn. Hữu ích để lưu trữ các tệp hệ thống, mẫu hoặc tài nguyên quản trị hỗ trợ ứng dụng của bạn nhưng không hướng tới người dùng.

Kiểm soát truy cập nâng cao

AI có thể tạo các quy tắc truy cập phức tạp dựa trên siêu dữ liệu tệp. Ví dụ:

  • Các bài viết đã phát hành được công khai nhưng bản nháp chỉ được hiển thị cho tác giả
  • Các tệp được gắn thẻ với một bộ phận chỉ hiển thị với người dùng trong bộ phận đó
  • Nội dung cao cấp yêu cầu cờ đăng ký (subscription) trên tài khoản của người dùng
  • Các tệp được chia sẻ sẽ hiển thị với các cộng tác viên được liệt kê trong siêu dữ liệu của tệp

Tối ưu hóa hình ảnh

Hình ảnh được tải lên hệ thống tệp nội dung sẽ được tự động tối ưu hóa để tải nhanh. Khi hiển thị một hình ảnh, bạn có thể yêu cầu chiều rộng cụ thể và hệ thống sẽ xử lý phần còn lại:

<!-- Thumbnail (200px wide) -->
<img src="/content/gallery/photo.jpg?w=200" />

<!-- Standard display (800px wide) -->
<img src="/content/gallery/photo.jpg?w=800" />

<!-- Hero image (1920px wide) -->
<img src="/content/gallery/photo.jpg?w=1920" />

<!-- Original, full-size image -->
<img src="/content/gallery/photo.jpg" />

Cách tối ưu hóa hoạt động

Tải lũy tiến — Lần đầu tiên ai đó yêu cầu kích thước được tối ưu hóa, hệ thống sẽ cung cấp phiên bản có sẵn gần nhất và tạo kích thước chính xác ở chế độ nền. Mọi yêu cầu sau đó đều nhận được hình ảnh được tối ưu hóa, có kích thước hoàn hảo. Tệp gốc luôn được bảo tồn.

Cung cấp định dạng hiện đại — Hệ thống tự động cung cấp các định dạng hình ảnh hiện đại (AVIF hoặc WebP) cho các trình duyệt hỗ trợ chúng, với tính năng tự động chuyển sang JPEG hoặc PNG cho các trình duyệt cũ hơn. Điều này diễn ra một cách minh bạch — bạn chỉ cần chỉ định chiều rộng và người dùng sẽ nhận được phiên bản tải nhanh nhất mà trình duyệt của họ có thể xử lý.

Tối ưu hóa hiệu suất — Sử dụng chiều rộng nhỏ hơn để cải thiện hiệu suất. Hình thu nhỏ 200px tải nhanh hơn nhiều so với hình ảnh 4000px gốc và sử dụng ít băng thông hơn. Chọn chiều rộng phù hợp với cách bạn hiển thị hình ảnh.

Sử dụng tệp trong ứng dụng của bạn

AI tự động tích hợp hệ thống tệp nội dung vào ứng dụng React của bạn. Khi bạn yêu cầu các tính năng liên quan đến tệp, nó sẽ tạo các thành phần giao diện người dùng, kết nối logic tải lên/tải xuống và xử lý lỗi.

Các mẫu thường gặp mà AI triển khai

Tải lên hình đại diện — Giao diện tải lên ảnh hồ sơ giúp xác thực loại hình ảnh, hiển thị tiến trình tải lên, xem trước hình ảnh và lưu đường dẫn đến hồ sơ của người dùng.

Thư viện tài liệu — Trình duyệt tệp liệt kê các tài liệu đã tải lên, hiển thị hình thu nhỏ cho hình ảnh, cung cấp liên kết tải xuống và cho phép lọc hoặc tìm kiếm.

Tải lên bằng cách kéo và thả — Vùng tải lên trực quan nơi người dùng có thể kéo tệp từ màn hình của họ, xem tiến trình tải lên, hủy quá trình tải lên đang diễn ra và nhận thông báo lỗi cho các tệp không hợp lệ.

Bộ chọn tệp — Một phương thức hoặc thanh bên hiển thị các tệp mà người dùng đã tải lên trước đó, cho phép họ chọn một tệp để sử dụng lại và hiển thị hình thu nhỏ cũng như tên tệp.

Tích hợp với edge function

Edge function (mã phía máy chủ của bạn) có thể truy cập hệ thống tệp nội dung để xử lý tệp, tạo tệp theo chương trình hoặc triển khai logic xử lý tệp tùy chỉnh.

Edge function có thể làm gì với tệp

  • Tạo báo cáo PDF và lưu chúng để người dùng tải xuống
  • Xử lý hình ảnh được tải lên (áp dụng hình mờ, tạo hình thu nhỏ, trích xuất siêu dữ liệu)
  • Quét các tài liệu đã tải lên để tìm dữ liệu nhạy cảm trước khi chấp nhận chúng
  • Triển khai logic lưu trữ hoặc sao lưu tùy chỉnh
  • Phân tích nội dung tệp và trích xuất dữ liệu có cấu trúc
  • Kích hoạt quy trình khi có tệp cụ thể được tải lên

Cảnh báo: Lưu ý bảo mật quan trọng

Edge function bỏ qua kiểm soát truy cập thông thường. Khi chức năng của bạn truy cập vào các tệp, nó không bị giới hạn bởi các quy tắc "công khai" hoặc "chủ sở hữu" áp dụng cho người dùng. Điều này có nghĩa là bạn phải triển khai hoạt động kiểm tra ủy quyền của riêng mình trong mã chức năng để đảm bảo người dùng chỉ có thể truy cập các tệp mà họ được phép xem.

Ví dụ: nếu người dùng gọi hàm của bạn để yêu cầu một tệp, bạn cần xác minh rằng họ sở hữu tệp đó hoặc có quyền truy cập tệp đó trước khi trả lại nội dung. AI xử lý việc này khi xây dựng các hàm của bạn, nhưng điều quan trọng là bạn phải hiểu rằng mã hàm chạy với các đặc quyền nâng cao.

Tổ chức lưu trữ

AI sắp xếp các tệp thành các thư mục hợp lý dựa trên những gì bạn đang xây dựng. Bạn không cần tạo cấu trúc thư mục theo cách thủ công — chỉ cần mô tả những gì bạn cần và AI sẽ thiết lập các đường dẫn thích hợp.

Các cách tổ chức thường gặp

  • /content/uploads/ - Tải lên của người dùng chung
  • /content/avatars/ - Ảnh hồ sơ người dùng
  • /content/documents/ - PDF và tài liệu
  • /content/gallery/ - Hình ảnh thư viện ảnh
  • /content/private/ - Tệp người dùng riêng tư
  • /content/public/ - Các tệp có thể truy cập công khai
  • /content/temp/ - Các tệp tạm thời có thể bị xóa

AI có thể tạo các thư mục lồng nhau như /content/uploads/2024/ hoặc /content/users/[username]/ khi thích hợp cho trường hợp sử dụng của bạn. Các tệp được theo dõi theo đường dẫn đầy đủ của chúng, do đó việc di chuyển hoặc đổi tên tệp sẽ tự động cập nhật tất cả các tham chiếu.

Giám sát và gỡ lỗi

Tất cả các hoạt động của tệp đều được ghi lại - tải lên, tải xuống, từ chối truy cập và lỗi. Bạn có thể xem các nhật ký này trong giao diện quản trị để hiểu cách sử dụng bộ nhớ tệp của bạn:

  • Xem tệp nào được tải lên thường xuyên nhất
  • Xác định nội dung tải lên không thành công và nguyên nhân đã xảy ra sự cố
  • Theo dõi các mẫu tải xuống và các tệp phổ biến
  • Theo dõi mức sử dụng và tăng trưởng bộ nhớ theo thời gian
  • Gỡ lỗi các vấn đề kiểm soát quyền truy cập khi người dùng không thể truy cập các tệp mà họ muốn xem

Hệ thống cũng theo dõi các số liệu lưu trữ - tổng số tệp được lưu trữ, tổng kích thước, tốc độ tăng trưởng và các tệp lớn nhất. Điều này giúp bạn hiểu được dung lượng lưu trữ của ứng dụng và kế hoạch mở rộng quy mô.

Giới hạn và ràng buộc

Theo mặc định, các tệp riêng lẻ có thể lên tới 500 MB. Điều này có thể cấu hình được — AI có thể điều chỉnh giới hạn dựa trên những gì bạn đang xây dựng. Đối với hầu hết các ứng dụng (tải lên hình ảnh, chia sẻ tài liệu, PDF), giới hạn mặc định là quá đủ.

Các tệp được lưu trữ dự phòng để đảm bảo độ tin cậy. Nếu bạn xóa một tệp, tệp đó sẽ bị xóa vĩnh viễn khỏi hệ thống — không có thùng rác hoặc thao tác hoàn tác nên việc xóa là ngay lập tức và là quyết định cuối cùng.

Làm việc với AI

Khi mô tả các tính năng cần lưu trữ tệp, hãy cụ thể về:

  • Ai có thể truy cập các tệp — Các quy tắc công khai, riêng tư, chia sẻ trong tổ chức hoặc tùy chỉnh
  • Loại tệp nào — Chỉ hình ảnh, tệp PDF, mọi loại tệp, giới hạn kích thước
  • Cách sắp xếp tệp — Thư mục, quy ước đặt tên, liệu người dùng có thể tạo thư mục con hay không
  • Điều gì xảy ra sau khi tải lên — Hiển thị trong thư viện, đính kèm vào một bản ghi, xử lý bằng một chức năng

AI sử dụng thông tin này để định cấu hình chính xác bộ lưu trữ, thiết lập chính sách truy cập và tạo giao diện phù hợp với nhu cầu của bạn.


Tài liệu liên quan: