2026-08-27 17:21:31 +07:00
2026-08-27 17:21:31 +07:00

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:
    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:

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.
    npx prisma generate
    
  2. Push Skema ke Database: Membuat struktur tabel-tabel di database (User, Order, Submission, dll.) sesuai dengan prisma/schema.prisma.
    npx prisma db push
    

Menjalankan Aplikasi

Setelah database siap, Anda bisa menjalankan aplikasi di tahap pengembangan lokal (development mode):

npm run dev

Aplikasi secara bawaan dapat diakses melalui browser dengan URL: 👉 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.
S
Description
No description provided
Readme
1.2 MiB
1.0.8
Latest
2026-09-16 10:41:35 +00:00
Languages
TypeScript 99%
CSS 0.9%
JavaScript 0.1%