update skill dan docs

2026-07-10 11:14:36 +07:00
parent d0eee7d062
commit bbcaf9826c
5 changed files with 584 additions and 26 deletions
@@ -63,6 +63,66 @@ Format output:

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

+## 2026-07-10 — Migrasi API Endpoint & Project Knowledge Base
+
+**Sprint/Phase:** Phase 7 — Infrastruktur & Dokumentasi
+**Durasi:** ~3 jam
+**Status:** ✅ Done
+
+### Yang Dikerjakan
+- Migrasi endpoint API Antrian dari `10.10.123.140:8089` ke `10.10.150.131:8089` di `.env`
+  - `VERIFICATION_API_BASE_URL`
+  - `ANTRIAN_API_URL`
+  - `PROXY_TARGET_HOST_KLINIK_FALLBACK`
+- Pembuatan **Project Knowledge Base** (`AGENTS.md`) di `.agents/` untuk agent AI context
+  - Dokumentasi lengkap arsitektur, store hierarchy, API endpoints, auth flow, gotchas
+  - File ini otomatis dimuat sebagai context di setiap session
+- Update DEVLOG, DEVPLAN, dan PRD berdasarkan kondisi project terkini
+
+### Keputusan Teknis
+> **API endpoint migration**: Backend Antrian API dipindah ke server baru (`10.10.150.131`). Semua konfigurasi ada di `.env` — perubahan `.env` membutuhkan restart dev server karena Nuxt membaca env hanya saat startup. Masih ada technical debt berupa hardcoded fallback IP lama di ~25 file source code.
+
+> **Project Knowledge Base**: Dibuat `.agents/AGENTS.md` sebagai single knowledge document yang mencakup arsitektur, store hierarchy, API config, auth flow, dan known gotchas. Ini mempercepat onboarding dan mengurangi kesalahan saat AI agent bekerja di codebase.
+
+### Masalah & Solusi
+| Masalah | Solusi | Referensi |
+|---------|--------|-----------|
+| API masih connect ke IP lama setelah ubah `.env` | Restart dev server (Ctrl+C → `npm run dev`). Nuxt hanya baca `.env` saat startup | `.env`, `nuxt.config.ts` |
+| Hardcoded fallback IP di ~25 file | Documented sebagai tech debt. Ideally semua fallback dihapus, hanya andalkan `.env` | `AGENTS.md` |
+| Banyak klinik tidak muncul di Admin Klinik Ruang | Filter `totalQuota === 0` di `ruangStore.js` menyembunyikan klinik dari API yang belum dikonfigurasi | `stores/ruangStore.js` |
+
+### Besok
+- [ ] Eliminasi hardcoded fallback IP lama di semua source files
+- [ ] Verifikasi koneksi ke endpoint baru (`10.10.150.131:8089`)
+- [ ] Investigasi klinik yang hilang dari Admin Klinik Ruang karena filter `totalQuota`
+
+---
+
+## 2026-07-09 — Fix Admin Klinik Ruang Missing Clinics
+
+**Sprint/Phase:** Phase 7 — Bug Fixing
+**Durasi:** ~1 jam
+**Status:** ✅ Done
+
+### Yang Dikerjakan
+- Investigasi bug di halaman Admin Klinik Ruang (`/adminklinikruang`) — hanya 5 klinik muncul dari total ~23 klinik
+- Root cause: Filter `totalQuota === 0` di `ruangStore.js` (`fetchRuangFromAPI()`) menyaring klinik yang:
+  1. Tidak ditemukan di clinicStore (default `totalQuota: 0`)
+  2. Belum dikonfigurasi kuotanya di seed data
+- Fix: Menghapus kedua filter `totalQuota === 0` (line 387-391 dan line 480-483)
+- User kemudian me-revert fix ini (mengembalikan filter) — menunjukkan filter ini memang diperlukan untuk business logic tertentu
+
+### Keputusan Teknis
+> Filter `totalQuota === 0` ternyata berfungsi ganda: (1) menyembunyikan klinik yang memang tidak aktif, (2) tapi juga menyembunyikan klinik baru dari API yang belum dikonfigurasi. Trade-off ini perlu didiskusikan dengan PO.
+
+### Masalah & Solusi
+| Masalah | Solusi | Referensi |
+|---------|--------|-----------|
+| Admin Klinik Ruang hanya tampil 5 klinik | Ditemukan filter `totalQuota === 0` di `ruangStore.fetchRuangFromAPI()` | `stores/ruangStore.js:387-391, 480-483` |
+| Fix di-revert oleh user | Filter diperlukan untuk business logic — perlu pendekatan alternatif (misal: tampilkan tapi tandai sebagai "belum dikonfigurasi") | — |
+
+---
+
 ## 2026-06-23 — Refactoring queueStore.js ke TypeScript (Phase 2: WebSocket & Typings)

 **Sprint/Phase:** Phase 6 (Verifikasi Akun & Kiosk) / Refactoring Technical Debt
