# aliefauzan/keretaxpress architecture

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

- Interactive diagram: https://gitdiagram.com/aliefauzan/keretaxpress
- Repository: https://github.com/aliefauzan/keretaxpress

## Overview

##### Project type and purpose
- This is a full-stack train-booking application named KeretaXpress.
- It comprises:
- A Flutter-based multi-platform mobile/desktop frontend (Android, iOS, Web, Windows, macOS, Linux)
- A Next.js React-based web frontend (in `web_version/`)
- A Laravel-based RESTful backend API (`tesbackend/`)
- A MySQL (or compatible) database plus file-storage for uploads
- CI/CD pipelines (GitHub Actions, Cloud Build) and optional Docker containerization

##### File structure
Top-level directories and their roles:
- `frontend/` → Flutter app source (lib/core services, models, screens, widgets; platform folders under android, ios, web, windows, macos, linux)
- `tesbackend/` → Laravel API (app/Http/Controllers, app/Models, app/Services; config, database/migrations & seeders; routes/api.php; Dockerfile & docker-compose.yml; CI workflows)
- `web_version/` → Next.js web client (src/app pages, components, utils, lib/api.ts; Next.js config files)

##### README for additional insights
- Business flows: user registration/login → train schedule query → seat selection → booking creation → payment (proof upload → status update) → booking history & filtering
- Key technologies: Flutter, Dart, http, intl, flutter_dotenv; Laravel 10.x, PHP 8.1+, Sanctum/personal-access tokens, MySQL; Docker; GitHub Actions

