Skip to Content

Pengelola File

  • Code: SET-FIL
  • Module: Settings
  • Type: Master Data

1. Overview

Pengelola File adalah pustaka semua file yang diunggah di tenant: logo perusahaan, gambar produk, lampiran, dan lainnya. Admin bisa menelusuri, mencari, dan menyaring seluruh file yang ada, lalu menghapus yang sudah tidak dipakai. File tidak diunggah langsung dari halaman ini; unggahan terjadi dari fitur masing-masing yang membutuhkannya, dan pustaka yang sama dipakai saat memilih file yang sudah ada.

Hasil yang diharapkan: penyimpanan tenant tetap rapi, dan admin tahu file mana yang dipakai di mana sebelum menghapusnya.

2. Problem

Tanpa pustaka file terpusat, berkas yang diunggah di berbagai fitur sulit dipantau dan dibersihkan. Akibatnya:

  • File yang diunggah menumpuk, termasuk file yang tidak pernah dipakai.
  • Sulit mengetahui sebuah file dipakai di mana sebelum menghapusnya.
  • Pengguna perlu memakai ulang file yang sama tanpa mengunggah ulang.

3. Goals & Non-goals

3.1 Goals

  • File yang sudah tidak terpakai bisa ditemukan dan dibersihkan sebelum memenuhi penyimpanan.
  • Penggunaan sebuah file diketahui sebelum file itu dihapus, sehingga tidak ada tampilan yang rusak.
  • File yang sudah ada bisa dipakai ulang di fitur lain tanpa diunggah kembali.

3.2 Non-goals

  • Unggah file langsung dari halaman ini; unggahan dilakukan dari fitur yang membutuhkannya.
  • Folder, penggantian nama, dan pemindahan file.
  • Kuota penyimpanan dan statistik pemakaian.

4. Business Rules

Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Pengelola File di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.

  • BR-01 File hanya bisa ditambahkan dari fitur yang membutuhkannya, bukan dari halaman Pengelola File.
  • BR-02 Kategori file ditentukan otomatis dari jenis berkasnya: gambar, dokumen, audio, atau video.
  • BR-03 Ukuran unggahan dibatasi maksimal 1 MB per berkas.
  • BR-04 Penyaringan berdasarkan penggunaan hanya membedakan berkas yang sedang dipakai dan yang tidak.
  • BR-05 Pilihan filter ekstensi hanya berisi ekstensi yang termasuk kategori yang sedang dipilih.

5. Flow

5.1 Main Flowchart

  1. Daftar File — Seluruh berkas yang diunggah di tenant ditampilkan dan dimuat bertahap.
  2. Cari dan Saring — Berkas dicari berdasarkan namanya, atau disaring menurut kategori, ekstensi, status penggunaan, dan pengunggahnya.
  3. Pratinjau File — Isi berkas dilihat lebih dulu untuk memastikan berkas yang dimaksud.
  4. Konfirmasi — Penghapusan dikonfirmasi lebih dulu, baik untuk satu berkas maupun beberapa sekaligus.
  5. File Terhapus — Berkas dihapus dari pustaka tenant.

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
Nama BerkasTeks—Mengikuti berkas yang diunggahNama berkas beserta ekstensinya
KategoriEnum—Ditentukan dari jenis berkasGambar, dokumen, audio, atau video (BR-02)
EkstensiTeks—Mengikuti berkas yang diunggahMisalnya png, pdf
Tipe BerkasTeks—Ditentukan dari isi berkasMisalnya image/png
UkuranAngka—Mengikuti berkas yang diunggahMaksimal 1 MB per berkas (BR-03)
Diunggah PadaTanggal & Waktu—Waktu unggahan—
Dibuat OlehRef. Pengguna—Pengguna yang mengunggahDitetapkan sistem
URLTeks—Dibuat saat berkas tersimpanAlamat berkas untuk pratinjau
Digunakan DiRef. Data, banyak——Daftar data yang memakai berkas ini

7. UI Structure

Bagian ini mendefinisikan cara File ditampilkan dan dioperasikan: kolom pada daftar dan filter beserta sumber pilihannya. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.

7.1 Datatable

Bisa dialihkan ke tampilan Grid; pilihan tampilan tersimpan di browser.

