🚁 Easy Catch

Marketplace Pengiriman Paket Berbasis Drone

Project Kompetisi Toyota Intercom — SMA Negeri 2 Painan · 2024/2025

---

📖 Deskripsi

Easy Catch adalah platform marketplace inovatif yang memungkinkan pengiriman paket menggunakan drone sebagai media alternatif transportasi. Project ini dikembangkan dalam rangka perlombaan yang diselenggarakan oleh Toyota Intercom pada tahun 2024/2025 oleh tim dari SMA Negeri 2 Painan.

Platform ini mengintegrasikan teknologi Geographic Information System (GIS) untuk membantu pengguna memantau rute pengiriman secara real-time, memberikan pengalaman belanja dan pengiriman yang lebih cepat, efisien, dan modern.

✨ Fitur Utama

• 🛒 Marketplace — Jual beli produk secara online dalam satu platform
• 🚁 Pengiriman via Drone — Alternatif pengiriman paket yang cepat dan efisien
• 🗺️ Integrasi GIS — Pelacakan rute pengiriman secara geografis
• 📦 Manajemen Pesanan — Kelola status pesanan secara real-time
• 👤 Autentikasi Pengguna — Sistem login dan registrasi yang aman

---

🛠️ Tech Stack

Kategori	Teknologi
Backend	PHP, Laravel
Frontend	React.js, Inertia.js
Styling	Tailwind CSS
Database	MySQL
Build Tool	Vite
Lainnya	GIS (Geographic Information System)

---

⚙️ Prasyarat

Pastikan perangkat kamu sudah terinstal:

• PHP >= 8.1
• Composer >= 2.x
• Node.js >= 18.x & npm
• MySQL >= 8.x
• Git

---

📦 Cara Install

1. Clone Repository

git clone https://github.com/Liando18/easy-catch.git
cd easy-catch

2. Install Dependensi PHP

composer install

3. Install Dependensi JavaScript

npm install

4. Konfigurasi Environment

cp .env.example .env

Buka file .env dan sesuaikan konfigurasi berikut:

APP_NAME="Easy Catch"
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=easy_catch
DB_USERNAME=root
DB_PASSWORD=

5. Generate Application Key

php artisan key:generate

6. Buat Database & Jalankan Migrasi

Buat database baru bernama easy_catch di MySQL, lalu jalankan:

php artisan migrate

7. (Opsional) Isi Data Awal

php artisan db:seed

8. Buat Symbolic Link Storage

php artisan storage:link

---

▶️ Cara Menjalankan

Buka dua terminal secara bersamaan dan jalankan perintah berikut:

Terminal 1 — Laravel Development Server

php artisan serve

Terminal 2 — Vite (Frontend Build)

npm run dev

Aplikasi dapat diakses di: http://localhost:8000

---

🏗️ Build untuk Produksi

npm run build
php artisan optimize

---

📁 Struktur Folder

easy-catch/
├── app/
│   ├── Http/
│   │   ├── Controllers/    # Logic controller aplikasi
│   │   └── Middleware/     # Middleware autentikasi & lainnya
│   ├── Models/             # Eloquent ORM models
│   └── Providers/          # Service providers
│
├── bootstrap/              # Bootstrap aplikasi Laravel
│
├── config/                 # Konfigurasi aplikasi (database, mail, dll)
│
├── database/
│   ├── migrations/         # Skema tabel database
│   ├── seeders/            # Data awal (dummy data)
│   └── factories/          # Factory untuk testing
│
├── public/                 # Asset publik & entry point (index.php)
│
├── resources/
│   ├── js/                 # Komponen React & halaman Inertia.js
│   │   ├── Components/     # Komponen UI yang dapat digunakan ulang
│   │   └── Pages/          # Halaman utama aplikasi
│   └── css/                # File stylesheet (Tailwind CSS)
│
├── routes/
│   ├── web.php             # Definisi routing web
│   └── api.php             # Definisi routing API
│
├── storage/                # File upload, log, dan cache
│
├── tests/                  # Unit & feature testing
│
├── .env.example            # Template konfigurasi environment
├── artisan                 # CLI Laravel
├── composer.json           # Dependensi PHP
├── package.json            # Dependensi JavaScript
├── tailwind.config.js      # Konfigurasi Tailwind CSS
└── vite.config.js          # Konfigurasi Vite bundler

---

🤝 Kontribusi

Project ini dibuat untuk keperluan kompetisi. Namun jika kamu ingin berkontribusi:

1. Fork repository ini
2. Buat branch fitur baru (git checkout -b fitur/nama-fitur)
3. Commit perubahan (git commit -m 'Menambahkan fitur baru')
4. Push ke branch (git push origin fitur/nama-fitur)
5. Buat Pull Request

---

📄 Lisensi

Didistribusikan di bawah lisensi MIT. Lihat file LICENSE untuk informasi lebih lanjut.

---

Dibuat dengan ❤️ oleh Tim SMA Negeri 2 Painan untuk kompetisi Toyota Intercom 2024/2025