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
- Daftar File — Seluruh berkas yang diunggah di tenant ditampilkan dan dimuat bertahap.
- Cari dan Saring — Berkas dicari berdasarkan namanya, atau disaring menurut kategori, ekstensi, status penggunaan, dan pengunggahnya.
- Pratinjau File — Isi berkas dilihat lebih dulu untuk memastikan berkas yang dimaksud.
- Konfirmasi — Penghapusan dikonfirmasi lebih dulu, baik untuk satu berkas maupun beberapa sekaligus.
- File Terhapus — Berkas dihapus dari pustaka tenant.
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama Berkas | Teks | — | Mengikuti berkas yang diunggah | Nama berkas beserta ekstensinya |
| Kategori | Enum | — | Ditentukan dari jenis berkas | Gambar, dokumen, audio, atau video (BR-02) |
| Ekstensi | Teks | — | Mengikuti berkas yang diunggah | Misalnya png, pdf |
| Tipe Berkas | Teks | — | Ditentukan dari isi berkas | Misalnya image/png |
| Ukuran | Angka | — | Mengikuti berkas yang diunggah | Maksimal 1 MB per berkas (BR-03) |
| Diunggah Pada | Tanggal & Waktu | — | Waktu unggahan | — |
| Dibuat Oleh | Ref. Pengguna | — | Pengguna yang mengunggah | Ditetapkan sistem |
| URL | Teks | — | Dibuat saat berkas tersimpan | Alamat berkas untuk pratinjau |
| Digunakan Di | Ref. 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.
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Nama Berkas | — | logo-terang.png | Thumbnail, Text |
| Kategori | — | Gambar | Badge |
| Ukuran | — | 240 KB | Text |
| Diunggah Pada | — | 23 Sep 2026 | Date |
| Digunakan Di | — | Company | Accordion bila lebih dari satu koleksi |
| Dibuat Oleh | — | Budi Santoso | Avatar, Text |
| Aksi | — | Lihat · Hapus | Action Menu |
Grid
| Bagian | Contoh Nilai | Komponen |
|---|---|---|
| Gambar Mini | — | Thumbnail, hanya untuk berkas gambar |
| Nama Berkas | logo-terang.png | Text |
| Tipe Berkas | image/png | Text |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Penggunaan | Single Select | Digunakan atau Tidak Digunakan | Kosong |
| Dibuat Oleh | Multi Select | Master Pengguna, bisa dicari | Kosong |
| Kategori | Multi Select (checkbox) | Gambar, Dokumen, Audio, Video | Kosong |
| Ekstensi | Multi 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Tampilan tabel: nama berkas, kategori, ukuran, diunggah pada, digunakan di, dibuat oleh. |
| AC-01.2 | Tampilan grid: gambar mini untuk file gambar, nama berkas, dan tipe MIME. |
| AC-01.3 | Pilihan tampilan grid/tabel tersimpan di browser dan dipakai lagi saat halaman dibuka. |
| AC-01.4 | Data dimuat bertahap saat menggulir. |
| AC-01.5 | Kolom “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.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Pencarian berdasarkan kata kunci. |
| AC-02.2 | Filter kategori (multi), ekstensi (multi, sesuai kategori), penggunaan (Digunakan / Tidak Digunakan / semua), dan dibuat oleh (multi pengguna). |
| AC-02.3 | Jumlah filter aktif tampil di tombol filter. |
US-03 - Pratinjau file
Sebagai admin, saya ingin melihat isi file tanpa mengunduhnya.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Aksi 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Hapus satuan dan massal hanya tersedia untuk pengguna dengan izin delete, setelah konfirmasi. |
| AC-04.2 | Bila penghapusan ditolak, pesan error tampil sebagai toast. |
| AC-04.3 | Menghapus file yang masih digunakan, misalnya logo perusahaan — tidak ada peringatan saat menghapus. Perlu dikonfirmasi: apakah ditolak atau kaitannya ikut dilepas. |
| AC-04.4 | Hapus massal dengan sebagian file gagal dihapus — Perlu dikonfirmasi: perlakuan atas sisanya; pesan hasilnya tampil sebagai toast. |
| AC-04.5 | Unggahan melebihi 1 MB — ditolak pengunggah sebelum dikirim. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Admin | Menyaring file “Tidak Digunakan” lalu menghapusnya secara massal |
| Admin | Mencari logo lama berdasarkan nama file untuk melihat pratinjaunya |
| Owner | Melihat file apa saja yang diunggah oleh seorang pengguna |
| Admin | Beralih ke tampilan grid untuk menelusuri gambar produk secara visual |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List File | settings:file:list:any | — |
| Cari dan Saring File | settings:file:list:any | — |
| Pratinjau File | settings:file:list:any | — |
| Hapus File | settings: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).