Gerobaks Backend Platform

Backend & API Documentation

ID: Pusat informasi resmi mengenai arsitektur backend, panduan integrasi API, dan catatan perubahan produk.
EN: Central hub for backend architecture, API integration guide, and detailed changelog.

Platform Capabilities

🇮🇩 Pengelolaan Sampah Pintar

Backend Gerobaks mendukung autentikasi berbasis token, manajemen jadwal penjemputan, pelacakan armada, notifikasi real-time, percakapan pengguna-mitra, sistem saldo poin, serta penilaian layanan. Semua layanan dirancang untuk terintegrasi mulus dengan aplikasi Flutter Gerobaks maupun kanal internal.

Authentication Scheduling Tracking Notifications

🇬🇧 Intelligent Waste Lifecycle

The backend offers token-based authentication, scheduling, live fleet tracking, real-time notifications, in-app messaging, reward ledger, and service ratings. Every endpoint is optimized for the Flutter client and ready for future channels such as internal dashboards.

Messaging Points Ratings Reports

RESTful API

Real-time Events

OAuth2 Secure

Mobile Optimized

Quick Start Guide

🇮🇩 Langkah Lokal

git clone https://github.com/aji-aali/gerobaks-api.git
cd gerobaks-api
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve

Gunakan php artisan queue:work untuk memproses job dan php artisan schedule:work untuk menjalankan scheduler lokal.

Pastikan variabel API_BASE_URL pada aplikasi Flutter menunjuk ke server ini.

Test Health Check

🇬🇧 Production Notes

Security

  • Enable HTTPS
  • Configure Sanctum
  • Rotate secrets

Performance

  • Cache routes
  • Cache config
  • Use Redis

Background Jobs

  • Configure Supervisord
  • Set up Horizon

Monitoring

  • Set up Sentry
  • Configure NewRelic

Configuration Checklist

Pending

Environment Playground

Choose a server and sync Swagger base URL
Local

Laravel artisan serve environment for local development.

Idle
https://gerobaks.dumeg.com
Staging

Shared QA sandbox for QA & stakeholder review.

Idle
https://staging-gerobaks.dumeg.com
Production

Live environment consumed by mobile & partner apps.

Idle
https://gerobaks.dumeg.com

Interactive API Explorer

openapi.yaml

ID: Jelajahi seluruh endpoint melalui Swagger UI di bawah ini atau akses langsung spesifikasi mentah via openapi.yaml.
EN: Explore every endpoint using the embedded Swagger UI or fetch the raw specification at openapi.yaml.

📝 Release Notes & Changelog

Latest commits from GitHub repository

Loading changelog from GitHub...