##### Elements
- UI clients (e.g., blue rectangles)
- API/server (green rectangle)
- Clear labels on each component (e.g., “Flutter App”, “Laravel API”, “MySQL DB”)
- HTTP requests/responses
- Database read/write
- Event publishing

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients Layer
    subgraph "Clients Layer"
        direction TB
        FlutterApp["Flutter App"]:::frontend
        CoreServices["Core Services"]:::frontend
        ModelsF["Models"]:::frontend
        Screens["Screens"]:::frontend
        Widgets["Widgets"]:::frontend
        Main["main.dart"]:::frontend
        FlutterApp --> CoreServices
        FlutterApp --> ModelsF
        FlutterApp --> Screens
        FlutterApp --> Widgets
        FlutterApp --> Main

        NextJsApp["Next.js Web App"]:::frontend
        Pages["Pages (App routes)"]:::frontend
        ComponentsF["UI Components"]:::frontend
        APIAbstraction["API Abstraction"]:::frontend
        Utils["Utilities"]:::frontend
        NextJsApp --> Pages
        NextJsApp --> ComponentsF
        NextJsApp --> APIAbstraction
        NextJsApp --> Utils
    end

    %% Backend Layer
    subgraph "Backend API Layer"
        direction TB
        LaravelAPI["Laravel REST API"]:::backend
        Controllers["Controllers"]:::backend
        SupabaseServiceComp["SupabaseService.php"]:::backend
        ModelsB["Models"]:::backend
        Routes["routes/api.php"]:::backend
        Middleware["Middleware"]:::backend
        Events["TrainUpdated Event"]:::backend
        Providers["SupabaseServiceProvider"]:::backend

        LaravelAPI --> Controllers
        LaravelAPI --> SupabaseServiceComp
        LaravelAPI --> ModelsB
        LaravelAPI --> Routes
        LaravelAPI --> Middleware
        LaravelAPI --> Events
        LaravelAPI --> Providers
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MySQLDB["MySQL Database"]:::database
        FileStorage["File Storage"]:::storage
        PublicUploads["Public Uploads"]:::storage
        PrivateUploads["Private Uploads"]:::storage
        MySQLDB
        FileStorage --> PublicUploads
        FileStorage --> PrivateUploads
    end

    %% External Services
    subgraph "External Services"
        direction TB
        SupabaseExt["Supabase (Real-time)"]:::external
    end

    %% Infrastructure & CI/CD
    subgraph "Infrastructure & CI/CD"
        direction TB
        DockerInfra["Docker Containers"]:::infra
        Dockerfile["Dockerfile"]:::infra
        DockerCompose["docker-compose.yml"]:::infra
        Dockerignore[".dockerignore"]:::infra
        CICD["CI/CD Pipelines"]:::infra
        Workflows["GitHub Actions Workflows"]:::infra
        CloudBuild["Cloud Build Config"]:::infra

        DockerInfra --> Dockerfile
        DockerInfra --> DockerCompose
        DockerInfra --> Dockerignore
        CICD --> Workflows
        CICD --> CloudBuild
    end

    %% Relationships
    FlutterApp -->|HTTPS/JSON| LaravelAPI
    NextJsApp -->|HTTPS/JSON| LaravelAPI
    LaravelAPI -->|SQL via Eloquent| MySQLDB
    LaravelAPI -->|read/write| FileStorage
    LaravelAPI -->|publish events| SupabaseExt
    CICD -->|build & deploy| DockerInfra
    DockerInfra -->|deploy containers| LaravelAPI
    DockerInfra -->|deploy containers| MySQLDB

    %% Click Events
    click CoreServices "https://github.com/aliefauzan/keretaxpress/tree/main/frontend/lib/core/services/"
    click ModelsF "https://github.com/aliefauzan/keretaxpress/tree/main/frontend/lib/models/"
    click Screens "https://github.com/aliefauzan/keretaxpress/tree/main/frontend/lib/screens/"
    click Widgets "https://github.com/aliefauzan/keretaxpress/tree/main/frontend/lib/widgets/"
    click Main "https://github.com/aliefauzan/keretaxpress/blob/main/frontend/lib/main.dart"
    click Pages "https://github.com/aliefauzan/keretaxpress/tree/main/web_version/src/app/"
    click ComponentsF "https://github.com/aliefauzan/keretaxpress/tree/main/web_version/src/components/"
    click APIAbstraction "https://github.com/aliefauzan/keretaxpress/blob/main/web_version/src/lib/api.ts"
    click Utils "https://github.com/aliefauzan/keretaxpress/tree/main/web_version/src/utils/"
    click Controllers "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/app/Http/Controllers/"
    click SupabaseServiceComp "https://github.com/aliefauzan/keretaxpress/blob/main/tesbackend/app/Services/SupabaseService.php"
    click ModelsB "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/app/Models/"
    click Routes "https://github.com/aliefauzan/keretaxpress/blob/main/tesbackend/routes/api.php"
    click Middleware "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/app/Http/Middleware/"
    click Events "https://github.com/aliefauzan/keretaxpress/blob/main/tesbackend/app/Events/TrainUpdated.php"
    click Providers "https://github.com/aliefauzan/keretaxpress/blob/main/tesbackend/app/Providers/SupabaseServiceProvider.php"
    click PublicUploads "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/storage/app/public/"
    click PrivateUploads "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/storage/app/private/"
    click Dockerfile "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/Dockerfile"
    click DockerCompose "https://github.com/aliefauzan/keretaxpress/blob/main/tesbackend/docker-compose.yml"
    click Dockerignore "https://github.com/aliefauzan/keretaxpress/blob/main/.dockerignore"
    click Workflows "https://github.com/aliefauzan/keretaxpress/tree/main/tesbackend/.github/workflows/"
    click CloudBuild "https://github.com/aliefauzan/keretaxpress/blob/main/tesbackend/cloudbuild.yaml"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0066CC,color:#003366;
    classDef backend fill:#DFF2E6,stroke:#33AA33,color:#226622;
    classDef database fill:#E6F7FF,stroke:#33AADD,color:#226688;
    classDef storage fill:#FFF0D9,stroke:#E6A800,color:#CC8400;
    classDef external fill:#F0E6FF,stroke:#AA33DD,color:#552288;
    classDef infra fill:#F2F2F2,stroke:#999999,color:#666666;
```
