# tala-jebrini/android-lab-project architecture

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

- Interactive diagram: https://gitdiagram.com/tala-jebrini/android-lab-project
- Repository: https://github.com/tala-jebrini/android-lab-project

## Overview

##### Project type and purpose
- This is a single‐platform (Android) mobile application for multi‐user task management.
- Users can sign up, sign in, add/edit/delete tasks, set reminders (notifications), view tasks by category/time, share tasks, and import tasks via a REST API.
- The app uses Java, Android SDK (Activities + Fragments), SQLite for persistent storage, Shared Preferences for lightweight user/session data, and an external REST API for task import.

##### File structure
- Top level:
- app/        ← Android Studio project
- README.md  ← Project description
- ENCS5150_Project.pdf ← Documentation
- Inside app/src/main/java/com/example/a1200493_courseproject:
- Activities: MainActivity, SignIn, Signup, Home
- Data managers: DataBaseHelper (SQLite), SharedPrefManager, HttpManager (REST client)
- BroadcastReceiver: TaskAlertReceiver (schedules notifications)
- Model classes: User, Task
- UI Fragments: TodayFragment, AllTasksFragment, CompletedTasksFragment, NewTaskFragment, SearchFragment, ProfileFragment
- Resources:
- layouts for each Activity/Fragment and dialogs
- navigation graph (mobile_navigation.xml)
- Build & config:
- build.gradle files
- AndroidManifest.xml
- proguard rules

##### README for additional insights
- Confirms technical stack: Android, SQLite, Java, Fragments, Shared Preferences
- Mentions REST API import and notifications

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Users
    User(("User")):::external
    subgraph "Android Application"
        direction TB
        subgraph "Presentation Layer"
            direction TB
            MA["MainActivity"]:::ui
            SI["SignIn"]:::ui
            SU["Signup"]:::ui
            HO["Home"]:::ui
            TF["TodayFragment"]:::ui
            ATF["AllTasksFragment"]:::ui
            CTF["CompletedTasksFragment"]:::ui
            NTF["NewTaskFragment"]:::ui
            SF["SearchFragment"]:::ui
            PF["ProfileFragment"]:::ui
        end

        subgraph "Business Logic Layer"
            direction TB
            HTTP["HttpManager"]:::logic
            DBH["DataBaseHelper"]:::logic
            SPM["SharedPrefManager"]:::logic
            TAR["TaskAlertReceiver"]:::logic
        end

        subgraph "Data Layer"
            direction TB
            DB[(SQLite DB)]:::data
            SP["SharedPreferences"]:::pref
        end
    end

    %% External Systems
    REST["REST API Service"]:::external
    AM["Android AlarmManager"]:::external

    %% Flows
    User -->|interacts with| MA
    User --> SI
    User --> SU
    User --> HO
    MA --> HTTP
    MA --> DBH
    MA --> SPM
    SI --> DBH
    SI --> SPM
    SU --> DBH
    SU --> SPM
    HO --> TF
    HO --> ATF
    HO --> CTF
    HO --> NTF
    HO --> SF
    HO --> PF

    TF --> DBH
    ATF --> DBH
    CTF --> DBH
    NTF --> DBH
    SF --> DBH
    PF --> SPM

    HTTP -->|HTTP calls| REST
    HTTP --> DB
    DBH --> DB
    SPM --> SP

    NTF --> TAR
    TAR -->|set alarms| AM
    AM -->|triggers| TAR

    %% Click Events
    click MA "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/MainActivity.java"
    click HO "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/Home.java"
    click SI "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/SignIn.java"
    click SU "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/Signup.java"
    click TF "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/ui/TodayFragment.java"
    click ATF "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/ui/AllTasksFragment.java"
    click CTF "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/ui/CompletedTasksFragment.java"
    click NTF "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/ui/NewTaskFragment.java"
    click SF "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/ui/SearchFragment.java"
    click PF "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/ui/ProfileFragment.java"
    click DBH "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/DataBaseHelper.java"
    click SPM "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/SharedPrefManager.java"
    click HTTP "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/HttpManager.java"
    click TAR "https://github.com/tala-jebrini/android-lab-project/blob/master/app/src/main/java/com/example/a1200493_courseproject/TaskAlertReceiver.java"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#000;
    classDef logic fill:#90EE90,stroke:#000;
    classDef data fill:#FFA500,stroke:#000;
    classDef pref fill:#D3D3D3,stroke:#000;
    classDef external fill:#F0F0F0,stroke:#000;
```
