File Saya
- Code: ACC-FIL
- Module: Account
- Type: Master Data
1. Overview
File Saya adalah pustaka file yang diunggah pengguna yang sedang login, misalnya foto profil, gambar produk, dan logo. Pengguna bisa menelusuri, mencari, dan menyaring filenya sendiri, lalu menghapus yang sudah tidak dipakai. Halaman ini adalah versi pribadi dari Settings → Pengelola File: hanya file milik pengguna sendiri yang tampil.
Hasil yang diharapkan: pengguna bisa membersihkan unggahannya sendiri tanpa bantuan admin.
2. Problem
Tanpa ruang kelola file pribadi, unggahan yang sudah tidak terpakai menumpuk dan hanya bisa dibersihkan lewat admin. Akibatnya:
- Pengguna sering mengganti foto atau gambar sehingga file lamanya tertinggal tanpa dipakai.
- Pengguna biasa tidak punya akses ke Pengelola File tenant, padahal mereka perlu mengelola unggahannya sendiri.
3. Goals & Non-goals
3.1 Goals
- Pengguna bisa melihat dan membersihkan unggahannya sendiri tanpa akses admin.
- File yang tidak jadi dipakai tidak menumpuk tanpa disadari pemiliknya.
3.2 Non-goals
- Mengunggah file langsung dari halaman ini; unggahan dilakukan dari fitur yang membutuhkannya.
- Berbagi file ke pengguna lain.
- Melihat file milik pengguna lain; kebutuhan itu dilayani Pengelola File untuk admin.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk File Saya 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 Hanya file yang diunggah pengguna itu sendiri yang tampil dan bisa dihapus dari halaman ini. File milik pengguna lain tidak bisa dilihat.
- BR-02 File tidak diunggah dari halaman ini, tetapi dari fitur yang membutuhkannya, misalnya foto profil. File yang diunggah tetapi tidak jadi disimpan berstatus sementara, tidak tampil di sini, dan dibersihkan otomatis setelah kedaluwarsa.
- BR-03 Kategori file ditentukan dari jenisnya: gambar, video, atau dokumen. File audio saat ini tercatat sebagai dokumen.
- BR-04 Daftar bisa dicari lewat nama dan disaring menurut penggunaan (digunakan atau tidak digunakan), kategori, dan ekstensi. Pilihan ekstensi hanya berisi ekstensi dari kategori yang dipilih. Tanpa urutan yang dipilih pengguna, daftar diurutkan dari yang terakhir diperbarui.
- BR-05 File yang masih dipakai data lain, yaitu kolom Digunakan Di tidak kosong, tidak bisa dihapus, baik satu per satu maupun sekaligus. Pengguna melihat pesan bahwa file masih digunakan.
- BR-06 Hapus satu file hanya mensyaratkan file itu milik pengguna sendiri. Hapus beberapa file sekaligus saat ini juga mensyaratkan izin
settings:file:delete:any, dan bila satu file saja ditolak (bukan milik sendiri, tanpa izin, atau masih digunakan), seluruh penghapusan dibatalkan. - BR-07 Penghapusan selalu dikonfirmasi lebih dulu. File yang dihapus juga hilang dari penyimpanan dan tidak bisa dipulihkan.
5. Flow
5.1 Main Flowchart
- Buka File Saya — Daftar file milik pengguna tampil dan dimuat bertahap (BR-01).
- Pilih Tampilan — Pengguna memilih tampilan Tabel atau Grid. Pilihan diingat di browser.
- Cari dan Saring — Pengguna mencari file berdasarkan nama, atau menyaringnya menurut kategori, ekstensi, dan penggunaan (BR-04).
- Pilih Aksi — Pengguna memilih melihat file, atau menghapus satu atau beberapa file.
- Pratinjau File — Isi file dilihat lebih dulu untuk memastikan file yang dimaksud.
- Konfirmasi Hapus — Pengguna mengonfirmasi penghapusan. File yang masih digunakan ditolak (BR-05, BR-06, BR-07).
- File Terhapus — File hilang dari pustaka pribadi pengguna dan dari penyimpanan (BR-07).
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama File | Teks | — | Mengikuti file yang diunggah | Nama file beserta ekstensinya |
| Kategori | Enum | — | Ditentukan dari jenis file | Gambar, dokumen, atau video (BR-03) |
| Ukuran | Angka | — | Mengikuti file yang diunggah | — |
| Diunggah Pada | Tanggal & Waktu | — | Waktu unggahan | Diisi dari waktu file terakhir diperbarui |
| Digunakan Di | Teks, banyak | — | — | Nama pemakaian file ini, misalnya Avatar; kosong ditampilkan ”-” (BR-05) |
7. UI Structure
Bagian ini mendefinisikan cara File Saya 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 File | — | foto-profil.png | Thumbnail, Text |
| Kategori | — | Gambar | Badge |
| Ukuran | — | 180 KB | Text |
| Diunggah Pada | — | 23 Sep 2026 | Date |
| Digunakan Di | — | Avatar | Accordion bila lebih dari satu pemakaian, ”-” bila kosong |
| Aksi | — | Lihat · Hapus | Action Menu |
Grid
| Bagian | Contoh Nilai | Komponen |
|---|---|---|
| Gambar Mini | — | Thumbnail, hanya untuk file gambar |
| Nama File | foto-profil.png | Text |
| Tipe File | image/png | Text |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Penggunaan | Single Select | Digunakan atau Tidak Digunakan | Kosong |
| Kategori | Multi Select (checkbox) | Gambar, Dokumen, Audio, Video | Kosong |
| Ekstensi | Multi Select (checkbox) | Mengikuti kategori yang dipilih (BR-04) | Kosong |
8. User Stories
US-01 - Menelusuri file saya
Sebagai pengguna, saya ingin melihat semua file yang saya unggah.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Hanya file milik pengguna yang login yang tampil (BR-01). |
| AC-01.2 | Tampilan tabel menampilkan nama file, kategori, ukuran, diunggah pada, dan digunakan di; nilai kosong tampil ”-”. |
| AC-01.3 | Tampilan grid menampilkan gambar mini untuk file gambar, nama file, dan tipe file. |
| AC-01.4 | Pilihan tampilan tabel atau grid diingat di browser. |
| AC-01.5 | File yang diunggah tetapi form-nya batal disimpan tidak tampil di sini dan dibersihkan otomatis (BR-02). |
| AC-01.6 | File berstatus Tidak Digunakan berasal dari file yang kaitannya sudah dilepas, misalnya foto profil lama yang diganti. |
US-02 - Mencari dan menyaring
Sebagai pengguna, saya ingin menyaring file saya.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Pencarian menyaring daftar berdasarkan nama file (BR-04). |
| AC-02.2 | Filter tersedia untuk kategori (bisa lebih dari satu), ekstensi (mengikuti kategori yang dipilih), dan penggunaan (BR-04). |
| AC-02.3 | Jumlah filter aktif tampil di tombol filter. |
| AC-02.4 | Kategori audio ada di filter tetapi belum memberi hasil karena file audio tercatat sebagai dokumen (BR-03). Perlu dikonfirmasi: apakah kategori audio perlu diberikan ke file audio. |
US-03 - Pratinjau file
Sebagai pengguna, saya ingin melihat isi file saya sebelum menghapusnya.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Aksi Lihat membuka pratinjau, dari tampilan tabel maupun grid. |
US-04 - Menghapus file
Sebagai pengguna, saya ingin menghapus file yang tidak saya pakai lagi.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Hapus satu file tersedia untuk semua pengguna dan meminta konfirmasi lebih dulu (BR-06, BR-07). |
| AC-04.2 | Hapus beberapa file sekaligus meminta konfirmasi lebih dulu dan saat ini mensyaratkan izin Pengelola File; tombolnya tetap tampil untuk semua pengguna (BR-06). Perlu dikonfirmasi: apakah hapus sekaligus seharusnya tanpa izin Pengelola File seperti hapus satu file. |
| AC-04.3 | File yang masih digunakan, misalnya foto profil sendiri atau gambar produk, tidak bisa dihapus dan pesan file masih digunakan tampil sebagai toast (BR-05). |
| AC-04.4 | Satu file saja ditolak dalam hapus sekaligus — seluruh penghapusan dibatalkan dan pesan error tampil sebagai toast (BR-06). |
| AC-04.5 | Setelah berhasil, file hilang dari daftar dan tidak bisa dipulihkan (BR-07). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Pengguna | Menyaring file “Tidak Digunakan” lalu menghapusnya sekaligus |
| Pengguna | Mencari gambar produk yang pernah diunggah untuk memeriksanya |
| Pengguna | Beralih ke tampilan grid untuk melihat gambar secara visual |
| Pengguna | Mengganti foto profil, lalu menghapus foto lama dari File Saya |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat, Cari, dan Hapus Satu File | — | Pengguna login; hanya file milik sendiri |
| Hapus Beberapa File Sekaligus | settings:file:delete:any | Pengguna login; hanya file milik sendiri dan tidak digunakan (lihat catatan perlu dikonfirmasi di AC-04.2) |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- File Manager (Settings) — versi tenant dengan semua file dan filter pengunggah.
- My Account — foto profil disimpan sebagai file milik pengguna, dan foto lama tetap ada di sini sebagai Tidak Digunakan.
Efek ke modul lain
- File yang dihapus dari sini hilang permanen dari penyimpanan dan tidak bisa dipilih lagi oleh fitur lain, misalnya foto profil.