Perangkat Terhubung
- Code: ACC-DEV
- Module: Account
- Type: System Record
1. Overview
Perangkat Terhubung menampilkan semua perangkat yang sedang login ke akun pengguna, lengkap dengan perkiraan lokasi dan waktu aktivitas terakhirnya. Perangkat yang sedang dipakai ditandai sebagai Perangkat Ini. Pengguna bisa mencabut satu perangkat atau semua perangkat sekaligus untuk langsung mengeluarkan login di perangkat itu.
Hasil yang diharapkan: pengguna bisa mengenali login yang tidak dikenal dan segera mengeluarkannya.
2. Problem
Tanpa daftar perangkat yang sedang login, pengguna tidak tahu perangkat mana saja yang mengakses akunnya. Akibatnya:
- Pengguna sering login di perangkat bersama, misalnya komputer kasir atau ponsel rekan, lalu lupa logout.
- Login dari lokasi yang tidak dikenal tidak terdeteksi.
- Saat perangkat hilang, pengguna tidak punya cara mengeluarkan login di perangkat itu dari jarak jauh.
3. Goals & Non-goals
3.1 Goals
- Pengguna tahu perangkat mana saja yang sedang login ke akunnya.
- Login yang tertinggal di perangkat bersama bisa diakhiri dari jarak jauh.
- Login yang tidak dikenali bisa dikenali dari lokasi dan waktu aktivitas terakhirnya.
- Semua login bisa dicabut sekaligus saat perangkat hilang.
3.2 Non-goals
- Admin mencabut login milik pengguna lain.
- Pemberitahuan otomatis saat terjadi login baru.
- Penamaan perangkat secara manual.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Perangkat Terhubung 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 Satu perangkat mewakili satu login milik pengguna, dan pengguna hanya melihat perangkat miliknya sendiri.
- BR-02 Perangkat yang sedang dipakai ditandai Perangkat Ini dan selalu tampil paling atas. Perangkat lain diurutkan dari aktivitas terakhir yang terbaru.
- BR-03 Lokasi dan koordinat berasal dari alamat IP, jadi hanya perkiraan. Aktivitas Terakhir diperbarui paling cepat satu kali per menit untuk tiap perangkat.
- BR-04 Pengguna bisa mencabut satu perangkat lain atau semua perangkat sekaligus, dan pencabutan selalu dikonfirmasi lebih dulu. Perangkat yang sedang dipakai tidak bisa dicabut satu per satu; pengguna keluar darinya lewat logout biasa.
- BR-05 Mencabut perangkat langsung mengakhiri login di perangkat itu dan menghapus notifikasi di perangkat itu. Perangkat tersebut harus login ulang untuk memakai aplikasi lagi. Cabut semua juga mengeluarkan perangkat yang sedang dipakai.
- BR-06 Login yang melewati masa berlakunya, yaitu 7 hari tanpa aktivitas (lihat Autentikasi), otomatis dicabut dengan akibat yang sama seperti pencabutan manual.
- BR-07 Pencarian menyaring daftar berdasarkan nama perangkat dan hanya berlaku pada perangkat yang sudah ditampilkan.
- BR-08 Login perangkat dan pencabutan perangkat tercatat di log aktivitas beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Buka Perangkat Terhubung — Daftar perangkat yang sedang login tampil, dengan Perangkat Ini di urutan pertama (BR-01, BR-02).
- Pilih Tampilan — Pengguna memilih tampilan Grid atau Peta. Pilihan diingat di browser.
- Cari Perangkat — Pengguna mempersempit daftar berdasarkan nama perangkat bila perlu (BR-07).
- Pilih Aksi — Pengguna memilih mencabut satu perangkat atau semua perangkat (BR-04).
- Konfirmasi Cabut — Pengguna mengonfirmasi pencabutan satu perangkat. Perangkat Ini tidak punya aksi cabut.
- Konfirmasi Cabut Semua — Pengguna mengonfirmasi pencabutan semua perangkat. Pengguna ikut keluar dari perangkat yang sedang dipakai.
- Login Perangkat Berakhir — Perangkat itu langsung kehilangan akses dan harus login ulang (BR-05).
- Semua Login Berakhir — Semua perangkat kehilangan akses sekaligus, termasuk perangkat ini, lalu pengguna diarahkan ke halaman login (BR-05).
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
| Aktif | Login masih berlaku dan perangkatnya tampil di daftar | Dicabut |
| Dicabut | Login berakhir, perangkat hilang dari daftar dan harus login ulang; login ulang di browser yang sama mengaktifkan kembali data perangkat yang sama | Aktif |
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama Perangkat | Teks | — | Dikenali dari perangkat; bila tidak terdeteksi, disusun dari browser dan platform, atau “Unknown” | Misalnya Chrome on macOS. “Tidak Ada Nama Perangkat” tampil bila nama kosong |
| Perangkat Ini | Boolean | — | Ditentukan dari login yang sedang berjalan | Penanda perangkat yang sedang dipakai (BR-02) |
| Aktivitas Terakhir | Tanggal & Waktu | — | Diperbarui sistem | Paling cepat sekali per menit (BR-03) |
| Platform, Browser | Teks | — | Dikenali dari perangkat | Misalnya macOS, Chrome |
| Kota, Negara | Teks | — | Diturunkan dari alamat IP | Hanya perkiraan (BR-03) |
| Alamat IP | Teks | — | Direkam saat login | Diperbarui bila alamat IP berubah |
| Tipe Perangkat | Enum | — | Dikenali dari perangkat (smartphone, desktop, tablet), kosong bila tidak terdeteksi | Hanya menentukan ikon; tidak ditampilkan sebagai teks. Tipe kosong atau lain memakai ikon tanda tanya |
| Koordinat Lokasi | Desimal | — | Diturunkan dari alamat IP | Titik lokasi untuk peta, bisa kosong (BR-03) |
| User Agent | Teks | — | Dikenali dari perangkat | Dicatat sistem; tidak ditampilkan di UI |
7. UI Structure
Bagian ini mendefinisikan cara Perangkat Terhubung ditampilkan dan dioperasikan. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Grid & Map
Dua tampilan, Grid dan Peta, dipilih lewat toggle; pilihan tersimpan di browser. Satu kotak pencarian menyaring daftar berdasarkan nama perangkat (BR-07). Aksi di header: Cabut Semua Perangkat.
Grid 🚧 Belum: FE
| Bagian | Contoh Nilai | Komponen |
|---|---|---|
| Ikon Perangkat | — | Icon, sesuai Tipe Perangkat |
| Nama Perangkat | Chrome on macOS | Text |
| Penanda | Perangkat Ini atau Perangkat Lain | Badge |
| Aktivitas Terakhir | 5 menit lalu | Text |
| Platform, Browser | macOS, Chrome | Text |
| Kota, Negara | Jakarta, Indonesia | Text |
| Alamat IP | 103.10.20.1 | Text |
| Aksi | Cabut | Button, hanya pada perangkat selain Perangkat Ini |
Peta
| Bagian | Komponen |
|---|---|
| Marker | Lingkaran berisi ikon Tipe Perangkat, warna primer untuk Perangkat Ini dan warna redup untuk lainnya; hanya perangkat dengan Koordinat Lokasi |
| Tooltip | Nama Perangkat |
| Popup | Sama seperti kartu Grid, dengan aksi Cabut |
8. User Stories
US-01 - Melihat perangkat terhubung
Sebagai pengguna, saya ingin melihat semua perangkat yang sedang login ke akun saya, agar tahu perangkat mana yang masih masuk.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Hanya perangkat milik pengguna yang tampil (BR-01). |
| AC-01.2 | Perangkat Ini tampil paling atas dan ditandai; perangkat lain diurutkan dari aktivitas terakhir yang terbaru (BR-02). |
| AC-01.3 | Setiap perangkat menampilkan ikon tipe perangkat, platform, browser, IP, kota, negara, dan aktivitas terakhir; tipe perangkat dan user agent tidak ditampilkan sebagai teks; nilai kosong tampil ”-”. 🚧 Belum: FE |
| AC-01.4 | Nama perangkat kosong — tampil “Tidak Ada Nama Perangkat”; tipe perangkat tidak terdeteksi — tampil ikon tanda tanya. |
| AC-01.5 | Pencarian menyaring daftar berdasarkan nama perangkat (BR-07). |
| AC-01.6 | Skeleton tampil selama data dimuat. |
US-02 - Melihat lokasi di peta
Sebagai pengguna, saya ingin melihat lokasi login di peta, agar login yang mencurigakan mudah terlihat.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Hanya perangkat dengan koordinat lokasi yang tampil sebagai marker (BR-03). |
| AC-02.2 | Peta menyesuaikan batas ke semua marker; bila hanya satu marker, peta berpusat padanya. |
| AC-02.3 | Marker punya tooltip dan popup detail dengan aksi cabut untuk perangkat lain. |
| AC-02.4 | Perangkat tanpa koordinat tidak tampil di peta, tetapi tetap tampil di Grid. |
| AC-02.5 | Tidak ada perangkat dengan koordinat — peta tampil tanpa marker. |
| AC-02.6 | Pilihan tampilan Grid atau Peta diingat di browser. |
US-03 - Mencabut satu perangkat
Sebagai pengguna, saya ingin mengeluarkan login di perangkat tertentu.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Aksi cabut hanya tersedia untuk perangkat selain Perangkat Ini (BR-04). |
| AC-03.2 | Pencabutan meminta konfirmasi lebih dulu (BR-04). |
| AC-03.3 | Setelah konfirmasi, login perangkat itu berakhir, toast sukses tampil, dan daftar dimuat ulang (BR-05). |
| AC-03.4 | Perangkat dicabut saat sedang dipakai — permintaan berikutnya langsung ditolak dan perangkat diarahkan ke halaman login (BR-05). |
| AC-03.5 | Pencabutan tercatat di log aktivitas (BR-08). |
US-04 - Mencabut semua perangkat
Sebagai pengguna, saya ingin mengeluarkan login di semua perangkat sekaligus.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Tombol Cabut Semua Perangkat tersedia di header dan meminta konfirmasi lebih dulu (BR-04). |
| AC-04.2 | Teks konfirmasi menyebut bahwa perangkat ini ikut keluar. |
| AC-04.3 | Setelah berhasil, semua login berakhir termasuk perangkat ini, dan pengguna langsung diarahkan ke halaman login (BR-05). |
| AC-04.4 | Pencabutan tercatat di log aktivitas (BR-08). |
US-05 - Login kedaluwarsa
Sebagai pengguna, saya ingin login yang sudah lama tidak dipakai dicabut otomatis, agar tidak ada login yang tertinggal.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Login yang melewati 7 hari tanpa aktivitas dicabut otomatis; perangkatnya hilang dari daftar dan harus login ulang (BR-06). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Pengguna | Mencabut login di komputer bersama yang lupa di-logout |
| Pengguna | Melihat peta dan menemukan login dari kota yang tidak dikenal, lalu mencabutnya |
| Pengguna | Ponsel hilang; mencabut semua perangkat dari laptop |
| Pengguna | Setelah mengganti kata sandi, memeriksa daftar perangkat untuk memastikan hanya perangkatnya yang login |
10. Permissions & Actions
10.1 Permission by Action
Fitur ini tidak memiliki permission; semua pengguna yang login hanya mengelola perangkat miliknya sendiri.
10.2 Action by Device
| Action | Perangkat Ini | Perangkat Lain |
|---|---|---|
| Lihat Detail | ✓ | ✓ |
| Cabut | — | ✓ |
| Tercakup Cabut Semua | ✓ | ✓ |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Authentication — login dari perangkat yang belum ada di daftar ini memicu notifikasi perangkat baru (BR-16 di sana); login membuat perangkat, dan perangkat yang dicabut kembali ke halaman login lewat alur di sana.
- My Account — mengganti kata sandi atau email mengeluarkan pengguna dari semua perangkat.
- Notifications — notifikasi perangkat terikat ke perangkat yang login dan ikut dihapus saat perangkat dicabut (BR-05).
- Activity Logs — mencatat login dan pencabutan perangkat (BR-08).