KolomSortableContoh NilaiKomponen
Nama Berkas—logo-terang.pngThumbnail, Text
Kategori—GambarBadge
Ukuran—240 KBText
Diunggah Pada—23 Sep 2026Date
Digunakan Di—CompanyAccordion bila lebih dari satu koleksi
Dibuat Oleh—Budi SantosoAvatar, Text
Aksi—Lihat · HapusAction Menu

Grid

BagianContoh NilaiKomponen
Gambar Mini—Thumbnail, hanya untuk berkas gambar
Nama Berkaslogo-terang.pngText
Tipe Berkasimage/pngText

7.2 Advance Filter

FieldKontrolSumber PilihanDefault
PenggunaanSingle SelectDigunakan atau Tidak DigunakanKosong
Dibuat OlehMulti SelectMaster Pengguna, bisa dicariKosong
KategoriMulti Select (checkbox)Gambar, Dokumen, Audio, VideoKosong
EkstensiMulti Select (checkbox)Mengikuti kategori yang dipilih (BR-05)Kosong

8. User Stories

US-01 - Menelusuri file

Sebagai admin, saya ingin melihat semua file tenant, agar tahu apa saja yang tersimpan.

IDKriteria penerimaan
AC-01.1Tampilan tabel: nama berkas, kategori, ukuran, diunggah pada, digunakan di, dibuat oleh.
AC-01.2Tampilan grid: gambar mini untuk file gambar, nama berkas, dan tipe MIME.
AC-01.3Pilihan tampilan grid/tabel tersimpan di browser dan dipakai lagi saat halaman dibuka.
AC-01.4Data dimuat bertahap saat menggulir.
AC-01.5Kolom “Digunakan Di” menampilkan nama koleksi; bila lebih dari satu, tampil jumlah koleksi yang bisa diperluas.

US-02 - Mencari dan menyaring file

Sebagai admin, saya ingin menyaring file, agar cepat menemukan file tertentu.

IDKriteria penerimaan
AC-02.1Pencarian berdasarkan kata kunci.
AC-02.2Filter kategori (multi), ekstensi (multi, sesuai kategori), penggunaan (Digunakan / Tidak Digunakan / semua), dan dibuat oleh (multi pengguna).
AC-02.3Jumlah filter aktif tampil di tombol filter.

US-03 - Pratinjau file

Sebagai admin, saya ingin melihat isi file tanpa mengunduhnya.

IDKriteria penerimaan
AC-03.1Aksi Lihat membuka pratinjau file dari tampilan grid maupun tabel.

US-04 - Menghapus file

Sebagai admin, saya ingin menghapus file yang tidak dipakai, agar penyimpanan rapi.

IDKriteria penerimaan
AC-04.1Hapus satuan dan massal hanya tersedia untuk pengguna dengan izin delete, setelah konfirmasi.
AC-04.2Bila penghapusan ditolak, pesan error tampil sebagai toast.
AC-04.3Menghapus file yang masih digunakan, misalnya logo perusahaan — tidak ada peringatan saat menghapus. Perlu dikonfirmasi: apakah ditolak atau kaitannya ikut dilepas.
AC-04.4Hapus massal dengan sebagian file gagal dihapus — Perlu dikonfirmasi: perlakuan atas sisanya; pesan hasilnya tampil sebagai toast.
AC-04.5Unggahan melebihi 1 MB — ditolak pengunggah sebelum dikirim.

9. User Scenarios

RoleScenario
AdminMenyaring file “Tidak Digunakan” lalu menghapusnya secara massal
AdminMencari logo lama berdasarkan nama file untuk melihat pratinjaunya
OwnerMelihat file apa saja yang diunggah oleh seorang pengguna
AdminBeralih ke tampilan grid untuk menelusuri gambar produk secara visual

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Filesettings:file:list:any—
Cari dan Saring Filesettings:file:list:any—
Pratinjau Filesettings:file:list:any—
Hapus Filesettings:file:delete:any—

11. Notifications

Fitur ini tidak memicu notifikasi.

12. Dependencies

PRD terkait

  • Company — logo perusahaan disimpan sebagai file.
  • Users — pengunggah file dan avatar pengguna.
  • Modul lain yang memakai pengunggah (produk, dan lainnya).

Efek ke modul lain

  • Menghapus file yang digunakan bisa membuat gambar/lampiran di modul lain hilang (lihat US-04).
Terakhir diperbarui