# immanuelpartogi/ta-kel-13 architecture

> Architecture diagram of the GitHub repository immanuelpartogi/ta-kel-13, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/immanuelpartogi/ta-kel-13
- Repository: https://github.com/immanuelpartogi/ta-kel-13

## Overview

##### Project type and purpose
- This is a full-stack ferry-booking system composed of three main applications:
- Backend API (Laravel 11 + MySQL + Redis queues + Midtrans payment integration)
- Mobile client (Flutter multi-platform app for end users)
- Admin panel (React + Vite + Tailwind CSS web application for system management)
- The README confirms a REST-based architecture serving both the mobile app and the admin UI, with additional services for notifications and payments.

##### File structure
- ferry_booking_system/ (backend)
- app/ (Controllers → Services → Models → Jobs)
- database/ (migrations, seeders)
- config/, routes/, resources/views (Laravel MVC)
- Uses Redis (queues), MySQL, external Midtrans service
- ferry_booking_app/ (mobile)
- lib/api (HTTP clients), lib/services (business logic), lib/providers (state management), lib/models
- Cross-platform code under android/, ios/, web/, linux/, macos/, windows/
- Uses Dio for HTTP, Provider/Bloc for state, Hive/SharedPreferences for local storage, FCM for push
- ferry_booking_management_system/ (admin)
- src/components, pages, services (API wrappers), contexts (AuthContext), hooks (useSettings)
- Vite + React Router + Tailwind + Axios for HTTP

##### README for additional insights
- Integration with Midtrans for payments, Redis + Laravel Queues for notifications
- JWT authentication, AES-256 encryption on sensitive data, push notifications via FCM

##### Detail level
- Scheduled jobs invoking Artisan Commands (e.g., CheckPendingPayments, SendBoardingReminders) interacting with Services/Models
- Inside mobile app, illustrate layers: UI Screens → Providers → API clients → local storage

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    subgraph "Mobile App" 
        direction TB
        MA_UI["UI Screens & Navigation"]:::client
        MA_Providers["State Management Providers"]:::client
        MA_APIClients["API Clients (Dio)"]:::client
        MA_LocalStorage["Local Storage & Utilities"]:::client
        MA_UI --> MA_Providers --> MA_APIClients -->|"HTTP REST"| API_Routes
    end

    subgraph "Admin Panel" 
        direction TB
        AP_Pages["Pages (Admin & Operator)"]:::client
        AP_Components["Components (Layout & Common)"]:::client
        AP_Services["API Service Wrappers"]:::client
        AP_Context["Global Contexts"]:::client
        AP_Hooks["Custom Hooks"]:::client
        AP_Pages --> AP_Components --> AP_Services -->|"HTTP REST"| API_Routes
        AP_Context --> AP_Services
        AP_Hooks --> AP_Services
    end

    %% Backend Monolith
    subgraph "Laravel Monolith" 
        direction TB
        API_Routes["Routes (REST API)"]:::backend
        Controllers["Controllers"]:::backend
        Services["Service Layer"]:::backend
        Models["Models"]:::backend
        Jobs["Jobs & Queues"]:::backend
        Commands["Console Commands (Scheduled Jobs)"]:::backend
        Notifications["Notifications"]:::backend
        ConfigMidtrans["Midtrans Configuration"]:::backend
        Migrations["Database Migrations & Seeders"]:::backend

        API_Routes --> Controllers --> Services --> Models
        Services --> Jobs -->|Queue| Redis[(Redis)]:::db
        Services -->|Webhook/API| Midtrans((Midtrans)):::external
        Services -->|Push| FCM((Firebase Cloud Messaging)):::external
        Commands --> Services
        Notifications -->|Push| FCM
        Services -->|SQL| MySQL[(MySQL)]:::db
        Models -->|SQL| MySQL
        Migrations -->|SQL| MySQL
    end

    %% External Datastores
    MySQL[(MySQL)]:::db
    Redis[(Redis)]:::db
    Midtrans((Midtrans)):::external
    FCM((Firebase Cloud Messaging)):::external

    %% Click Events - Backend
    click Mobile_App "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_app/"
    click MA_UI "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_app/lib/screens/"
    click MA_Providers "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_app/lib/providers/"
    click MA_APIClients "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_app/lib/api/"
    click MA_LocalStorage "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_app/lib/utils/"
    click Admin_Panel "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_management_system/"
    click AP_Pages "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_management_system/src/pages/"
    click AP_Components "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_management_system/src/components/"
    click AP_Services "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_management_system/src/services/"
    click AP_Context "https://github.com/immanuelpartogi/ta-kel-13/blob/main/ferry_booking_management_system/src/contexts/AuthContext.jsx"
    click AP_Hooks "https://github.com/immanuelpartogi/ta-kel-13/blob/main/ferry_booking_management_system/src/hooks/useSettings.js"
    click API_Routes "https://github.com/immanuelpartogi/ta-kel-13/blob/main/ferry_booking_system/routes/api.php"
    click Controllers "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/app/Http/Controllers/Api/"
    click Services "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/app/Services/"
    click Models "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/app/Models/"
    click Jobs "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/app/Jobs/"
    click Commands "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/app/Console/Commands/"
    click Notifications "https://github.com/immanuelpartogi/ta-kel-13/blob/main/ferry_booking_system/app/Notifications/CustomResetPasswordNotification.php"
    click ConfigMidtrans "https://github.com/immanuelpartogi/ta-kel-13/blob/main/ferry_booking_system/config/midtrans.php"
    click Migrations "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/database/migrations/"
    click Monolith "https://github.com/immanuelpartogi/ta-kel-13/tree/main/ferry_booking_system/"

    classDef client fill:#D6EAF8,stroke:#2980B9,color:#154360
    classDef backend fill:#D5F5E3,stroke:#27AE60,color:#1E8449
    classDef db fill:#F9E79F,stroke:#B7950B,color:#7D6608
    classDef external fill:#F5CBA7,stroke:#D35400,color:#87421F
```
