# amfoss/temple-app architecture

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

- Interactive diagram: https://gitdiagram.com/amfoss/temple-app
- Repository: https://github.com/amfoss/temple-app

## Overview

##### High-Level Components

a. Client-Side (Android App):
- User Interface Layer
- Login/Authentication Module
- Dashboard/Home Module
- Three main functional modules (Poojas, Donations, Expenses)
- Settings Module

b. Architecture Pattern:
- MVVM (Model-View-ViewModel) architecture
- Views (Activities/Fragments)
- ViewModels (for each major feature)
- Models (Data classes)

c. External Services:
- Firebase Authentication
- Firebase Realtime Database
- Printing Service Integration

**UI Layer (Activities/Fragments)**
**↕**
**ViewModel Layer**
**↕**
**Repository/Data Layer**
**↕**
**External Services Layer**

##### Component Relationships

a. Main Modules (Side by Side):
**Pooja Module --- Income/Donation Module --- Expenses Module**

Each module should show:
- Fragment/Activity
- Associated ViewModel
- Data Model
- Adapter (if applicable)

b. Authentication Flow:
**Login Activity → Firebase Auth → Home Activity**

##### Specific Implementation Details

Key architectural elements:
- MVVM pattern implementation
- Firebase integration points
- RecyclerView adapters for list displays
- Printer service connection
- Navigation components

##### Data Flow Representation

- User input flow
- Data persistence flow
- Authentication flow
- Printing request flow

##### Additional Notes

- Role-based access control (General secretary, president, treasurer)
- Data synchronization with Firebase
- Printer integration points
- Module independence and interaction

Remember to:
- Clear boundaries between components
- MVVM architecture pattern
- Major features (poojas, donations, expenses)
- Security implementation points

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef ui fill:#a8d1f0,stroke:#000
    classDef viewmodel fill:#90EE90,stroke:#000
    classDef model fill:#FFE5B4,stroke:#000
    classDef external fill:#FFB6C1,stroke:#000
    classDef utility fill:#DDA0DD,stroke:#000

    %% Legend
    subgraph Legend
        UI[UI Components]:::ui
        VM[ViewModels]:::viewmodel
        M[Models]:::model
        EX[External Services]:::external
        UT[Utilities]:::utility
    end

    %% External Services Layer
    subgraph External
        Firebase[Firebase Services]:::external
        PrintService[Printing Service]:::external
    end

    %% Authentication Module
    subgraph Auth
        LoginActivity[Login Activity]:::ui
        UserModel[User Model]:::model
    end

    %% Home/Dashboard Module
    subgraph Dashboard
        HomeActivity[Home Activity]:::ui
        SectionsPagerAdapter[Sections Pager Adapter]:::ui
    end

    %% Pooja Module
    subgraph Pooja
        PoojaFragment[Pooja Fragment]:::ui
        PoojaViewModel[Pooja ViewModel]:::viewmodel
        PoojaModel[Pooja Model]:::model
    end

    %% Income/Donations Module
    subgraph Income
        IncomeFragment[Income Fragment]:::ui
        IncomeViewModel[Income ViewModel]:::viewmodel
        DonationModel[Donation Model]:::model
    end

    %% Expenses Module
    subgraph Expenses
        ExpensesFragment[Expenses Fragment]:::ui
        ExpenseViewModel[Expense ViewModel]:::viewmodel
        ExpenseModel[Expense Model]:::model
    end

    %% Settings Module
    subgraph Settings
        SettingsActivity[Settings Activity]:::ui
        SettingsViewModel[Settings ViewModel]:::viewmodel
        MemberModel[Member Model]:::model
    end

    %% Utilities
    subgraph Utilities
        ActivityUtils[Activity Utils]:::utility
        Constants[Constants]:::utility
    end

    %% Relationships
    LoginActivity --> Firebase
    Firebase --> HomeActivity
    HomeActivity --> SectionsPagerAdapter
    SectionsPagerAdapter --> PoojaFragment
    SectionsPagerAdapter --> IncomeFragment
    SectionsPagerAdapter --> ExpensesFragment

    PoojaFragment --> PoojaViewModel
    PoojaViewModel --> PoojaModel
    PoojaModel --> Firebase

    IncomeFragment --> IncomeViewModel
    IncomeViewModel --> DonationModel
    DonationModel --> Firebase

    ExpensesFragment --> ExpenseViewModel
    ExpenseViewModel --> ExpenseModel
    ExpenseModel --> Firebase

    SettingsActivity --> SettingsViewModel
    SettingsViewModel --> MemberModel
    MemberModel --> Firebase

    %% Click Events
    click LoginActivity "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/home/LoginActivity.java"
    click UserModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/home/UserModel.java"
    click HomeActivity "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/home/HomeActivity.java"
    click SectionsPagerAdapter "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/home/SectionsPagerAdapter.java"
    click PoojaFragment "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/poojas/PoojaFragment.java"
    click PoojaViewModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/poojas/viewmodel/PoojaViewModel.java"
    click PoojaModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/poojas/adapter/PoojaModel.java"
    click IncomeFragment "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/income/IncomeFragment.java"
    click IncomeViewModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/income/viewmodels/IncomeViewModel.java"
    click DonationModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/income/adapter/DonationModel.java"
    click ExpensesFragment "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/expenses/ExpensesFragment.java"
    click ExpenseViewModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/expenses/viewModel/ExpenseViewModel.java"
    click ExpenseModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/expenses/adapter/ExpenseModel.java"
    click SettingsActivity "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/settings/SettingsActivity.java"
    click SettingsViewModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/settings/SettingsViewModel.java"
    click MemberModel "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/settings/MemberModel.java"
    click ActivityUtils "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/Util/ActivityUtils.java"
    click Constants "https://github.com/amfoss/temple-app/blob/development/app/src/main/java/org/amfoss/templeapp/Util/Constants.java"
```
