Beranda DocsGetting StartedQuick Start

Quick Start

Panduan menjalankan seluruh stack OrthoBreath dari komputer baru dalam 5 menit.

Status: Stablev1.0.0Source Verified: Yes

Source: package.json, scripts/reset-and-seed-test.mjsTests: tests/e2e/clinical-journey.spec.ts

Quick Start Guide#

Panduan ini memungkinkan developer menjalankan seluruh ekosistem OrthoBreath v1.0.0 (Frontend Next.js, AI Backend FastAPI, dan Firebase Emulators) dari komputer baru.

1. Prerequisites#

Pastikan perangkat Anda telah terinstal:

Node.js: >= 24.0.0 (node -v)
npm: >= 10.0.0 (npm -v)
Python: >= 3.11.0 (python --version)
Java JRE/JDK: >= 11 (diperlukan untuk Firebase Local Emulator)
Git: (git --version)

2. Clone & Install Dependencies#

bash

1# 1. Clone repository
2git clone https://github.com/afadlih/OrthoBreath.git
3cd OrthoBreath
4
5# 2. Install dependencies Frontend (Next.js & tools)
6npm install
7
8# 3. Setup virtual environment & dependencies AI Backend
9cd backend
10python -m venv .venv
11
12# Windows (PowerShell):
13.venv\Scripts\activate
14# macOS / Linux:
15# source .venv/bin/activate
16
17pip install -r requirements-dev.txt
18cd ..

3. Konfigurasi Environment#

Salin file contoh konfigurasi lokal:

bash

1# Salin template environment Next.js
2cp .env.example .env.local
3
4# Salin template environment AI Backend
5cp backend/.env.example backend/.env

4. Menjalankan Server#

Jalankan service sesuai kebutuhan:

A. Jalankan Frontend Web App (Next.js):#

bash

1npm run dev
2# Buka http://localhost:3000 di browser

B. Jalankan AI Backend (FastAPI):#

bash

1# Di terminal kedua:
2cd backend
3.venv\Scripts\activate
4uvicorn app.main:app --host 127.0.0.1 --port 8000 --reload
5# Endpoint docs OpenAPI: http://127.0.0.1:8000/docs

C. Menjalankan Verifikasi Menyeluruh (Quality Gate):#

bash

1npm run verify

5. Akun Uji Coba Default (Demo/Emulator)#

Jika menggunakan Firebase Emulator atau demo seed:

Peran (Role)	Email Login	Password Default	Akses Menu
Administrator	`[email protected]`	`Admin#2026Secure!`	Manajemen Klinik, Audit, Pengguna, Pengaturan
Dokter Gigi	`[email protected]`	`Dokter#2026Pass`	Pasien, Pemeriksaan, Validasi Rekam Medis
Operator	`[email protected]`	`Operator#2026Pass`	Pendaftaran Pasien, Pengambilan Sensor/Foto
Orang Tua	`[email protected]`	`OrangTua#2026Pass`	Riwayat Pemeriksaan Anak, Edukasi

SebelumnyaIntroduction

SelanjutnyaInstallation & Prereqs

Beranda DocsGetting StartedQuick Start

Quick Start

Panduan menjalankan seluruh stack OrthoBreath dari komputer baru dalam 5 menit.

Status: Stablev1.0.0Source Verified: Yes

Source: package.json, scripts/reset-and-seed-test.mjsTests: tests/e2e/clinical-journey.spec.ts

Quick Start Guide#

Panduan ini memungkinkan developer menjalankan seluruh ekosistem OrthoBreath v1.0.0 (Frontend Next.js, AI Backend FastAPI, dan Firebase Emulators) dari komputer baru.

1. Prerequisites#

Pastikan perangkat Anda telah terinstal:

Node.js: >= 24.0.0 (node -v)
npm: >= 10.0.0 (npm -v)
Python: >= 3.11.0 (python --version)
Java JRE/JDK: >= 11 (diperlukan untuk Firebase Local Emulator)
Git: (git --version)

2. Clone & Install Dependencies#

bash

1# 1. Clone repository
2git clone https://github.com/afadlih/OrthoBreath.git
3cd OrthoBreath
4
5# 2. Install dependencies Frontend (Next.js & tools)
6npm install
7
8# 3. Setup virtual environment & dependencies AI Backend
9cd backend
10python -m venv .venv
11
12# Windows (PowerShell):
13.venv\Scripts\activate
14# macOS / Linux:
15# source .venv/bin/activate
16
17pip install -r requirements-dev.txt
18cd ..

3. Konfigurasi Environment#

Salin file contoh konfigurasi lokal:

bash

1# Salin template environment Next.js
2cp .env.example .env.local
3
4# Salin template environment AI Backend
5cp backend/.env.example backend/.env

4. Menjalankan Server#

Jalankan service sesuai kebutuhan:

A. Jalankan Frontend Web App (Next.js):#

bash

1npm run dev
2# Buka http://localhost:3000 di browser

B. Jalankan AI Backend (FastAPI):#

bash

1# Di terminal kedua:
2cd backend
3.venv\Scripts\activate
4uvicorn app.main:app --host 127.0.0.1 --port 8000 --reload
5# Endpoint docs OpenAPI: http://127.0.0.1:8000/docs

C. Menjalankan Verifikasi Menyeluruh (Quality Gate):#

bash

1npm run verify

5. Akun Uji Coba Default (Demo/Emulator)#

Jika menggunakan Firebase Emulator atau demo seed:

Peran (Role)	Email Login	Password Default	Akses Menu
Administrator	`[email protected]`	`Admin#2026Secure!`	Manajemen Klinik, Audit, Pengguna, Pengaturan
Dokter Gigi	`[email protected]`	`Dokter#2026Pass`	Pasien, Pemeriksaan, Validasi Rekam Medis
Operator	`[email protected]`	`Operator#2026Pass`	Pendaftaran Pasien, Pengambilan Sensor/Foto
Orang Tua	`[email protected]`	`OrangTua#2026Pass`	Riwayat Pemeriksaan Anak, Edukasi

SebelumnyaIntroduction

SelanjutnyaInstallation & Prereqs