Konfigurasi Pengembangan Lokal

Panduan ini akan memandu Anda melalui pengaturan environment pengembangan lokal untuk situs web Ascendia Cabinet HIMARPL.

Prasyarat

Sebelum menginstal aplikasi, pastikan Anda memiliki:

Node.js dan npm terinstal
Git terinstal
Akses ke layanan berikut:

Akun CockroachDB
Akun PostHog (opsional)

Detail Pengaturan Lingkungan

Proyek ini memerlukan beberapa environment variable yang harus diatur dalam file .env agar berfungsi dengan baik.

Pengaturan CockroachDB

Ikuti Panduan Cepat CockroachDB untuk mendapatkan DATABASE_URL Anda.

Langkah-langkah Pengaturan

Fork dan clone repositorinya:

git clone https://github.com/himarplupi/ascendia-himarpl.git

git clone git@github.com:himarplupi/ascendia-himarpl.git

gh repo clone himarplupi/ascendia-himarpl

Lakukan navigasi ke direktori proyek:
Terminal window
```
cd ascendia-himarpl
```

Buat file environment variables: Buat file .env pada direktori utama dengan variables berikut:

DATABASE_URL=
NEXT_PUBLIC_BASE_URL="http://localhost:3000"
NEXT_PUBLIC_BASE_PATH=""
NEXT_BASE_URL="http://localhost:3000"
NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

Atur remote upstream:

git remote add upstream https://github.com/himarplupi/ascendia-himarpl.git

git remote add upstream git@github.com:himarplupi/ascendia-himarpl.git

gh repo sync himarplupi/ascendia-himarpl

Unduh dependensi dan mulai server pengembangannya:

npm ci              # Install dependencies
npm run db:push     # Push database schema to CockroachDB
npm run dev         # Start development server

Sekarang, aplikasinya seharusnya berjalan pada http://localhost:3000.

Buat branch baru untuk perubahan yang Anda lakukan
Terminal window
```
git checkout -b my-feature-branch
```
Setelah Anda puas dengan perubahannya, add dan commit perubahan tersebut pada branch Anda, kemudian push branch Anda ke repositori fork.
Terminal window
```
git add .
git commit # Please follow the commit guidelines below
git push -u origin my-feature-branch
```
Sebelum melakukan commit dan membuka Pull Request, tolong baca Commit Guidelines dan Pull Request Policy berikut.
Buat Pull Request.

Kami mengimbau kepada pembuat PR untuk menghindari rebasing/memperbarui PR Anda dengan main branch secara tidak perlu.

Perintah yang tersedia

npm run dev - Memulai server pengembangan dengan hot reload
npm run build - Membuat build produksi
npm run start - Memulai server produksi
npm run db:push - Mendorong skema basis data ke CockroachDB
npm run db:studio - Membuka Prisma Studio untuk manajemen basis data
npm run lint - Menjalankan pemeriksaan linting