specs / 015-Changes-POS-Setup-Error-UX

015 - POS setup error UX

  • Tanggal: 2026-08-10
  • Chat/topik: Pesan error jelas saat setup perangkat POS (404 outlet)

Ringkasan perubahan

Setup POS memetakan DioException menjadi copy formal-ramah (outlet tidak ditemukan, mode invalid, network) alih-alih dump Dio mentah. Data outlet tetap dikelola di admin.

Impact bisnis

Kasir/ops tidak bingung saat kode outlet salah; arahkan ke admin untuk daftarkan outlet.

Epic / User stories

  • Epic: POS device onboarding
  • US: Sebagai operator POS, saya ingin pesan error singkat saat daftar perangkat gagal, agar tahu apa yang harus diperbaiki tanpa melihat error teknis.

User terdampak

Kasir / staff yang setup tablet POS.

Aplikasi terdampak

  • mpc-pos: PERLU — map Dio + copy error di setup
  • mpc-be / mpc-be-pos / mpc-admin / Android / iOS / mpc-web / mpc-owner / ksr-sync: TIDAK — tidak ubah API/data

Perubahan schema

Tidak ada.

Perubahan kode

  • mpc-pos/lib/data/pos_repository.dart — registerDevice wrap _mapDio; pesan ID ramah
  • mpc-pos/lib/screens/setup_screen.dart — tampilkan PosApiException.message
  • Changelog v1.3 + demo APK