64 lines
2.6 KiB
Markdown
64 lines
2.6 KiB
Markdown
# TitipIn - Sistem Titip Pesanan
|
|
|
|
Aplikasi web modern berbasis Next.js untuk mempermudah sistem "jasa titip" (jastip) atau pesanan bersama. Aplikasi ini berjalan dengan arsitektur serverless (Server Actions) dan menggunakan sistem autentikasi stateless (berbasis UUID di LocalStorage).
|
|
|
|
## Kebutuhan Sistem (Prerequisites)
|
|
Sebelum menjalankan aplikasi ini, pastikan Anda telah menginstal perangkat lunak berikut:
|
|
- **Node.js**: Versi 18.x atau lebih baru (direkomendasikan versi LTS terbaru).
|
|
- **npm**: (biasanya sudah termasuk saat instalasi Node.js).
|
|
- **PostgreSQL**: Database server berjalan (versi 13 atau lebih baru direkomendasikan).
|
|
|
|
## Instalasi
|
|
1. Lakukan _clone_ repositori ini atau pastikan Anda berada di root folder aplikasi.
|
|
2. Buka terminal/command prompt.
|
|
3. Jalankan perintah instalasi dependensi:
|
|
```bash
|
|
npm install
|
|
```
|
|
*Catatan: Pastikan dependensi Prisma terinstal pada versi stabil (contoh: `@prisma/client@5`).*
|
|
|
|
## Pengaturan Environment
|
|
Buat sebuah file bernama `.env` di root folder proyek Anda. Konfigurasi kredensial database PostgreSQL Anda seperti format berikut:
|
|
|
|
```env
|
|
DATABASE_HOST="172.10.10.2"
|
|
DATABASE_PORT="5411"
|
|
DATABASE_USER="postgres"
|
|
DATABASE_PASSWORD="eigen3m!"
|
|
DATABASE_NAME="testing"
|
|
DATABASE_URL="postgresql://${DATABASE_USER}:${DATABASE_PASSWORD}@${DATABASE_HOST}:${DATABASE_PORT}/${DATABASE_NAME}?schema=public"
|
|
```
|
|
*(Sesuaikan IP, port, dan kredensial lain jika server database Anda berbeda).*
|
|
|
|
## Eksekusi Migrasi Database
|
|
Aplikasi menggunakan **Prisma ORM** untuk berinteraksi dengan database. Jalankan perintah terminal berikut secara berurutan untuk menyinkronkan skema dan mengaktifkan client:
|
|
|
|
1. **Generate Prisma Client**: Membangun tipe TypeScript dan library client.
|
|
```bash
|
|
npx prisma generate
|
|
```
|
|
2. **Push Skema ke Database**: Membuat struktur tabel-tabel di database (User, Order, Submission, dll.) sesuai dengan `prisma/schema.prisma`.
|
|
```bash
|
|
npx prisma db push
|
|
```
|
|
|
|
## Menjalankan Aplikasi
|
|
Setelah database siap, Anda bisa menjalankan aplikasi di tahap pengembangan lokal (development mode):
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
Aplikasi secara bawaan dapat diakses melalui browser dengan URL:
|
|
👉 **[http://localhost:3000](http://localhost:3000)**
|
|
|
|
---
|
|
|
|
### Alur Singkat Aplikasi:
|
|
- Akses pertama kali, sistem akan _generate_ UUID unik untuk *device* Anda dan menyimpannya di `localStorage`.
|
|
- Aplikasi akan menampilkan Modal Wajib untuk mendaftarkan **Nama** dan opsional **Foto Profil**.
|
|
- Anda dapat mulai:
|
|
- Membuat Jasa Titip di menu **Jasa Order Saya**.
|
|
- Mengikuti Jasa Titip teman di menu **Open Order**.
|
|
- Mengelola pembayaran & melihat rincian di halaman detail.
|