My Files (File Saya)
| Code | ACC-FIL |
| Module | Account |
| Type | Self-service file library |
| Status | Implemented |
| Priority | P2 |
| Process | Manajemen akun pribadi |
| API | [URL Postman] |
1. Overview
File Saya adalah pustaka file yang diunggah oleh pengguna yang sedang login, misalnya foto profil, gambar produk, dan logo. Pengguna bisa melihat file dalam tampilan grid atau tabel, mencari, menyaring (kategori, ekstensi, penggunaan), melihat pratinjau, dan menghapus file miliknya.
Halaman ini adalah versi pribadi dari Settings → Pengelola File. Bedanya, hanya file milik pengguna sendiri yang tampil, dan tidak butuh permission khusus.
Hasil yang diharapkan: pengguna bisa membersihkan unggahannya sendiri tanpa akses admin.
2. Problem
- Pengguna sering mengunggah file yang akhirnya tidak dipakai (salah pilih, coba-coba).
- Pengguna biasa tidak punya akses ke Pengelola File tenant, tetapi tetap perlu mengelola unggahannya.
3. Goals & Non-goals
Goals
- Pengguna bisa melihat semua file yang ia unggah. Indikator: daftar hanya berisi file milik pengguna.
- Pengguna bisa membersihkan file tak terpakai. Indikator: filter “Tidak Digunakan” dan hapus massal.
Non-goals
- Unggah file langsung dari halaman ini
- Berbagi file ke pengguna lain
- Melihat file milik pengguna lain (lihat Pengelola File)
4. User Scenarios
| Role | Scenario |
|---|---|
| Semua pengguna | Menyaring file “Tidak Digunakan” lalu menghapusnya sekaligus |
| Staf | Mencari gambar produk yang pernah diunggah untuk memeriksanya |
| Semua pengguna | Beralih ke tampilan grid untuk melihat gambar secara visual |
5. User Flow
- Daftar file — Dimuat bertahap (15 per muatan). Pilihan tampilan grid/tabel disimpan di browser (localStorage, terpisah dari Pengelola File).
- Cari / filter — Pencarian kata kunci; filter kategori (Gambar, Dokumen, Audio, Video), ekstensi (menyesuaikan kategori), dan penggunaan (Digunakan / Tidak Digunakan).
- Pratinjau — Membuka file dalam penampil.
- Konfirmasi hapus — Dialog konfirmasi hapus satuan atau massal.
- Terhapus — Toast sukses, daftar dimuat ulang.
Alternative paths
- Kategori filter diubah — ekstensi yang tidak termasuk kategori baru otomatis dilepas.
6. User Stories
Prioritas: P0 wajib untuk rilis, P1 penting, P2 kalau sempat.
US-01 — Menelusuri file saya (P2)
Sebagai pengguna, saya ingin melihat semua file yang saya unggah.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Hanya file milik pengguna yang login yang tampil. |
| AC-01.2 | Tampilan tabel: nama berkas, kategori, ukuran, diunggah pada, digunakan di (kosong ditampilkan ”-”). |
| AC-01.3 | Tampilan grid: gambar mini untuk file gambar, nama berkas, tipe MIME. |
| AC-01.4 | Pilihan tampilan tersimpan di browser. |
US-02 — Mencari dan menyaring (P2)
Sebagai pengguna, saya ingin menyaring file saya.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Pencarian kata kunci. |
| AC-02.2 | Filter kategori (multi), ekstensi (multi, sesuai kategori), dan penggunaan. |
| AC-02.3 | Jumlah filter aktif tampil di tombol filter. |
US-03 — Pratinjau dan hapus (P2)
Sebagai pengguna, saya ingin melihat dan menghapus file saya.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Aksi Lihat membuka pratinjau dari grid maupun tabel. |
| AC-03.2 | Hapus satuan dan massal selalu tersedia (tanpa permission), setelah konfirmasi. |
| AC-03.3 | Bila BE menolak, pesan error tampil sebagai toast. |
7. Document Structure
Sama dengan PRD File Manager bagian 7, tanpa kolom “Dibuat Oleh” (selalu pengguna sendiri).
| Field | Required | Default | Notes |
|---|---|---|---|
| Nama Berkas | — | — | Read-only |
| Kategori | — | — | image, document, audio, video |
| Ukuran | — | — | |
| Diunggah Pada | — | — | |
| Digunakan Di | — | — | Koleksi dari fileables; kosong ditampilkan ”-” |
8. Status Lifecycle
Tidak berlaku. Status “Digunakan / Tidak Digunakan” diturunkan dari relasi fileables.
9. Permissions & Actions
Permissions
| Action | Permission | Syarat tambahan |
|---|---|---|
| Lihat, cari, filter, pratinjau, hapus | — | Pengguna login; hanya file milik sendiri |
10. Business Rules
Aturan bisnis adalah ketentuan yang berlaku di semua layar dan semua aksi, siapa pun yang melakukannya. FE memakainya sebagai validasi di form, BE memakainya sebagai sumber kebenaran; jika keduanya berbeda, perilaku BE yang dianggap benar dan FE menyesuaikan.
- BR-01 Hanya file dengan pengunggah = pengguna login yang dikembalikan dan boleh dihapus.
- BR-02 File hanya ditambahkan lewat komponen pengunggah di fitur lain.
- BR-03 Filter penggunaan dikirim sebagai
has_any_relationships. - BR-04 Filter ekstensi hanya berisi ekstensi dari kategori terpilih.
11. Edge Cases
Edge case adalah kondisi yang jarang terjadi tetapi pasti muncul di operasional nyata. Perilaku yang diharapkan ditetapkan di sini agar tidak diputuskan sendiri-sendiri saat implementasi.
| ID | Case | Expected behavior |
|---|---|---|
| EC-01 | Menghapus file yang masih digunakan (misalnya foto profil sendiri atau gambar produk) | FE tidak memperingatkan; BE menentukan apakah ditolak atau relasi ikut dilepas |
| EC-02 | Pengguna mengunggah file lalu batal menyimpan form | File tetap ada sebagai “Tidak Digunakan” dan bisa dihapus di sini |
12. API Contract
| Action | Method | Endpoint | Ref |
|---|---|---|---|
| Daftar file saya (cursor, cari, filter) | GET | /api/auth/files/cursor | US-01, US-02 |
| Hapus file saya | DELETE | /api/auth/files/:id | US-03 |
| Hapus file saya massal | POST | /api/auth/files/delete-many | US-03 |
13. Dependencies
PRD terkait
- File Manager (Settings) — versi tenant dengan semua file dan filter pengunggah.
- My Account — foto profil disimpan sebagai file milik pengguna.