@@ -668,13 +728,14 @@ Format output:

 | Metrik | Value |
 |--------|-------|
-| Total hari dev | ~50+ hari (Jan 2026 — Mei 2026) |
-| Fase project | 5 fase (Setup → Fondasi → Hak Akses → Eksekutif → Stabilisasi) |
-| Fitur selesai | 8 modul utama (Anjungan, Check-in, Loket, Klinik, Penunjang, Dashboard, Setting, Hak Akses) |
-| Total commits | 80+ commits |
-| Bug ditemukan | 15+ (WebSocket, loket interference, memory, display sync) |
-| Bug diselesaikan | 15+ |
-| Halaman dibuat | 28 halaman |
-| Composables | 16 composable |
-| Pinia Stores | 13 stores |
-| Komponen | 20+ komponen |
+| Total hari dev | ~60+ hari (Jan 2026 — Juli 2026) |
+| Fase project | 7 fase (Setup → Fondasi → Hak Akses → Eksekutif → Stabilisasi → Verifikasi → Infrastruktur) |
+| Fitur selesai | 8 modul utama + dokumentasi + migrasi infra |
+| Total commits | 90+ commits |
+| Bug ditemukan | 18+ (WebSocket, loket interference, memory, display sync, missing clinics, API endpoint) |
+| Bug diselesaikan | 18+ |
+| Halaman dibuat | 28+ halaman |
+| Composables | 18 composable |
+| Pinia Stores | 14 stores |
+| Komponen | 25+ komponen |
+| Dokumentasi | AGENTS.md, DEVLOG.md, DEVPLAN.md, PRD.md, API_ENDPOINTS_CLINIC_DOCTOR.md |
@@ -1,10 +1,10 @@
 # 🗺️ DEVPLAN — Development Plan

 **Project:** Web Antrean — Sistem Manajemen Antrean Rawat Jalan RSSA
-**Version:** 1.0.0
+**Version:** 1.1.0
 **Author:** Akbar
 **Stack:** JavaScript · Vue 3 · TypeScript · Nuxt 3 · Vuetify 3 · Pinia
-**Last Updated:** 2026-05-25
+**Last Updated:** 2026-07-10

 ---

@@ -45,8 +45,8 @@ Format dalam tabel Markdown yang terstruktur.
 ## 1. Project Timeline

 ```
-[Start]──Phase 0──Phase 1──Phase 2──Phase 3──Phase 4──Phase 5──Phase 6──[Launch]
-          Setup   Fondasi  Inti API  Hak Akses Eksekutif Stabilisasi Verifikasi
+[Start]──Phase 0──Phase 1──Phase 2──Phase 3──Phase 4──Phase 5──Phase 6──Phase 7──[Launch]
+          Setup   Fondasi  Inti API  Hak Akses Eksekutif Stabilisasi Verifikasi Infrastruktur
 ```

 | Fase | Nama | Durasi | Target | Status |
@@ -57,7 +57,8 @@ Format dalam tabel Markdown yang terstruktur.
 | Phase 3 | Hak Akses & Keycloak | 2 Minggu | Apr 2026 | ✅ Done |
 | Phase 4 | Fitur Eksekutif & Docker | 1 Minggu | Pertengahan Mei | ✅ Done |
 | Phase 5 | Stabilisasi & Dokumentasi | 2 Minggu | Akhir Mei 2026 | ✅ Done |
