# achrafsl/edimydar architecture

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

- Interactive diagram: https://gitdiagram.com/achrafsl/edimydar
- Repository: https://github.com/achrafsl/edimydar

## Overview

##### Project Type and Purpose
- This is an Android mobile ToDo application (“EdiMyDar”) written in Java.
- It provides user authentication, task management (today’s tasks and general tasks), AI-powered help via a REST API, and push/local notifications.
- The app uses Firebase (Auth, Firestore, FCM), OkHttp for AI API calls, and standard Android UI components (Activities, Fragments, RecyclerViews).

##### High-Level Architecture Components
A. Android Client
1. Presentation Layer
- Activities (Home, Login, Register, UserProfile, ForgotPassword flows)
- Fragments (MyDay, Task, AI Help)
- RecyclerView Adapters (MessageAdapter, TaskRecyclerViewAdapter, NormalTaskAdapter)
2. Business / Domain Layer
- Models (Message, DailyTask, NormalTask)
- ImageUtils (Base64 ↔ Bitmap conversions)
- NotificationReceiver (AlarmManager → BroadcastReceiver)
3. Data Access Layer
- Firebase Auth (login, registration, re-authentication)
- Firestore (CRUD operations on user profile and task collections)
- OkHttp (REST client for Gemini AI API)
- Local in-memory task lists (populated from Firestore at runtime)
B. External Services
- Firebase Cloud Firestore (persistent storage)
- Firebase Authentication (user management)
- Firebase Cloud Messaging (push notifications)
- Gemini AI REST API (task-assist chatbot)

##### Relationships and Data Flows
- User interacts with UI (Activities/Fragments) → event handlers invoke business logic.
- UI layer calls Data Access Layer:
- Auth calls → Firebase Auth endpoints
- CRUD tasks → Firestore collections
- Profile image → Firestore (Base64 blob)
- AI queries → OkHttp → Gemini API → message responses → UI
- Notification scheduling:
- TaskFragment schedules alarms via Android AlarmManager → NotificationReceiver → builds and posts notifications through FCM/local channels.
- Adapters bind models to RecyclerViews in Fragments.

##### Architectural Patterns and Principles
- MVC-like separation:
- View = XML layouts + Activities/Fragments
- Controller = Activities/Fragments + Adapters
- Model = Plain Java objects (Message, Task)
- Single Responsibility: each Activity or Fragment handles one screen/flow.
- Dependency inversion: external services invoked via wrapper classes (ImageUtils, NotificationReceiver).
- Modular packaging: clear separation between UI, models, adapters, utils.

## Diagram (Mermaid)

```mermaid
graph TB
  subgraph "Android App"
    subgraph "Presentation Layer"
      HA["Home Activity"]:::presentation
      click HA "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/HomeAct.java"
      LP["Login Activity"]:::presentation
      click LP "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/Login.java"
      RG["Register Activity"]:::presentation
      click RG "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/Register.java"
      FP["ForgotPassword Activity"]:::presentation
      click FP "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/ForgotPWD.java"
      FPF["ForgotPwd Failure"]:::presentation
      click FPF "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/ForgotPWD_R_FAILURE.java"
      FPS["ForgotPwd Success"]:::presentation
      click FPS "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/ForgotPWD_R_SUCCESS.java"
      UP["UserProfile Activity"]:::presentation
      click UP "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/UsrProfileActivity.java"
      MD["MyDay Fragment"]:::presentation
      click MD "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/myDayFragment.java"
      TF["Task Fragment"]:::presentation
      click TF "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/TaskFragment.java"
      AF["AI Help Fragment"]:::presentation
      click AF "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/AiFragment.java"
    end
    subgraph "Business/Domain Layer"
      MA["MessageAdapter"]:::domain
      click MA "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/MessageAdapter.java"
      TA["DailyTask Adapter"]:::domain
      click TA "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/TaskRecylerViewAdapter.java"
      NA["GeneralTask Adapter"]:::domain
      click NA "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/normalTaskRecycler_V_Adapter.java"
      DT["DailyTask Model"]:::domain
      click DT "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/DailyTask.java"
      NT["NormalTask Model"]:::domain
      click NT "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/NormalTask.java"
      ME["Message Model"]:::domain
      click ME "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/message.java"
      IU["ImageUtils"]:::domain
      click IU "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/ImageUtils.java"
      AM["AlarmManager"]:::domain
      NR["NotificationReceiver"]:::domain
      click NR "https://github.com/achrafsl/edimydar/blob/master/app/src/main/java/com/example/edimydar/NotificationReceiver.java"
    end
    subgraph "Data Access Layer"
      FA["Firebase Auth Client"]:::data
      FB["Firestore Client"]:::data
      OK["OkHttp Client"]:::data
      LM["Local InMemory Lists"]:::data
    end
  end

  %% External Services
  FBAuthSv["Firebase Authentication"]:::external
  FBSv["Firebase Firestore\n(collections: users, tasks)"]:::external
  FCMSv["Firebase Cloud Messaging"]:::external
  AISv["Gemini AI REST API"]:::external

  %% Data Flows
  HA -->|"fetchUserTasks()"| FB
  LP -->|"login()"| FA
  RG -->|"register()"| FA
  FP -->|"resetPassword()"| FA
  UP -->|"updateProfile()"| FB

  MD -->|"binds"| TA & DT
  TF -->|"binds"| NA & NT
  AF -->|"binds"| MA & ME

  AF -->|"sendChatRequest()"| OK
  TF -->|"scheduleNotification()"| AM
  AM -.->|"broadcast()"| NR
  NR -.->|"postNotification()"| FCMSv

  FA -->|"login()/register()"| FBAuthSv
  FB -->|"CRUD operations"| FBSv
  OK -->|"POST /chat"| AISv

  %% Classes
  classDef presentation fill:#cce5ff,stroke:#000;
  classDef domain fill:#d4edda,stroke:#000;
  classDef data fill:#d1ecf1,stroke:#000;
  classDef external fill:#f8d7da,stroke:#000;
```
