Skip to Content

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

  1. Buka File Saya — Daftar file milik pengguna tampil dan dimuat bertahap (BR-01).
  2. Pilih Tampilan — Pengguna memilih tampilan Tabel atau Grid. Pilihan diingat di browser.
  3. Cari dan Saring — Pengguna mencari file berdasarkan nama, atau menyaringnya menurut kategori, ekstensi, dan penggunaan (BR-04).
  4. Pilih Aksi — Pengguna memilih melihat file, atau menghapus satu atau beberapa file.
  5. Pratinjau File — Isi file dilihat lebih dulu untuk memastikan file yang dimaksud.
  6. Konfirmasi Hapus — Pengguna mengonfirmasi penghapusan. File yang masih digunakan ditolak (BR-05, BR-06, BR-07).
  7. File Terhapus — File hilang dari pustaka pribadi pengguna dan dari penyimpanan (BR-07).

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
Nama FileTeks—Mengikuti file yang diunggahNama file beserta ekstensinya
KategoriEnum—Ditentukan dari jenis fileGambar, dokumen, atau video (BR-03)
UkuranAngka—Mengikuti file yang diunggah—
Diunggah PadaTanggal & Waktu—Waktu unggahanDiisi dari waktu file terakhir diperbarui
Digunakan DiTeks, 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.

KolomSortableContoh NilaiKomponen
Nama File—foto-profil.pngThumbnail, Text
Kategori—GambarBadge
Ukuran—180 KBText
Diunggah Pada—23 Sep 2026Date
Digunakan Di—AvatarAccordion bila lebih dari satu pemakaian, ”-” bila kosong
Aksi—Lihat · HapusAction Menu

Grid

BagianContoh NilaiKomponen
Gambar Mini—Thumbnail, hanya untuk file gambar
Nama Filefoto-profil.pngText
Tipe Fileimage/pngText

7.2 Advance Filter

FieldKontrolSumber PilihanDefault
PenggunaanSingle SelectDigunakan atau Tidak DigunakanKosong
KategoriMulti Select (checkbox)Gambar, Dokumen, Audio, VideoKosong
EkstensiMulti 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.

IDKriteria penerimaan
AC-01.1Hanya file milik pengguna yang login yang tampil (BR-01).
AC-01.2Tampilan tabel menampilkan nama file, kategori, ukuran, diunggah pada, dan digunakan di; nilai kosong tampil ”-”.
AC-01.3Tampilan grid menampilkan gambar mini untuk file gambar, nama file, dan tipe file.
AC-01.4Pilihan tampilan tabel atau grid diingat di browser.
AC-01.5File yang diunggah tetapi form-nya batal disimpan tidak tampil di sini dan dibersihkan otomatis (BR-02).
AC-01.6File 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.

IDKriteria penerimaan
AC-02.1Pencarian menyaring daftar berdasarkan nama file (BR-04).
AC-02.2Filter tersedia untuk kategori (bisa lebih dari satu), ekstensi (mengikuti kategori yang dipilih), dan penggunaan (BR-04).
AC-02.3Jumlah filter aktif tampil di tombol filter.
AC-02.4Kategori 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.

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

US-04 - Menghapus file

Sebagai pengguna, saya ingin menghapus file yang tidak saya pakai lagi.

IDKriteria penerimaan
AC-04.1Hapus satu file tersedia untuk semua pengguna dan meminta konfirmasi lebih dulu (BR-06, BR-07).
AC-04.2Hapus 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.3File 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.4Satu file saja ditolak dalam hapus sekaligus — seluruh penghapusan dibatalkan dan pesan error tampil sebagai toast (BR-06).
AC-04.5Setelah berhasil, file hilang dari daftar dan tidak bisa dipulihkan (BR-07).

9. User Scenarios

RoleScenario
PenggunaMenyaring file “Tidak Digunakan” lalu menghapusnya sekaligus
PenggunaMencari gambar produk yang pernah diunggah untuk memeriksanya
PenggunaBeralih ke tampilan grid untuk melihat gambar secara visual
PenggunaMengganti foto profil, lalu menghapus foto lama dari File Saya

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat, Cari, dan Hapus Satu File—Pengguna login; hanya file milik sendiri
Hapus Beberapa File Sekaligussettings:file:delete:anyPengguna 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.
Terakhir diperbarui