Installation & Prerequisites
Panduan mendalam penyiapan environment development lokal untuk Node.js, Python, Firebase CLI, dan Caddy.
Status: Stablev1.0.0Source Verified: Yes
Source:
package.json, backend/requirements.txt, CaddyfileTests: tests/unit/authPolicy.test.tsInstallation & Prerequisites Guide#
Panduan instalasi langkah demi langkah untuk menyiapkan lingkungan pengembangan lokal OrthoBreath secara lengkap dan andal.
1. Kebutuhan Sistem Minimum#
| Komponen | Spesifikasi Minimum | Rekomendasi |
|---|---|---|
| Sistem Operasi | Windows 10/11 64-bit, macOS 13+, Ubuntu 22.04 LTS | Windows 11 / Ubuntu 24.04 |
| RAM | 8 GB | 16 GB (untuk menjalankan emulator & AI engine bersamaan) |
| Storage | 5 GB ruang disk kosong | SSD NVMe |
| Node.js | v24.x LTS | v24.0.0+ |
| Python | v3.11.x | v3.11.9 |
| Java (JRE) | Java 11+ | OpenJDK 21 (untuk Firebase Emulator Suite) |
2. Penyiapan Node.js 24 & Toolchain#
Pastikan Node.js 24 terpasang. Gunakan Node Version Manager (nvm atau fnm):
bash
bash
1# Menggunakan nvm (macOS/Linux)2nvm install 243nvm use 2445# Verifikasi versi6node -v # v24.x.x7npm -v # 10.x.x89# Instal dependensi proyek10npm ci
3. Penyiapan Python 3.11 & Virtualenv#
Layanan AI Inference dibangun menggunakan Python 3.11.
bash
bash
1cd backend23# Buat virtual environment4python -m venv .venv56# Aktivasi di Windows PowerShell:7.venv\Scripts\Activate.ps189# Aktivasi di Linux/macOS:10source .venv/bin/activate1112# Upgrade pip dan instal seluruh dependencies13pip install --upgrade pip14pip install -r requirements.txt15pip install -r requirements-dev.txt1617# Verifikasi instalasi model & test18pytest tests/
4. Firebase CLI & Emulator Suite#
Firebase Emulator memungkinkan pengujian autentikasi, Firestore, dan security rules secara lokal tanpa mengotori database cloud.
bash
bash
1# Instal Firebase CLI secara global2npm install -g firebase-tools34# Login ke akun Firebase (opsional untuk emulator)5firebase login67# Uji menjalankan emulator lokal8npm run firebase:emulators
5. Setup HTTPS Lokal dengan Caddy#
Beberapa fitur browser seperti akses kamera WebRTC intraoral memerlukan koneksi aman (HTTPS). Repositori menyediakan Caddyfile siap pakai:
bash
bash
1# Jalankan Caddy server lokal2caddy run
Aplikasi akan dapat diakses secara aman di https://localhost dengan sertifikat SSL lokal yang terpercaya secara otomatis.