# vuralkayracetintas/app_jam_f_40 architecture

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

- Interactive diagram: https://gitdiagram.com/vuralkayracetintas/app_jam_f_40
- Repository: https://github.com/vuralkayracetintas/app_jam_f_40

## Overview

##### Project Type and Purpose
- This is a cross-platform mobile/web “Announcement” application built in Flutter. It targets Android, iOS, Linux, macOS, Windows, and the Web.
- Purpose: allow students to log in, select announcement categories (Flutter, Unity, General), and view tasks, events, and push notifications.

##### File Structure Highlights
- Top-level platform folders: android/, ios/, linux/, macos/, windows/, web/.
- Core application code in lib/:
- pages/ – UI screens organized by feature (login, home, announce/category pages, splash)
- pages/service/ – notification services (Firebase and local)
- pages/widgets/ – reusable UI controls
- assets/ – images & Lottie animations
- Configuration/build: pubspec.yaml, analysis_options.yaml, platform Gradle/Xcode/CMake files.

##### Architectural Overview from README
- Presentation layer: Flutter Widgets and Pages
- Service layer: Firebase Cloud Messaging + local notifications
- No in-repo backend – relies on external FCM service for announcements

a. Main Components
- Flutter Client (Single codebase)
– Presentation Layer (lib/pages & lib/pages/widgets)
– Service Layer (lib/pages/service)
- Platform Runtimes (“Flutter Engine” per target: Android, iOS, Web, Desktop)
- External Services
– Firebase Cloud Messaging (push notifications)
– Optional external announcements URLs (use_url.dart → url_launcher)
b. Relationships & Data Flow
1. User taps UI → Presentation Layer
2. UI requests notifications permission → Service Layer
3. Service Layer registers with FCM → Firebase Cloud Messaging
4. FCM delivers push → Service Layer → Local Notification API → Presentation
5. User clicks links → url_launcher → External Web
c. Architectural Patterns
- Layered architecture (UI → Services → External)
- Platform‐abstraction via Flutter Engine
d. Key Technologies
- Flutter & Dart
- firebase_messaging (in firebase_notification_service.dart)
- flutter_local_notifications (in local_notification_service.dart)
- url_launcher (in use_url.dart)
- Lottie animations (assets/animations)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Configuration & Dependencies
    subgraph "Configuration"
        PUBSPEC["pubspec.yaml"]:::config
        ANALYSIS["analysis_options.yaml"]:::config
    end

    %% Codebase Layers
    subgraph "Codebase"
        subgraph "Presentation Layer" 
            MAIN["main.dart"]:::ui
            LOGIN["Login Screen\nlib/pages/login_page.dart"]:::ui
            HOME["Home Screen\nlib/pages/home_page.dart"]:::ui
            SPLASH["Splash Screen\nlib/pages/splash_screen.dart"]:::ui

            subgraph "Flutter Category Pages"
                F_ANN["duyuru_flutter.dart"]:::ui
                F_EVT["etkinlik_flutter.dart"]:::ui
                F_TASK["gorevler_flutter.dart"]:::ui
            end

            subgraph "General Category Pages"
                G_ANN["duyuru_genel.dart"]:::ui
                G_EVT["etkinlik_genel.dart"]:::ui
            end

            subgraph "Unity Category Pages"
                U_ANN["duyuru_unity.dart"]:::ui
                U_EVT["etkinlik_unity.dart"]:::ui
                U_TASK["gorevler_unity.dart"]:::ui
            end

            subgraph "Tab Bars & Widgets"
                TAB_F["custom_tabbar_flutter.dart"]:::ui
                TAB_G["custom_tabbar_genel.dart"]:::ui
                TAB_U["custom_tabbar_unity.dart"]:::ui
                FAB["customFAB.dart"]:::ui
            end
        end

        subgraph "Service Layer"
            FCM["firebase_notification_service.dart"]:::services
            LOCAL["local_notification_service.dart"]:::services
            URL["use_url.dart"]:::services
        end

        subgraph "Assets"
            ANIM["Lottie Animations\nassets/animations/"]:::assets
            IMG["Images\nassets/images/"]:::assets
        end
    end

    %% Platform Runtimes
    subgraph "Platform Runtimes"
        ANDROID["Android"]:::runtime
        IOS["iOS"]:::runtime
        WEB["Web"]:::runtime
        LINUX["Linux"]:::runtime
        MACOS["macOS"]:::runtime
        WINDOWS["Windows"]:::runtime
    end

    %% External Services
    Firebase["Firebase Cloud Messaging"]:::external
    ExternalWeb["External Web URL"]:::external

    %% Dependencies & Data Flows
    PUBSPEC -->|defines deps| MAIN
    MAIN -->|navigates to| LOGIN
    MAIN --> HOME
    MAIN --> SPLASH

    LOGIN -->|opens| F_ANN
    HOME -->|opens| TAB_F
    SPLASH -->|opens| HOME

    %% Categories
    F_ANN --> F_EVT
    F_EVT --> F_TASK

    G_ANN --> G_EVT

    U_ANN --> U_EVT
    U_EVT --> U_TASK

    %% Widgets
    HOME --> FAB
    HOME --> TAB_F
    HOME --> TAB_G
    HOME --> TAB_U

    %% Assets into UI
    ANIM --> MAIN
    IMG --> MAIN

    %% UI to Service
    MAIN -->|request permission| FCM
    MAIN -->|invoke URL| URL

    %% Service to External
    FCM -->|registers| Firebase
    Firebase -->|pushes| FCM
    FCM -->|triggers| LOCAL
    LOCAL -->|notifies| MAIN

    URL -->|launches| ExternalWeb

    %% UI runs on runtimes
    MAIN --> ANDROID
    MAIN --> IOS
    MAIN --> WEB
    MAIN --> LINUX
    MAIN --> MACOS
    MAIN --> WINDOWS

    %% Click Events
    click MAIN "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/main.dart"
    click LOGIN "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/login_page.dart"
    click HOME "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/home_page.dart"
    click SPLASH "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/splash_screen.dart"
    click F_ANN "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/flutter/duyuru_flutter.dart"
    click F_EVT "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/flutter/etkinlik_flutter.dart"
    click F_TASK "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/flutter/gorevler_flutter.dart"
    click G_ANN "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/genel/duyuru_genel.dart"
    click G_EVT "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/genel/etkinlik_genel.dart"
    click U_ANN "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/unity/duyuru_unity.dart"
    click U_EVT "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/unity/etkinlik_unity.dart"
    click U_TASK "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/unity/gorevler_unity.dart"
    click TAB_F "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/tabbar/custom_tabbar_flutter.dart"
    click TAB_G "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/tabbar/custom_tabbar_genel.dart"
    click TAB_U "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/tabbar/custom_tabbar_unity.dart"
    click FAB "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/widgets/customFAB.dart"
    click FCM "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/service/firebase_notification_service.dart"
    click LOCAL "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/service/local_notification_service.dart"
    click URL "https://github.com/vuralkayracetintas/app_jam_f_40/blob/main/lib/pages/package/use_url.dart"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef services fill:#90EE90,stroke:#333,stroke-width:1px
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
    classDef runtime fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef config fill:#E6E6FA,stroke:#333,stroke-width:1px
    classDef assets fill:#FFFACD,stroke:#333,stroke-width:1px
```
