# heerce27/ecoloop architecture

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

- Interactive diagram: https://gitdiagram.com/heerce27/ecoloop
- Repository: https://github.com/heerce27/ecoloop

## Overview

EcoLoop is a local-first Android app for tracking personal environmental impact and encouraging sustainable actions. The documented user journey runs from splash and login/registration to a dashboard, then into activity tracking, recommendations, circular actions, purchasing guidance, recycling search, and challenges. Activity tracking includes carbon and point calculations, history, and optional image proof. The README documents local SQLite and preference storage plus Maps intents. Java sources were not sampled, so feature-to-class mappings and internal calls cannot be verified; feature nodes use the existing source directory, and edges reflect documented flows only.

Main entry points: [`app/src/main/java/com/example/ecoloop`](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_splash["Splash screen"]
  node_home["Home and login"]
  node_auth["Account access"]
  node_dashboard["Dashboard"]
end

subgraph group_tracking["Impact tracking"]
  node_activity["Activity input"]
  node_carbon["Carbon calculation"]
  node_history["Activity history"]
  node_proof["Activity proof"]
  node_points["Eco points"]
end

subgraph group_guidance["Sustainability guidance"]
  node_advisor["Eco Advisor"]
  node_circular["Circular actions"]
  node_buy["Before You Buy"]
  node_finder["Recycling Finder"]
  node_challenges["Eco Challenges"]
end

subgraph group_persistence["Local persistence"]
  node_sqlite[("SQLite database")]
  node_preferences[("Shared preferences")]
end

node_user(("User"))
node_maps["Google Maps"]

node_user -->|"opens app"| node_splash
node_splash -->|"continues to"| node_home
node_home -->|"offers access"| node_auth
node_auth -->|"enters"| node_dashboard
node_dashboard -->|"opens"| node_activity
node_activity -->|"calculates"| node_carbon
node_activity -->|"stores record"| node_history
node_activity -->|"may attach"| node_proof
node_activity -->|"calculates"| node_points
node_dashboard -->|"opens"| node_advisor
node_dashboard -->|"opens"| node_circular
node_dashboard -->|"opens"| node_buy
node_dashboard -->|"opens"| node_finder
node_dashboard -->|"opens"| node_challenges
node_auth -->|"authenticates with"| node_sqlite
node_history -->|"stores activities"| node_sqlite
node_auth -->|"persists session"| node_preferences
node_challenges -->|"saves progress"| node_preferences
node_finder -->|"opens locations"| node_maps

click node_splash "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_home "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_auth "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_dashboard "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_activity "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_carbon "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_history "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_proof "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_points "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_advisor "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_circular "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_buy "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_finder "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_challenges "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_sqlite "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"
click node_preferences "https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop"

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_splash,node_home,node_auth,node_dashboard,node_user toneBlue
class node_activity,node_carbon,node_history,node_proof,node_points toneAmber
class node_advisor,node_circular,node_buy,node_finder,node_challenges toneMint
class node_sqlite,node_preferences toneRose
class node_maps toneIndigo
```

## Components

### App entry

- [Splash screen](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Home and login](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Account access](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Dashboard](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`

### Impact tracking

- [Activity input](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Carbon calculation](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Activity history](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Activity proof](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Eco points](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`

### Sustainability guidance

- [Eco Advisor](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Circular actions](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Before You Buy](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Recycling Finder](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Eco Challenges](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`

### Local persistence

- [SQLite database](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`
- [Shared preferences](https://github.com/heerce27/ecoloop/tree/main/app/src/main/java/com/example/ecoloop): `app/src/main/java/com/example/ecoloop`

### Other components

- **User**
- **Google Maps**

## Connections

- User → Splash screen: opens app (evidence: `README.md`)
- Splash screen → Home and login: continues to (evidence: `README.md`)
- Home and login → Account access: offers access (evidence: `README.md`)
- Account access → Dashboard: enters (evidence: `README.md`)
- Dashboard → Activity input: opens (evidence: `README.md`)
- Activity input → Carbon calculation: calculates (evidence: `README.md`)
- Activity input → Activity history: stores record (evidence: `README.md`)
- Activity input → Activity proof: may attach (evidence: `README.md`)
- Activity input → Eco points: calculates (evidence: `README.md`)
- Dashboard → Eco Advisor: opens (evidence: `README.md`)
- Dashboard → Circular actions: opens (evidence: `README.md`)
- Dashboard → Before You Buy: opens (evidence: `README.md`)
- Dashboard → Recycling Finder: opens (evidence: `README.md`)
- Dashboard → Eco Challenges: opens (evidence: `README.md`)
- Account access → SQLite database: authenticates with (evidence: `README.md`)
- Activity history → SQLite database: stores activities (evidence: `README.md`)
- Account access → Shared preferences: persists session (evidence: `README.md`)
- Eco Challenges → Shared preferences: saves progress (evidence: `README.md`)
- Recycling Finder → Google Maps: opens locations (evidence: `README.md`)
