README

Sistem manajemen logistik dan pengiriman yang komprehensif dengan kemampuan pelacakan real-time.

🚀 Fitur Utama

🔐 Authentication & Authorization
- Login/Logout dengan Laravel Sanctum
- Role-based access control (Spatie Permission)
- Firebase Cloud Messaging integration
📦 Delivery Management
- Create delivery requests dengan multiple destinations
- Package management per destination
- Task assignment ke drivers
- Route optimization
- Delivery history tracking
📍 Real-time Tracking
- GPS tracking dari mobile devices
- Real-time location updates via WebSocket (Laravel Reverb)
- Tracking alarms & notifications
- Mapbox integration untuk visualisasi
📊 Reporting
- Delivery reports dengan filter tanggal
- Distance & duration tracking
- Task completion status
🗺️ Geographic Data
- Indonesia geographic hierarchy (Province → Regency → District → Village)
- Address geocoding

🛠️ Tech Stack

Backend

Laravel 12 - PHP Framework
Laravel Sanctum - API Authentication
Laravel Livewire 3.6 - Dynamic UI
Laravel Reverb - WebSocket Server
Spatie Laravel Permission - Role & Permission Management
Firebase Cloud Messaging - Push Notifications

🧠 Intelligent Architecture

Important

Project ini menggunakan standar arsitektur "World-Class" yang didokumentasikan di .aicontext.md.

Service Layer: Manual Repo Instantiation, Strict Transactions.
Deep Migrations: Folder-matching Table Names (apps/deliveries/requests -> apps_deliveries_requests).
Frontend: Strict JS Execution Guards & Livewire Coupling.
Generative Rules: Standardized "Scaffolding" for new modules.

Referensi Lengkap: .aicontext.md

Frontend

TypeScript - Type-safe JavaScript
TypeScript - Type-safe JavaScript
Vite - Build Tool
TailwindCSS 4.0 - Utility-first CSS
Alpine.js - Lightweight JavaScript
Mapbox GL - Real-time Map Visualization
ApexCharts - Data Visualization

Database

SQLite (Development)
PostgreSQL/MySQL (Production Ready)

📋 Requirements

PHP >= 8.2
Composer
Node.js >= 18.x
NPM/Yarn
SQLite/PostgreSQL/MySQL

🚀 Installation

1. Clone Repository

git clone <repository-url>
cd WEB_LOGISTECH

2. Install Dependencies

# Install PHP dependencies
composer install

# Install Node dependencies
npm install
# atau
yarn install

3. Environment Setup

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

4. Database Setup

# Run migrations
php artisan migrate

# (Optional) Seed database
php artisan db:seed

5. Build Assets

# Development
npm run dev

# Production
npm run build

6. Run Application

# Development server
php artisan serve

# Atau gunakan composer script
composer run dev

Aplikasi akan berjalan di http://localhost:8000

📚 API Documentation

Dokumentasi API lengkap tersedia dalam format OpenAPI 3.0 dan Postman Collection.

Quick Start

Menggunakan Postman

Import collection dari docs/postman/HND-Logistech-API.postman_collection.json
Import environment dari docs/postman/HND-Logistech-Local.postman_environment.json
Jalankan request Login untuk mendapatkan token
Token akan otomatis tersimpan dan siap digunakan

Menggunakan OpenAPI/Swagger

# Install Swagger UI
npm install -g swagger-ui-watcher

# Run Swagger UI
cd docs/api
swagger-ui-watcher openapi.json

Buka browser di http://localhost:8000

Dokumentasi Lengkap

API Documentation - OpenAPI 3.0 Specification
Postman Collection - Ready-to-use Postman Collection
Complete Documentation - Overview semua dokumentasi

API Endpoints

Authentication

POST   /api/auth          # Login
GET    /api/auth          # Verify Token
DELETE /api/auth          # Logout

Delivery Management

GET    /api/dashboards/apps/deliveries/requests          # List Requests
POST   /api/dashboards/apps/deliveries/requests          # Create Request
PATCH  /api/dashboards/apps/deliveries/requests/{id}     # Update Request
DELETE /api/dashboards/apps/deliveries/requests/{id}     # Delete Request