-| Phase 6 | Verifikasi Akun & Kiosk | 2 Minggu | Juni 2026 | 🔄 In Progress |
+| Phase 6 | Verifikasi Akun & Kiosk | 2 Minggu | Juni 2026 | ✅ Done |
+| Phase 7 | Infrastruktur & Dokumentasi | Ongoing | Juli 2026 | 🔄 In Progress |

 ---

@@ -145,6 +146,19 @@ Format dalam tabel Markdown yang terstruktur.
 | Fitur pindah klinik pada dashboard admin | 8 jam | Phase 2 | ✅ Done |
 | Halaman Detail Akun Verifikasi | 4 jam | Phase 3 | ✅ Done |
 | Implementasi Proxy Routes (CORS) | 8 jam | Phase 2 | ✅ Done |
+| Refactoring queueStore.js ke TypeScript | 8 jam | Phase 2 | ✅ Done |
+| Ekstraksi useQueueSync composable | 4 jam | Phase 2 | ✅ Done |
+
+### Phase 7 — Infrastruktur & Dokumentasi
+| Task | Estimasi | Dependencies | Status |
+|------|----------|--------------|--------|
+| Migrasi API endpoint (123.140 → 150.131) | 2 jam | — | ✅ Done |
+| Pembuatan Project Knowledge Base (AGENTS.md) | 3 jam | — | ✅ Done |
+| Update DEVLOG, DEVPLAN, PRD | 2 jam | — | ✅ Done |
+| Fix Admin Klinik Ruang missing clinics | 1 jam | Phase 2 | ✅ Done |
+| Eliminasi hardcoded fallback IP di source files | 4 jam | Task 1 | ⏳ Pending |
+| SQLite config → External API migration | 8 jam | Phase 2 | ⏳ Pending |
+| Production deployment & monitoring | 8 jam | All | ⏳ Pending |

 ---

@@ -157,12 +171,12 @@ Nuxt 3 + TypeScript
 ├── Vuetify 3 (UI Framework)
 │   └── Material Design Icons
 ├── Nuxt Nitro (Server Engine)
-│   └── Server Routes (CORS Proxy API)
+│   └── Server API Routes + SQLite (better-sqlite3)
 ├── Auth Layer
 │   └── Keycloak SSO (OIDC/OAuth 2.0)
 ├── API Layer
 │   ├── Visit API (10.10.123.135:8084)
-│   └── Antrian API (10.10.123.140:8089)
+│   └── Antrian API (10.10.150.131:8089) ← UPDATED
 └── Real-time Layer
    └── Native Browser WebSocket
 ```
@@ -194,10 +208,12 @@ npm run _command_dev
 AUTH_ORIGIN="http://10.10.150.175:3000"
 KEYCLOAK_CLIENT_ID="akbar-test"
 KEYCLOAK_ISSUER="https://auth.rssa.top/realms/sandbox"
-ANTRIAN_API_URL="http://10.10.123.140:8089/api/v1"
+ANTRIAN_API_URL="http://10.10.150.131:8089/api/v1"          # UPDATED Juli 2026
+VERIFICATION_API_BASE_URL="http://10.10.150.131:8089/api/v1" # UPDATED Juli 2026
 VISIT_API_URL="http://10.10.123.135:8084/api/v1"
 WS_API_URL="ws://10.10.123.135:8084/api/v1/ws"
 PROXY_CLIENT_ORIGIN="http://10.10.150.175:3000"
+PROXY_TARGET_HOST_KLINIK_FALLBACK="10.10.150.131:8089"       # UPDATED Juli 2026
 ```

 ---
@@ -232,7 +248,9 @@ docs: update DEVPLAN
 | 🔐 Auth & Roles | Keycloak jalan, routing terlindungi middleware | Apr 2026 | ✅ Done |
 | 🏥 Anjungan Ready | Pasien bisa check-in & ambil tiket lancar | Pertengahan Mei | ✅ Done |
 | 🛡️ Stability Pass | Tidak ada leak, isolasi loket aman, no WS drift | Akhir Mei 2026 | ✅ Done |
