Pengaktifan Mesin — Hiro App

Pencetus: Pelanggan memilih mesin atau mengimbas kod QR dalam Hiro App Produk: Hiro App · Hiro Platform · Hiro Link Hasil: Mesin bermula, pelanggan melihat pemasa kitaran aktif

---

Aliran

Pelanggan buka Hiro App
        │
        ├─ Imbas kod QR pada mesin
        │       ATAU
        └─ Layari outlet → pilih mesin
                │
                ▼
        App hantar permintaan pengaktifan ke Hiro Platform
        (outlet ID, machine ID, customer ID, baki wallet)
                │
                ▼
        ┌─────────────────────────────────┐
        │  Hiro Platform: Pra-semakan     │
        └─────────────────────────────────┘
                │
                ├─ [1] Adakah mesin dalam talian?
                │       (semak heartbeat / status terakhir Hiro Link)
                │       TIDAK → pulangkan ralat → App papar "Mesin tidak tersedia"
                │
                ├─ [2] Adakah mesin tersedia?
                │       Platform semak jenis mesin dahulu:
                │       │
                │       ├─ WASHER (Mesin Basuh)
                │       │       Mesti melahu untuk diaktifkan
                │       │       Sedang berjalan → pulangkan ralat → App papar "Mesin sedang digunakan"
                │       │
                │       └─ DRYER (Mesin Pengering)
                │               Melahu  → teruskan pengaktifan seperti biasa
                │               Sedang berjalan → benarkan tambahan masa (lanjutkan kitaran semasa)
                │               App papar baki masa + pilihan "Tambah masa"
                │
                └─ [3] Adakah pelanggan ada kredit wallet yang mencukupi?
                        (harga kitaran ≤ baki wallet)
                        TIDAK → pulangkan ralat → App papar "Kredit tidak mencukupi"
                               + gesa untuk tambah nilai
                │
                ▼  Semua semakan lulus
        Platform tolak kos kitaran daripada baki wallet
                │
                ▼
        Platform hantar arahan pengaktifan ke Hiro Link
                │
                ▼
        Hiro Link aktifkan mesin
                │
                ├─ Mesin balas (berasaskan protokol)  → Link hantar pengesahan mula kitaran + data pemasa ke Platform
                │
                └─ Tiada balasan mesin (berasaskan pulse)  → Link hantar pengesahan pulse-dihantar ke Platform
                │
                ▼
        Platform rekod transaksi
        (timestamp, outlet, mesin, pelanggan, jumlah, jenis kitaran)
                │
                ▼
        Platform hantar pengesahan pengaktifan ke App
        (transaction ID, tempoh kitaran / mula pemasa)
                │
                ▼
        App papar pemasa kitaran aktif + pengesahan pesanan

---

Ringkasan Pra-Semakan

Semakan	Syarat Lulus	Respons Kegagalan
Mesin dalam talian	Hiro Link disambungkan dan boleh dicapai oleh Platform	"Mesin tidak tersedia, sila cuba mesin lain"
Mesin tersedia	Washer: mesti melahu. Dryer: melahu atau berjalan (tambahan masa dibenarkan)	Washer berjalan → "Mesin sedang digunakan"
Kredit mencukupi	Baki wallet ≥ harga kitaran	"Kredit tidak mencukupi" + gesaan tambah nilai

Tingkah Laku Jenis Mesin

Jenis Mesin	Melahu	Sedang Berjalan
Washer	Aktifkan seperti biasa	Disekat — tidak boleh diaktifkan, papar "Mesin sedang digunakan"
Dryer	Aktifkan seperti biasa	Benarkan tambahan masa — lanjutkan kitaran yang sedang berjalan

---

Selepas Pengaktifan

• Pelanggan melihat pemasa kira detik dalam Hiro App
• Sumber pemasa: data kitaran Hiro Link melalui Platform (berasaskan protokol). Untuk mesin berasaskan pulse, pemasa ialah anggaran pratetap dengan offset untuk mengambil kira kelewatan antara pembayaran dan pelanggan memuatkan mesin — ditunjukkan dengan awalan "~" untuk menandakan ia adalah anggaran
• Transaksi direkodkan dalam Platform untuk sejarah pesanan dan pelaporan peniaga

---

Aliran Berkaitan

• Pengaktifan Mesin — Kiosk — logik Platform yang sama, titik masuk berbeza
• Pengaktifan Mesin — DirectPay — memintas App sepenuhnya; pembayaran QR-pada-mesin untuk pengguna sekali-sekala
• Tambah Nilai Wallet — dicetuskan apabila semakan kredit gagal