GET    /api/dashboards/apps/deliveries/tasks             # List Tasks
GET    /api/dashboards/apps/deliveries/reports           # List Reports

Real-time Tracking

GET    /api/dashboards/apps/trackings/monitors           # List Monitors
POST   /api/dashboards/apps/trackings/monitors           # Create Monitor
GET    /api/dashboards/apps/trackings/alarms             # List Alarms

Account Management

GET    /api/dashboards/managements/accounts              # List Accounts (Admin)
GET    /api/base/accounts                                # Get Current Account
PATCH  /api/base/accounts/firebase                       # Update Firebase Token

🔐 Authentication

API menggunakan Laravel Sanctum bearer token authentication.

Login

curl -X POST "http://localhost:8000/api/auth" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin",
    "password": "password123"
  }'

Menggunakan Token

curl -X GET "http://localhost:8000/api/dashboards/apps/deliveries/requests" \
  -H "Authorization: Bearer {your-token}" \
  -H "Content-Type: application/json"

🧪 Testing

# Run tests
php artisan test

# Run with coverage
php artisan test --coverage

📦 Deployment

Production Build

# Build assets
npm run build

# Optimize Laravel
php artisan config:cache
php artisan route:cache
php artisan view:cache

Docker (Optional)

# Development
docker-compose up -d

# Staging
docker-compose -f compose.staging.yml up -d

🔧 Development

Code Style

# PHP (Laravel Pint)
./vendor/bin/pint

# JavaScript/TypeScript (Prettier)
npm run format

Database

# Create migration
php artisan make:migration create_table_name

# Run migrations
php artisan migrate

# Rollback
php artisan migrate:rollback

# Fresh migration with seed
php artisan migrate:fresh --seed

Queue & Jobs

# Run queue worker
php artisan queue:work

# Run scheduler
php artisan schedule:work

WebSocket (Reverb)

# Start Reverb server
php artisan reverb:start

# Development with watch
php artisan reverb:start --debug

📁 Project Structure

WEB_LOGISTECH/
├── app/
│   ├── Console/         # Artisan commands
│   ├── Events/          # Event classes
│   ├── Http/
│   │   ├── Controllers/ # API & Web controllers
│   │   └── Middleware/  # Custom middleware
│   ├── Livewire/        # Livewire components
│   ├── Models/          # Eloquent models
│   ├── Repositories/    # Repository pattern
│   └── Services/        # Business logic
│
├── database/
│   ├── migrations/      # Database migrations
│   ├── seeders/         # Database seeders
│   └── factories/       # Model factories
│
├── docs/
│   ├── api/             # OpenAPI documentation
│   └── postman/         # Postman collection
│
├── resources/
│   ├── views/           # Blade templates
│   └── theme/           # Frontend assets
│
└── routes/
    ├── api.php          # API routes
    ├── web.php          # Web routes
    └── channels.php     # Broadcast channels

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Team

HND Technology

Email: support@hndtech.com
Website: hndtech.com

🙏 Acknowledgments

Laravel - The PHP Framework
Livewire - Dynamic UI
TailwindCSS - Utility-first CSS
Mapbox - Real-time Maps
Firebase - Push Notifications

Built with ❤️ by HND Technology Team

yovanggaanandhika / laravel

Maintainers

Details

README

🚀 Fitur Utama

🛠️ Tech Stack

Backend

🧠 Intelligent Architecture

Frontend

Database

📋 Requirements

🚀 Installation

1. Clone Repository

2. Install Dependencies

3. Environment Setup

4. Database Setup

5. Build Assets

6. Run Application

📚 API Documentation

Quick Start

Menggunakan Postman

Menggunakan OpenAPI/Swagger

Dokumentasi Lengkap

API Endpoints

Authentication

Delivery Management

Real-time Tracking

Account Management

🔐 Authentication

Login

Menggunakan Token

🧪 Testing

📦 Deployment

Production Build

Docker (Optional)

🔧 Development

Code Style

Database

Queue & Jobs

WebSocket (Reverb)

📁 Project Structure

🤝 Contributing

📄 License

👥 Team

🙏 Acknowledgments