# himanagendra/zomakase architecture

> Architecture diagram of the GitHub repository himanagendra/zomakase, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/himanagendra/zomakase
- Repository: https://github.com/himanagendra/zomakase

## Overview

ZomaKase monitors Zomato Food Rescue offers in the background and alerts users, with account/address management, schedules, dashboard history, and community chat. The main flow is sign-in and account setup, then continuous monitoring: RescueMonitorService refreshes account telemetry, subscribes to deal events, records events, and triggers alerts. Firebase supports authentication, profiles, chat and shared data; local encrypted preferences and logs retain app state. Major UI and service branches are shown from README and the source index; unsampled relationships are omitted where their callers are not evidenced.

Main entry points: [`app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt) (Rescue monitor), [`app/src/main/java/com/zomakase/app/ui/MainActivity.kt`](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/MainActivity.kt) (App navigation), [`app/src/main/java/com/zomakase/app/data/network/FirebaseClient.kt`](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/FirebaseClient.kt) (Firebase services), [`app/src/main/java/com/zomakase/app/data/local/SecurePreferences.kt`](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/SecurePreferences.kt) (Secure preferences)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and setup"]
  node_login["Sign-in<br/>[LoginActivity.kt]"]
  node_accounts["Accounts and addresses"]
end

subgraph group_monitor["Rescue monitoring"]
  node_zomato["Zomato API client<br/>[ZomatoClient.kt]"]
  node_monitorservice["Rescue monitor"]
  node_mqtt["Zomato telemetry"]
  node_alerts["Alert manager<br/>[AlertManager.kt]"]
  node_schedule["Monitoring schedule<br/>[ScheduleManager.kt]"]
  node_zomato_service["Zomato service API<br/>[ZomatoService.kt]"]
end

subgraph group_state["App state and platform"]
  node_secureprefs[("Secure preferences")]
  node_events[("Rescue events and logs<br/>[EventLog.kt]")]
  node_autokill["Background allowance<br/>[AutoKillManager.kt]"]
  node_systemstatus["System status"]
end

subgraph group_experience["User experience"]
  node_home["Dashboard and stats<br/>[HomeFragment.kt]"]
  node_main["App navigation<br/>[MainActivity.kt]"]
  node_profile["Profile and accounts<br/>[ProfileActivity.kt]"]
  node_settings["Settings"]
  node_logsui["Alert history<br/>[LogsFragment.kt]"]
  node_admin["Administration<br/>[AdminActivity.kt]"]
end

subgraph group_community["Community and Firebase"]
  node_firebase["Firebase services<br/>[FirebaseClient.kt]"]
  node_chatui["Community chat<br/>[ChatFragment.kt]"]
  node_chatservice["Chat messaging"]
  node_chatdb[("Local chat database<br/>[ChatDatabase.kt]")]
end

node_user(("App user"))

node_user -->|"signs in"| node_login
node_login -->|"authenticates"| node_firebase
node_login -->|"caches access"| node_secureprefs
node_main -->|"routes unauthenticated"| node_login
node_user -.->|"uses app"| node_main
node_accounts -->|"reads and updates"| node_secureprefs
node_accounts -->|"fetches addresses"| node_zomato
node_accounts -->|"syncs profile"| node_firebase
node_monitorservice -->|"loads accounts"| node_secureprefs
node_monitorservice -->|"refreshes credentials"| node_zomato
node_monitorservice -->|"connects and subscribes"| node_mqtt
node_mqtt -.->|"delivers deal events"| node_monitorservice
node_monitorservice -->|"records activity"| node_events
node_monitorservice -->|"triggers notifications"| node_alerts
node_monitorservice -->|"checks schedule"| node_schedule
node_monitorservice -->|"checks policy"| node_autokill
node_home -->|"starts monitoring"| node_monitorservice
node_home -->|"manages schedule"| node_schedule
node_home -->|"checks background"| node_autokill
node_home -.->|"loads stats"| node_firebase
node_main -->|"hosts dashboard"| node_home
node_main -->|"hosts accounts"| node_accounts
node_main -->|"opens settings"| node_settings
node_main -->|"opens history"| node_logsui
node_main -.->|"opens chat"| node_chatui
node_profile -->|"reads profile"| node_firebase
node_profile -->|"reads settings"| node_secureprefs
node_profile -->|"reads history"| node_events
node_settings -->|"starts or stops"| node_monitorservice
node_settings -->|"clears preferences"| node_secureprefs
node_settings -->|"clears chat cache"| node_chatdb
node_logsui -->|"reads history"| node_events
node_chatui -->|"loads and sends messages"| node_firebase
node_chatui -.->|"uses local cache"| node_chatdb
node_chatservice -->|"stores messages"| node_chatdb
node_chatservice -->|"notifies users"| node_alerts
node_systemstatus -->|"reads settings"| node_secureprefs
node_systemstatus -.->|"reports status"| node_firebase
node_admin -->|"manages users"| node_firebase
node_zomato -.->|"uses API endpoints"| node_zomato_service
node_user -.->|"configures accounts"| node_accounts
node_user -.->|"participates"| node_chatui

click node_login "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/LoginActivity.kt"
click node_firebase "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/FirebaseClient.kt"
click node_accounts "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/accounts/AccountsFragment.kt"
click node_secureprefs "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/SecurePreferences.kt"
click node_zomato "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/ZomatoClient.kt"
click node_monitorservice "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt"
click node_events "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/EventLog.kt"
click node_alerts "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/AlertManager.kt"
click node_schedule "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/ScheduleManager.kt"
click node_autokill "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/AutoKillManager.kt"
click node_home "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/home/HomeFragment.kt"
click node_main "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/MainActivity.kt"
click node_profile "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/ProfileActivity.kt"
click node_settings "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/settings/SettingsActivity.kt"
click node_logsui "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/logs/LogsFragment.kt"
click node_chatui "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/chat/ChatFragment.kt"
click node_chatservice "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/ChatMessagingService.kt"
click node_chatdb "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/ChatDatabase.kt"
click node_systemstatus "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/SystemStatusManager.kt"
click node_admin "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/admin/AdminActivity.kt"
click node_zomato_service "https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/ZomatoService.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_accounts,node_user toneBlue
class node_zomato,node_monitorservice,node_mqtt,node_alerts,node_schedule,node_zomato_service toneAmber
class node_secureprefs,node_events,node_autokill,node_systemstatus toneMint
class node_home,node_main,node_profile,node_settings,node_logsui,node_admin toneRose
class node_firebase,node_chatui,node_chatservice,node_chatdb toneIndigo
```

## Components

### Identity and setup

- [Sign-in](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/LoginActivity.kt): `app/src/main/java/com/zomakase/app/ui/LoginActivity.kt`
- [Accounts and addresses](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/accounts/AccountsFragment.kt): `app/src/main/java/com/zomakase/app/ui/accounts/AccountsFragment.kt`

### Rescue monitoring

- [Zomato API client](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/ZomatoClient.kt): `app/src/main/java/com/zomakase/app/data/network/ZomatoClient.kt`
- [Rescue monitor](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt): `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`
- **Zomato telemetry**
- [Alert manager](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/AlertManager.kt): `app/src/main/java/com/zomakase/app/service/AlertManager.kt`
- [Monitoring schedule](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/ScheduleManager.kt): `app/src/main/java/com/zomakase/app/service/ScheduleManager.kt`
- [Zomato service API](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/ZomatoService.kt): `app/src/main/java/com/zomakase/app/data/network/ZomatoService.kt`

### App state and platform

- [Secure preferences](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/SecurePreferences.kt): `app/src/main/java/com/zomakase/app/data/local/SecurePreferences.kt`
- [Rescue events and logs](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/EventLog.kt): `app/src/main/java/com/zomakase/app/data/local/EventLog.kt`
- [Background allowance](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/AutoKillManager.kt): `app/src/main/java/com/zomakase/app/service/AutoKillManager.kt`
- [System status](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/SystemStatusManager.kt): `app/src/main/java/com/zomakase/app/data/network/SystemStatusManager.kt`

### User experience

- [Dashboard and stats](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/home/HomeFragment.kt): `app/src/main/java/com/zomakase/app/ui/home/HomeFragment.kt`
- [App navigation](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/MainActivity.kt): `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`
- [Profile and accounts](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/ProfileActivity.kt): `app/src/main/java/com/zomakase/app/ui/ProfileActivity.kt`
- [Settings](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/settings/SettingsActivity.kt): `app/src/main/java/com/zomakase/app/ui/settings/SettingsActivity.kt`
- [Alert history](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/logs/LogsFragment.kt): `app/src/main/java/com/zomakase/app/ui/logs/LogsFragment.kt`
- [Administration](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/admin/AdminActivity.kt): `app/src/main/java/com/zomakase/app/ui/admin/AdminActivity.kt`

### Community and Firebase

- [Firebase services](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/network/FirebaseClient.kt): `app/src/main/java/com/zomakase/app/data/network/FirebaseClient.kt`
- [Community chat](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/ui/chat/ChatFragment.kt): `app/src/main/java/com/zomakase/app/ui/chat/ChatFragment.kt`
- [Chat messaging](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/service/ChatMessagingService.kt): `app/src/main/java/com/zomakase/app/service/ChatMessagingService.kt`
- [Local chat database](https://github.com/himanagendra/zomakase/blob/main/app/src/main/java/com/zomakase/app/data/local/ChatDatabase.kt): `app/src/main/java/com/zomakase/app/data/local/ChatDatabase.kt`

### Other components

- **App user**

## Connections

- App user → Sign-in: signs in (evidence: `app/src/main/java/com/zomakase/app/ui/LoginActivity.kt`)
- Sign-in → Firebase services: authenticates (evidence: `app/src/main/java/com/zomakase/app/ui/LoginActivity.kt`)
- Sign-in → Secure preferences: caches access (evidence: `app/src/main/java/com/zomakase/app/ui/LoginActivity.kt`)
- App navigation → Sign-in: routes unauthenticated (evidence: `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`)
- App user → App navigation: uses app
- Accounts and addresses → Secure preferences: reads and updates (evidence: `app/src/main/java/com/zomakase/app/ui/accounts/AccountsFragment.kt`)
- Accounts and addresses → Zomato API client: fetches addresses (evidence: `app/src/main/java/com/zomakase/app/ui/accounts/AccountsFragment.kt`)
- Accounts and addresses → Firebase services: syncs profile (evidence: `app/src/main/java/com/zomakase/app/ui/accounts/AccountsFragment.kt`)
- Rescue monitor → Secure preferences: loads accounts (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Rescue monitor → Zomato API client: refreshes credentials (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Rescue monitor → Zomato telemetry: connects and subscribes (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Zomato telemetry → Rescue monitor: delivers deal events
- Rescue monitor → Rescue events and logs: records activity (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Rescue monitor → Alert manager: triggers notifications (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Rescue monitor → Monitoring schedule: checks schedule (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Rescue monitor → Background allowance: checks policy (evidence: `app/src/main/java/com/zomakase/app/service/RescueMonitorService.kt`)
- Dashboard and stats → Rescue monitor: starts monitoring (evidence: `app/src/main/java/com/zomakase/app/ui/home/HomeFragment.kt`)
- Dashboard and stats → Monitoring schedule: manages schedule (evidence: `app/src/main/java/com/zomakase/app/ui/home/HomeFragment.kt`)
- Dashboard and stats → Background allowance: checks background (evidence: `app/src/main/java/com/zomakase/app/ui/home/HomeFragment.kt`)
- Dashboard and stats → Firebase services: loads stats
- App navigation → Dashboard and stats: hosts dashboard (evidence: `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`)
- App navigation → Accounts and addresses: hosts accounts (evidence: `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`)
- App navigation → Settings: opens settings (evidence: `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`)
- App navigation → Alert history: opens history (evidence: `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`)
- App navigation → Community chat: opens chat (evidence: `app/src/main/java/com/zomakase/app/ui/MainActivity.kt`)
- Profile and accounts → Firebase services: reads profile (evidence: `app/src/main/java/com/zomakase/app/ui/ProfileActivity.kt`)
- Profile and accounts → Secure preferences: reads settings (evidence: `app/src/main/java/com/zomakase/app/ui/ProfileActivity.kt`)
- Profile and accounts → Rescue events and logs: reads history (evidence: `app/src/main/java/com/zomakase/app/ui/ProfileActivity.kt`)
- Settings → Rescue monitor: starts or stops (evidence: `app/src/main/java/com/zomakase/app/ui/settings/SettingsActivity.kt`)
- Settings → Secure preferences: clears preferences (evidence: `app/src/main/java/com/zomakase/app/ui/settings/SettingsActivity.kt`)
- Settings → Local chat database: clears chat cache (evidence: `app/src/main/java/com/zomakase/app/ui/settings/SettingsActivity.kt`)
- Alert history → Rescue events and logs: reads history (evidence: `app/src/main/java/com/zomakase/app/ui/logs/LogsFragment.kt`)
- Community chat → Firebase services: loads and sends messages (evidence: `app/src/main/java/com/zomakase/app/ui/chat/ChatFragment.kt`)
- Community chat → Local chat database: uses local cache
- Chat messaging → Local chat database: stores messages (evidence: `app/src/main/java/com/zomakase/app/service/ChatMessagingService.kt`)
- Chat messaging → Alert manager: notifies users (evidence: `app/src/main/java/com/zomakase/app/service/ChatMessagingService.kt`)
- System status → Secure preferences: reads settings (evidence: `app/src/main/java/com/zomakase/app/data/network/SystemStatusManager.kt`)
- System status → Firebase services: reports status (evidence: `app/src/main/java/com/zomakase/app/data/network/SystemStatusManager.kt`)
- Administration → Firebase services: manages users (evidence: `app/src/main/java/com/zomakase/app/ui/admin/AdminActivity.kt`)
- Zomato API client → Zomato service API: uses API endpoints (evidence: `app/src/main/java/com/zomakase/app/data/network/ZomatoClient.kt`)
- App user → Accounts and addresses: configures accounts
- App user → Community chat: participates
