feat: implement queue store with clinic API integration, WebSocket sync, and patient data management

2026-07-02 11:39:07 +07:00
parent e18ed186e1
commit 61772105fd
8 changed files with 553 additions and 541 deletions
@@ -63,6 +63,56 @@ Format output:

 <!-- Tambahkan entry baru di bawah baris ini, urutan terbaru di atas -->

+## 2026-06-23 — Refactoring queueStore.js ke TypeScript (Phase 2: WebSocket & Typings)
+
+**Sprint/Phase:** Phase 6 (Verifikasi Akun & Kiosk) / Refactoring Technical Debt
+**Durasi:** 1 jam
+**Status:** ✅ Done
+
+### Yang Dikerjakan
+- Membuat composable mandiri `composables/useQueueSync.ts` dan memindahkan lebih dari 200 baris logika *WebSocket* (`onWsMessage`, `connect`, `startAutoSync`) dari dalam *store*.
+- Menjalankan *scripting* untuk me-resolve sebagian besar error peringatan `implicit any type` dan `catch(error: any)` di dalam `queueStore.ts`.
+- Menerapkan injeksi dependencies dari `queueStore` ke dalam parameter `useQueueSync()` tanpa memutus *reactivity* dari Pinia state.
+
+### Keputusan Teknis
+> **Dependency Injection pada Composable:** Karena fungsionalitas WebSocket membutuhkan akses terhadap state (`allPatients`, `currentProcessingPatient`) dan actions (`fetchPatientsForLoket`, dll), maka variabel-variabel tersebut dilempar (injected) melalui parameter `deps` ke dalam fungsi `useQueueSync(deps)`. Hal ini mencegah masalah *circular dependencies* di ekosistem Nuxt/Pinia.
+
+### Masalah & Solusi
+| Masalah | Solusi | Referensi |
+|---------|--------|-----------|
+| Pinia-Plugin-PersistedState *type mismatch* pada `paths` config | Menambahkan flag `// @ts-ignore` untuk properti `paths` karena kompatibel secara *runtime* namun melanggar validasi tipe di rilis plugin yang terpasang. | QMD: Technical Debt |
+
+### Besok
+- Menguji secara manual interaksi antar *terminal* (Anjungan, Loket, Klinik) untuk memverifikasi fungsionalitas `useQueueSync`.
+- Menulis Unit Tests (jika platform sudah siap).
+
+---
+
+## 2026-06-23 — Refactoring queueStore.js ke TypeScript (Phase 1)
+
+**Sprint/Phase:** Phase 6 (Verifikasi Akun & Kiosk) / Refactoring Technical Debt
+**Durasi:** 1 jam
+**Status:** 🔄 In Progress
+
+### Yang Dikerjakan
+- Mengubah ekstensi file `queueStore.js` menjadi `queueStore.ts`.
+- Membuat file definisi tipe antrean di `types/queue.ts` (`QueuePatient`).
+- Mengekstrak raw fetch API calls (Loket, Visit, Update, Selesai Tiket) ke composable mandiri `composables/useQueueAPI.ts`.
+- Melakukan transisi pada fungsi-fungsi besar (`fetchPatientsForLoket`, `callNext`, `callMultiplePatients`, `processPatient`) di dalam `queueStore.ts` untuk menggunakan `useQueueAPI` guna memangkas boilerplate fetch.
+
+### Keputusan Teknis
+> **Incremental Refactoring:** Menghindari pecahnya `queueStore` secara drastis dengan tetap mempertahankan satu *store instance* (`useQueueStore`) namun mengabstraksi beban logikanya keluar (*API* & *Sync layer*). Ini meminimalisasi *blast radius* / *breaking changes* ke komponen UI yang sudah jalan.
+
+### Masalah & Solusi
+| Masalah | Solusi | Referensi |
+|---------|--------|-----------|
+| Pembengkakan ukuran *store file* (>3500 baris, 145KB). | Mulai memisahkan logika pemanggilan API eksternal dan mendefinisikan strukturnya dengan TypeScript. | QMD: Technical Debt |
+
+### Besok
+- Membuat tipe yang strict untuk `state` dan seluruh *method signatures* di `queueStore.ts`.
+- Mengekstraksi fungsionalitas WebSocket ke `composables/useQueueSync.ts`.
+- Jika sudah ringan, memecah *store* menjadi `loketQueueStore` dan `clinicQueueStore`.
+
 ---

 ## 2026-06-19 — Fitur Detail Akun Verifikasi