# aayushman024/project_management-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/aayushman024/project_management-frontend
- Repository: https://github.com/aayushman024/project_management-frontend

## Overview

##### Project type and purpose
- From the file tree and README, this is a cross-platform Flutter “Project Management System” client application. It provides UI pages (login, dashboard, project detail, etc.), uses controllers for business logic, and calls out to a remote REST API to create/read/update projects, features, bugs, and teams.

##### File structure
- Top-level “web/” and “windows/” folders contain platform runners (HTML shell for web, C++ runner for Windows).
- lib/main.dart serves as the Flutter entry point.
- lib/pages/ holds the app’s screens (loginPage, homePage, projectDetailPage, etc.).
- lib/components/ provides reusable UI widgets (projectCard, barGraph, timeline, etc.).
- lib/controllers/ contains state‐management and business logic.
- lib/api/ defines HTTP clients and data models (apis.dart, getAllProjects.dart).
- lib/dialogBoxes/ holds pop-up forms (addBugs, addFeature, etc.).
- pubspec.yaml lists the app’s external dependencies (Flutter SDK, http package, etc.).

##### README for additional insights
- The README is minimal (“Project Management System”) and confirms this is purely the front-end. There is an external back-end (not in this repo) that the API module communicates with over HTTP.

##### Detail
- Folders under lib as separate sub-components (pages vs components vs dialogBoxes).
- Platform targets (web, windows, mobile) feeding into the same Flutter App layer.
- Explicitly call out the data model (JSON ↔ Dart classes in lib/api/models).
- Do not omit the controllers layer—this is where state management and business rules live.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Platform Runners"
        WR["Web Runner"]:::platform
        WinR["Windows Runner"]:::platform
        MR["Mobile Runner"]:::platform
    end
    FR["Flutter Engine/Dart VM (lib/main.dart)"]:::engine
    subgraph "Flutter App"
        subgraph "Presentation Layer"
            Pages["Pages (lib/pages/)"]:::presentation
            Components["Components (lib/components/)"]:::presentation
        end
        subgraph "Business Logic Layer"
            Controllers["Controllers (lib/controllers/controllers.dart)"]:::business
            Dialogs["Dialog Boxes (lib/dialogBoxes/)"]:::business
        end
        subgraph "Data Layer"
            APIClient["API Client (lib/api/apis.dart)"]:::data
            Models["Models (lib/api/models/)"]:::data
        end
    end
    External["Project Management REST API + DB"]:::external

    WR --> FR
    WinR --> FR
    MR --> FR
    FR --> Pages
    FR --> Components
    Pages --> Controllers
    Components --> Controllers
    Controllers --> Dialogs
    Controllers --> APIClient
    APIClient --> External
    External --> APIClient
    APIClient --> Models
    Models --> Controllers
    Controllers --> Pages

    click WR "https://github.com/aayushman024/project_management-frontend/blob/main/web/index.html"
    click WinR "https://github.com/aayushman024/project_management-frontend/blob/main/windows/runner/main.cpp"
    click MR "https://github.com/aayushman024/project_management-frontend/blob/main/web/index.html"
    click FR "https://github.com/aayushman024/project_management-frontend/blob/main/lib/main.dart"
    click Pages "https://github.com/aayushman024/project_management-frontend/tree/main/lib/pages/"
    click Components "https://github.com/aayushman024/project_management-frontend/tree/main/lib/components/"
    click Controllers "https://github.com/aayushman024/project_management-frontend/blob/main/lib/controllers/controllers.dart"
    click Dialogs "https://github.com/aayushman024/project_management-frontend/tree/main/lib/dialogBoxes/"
    click APIClient "https://github.com/aayushman024/project_management-frontend/blob/main/lib/api/apis.dart"
    click Models "https://github.com/aayushman024/project_management-frontend/tree/main/lib/api/models/"

    classDef platform fill:#e0e0e0,stroke:#333,stroke-width:1px
    classDef engine fill:#dddddd,stroke:#333,stroke-width:1px
    classDef presentation fill:#bbdefb,stroke:#333,stroke-width:1px
    classDef business fill:#c8e6c9,stroke:#333,stroke-width:1px
    classDef data fill:#ffe0b2,stroke:#333,stroke-width:1px
    classDef external fill:#f5f5f5,stroke:#555,stroke-width:2px,stroke-dasharray:5 5
```
