# aliza02/taskmanager architecture

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

- Interactive diagram: https://gitdiagram.com/aliza02/taskmanager
- Repository: https://github.com/aliza02/taskmanager

## Overview

##### Project Type and Purpose
- This is a cross-platform (Android, iOS, Web, macOS, Windows, Linux) Flutter application called “Taskmanager.”
- It provides project collaboration, task tracking, comments, and notifications (push and email).
- Uses Firebase (Auth, Firestore, Cloud Messaging), EmailJS API for emails, BLoC for state management, and dependency injection.

##### File-Structure Highlights
- Top-level: platform folders (android, ios, macos, windows, linux, web), standard Flutter host code.
- lib/: the core app code, organized into:
- main.dart (app entry)
- routes/: navigation definitions and page mappings
- screens/: UI pages grouped by feature (auth, home, workspaces, comments, notifications)
- widgets/: reusable UI components
- bloc/: BLoC classes (events, states, blocs) per feature (tasks, projects, members, user, navigation)
- controllers/: “use-case” or service layer classes (project_controller, etc.)
- data/: data‐access layer (Firebase auth, database functions, email sending)
- notification/: local notification wrappers
- injection/: DI setup for controllers and services
- pubspec.yaml: dependency list (flutter, firebase, bloc, get_it or injectable, etc.)

##### Architecture Synopsis from README
- UI screens use BLoC to manage state.
- BLoC delegates to controllers/use-cases.
- Controllers call data layer (database functions or email sending).
- Data layer interacts with Firebase services and EmailJS API.
- Notifications: uses Firebase Cloud Messaging + local notifications wrapper.

##### Components
a. Frontend (Flutter App)
- Platform Hosts (Android, iOS, Web, Desktop)
- UI Layer (screens, widgets)
- Navigation/Routes
b. State Management Layer
c. Domain/Service Layer
- Controllers (project_controller, etc.)
d. Data Layer/Repositories
- Firebase Auth & Firestore Database Functions
- EmailJS Service
- Local Notification Service
e. Dependency Injection
- DI Container (provides controllers, repositories to BLoCs)
f. External Services
- Firebase Cloud Messaging
- EmailJS API
- Firebase (Google) Sign-in

##### Relationships & Data Flows
1. UI → BLoC (dispatch events, read states)
2. BLoC → Controllers (invoke use-cases)
3. Controllers → Data Layer (perform CRUD, send email)
4. Data Layer ↔ Firebase services (Auth, Firestore, FCM)
5. Data Layer → EmailJS (REST call)
6. FCM → Notification Service → UI (push notifications)
- DI container injects controllers and repos into BLoCs at startup.

##### Architectural Patterns & Principles
- Separation of Concerns: UI vs. state vs. domain vs. data
- BLoC Pattern for reactive state management
- Dependency Injection (get_it/injectable) for decoupling
- Repository pattern over Firebase services
- REST integration for EmailJS alongside real-time DB

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Entry and DI Bootstrap
    Main["main.dart (Entry & DI)"]:::di
    click Main "https://github.com/aliza02/taskmanager/blob/master/lib/main.dart"
    FirebaseOptions["firebase_options.dart"]:::di
    click FirebaseOptions "https://github.com/aliza02/taskmanager/blob/master/lib/firebase_options.dart"

    %% Dependency Injection Container
    DI["DI Container"]:::di
    click DI "https://github.com/aliza02/taskmanager/blob/master/lib/injection/database.dart"

    %% Flutter Application Layers
    subgraph "Flutter App"
        direction TB
        subgraph "Platform Hosts"
            direction TB
            Android["Android"]:::frontend
            iOS["iOS"]:::frontend
            Web["Web"]:::frontend
            Desktop["Desktop (macOS, Windows, Linux)"]:::frontend
        end

        subgraph "UI Layer"
            direction TB
            Screens["Screens"]:::frontend
            click Screens "https://github.com/aliza02/taskmanager/tree/master/lib/screens/"
            Widgets["Widgets"]:::frontend
            click Widgets "https://github.com/aliza02/taskmanager/tree/master/lib/widgets/"
            RoutesDef["Routes Definitions"]:::frontend
            click RoutesDef "https://github.com/aliza02/taskmanager/blob/master/lib/routes/routes.dart"
            Pages["Page Mappings"]:::frontend
            click Pages "https://github.com/aliza02/taskmanager/blob/master/lib/routes/pages.dart"
        end

        BLoC["BLoC Layer"]:::bloc
        click BLoC "https://github.com/aliza02/taskmanager/tree/master/lib/bloc/"

        Controllers["Controllers (Use-Cases)"]:::controllers
        click Controllers "https://github.com/aliza02/taskmanager/blob/master/lib/controllers/project_controller.dart"

        subgraph "Data Layer"
            direction TB
            Auth["Firebase Auth Module"]:::data
            click Auth "https://github.com/aliza02/taskmanager/blob/master/lib/data/Authentications/google_signin.dart"
            DB["Firestore DB Functions"]:::data
            click DB "https://github.com/aliza02/taskmanager/blob/master/lib/data/databse/database_functions.dart"
            Email["EmailJS Service"]:::data
            click Email "https://github.com/aliza02/taskmanager/blob/master/lib/data/email/email_sending.dart"
            NotificationLocal["Local Notification Service"]:::data
            click NotificationLocal "https://github.com/aliza02/taskmanager/blob/master/lib/notification/notification_services.dart"
        end
    end

    %% External Services
    subgraph "External Services"
        direction TB
        FirebaseExt["Firebase (Auth & Firestore)"]:::external
        FCM["Firebase Cloud Messaging"]:::external
        EmailJS["EmailJS API"]:::external
    end

    %% Data Flow and Dependencies
    Main --> DI
    DI --> BLoC
    DI --> Controllers
    DI --> Auth
    DI --> DB
    DI --> Email
    DI --> NotificationLocal

    Android --> Screens
    iOS --> Screens
    Web --> Screens
    Desktop --> Screens

    Screens --> BLoC
    Widgets --> BLoC
    RoutesDef --> BLoC
    Pages --> BLoC

    BLoC --> Controllers
    Controllers --> Auth
    Controllers --> DB
    Controllers --> Email

    Auth --> FirebaseExt
    DB --> FirebaseExt
    Email --> EmailJS

    %% Notifications Flow
    FCM -- "push notifications" --> NotificationLocal
    NotificationLocal -.->|"displays notifications"| Screens

    %% Class Definitions
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#004D40;
    classDef bloc fill:#E8F5E9,stroke:#2E7D32,color:#1B5E20;
    classDef controllers fill:#FFF3E0,stroke:#EF6C00,color:#E65100;
    classDef data fill:#F3E5F5,stroke:#6A1B9A,color:#4A148C;
    classDef external fill:#FFEBEE,stroke:#C62828,color:#B71C1C;
    classDef di fill:#ECEFF1,stroke:#455A64,color:#263238;
```
