FuelTrack Pro - Sistem Manajemen Distribusi BBM

FuelTrack Pro adalah platform digital untuk mengelola distribusi Bahan Bakar Minyak (BBM) menggunakan kupon digital berbasis QR Code. Sistem ini terdiri dari Dashboard Admin (Web) dan Interface Petugas (PWA).

Fitur Utama

• Admin: Kelola Kendaraan, Terbitkan Kupon QR, Monitor Transaksi, Laporan Grafik.
• Petugas: Login PWA, Scan QR Kupon, Input Realisasi (Liter, Odometer, Foto), Riwayat Pengisian.
• Teknis: JWT Auth, Prisma ORM, Mobile-First UI, PWA Support (Offline Ready), QR Encryption.

Kredensial Login (Default)

Peran	Username	Password
Admin	admin	admin123
Petugas	officer	petugas123

Cara Penggunaan

1. Login sebagai Admin untuk mendaftarkan kendaraan dan menerbitkan kupon.
2. Download QR Code kupon yang diterbitkan (klik tombol QR di tabel kupon).
3. Login sebagai Petugas (buka di browser mobile) untuk melakukan Scan QR.
4. Input Realisasi setelah scan berhasil, ambil foto odometer dan kendaraan, lalu simpan.
5. Monitor Transaksi di dashboard admin untuk melihat riwayat lengkap.

Konfigurasi Database (PostgreSQL)

Aplikasi ini saat ini berjalan menggunakan SQLite untuk kemudahan preview. Untuk beralih ke PostgreSQL:

1. Update datasource di prisma/schema.prisma:

   datasource db {
     provider = "postgresql"
     url      = env("DATABASE_URL")
   }

2. Set DATABASE_URL di .env dengan connection string PostgreSQL Anda.
3. Jalankan npx prisma db push.

API Documentation (Summary)

• POST /api/auth/login: Login user.
• POST /api/coupons: Terbitkan kupon baru (Admin).
• POST /api/coupons/verify: Verifikasi token QR.
• POST /api/transactions: Rekam realisasi pengisian fuel.
• GET /api/reports/monthly: Data statistik bulanan.

---

Built with React, Express, Prisma, and TailwindCSS.

ebbm

dop

qrbm