-| 🚀 Production Go-Live | Deployment docker di server production | Q2/Q3 2026 | 🔄 Pending |
+| 🔄 TypeScript Migration | queueStore refactored ke TS, composable extracted | Juni 2026 | ✅ Done |
+| 📡 API Endpoint Migration | Antrian API pindah ke server baru (150.131) | Juli 2026 | ✅ Done |
+| 🚀 Production Go-Live | Deployment docker di server production | Q3 2026 | 🔄 Pending |

 ---

@@ -240,4 +258,5 @@ docs: update DEVPLAN

 | Versi | Tanggal | Author | Perubahan |
 |-------|---------|--------|-----------|
+| 1.1.0 | 2026-07-10 | Akbar | Phase 7: migrasi API, knowledge base, update docs |
 | 1.0.0 | 2026-05-25 | Akbar | Initial plan — direkonstruksi berdasarkan timeline aktual |
@@ -1,11 +1,11 @@
 # 📋 PRD — Product Requirements Document

 **Project:** Web Antrean — Sistem Manajemen Antrean Rawat Jalan RSSA
-**Version:** 1.0.0
-**Status:** `In Review`
+**Version:** 1.1.0
+**Status:** `In Progress`
 **Author:** Akbar
 **Stack:** JavaScript · Vue 3 · TypeScript · Nuxt 3 · Vuetify 3 · Pinia
-**Last Updated:** 2026-05-25
+**Last Updated:** 2026-07-10

 ---

@@ -195,7 +195,7 @@ Rumah Sakit RSSA menghadapi masalah antrean rawat jalan yang tidak terstruktur:
 | Service | Base URL | Keterangan |
 |---------|----------|------------|
 | Visit API | `http://10.10.123.135:8084/api/v1` | Data kunjungan & antrean utama |
-| Antrian API (Klinik) | `http://10.10.123.140:8089/api/v1` | Verifikasi & data klinik/dokter |
+| Antrian API (Klinik) | `http://10.10.150.131:8089/api/v1` | Verifikasi & data klinik/dokter |
 | WebSocket | `ws://10.10.123.135:8084/api/v1/ws` | Real-time queue update |

 ### 7.3 Arsitektur Sistem
@@ -211,8 +211,8 @@ Rumah Sakit RSSA menghadapi masalah antrean rawat jalan yang tidak terstruktur:
 ┌──────────▼──────────┐  ┌────▼───────────────┐
 │  Nuxt Server (Nitro) │  │   WebSocket Server  │
 │  server/api/         │  │   ws://10.10.123.   │
-│  server/routes/      │  │   135:8084/api/v1/ws│
-│  (Proxy + API layer) │  └────────────────────┘
+│  SQLite (users.db)   │  │   135:8084/api/v1/ws│
+│  (Config + Users)    │  └────────────────────┘
 └──────────┬──────────┘
           │ HTTP Proxy (CORS bypass)
 ┌──────────▼──────────────────────────────────┐
@@ -227,7 +227,7 @@ Rumah Sakit RSSA menghadapi masalah antrean rawat jalan yang tidak terstruktur:
 | Proxy Path | Target Backend | Keterangan |
 |------------|---------------|------------|
 | `/visit-api/**` | `http://10.10.123.135:8084/api/v1/**` | Data kunjungan pasien |
-| `/klinik-api/**` | `http://10.10.123.140:8089/api/v1/**` | Data klinik & dokter |
+| `/klinik-api/**` | `http://10.10.150.131:8089/api/v1/**` | Data klinik & dokter |
 | `/stats-api/**` | `http://10.10.123.135:8084/api/v1/**` | Statistik dashboard |

 ### 7.5 Struktur Folder
@@ -405,4 +405,5 @@ export interface ApiResponse<T> {

 | Versi | Tanggal | Author | Perubahan |
 |-------|---------|--------|-----------|
+| 1.1.0 | 2026-07-10 | Akbar | Update API endpoints (150.131), arsitektur diagram, proxy routes, Phase 7 |
 | 1.0.0 | 2026-05-25 | Akbar | Initial PRD — dibuat berdasarkan kondisi project aktual |