# aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php architecture

> Architecture diagram of the GitHub repository aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php
- Repository: https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php

## Overview

##### Main Components
- Client Application (Flutter):
– This is the core mobile/desktop app structure covering Android, iOS, Windows, and potentially other platforms based on each subfolder (android, ios, windows).
– Within the Flutter project, the “lib” folder is structured into several sub-components:
▸ Model layer: Contains classes such as “kullanici.dart”, “siparis_model.dart”, and “proje_model.dart” that represent the core data.
▸ Controller layer: Manages UI logic and interactions (e.g., “genelController.dart”).
▸ Service layer: Handles communication with the backend (e.g., “oturum.dart”, “veri_getir.dart”, “veri_gonder.dart”).
▸ Pages/Views: Different screens like “anasayfa.dart”, “oturum/giris.dart”, various “siparis” and “proje” pages.
▸ Widget layer: Reusable UI components such as information rows, custom containers, etc.
- External Backend (PHP Script):
– This backend service is not included in the repository but is critical as the data provider and business logic handler. It processes orders and projects data such as delivery dates, statuses, customer information, etc.
– The Flutter configuration (found in “lib/sabitler/ext.dart”) likely contains API endpoints and keys.
- Optional Supporting Infrastructure:
– Hosting environment for PHP (not shown in the tree but mentioned in the README).
– Database (implied by the PHP script, holding orders and projects data).

##### Relationships and Interactions
- The Flutter client acts as the presentation layer, interacting directly with users.
- UI events (via widgets and pages) are routed to Controllers, which use Service classes to send API calls.
- Service layer components perform network communication (REST API calls, HTTP requests) to the PHP backend.
- The data flows back from the backend to update the UI.
- Platform-specific folders (android, ios, windows) indicate that the client application is built for multiple targets; these platforms may have slight differences in configuration or customization, but they all share the same core Flutter code from “lib”.

##### Architectural Patterns and Design Principles
- “Separation of Concerns” is clearly implemented by dividing the system into models, controllers, services, and UI widgets.
- The structure hints at an MVC or MVVM-like pattern where:
– Models represent data.
– Controllers/Services handle business logic and manage data interaction.
– Views (pages and widgets) display the information.
- The client-backend separation clearly follows a RESTful API communication pattern.

##### Incorporate Relevant Technologies, Frameworks, and Libraries
- Flutter SDK for the client application.
- Native project configurations for Android, iOS, and Windows.
- The PHP backend script (details available on its GitHub page) as the service provider.
- HTTP network libraries (implied in the “veri_getir.dart” and “veri_gonder.dart” files) for API calls.
- State management (possibly using Flutter’s native state management or another system) which isn’t explicitly named but is likely part of the controller and service logic.

##### Elements
- Labels for Each Component:
– “Flutter Client Application” split into its submodules (Models, Views, Controllers/Services).
– “API Service Layer” inside the Flutter app.
– “Platform-specific Code” (Android, iOS, Windows).
– “External PHP Backend Service” (with supporting database).
– Show data/request flows from UI components → Controllers → Services → PHP backend, and the reverse data responses from the backend.
- Visual Differentiation:

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Main Flutter Client Application node
    FLUTTER["Flutter Client Application"]:::client
    click FLUTTER "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/lib"

    %% App Structure Subgraph
    subgraph "App Structure (lib)"
        MODELS["Models"]:::model
        click MODELS "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/lib/model"
        
        CONTROLLERS["Controllers"]:::controller
        click CONTROLLERS "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/blob/master/lib/controller/genelController.dart"
        
        SERVICES["Services"]:::service
        click SERVICES "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/lib/servis"
        
        PAGES["Pages/Views"]:::view
        click PAGES "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/lib/sayfalar"
        
        WIDGETS["Widgets"]:::widget
        click WIDGETS "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/lib/widget"
        
        BACKENDCFG["Backend Config"]:::config
        click BACKENDCFG "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/blob/master/lib/sabitler/ext.dart"
    end

    %% Platform-Specific Code Subgraph
    subgraph "Platform-Specific Code"
        ANDROID["Android"]:::platform
        click ANDROID "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/blob/master/android/app/src/main/kotlin/com/aksoyhlc/siparistakip/MainActivity.kt"
        
        IOS["iOS"]:::platform
        click IOS "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/ios/"
        
        WINDOWS["Windows"]:::platform
        click WINDOWS "https://github.com/aksoyhlc/aksoyhlc-order-project-tracking-application-flutter-php/tree/master/windows/"
    end

    %% External Infrastructure Subgraph
    subgraph "External Infrastructure"
        PHP_BACKEND["External PHP Backend Service"]:::backend
        DATABASE["Database"]:::db
    end

    %% Connections within Flutter App Structure
    FLUTTER --> PAGES
    PAGES -->|"triggers"| CONTROLLERS
    CONTROLLERS -->|"calls"| SERVICES
    BACKENDCFG -->|"configures"| SERVICES
    SERVICES -->|"APIcall"| PHP_BACKEND
    PHP_BACKEND -->|"response"| SERVICES
    SERVICES -->|"updates"| PAGES

    %% Connections to Platform-Specific Code
    FLUTTER --> ANDROID
    FLUTTER --> IOS
    FLUTTER --> WINDOWS

    %% Connection from External PHP Backend to Database
    PHP_BACKEND -->|"accesses"| DATABASE

    %% Styles
    classDef client fill:#f9c,stroke:#333,stroke-width:2px;
    classDef model fill:#cde,stroke:#333,stroke-width:2px;
    classDef controller fill:#dff,stroke:#333,stroke-width:2px;
    classDef service fill:#fdd,stroke:#333,stroke-width:2px;
    classDef view fill:#dfd,stroke:#333,stroke-width:2px;
    classDef widget fill:#fed,stroke:#333,stroke-width:2px;
    classDef config fill:#eee,stroke:#333,stroke-width:2px;
    classDef platform fill:#ffc,stroke:#333,stroke-width:2px;
    classDef backend fill:#ddd,stroke:#333,stroke-width:2px;
    classDef db fill:#ffe4b5,stroke:#333,stroke-width:2px;
```
