Latihan yang dipandu pengasuh, dengan hasil sesi yang dapat ditelusuri.
Arka adalah sistem latihan rehabilitasi motorik dan kognitif untuk panti jompo dan rumah sakit. Arka menghubungkan web app pengasuh, backend sesi yang otoritatif, dan perangkat ESP32 untuk menjalankan latihan fisik dengan aman serta menyimpan hasil yang berada dalam scope institusi.
Arka adalah alat bantu latihan dan pencatatan sesi. Arka bukan perangkat diagnosis, bukan alat penetapan terapi, dan bukan pengganti asesmen tenaga kesehatan.
Sesi latihan dengan perangkat fisik membutuhkan lebih dari sekadar tampilan permainan. Pengasuh perlu mengetahui bahwa perangkat siap, sesi dapat dihentikan dengan aman, input tidak dinilai oleh browser, dan hasil tersimpan tanpa mencampurkan identitas peserta ke firmware.
Arka menjaga satu alur yang jelas:
- Institusi masuk dan memeriksa kesiapan perangkat.
- Pengasuh memilih mode dan memasukkan identitas minimum peserta.
- Backend mengikat perangkat ke preparation dan sesi secara eksklusif.
- Peserta mengikuti instruksi melalui layar dan perangkat fisik.
- Backend memfinalisasi hasil dan menyediakan riwayat privat peserta.
| Repository | Tanggung jawab |
|---|---|
Arka-FE |
React web app untuk landing page, autentikasi, onboarding, dashboard, dan alur sesi |
Arka-BE |
Express API untuk autentikasi, otorisasi, database, game runtime, device gateway, WebSocket, dan worker |
Firmware ESP32 serta dokumentasi produk dan arsitektur dikelola bersama source Arka. README dan konfigurasi aplikasi berada di masing-masing direktori implementasi.
| Layer | Teknologi |
|---|---|
| Web | React 19, Vite 8, TypeScript, Tailwind CSS 4 |
| API | Node.js, Express 5, TypeScript, Zod |
| Authentication | Better Auth dengan session cookie HTTP-only |
| Data | PostgreSQL, Prisma 7, Redis/Valkey |
| Realtime | WebSocket untuk browser dan device gateway |
| Device | ESP32 Arduino, PlatformIO, ArduinoJson |
| Local AI | Ollama privat untuk rangkuman nonklinis opsional |
- Pengasuh tetap memegang kendali — peserta selalu mengikuti sesi dengan pendamping.
- Backend adalah sumber kebenaran — browser tidak memulai timer, menilai input, atau memfinalisasi hasil.
- Privasi minimum — firmware tidak menerima nama, kode peserta, cookie, atau credential pengguna.
- Fail-safe — disconnect, fault, timeout, dan command stale tidak boleh membuat actuator tetap aktif atau menghasilkan skor palsu.
- Bukan klaim klinis — skor dan rangkuman hanya mendeskripsikan sesi permainan.
Backend:
cd Arka-BE
npm ci
npm run prisma:generate
npm run prisma:migrate
npm run devFrontend:
cd Arka-FE
npm ci
npm run devKonfigurasi provider, environment variable, firmware, dan runbook ada di README root serta direktori docs.
MVP mencakup login institusi, onboarding, dashboard, kesiapan perangkat, tiga mode latihan, session lifecycle server-authoritative, penyimpanan hasil, riwayat peserta, audit, device gateway, dan rangkuman AI lokal yang opsional.
Fitur yang belum terhubung ke provider atau deployment production tidak dianggap selesai hanya karena sudah tertulis di PRD.
