# zluck4270/app_mobile architecture

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

- Interactive diagram: https://gitdiagram.com/zluck4270/app_mobile
- Repository: https://github.com/zluck4270/app_mobile

## Overview

ECOLIMP is an offline-first Android app for recording waste collections and synchronizing them with Python services. The operator signs in, records a collection (with documented QR/photo assistance), and the app keeps records locally until synchronization; dashboards and reports expose collection status and history. The sampled repository implementation supports the local-storage and sync path, while the README documents scanner/photo analysis capabilities not visible in sampled Android source. The tree contains two Python backends; their relationship is not established.

Main entry points: [`android_data_layer/data/repository/RecoleccionRepository.java`](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/repository/RecoleccionRepository.java) (Collection repository), [`backend/main.py`](https://github.com/zluck4270/app_mobile/blob/master/backend/main.py) (ECOLIM API), [`app/src/main/java/com/example/android/RecoleccionFragment.java`](https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/RecoleccionFragment.java) (Collection entry), [`app/src/main/java/com/example/android`](https://github.com/zluck4270/app_mobile/tree/master/app/src/main/java/com/example/android) (QR and photo scan)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Android app"]
  node_auth["Login and session<br/>[LoginActivity.java]"]
  node_session["Session storage"]
  node_collection["Collection entry"]
  node_scanner["QR and photo scan"]
  node_dashboard["Dashboard"]
  node_reports["Reports and filters"]
end

subgraph group_local["Offline data"]
  node_repository["Collection repository"]
  node_catalog["Catalog repository"]
  node_dao["Room DAO<br/>[EcolimDao.java]"]
  node_localdb[("Local database")]
  node_entities["Local entities"]
  node_api["Android API client<br/>[ApiClient.java]"]
  node_api_contract["API contract"]
end

subgraph group_services["Python services"]
  node_fastapi["ECOLIM API<br/>[main.py]"]
  node_schemas["Request schemas<br/>[schemas.py]"]
  node_photo_service["Photo analysis<br/>[main.py]"]
end

subgraph group_persistence["Server persistence"]
  node_models["Server models<br/>[models.py]"]
  node_db_access["Database access<br/>[database.py]"]
  node_serverdb[("PostgreSQL store")]
end

node_operator(("Operator"))

node_operator -->|"signs in"| node_auth
node_auth -->|"stores session"| node_session
node_operator -->|"records waste"| node_collection
node_collection -->|"scans QR or photo"| node_scanner
node_scanner -->|"submits photo"| node_photo_service
node_photo_service -->|"returns classification"| node_scanner
node_collection -.->|"saves collection"| node_repository
node_repository -->|"reads and writes"| node_dao
node_catalog -->|"reads catalogs"| node_dao
node_dao -->|"uses"| node_localdb
node_localdb -->|"stores"| node_entities
node_dashboard -.->|"reads status"| node_repository
node_reports -.->|"requests history"| node_repository
node_repository -->|"calls sync"| node_api_contract
node_api_contract -->|"documents endpoints"| node_fastapi
node_fastapi -->|"validates requests"| node_schemas
node_fastapi -->|"queries and inserts"| node_models
node_fastapi -->|"opens sessions"| node_db_access
node_models -->|"uses base"| node_db_access
node_db_access -.->|"connects to"| node_serverdb

click node_auth "https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/ui/login/LoginActivity.java"
click node_session "https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/utils/SessionManager.java"
click node_collection "https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/RecoleccionFragment.java"
click node_scanner "https://github.com/zluck4270/app_mobile/tree/master/app/src/main/java/com/example/android"
click node_dashboard "https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/DashboardFragment.java"
click node_reports "https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/ReportesFragment.java"
click node_repository "https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/repository/RecoleccionRepository.java"
click node_catalog "https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/repository/CatalogoRepository.java"
click node_dao "https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/local/dao/EcolimDao.java"
click node_localdb "https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/local/EcolimDatabase.java"
click node_entities "https://github.com/zluck4270/app_mobile/tree/master/android_data_layer/data/local/entity"
click node_api "https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/api/ApiClient.java"
click node_api_contract "https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/api/EcolimApiService.java"
click node_fastapi "https://github.com/zluck4270/app_mobile/blob/master/backend/main.py"
click node_schemas "https://github.com/zluck4270/app_mobile/blob/master/backend/schemas.py"
click node_models "https://github.com/zluck4270/app_mobile/blob/master/backend/models.py"
click node_db_access "https://github.com/zluck4270/app_mobile/blob/master/backend/database.py"
click node_photo_service "https://github.com/zluck4270/app_mobile/blob/master/backend_ecolim/main.py"

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_auth,node_session,node_collection,node_scanner,node_dashboard,node_reports toneBlue
class node_repository,node_catalog,node_dao,node_localdb,node_entities,node_api,node_api_contract toneAmber
class node_fastapi,node_schemas,node_photo_service toneMint
class node_models,node_db_access,node_serverdb toneRose
class node_operator toneIndigo
```

## Components

### Android app

- [Login and session](https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/ui/login/LoginActivity.java): `app/src/main/java/com/example/android/ui/login/LoginActivity.java`
- [Session storage](https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/utils/SessionManager.java): `app/src/main/java/com/example/android/utils/SessionManager.java`
- [Collection entry](https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/RecoleccionFragment.java): `app/src/main/java/com/example/android/RecoleccionFragment.java`
- [QR and photo scan](https://github.com/zluck4270/app_mobile/tree/master/app/src/main/java/com/example/android): `app/src/main/java/com/example/android`
- [Dashboard](https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/DashboardFragment.java): `app/src/main/java/com/example/android/DashboardFragment.java`
- [Reports and filters](https://github.com/zluck4270/app_mobile/blob/master/app/src/main/java/com/example/android/ReportesFragment.java): `app/src/main/java/com/example/android/ReportesFragment.java`

### Offline data

- [Collection repository](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/repository/RecoleccionRepository.java): `android_data_layer/data/repository/RecoleccionRepository.java`
- [Catalog repository](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/repository/CatalogoRepository.java): `android_data_layer/data/repository/CatalogoRepository.java`
- [Room DAO](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/local/dao/EcolimDao.java): `android_data_layer/data/local/dao/EcolimDao.java`
- [Local database](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/data/local/EcolimDatabase.java): `android_data_layer/data/local/EcolimDatabase.java`
- [Local entities](https://github.com/zluck4270/app_mobile/tree/master/android_data_layer/data/local/entity): `android_data_layer/data/local/entity`
- [Android API client](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/api/ApiClient.java): `android_data_layer/api/ApiClient.java`
- [API contract](https://github.com/zluck4270/app_mobile/blob/master/android_data_layer/api/EcolimApiService.java): `android_data_layer/api/EcolimApiService.java`

### Python services

- [ECOLIM API](https://github.com/zluck4270/app_mobile/blob/master/backend/main.py): `backend/main.py`
- [Request schemas](https://github.com/zluck4270/app_mobile/blob/master/backend/schemas.py): `backend/schemas.py`
- [Photo analysis](https://github.com/zluck4270/app_mobile/blob/master/backend_ecolim/main.py): `backend_ecolim/main.py`

### Server persistence

- [Server models](https://github.com/zluck4270/app_mobile/blob/master/backend/models.py): `backend/models.py`
- [Database access](https://github.com/zluck4270/app_mobile/blob/master/backend/database.py): `backend/database.py`
- **PostgreSQL store**

### Other components

- **Operator**

## Connections

- Operator → Login and session: signs in (evidence: `README.md`)
- Login and session → Session storage: stores session (evidence: `README.md`)
- Operator → Collection entry: records waste (evidence: `README.md`)
- Collection entry → QR and photo scan: scans QR or photo (evidence: `README.md`)
- QR and photo scan → Photo analysis: submits photo (evidence: `README.md`)
- Photo analysis → QR and photo scan: returns classification (evidence: `README.md`)
- Collection entry → Collection repository: saves collection
- Collection repository → Room DAO: reads and writes (evidence: `android_data_layer/data/repository/RecoleccionRepository.java`)
- Catalog repository → Room DAO: reads catalogs (evidence: `android_data_layer/data/repository/CatalogoRepository.java`)
- Room DAO → Local database: uses (evidence: `android_data_layer/data/local/EcolimDatabase.java`)
- Local database → Local entities: stores (evidence: `android_data_layer/data/local/EcolimDatabase.java`)
- Dashboard → Collection repository: reads status
- Reports and filters → Collection repository: requests history
- Collection repository → API contract: calls sync (evidence: `android_data_layer/data/repository/RecoleccionRepository.java`)
- API contract → ECOLIM API: documents endpoints (evidence: `android_data_layer/api/EcolimApiService.java`)
- ECOLIM API → Request schemas: validates requests (evidence: `backend/main.py`)
- ECOLIM API → Server models: queries and inserts (evidence: `backend/main.py`)
- ECOLIM API → Database access: opens sessions (evidence: `backend/main.py`)
- Server models → Database access: uses base (evidence: `backend/models.py`)
- Database access → PostgreSQL store: connects to (evidence: `backend/database.py`)
