# schooleproject/school architecture

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

- Interactive diagram: https://gitdiagram.com/schooleproject/school
- Repository: https://github.com/schooleproject/school

## Overview

##### Project type and purpose
- This is a multi-platform Flutter application (mobile, web, desktop) called “login_app.”
- The business domain is a school management portal: it provides separate UIs for Administrators, Guardians, and Teachers. Users log in, then access pages to manage classes, attendance, announcements, exam schedules, books, student evaluations, fees, etc.

##### File structure
- Top-level platform folders:
- android/ (Gradle-based build, MainActivity.kt)
- ios/, macos/, linux/, windows/ (Xcode and CMake configurations, native runner code)
- lib/ contains the Dart source:
- main.dart (entry point, MaterialApp)
- login_page.dart (login screen)
- admin_page/ (CRUD UIs: AddClassPage.dart, AttendancePage.dart, FeesPage.dart, etc.)
- guardian_page/ (NotificationsPage.dart, StudentListPage.dart, etc.)
- teacher_page.dart (likely similar grouping)
- pubspec.yaml / pubspec.lock for dependencies
- test/widget_test.dart for Flutter widget tests
- IDE/editor configs: .vscode/, .metadata/, analysis_options.yaml

##### README
- It contains only the default Flutter boilerplate. No architecture or backend specifics are described.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Platforms
    subgraph "Client Platforms"
        direction TB
        Android["Android"]:::platform
        iOS["iOS"]:::platform
        Web["Web"]:::platform
        Windows["Windows"]:::platform
        macOS["macOS"]:::platform
        Linux["Linux"]:::platform
    end

    %% Flutter Engine & Entry
    Android -->|launch| Engine["Flutter Engine\n+Dart Runtime"]:::engine
    iOS -->|launch| Engine
    Web -->|launch| Engine
    Windows -->|launch| Engine
    macOS -->|launch| Engine
    Linux -->|launch| Engine

    Engine -->|runs| Main["main.dart\n(MaterialApp)"]:::engine

    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        Main --> LoginModule["Login Module"]:::presentation
        Main --> AdminModule["Admin Module"]:::presentation
        Main --> GuardianModule["Guardian Module"]:::presentation
        Main --> TeacherModule["Teacher Module"]:::presentation
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        UIService["UI Service / State Management"]:::service
        APIClient["API Client"]:::service
    end

    LoginModule --> UIService
    AdminModule --> UIService
    GuardianModule --> UIService
    TeacherModule --> UIService
    UIService --> APIClient

    %% External Services & Data
    subgraph "External Services"
        direction TB
        AuthService["Authentication Service"]:::external
        DataAPI["School Data API"]:::external
    end

    APIClient -->|authenticate| AuthService
    APIClient -->|fetch/update data| DataAPI

    DataAPI --> Database["Database"]:::data

    %% Tests & Config
    subgraph "Utilities"
        direction TB
        Tests["widget_test.dart"]:::utility
        Config["pubspec.yaml\npubspec.lock"]:::utility
        Lint["analysis_options.yaml"]:::utility
    end

    %% Click Events
    click Android "https://github.com/schooleproject/school/blob/w/android/app/src/main/kotlin/com/example/login_app/MainActivity.kt"
    click iOS "https://github.com/schooleproject/school/blob/w/ios/Runner/AppDelegate.swift"
    click Web "https://github.com/schooleproject/school/blob/w/web/index.html"
    click Windows "https://github.com/schooleproject/school/blob/w/windows/runner/main.cpp"
    click macOS "https://github.com/schooleproject/school/blob/w/macos/Runner/MainFlutterWindow.swift"
    click Linux "https://github.com/schooleproject/school/blob/w/linux/main.cc"
    click Main "https://github.com/schooleproject/school/blob/w/lib/main.dart"
    click LoginModule "https://github.com/schooleproject/school/blob/w/lib/login_page.dart"
    click AdminModule "https://github.com/schooleproject/school/tree/w/lib/admin_page/"
    click GuardianModule "https://github.com/schooleproject/school/tree/w/lib/guardian_page/"
    click TeacherModule "https://github.com/schooleproject/school/blob/w/lib/teacher_page.dart"
    click Tests "https://github.com/schooleproject/school/blob/w/test/widget_test.dart"
    click Config "https://github.com/schooleproject/school/blob/w/pubspec.yaml"
    click Lint "https://github.com/schooleproject/school/blob/w/analysis_options.yaml"

    %% Styles
    classDef platform fill:#D0E8FF,stroke:#004080,stroke-width:1px;
    classDef engine fill:#D6F5D6,stroke:#1B7A1B,stroke-width:1px;
    classDef presentation fill:#FFF4CC,stroke:#997A00,stroke-width:1px;
    classDef service fill:#FFD9B3,stroke:#CC6600,stroke-width:1px;
    classDef external fill:#FFD1DC,stroke:#B3003B,stroke-width:1px;
    classDef data fill:#E2CCFF,stroke:#663399,stroke-width:1px;
    classDef utility fill:#F0F0F0,stroke:#888888,stroke-width:1px,stroke-dasharray: 5 5;
```
