Skip to Content
Tenant BackofficeAkunPerangkat Terhubung

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

  1. Buka Perangkat Terhubung — Daftar perangkat yang sedang login tampil, dengan Perangkat Ini di urutan pertama (BR-01, BR-02).
  2. Pilih Tampilan — Pengguna memilih tampilan Grid atau Peta. Pilihan diingat di browser.
  3. Cari Perangkat — Pengguna mempersempit daftar berdasarkan nama perangkat bila perlu (BR-07).
  4. Pilih Aksi — Pengguna memilih mencabut satu perangkat atau semua perangkat (BR-04).
  5. Konfirmasi Cabut — Pengguna mengonfirmasi pencabutan satu perangkat. Perangkat Ini tidak punya aksi cabut.
  6. Konfirmasi Cabut Semua — Pengguna mengonfirmasi pencabutan semua perangkat. Pengguna ikut keluar dari perangkat yang sedang dipakai.
  7. Login Perangkat Berakhir — Perangkat itu langsung kehilangan akses dan harus login ulang (BR-05).
  8. Semua Login Berakhir — Semua perangkat kehilangan akses sekaligus, termasuk perangkat ini, lalu pengguna diarahkan ke halaman login (BR-05).

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
AktifLogin masih berlaku dan perangkatnya tampil di daftarDicabut
DicabutLogin berakhir, perangkat hilang dari daftar dan harus login ulang; login ulang di browser yang sama mengaktifkan kembali data perangkat yang samaAktif

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
Nama PerangkatTeks—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 IniBoolean—Ditentukan dari login yang sedang berjalanPenanda perangkat yang sedang dipakai (BR-02)
Aktivitas TerakhirTanggal & Waktu—Diperbarui sistemPaling cepat sekali per menit (BR-03)
Platform, BrowserTeks—Dikenali dari perangkatMisalnya macOS, Chrome
Kota, NegaraTeks—Diturunkan dari alamat IPHanya perkiraan (BR-03)
Alamat IPTeks—Direkam saat loginDiperbarui bila alamat IP berubah
Tipe PerangkatEnum—Dikenali dari perangkat (smartphone, desktop, tablet), kosong bila tidak terdeteksiHanya menentukan ikon; tidak ditampilkan sebagai teks. Tipe kosong atau lain memakai ikon tanda tanya
Koordinat LokasiDesimal—Diturunkan dari alamat IPTitik lokasi untuk peta, bisa kosong (BR-03)
User AgentTeks—Dikenali dari perangkatDicatat 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

BagianContoh NilaiKomponen
Ikon Perangkat—Icon, sesuai Tipe Perangkat
Nama PerangkatChrome on macOSText
PenandaPerangkat Ini atau Perangkat LainBadge
Aktivitas Terakhir5 menit laluText
Platform, BrowsermacOS, ChromeText
Kota, NegaraJakarta, IndonesiaText
Alamat IP103.10.20.1Text
AksiCabutButton, hanya pada perangkat selain Perangkat Ini

Peta

BagianKomponen
MarkerLingkaran berisi ikon Tipe Perangkat, warna primer untuk Perangkat Ini dan warna redup untuk lainnya; hanya perangkat dengan Koordinat Lokasi
TooltipNama Perangkat
PopupSama 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.

IDKriteria penerimaan
AC-01.1Hanya perangkat milik pengguna yang tampil (BR-01).
AC-01.2Perangkat Ini tampil paling atas dan ditandai; perangkat lain diurutkan dari aktivitas terakhir yang terbaru (BR-02).
AC-01.3Setiap 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.4Nama perangkat kosong — tampil “Tidak Ada Nama Perangkat”; tipe perangkat tidak terdeteksi — tampil ikon tanda tanya.
AC-01.5Pencarian menyaring daftar berdasarkan nama perangkat (BR-07).
AC-01.6Skeleton 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.

IDKriteria penerimaan
AC-02.1Hanya perangkat dengan koordinat lokasi yang tampil sebagai marker (BR-03).
AC-02.2Peta menyesuaikan batas ke semua marker; bila hanya satu marker, peta berpusat padanya.
AC-02.3Marker punya tooltip dan popup detail dengan aksi cabut untuk perangkat lain.
AC-02.4Perangkat tanpa koordinat tidak tampil di peta, tetapi tetap tampil di Grid.
AC-02.5Tidak ada perangkat dengan koordinat — peta tampil tanpa marker.
AC-02.6Pilihan tampilan Grid atau Peta diingat di browser.

US-03 - Mencabut satu perangkat

Sebagai pengguna, saya ingin mengeluarkan login di perangkat tertentu.

IDKriteria penerimaan
AC-03.1Aksi cabut hanya tersedia untuk perangkat selain Perangkat Ini (BR-04).
AC-03.2Pencabutan meminta konfirmasi lebih dulu (BR-04).
AC-03.3Setelah konfirmasi, login perangkat itu berakhir, toast sukses tampil, dan daftar dimuat ulang (BR-05).
AC-03.4Perangkat dicabut saat sedang dipakai — permintaan berikutnya langsung ditolak dan perangkat diarahkan ke halaman login (BR-05).
AC-03.5Pencabutan tercatat di log aktivitas (BR-08).

US-04 - Mencabut semua perangkat

Sebagai pengguna, saya ingin mengeluarkan login di semua perangkat sekaligus.

IDKriteria penerimaan
AC-04.1Tombol Cabut Semua Perangkat tersedia di header dan meminta konfirmasi lebih dulu (BR-04).
AC-04.2Teks konfirmasi menyebut bahwa perangkat ini ikut keluar.
AC-04.3Setelah berhasil, semua login berakhir termasuk perangkat ini, dan pengguna langsung diarahkan ke halaman login (BR-05).
AC-04.4Pencabutan 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.

IDKriteria penerimaan
AC-05.1Login yang melewati 7 hari tanpa aktivitas dicabut otomatis; perangkatnya hilang dari daftar dan harus login ulang (BR-06).

9. User Scenarios

RoleScenario
PenggunaMencabut login di komputer bersama yang lupa di-logout
PenggunaMelihat peta dan menemukan login dari kota yang tidak dikenal, lalu mencabutnya
PenggunaPonsel hilang; mencabut semua perangkat dari laptop
PenggunaSetelah 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

ActionPerangkat IniPerangkat 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).
Terakhir diperbarui