# bhuvanchebrolu/foodloop_backend architecture

> Architecture diagram of the GitHub repository bhuvanchebrolu/foodloop_backend, 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/bhuvanchebrolu/foodloop_backend
- Repository: https://github.com/bhuvanchebrolu/foodloop_backend

## Overview

FoodLoop is a Django REST backend for household food inventory, community sharing, expiry alerts, and related administration and analytics. The principal workflow is residents managing food and sharing it; expiry processing can then create notifications and attempt push delivery. The tree and source index establish the product areas, but the README is empty and several views were not excerpted, so their detailed routing and cross-app behavior are not inferred. Edges are limited to relationships visible in excerpts or source-index references.

Main entry points: [`apps/notifications/services.py`](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/services.py) (Expiry Engine), [`apps/users/views_admin.py`](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/views_admin.py) (User Administration), [`apps/foods/models.py`](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/foods/models.py) (Food & Consumption), [`apps/shares/views.py`](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/shares/views.py) (Sharing API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Residents &amp; Apartments"]
  node_user_api["User API<br/>[views.py]"]
  node_user_admin["User Administration<br/>[views_admin.py]"]
  node_users[("Users &amp; Settings<br/>[models.py]")]
  node_apartment_api["Apartment API<br/>[views.py]"]
  node_apartments[("Apartments<br/>[models.py]")]
end

subgraph group_food["Food &amp; Sharing"]
  node_food_api["Food Inventory API<br/>[views.py]"]
  node_food_data[("Food &amp; Consumption<br/>[models.py]")]
  node_share_api["Sharing API<br/>[views.py]"]
  node_share_data[("Shares &amp; Requests<br/>[models.py]")]
end

subgraph group_insights["Insights &amp; Moderation"]
  node_analytics["Analytics<br/>[views.py]"]
  node_reports_api["Reports &amp; Review<br/>[views.py]"]
  node_reports[("Report Records<br/>[models.py]")]
end

subgraph group_platform["Notifications &amp; Activity"]
  node_expiry_engine["Expiry Engine<br/>[services.py]"]
  node_expiry_task["Expiry Task<br/>[tasks.py]"]
  node_notification_data[("Notifications &amp; Tokens<br/>[models.py]")]
  node_push_delivery["Firebase Push<br/>[firebase.py]"]
  node_activity_helper["Activity Logging<br/>[utils.py]"]
  node_activity_data[("Activity Records<br/>[models.py]")]
end

node_resident(("Resident / Admin"))

node_resident -.->|"uses"| node_user_api
node_resident -.->|"manages food"| node_food_api
node_resident -.->|"shares food"| node_share_api
node_resident -.->|"submits reports"| node_reports_api
node_apartment_api -->|"reads/writes"| node_apartments
node_user_api -->|"uses"| node_users
node_user_admin -->|"manages"| node_users
node_user_admin -->|"uses"| node_apartments
node_user_admin -->|"uses"| node_share_data
node_user_admin -->|"uses"| node_food_data
node_user_admin -->|"uses"| node_reports
node_food_api -->|"uses"| node_food_data
node_share_api -->|"uses"| node_share_data
node_share_api -->|"uses"| node_food_data
node_analytics -->|"reads"| node_food_data
node_analytics -->|"reads"| node_share_data
node_reports_api -->|"uses"| node_reports
node_reports_api -->|"creates"| node_notification_data
node_expiry_task -->|"runs"| node_expiry_engine
node_expiry_engine -->|"scans/updates"| node_food_data
node_expiry_engine -->|"checks settings"| node_users
node_expiry_engine -->|"creates"| node_notification_data
node_expiry_engine -->|"logs activity"| node_activity_helper
node_expiry_engine -->|"sends push"| node_push_delivery
node_notification_data -->|"triggers push"| node_push_delivery
node_activity_helper -->|"writes"| node_activity_data

click node_user_api "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/views.py"
click node_user_admin "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/views_admin.py"
click node_users "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/models.py"
click node_apartment_api "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/apartments/views.py"
click node_apartments "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/apartments/models.py"
click node_food_api "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/foods/views.py"
click node_food_data "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/foods/models.py"
click node_share_api "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/shares/views.py"
click node_share_data "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/shares/models.py"
click node_analytics "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/analytics/views.py"
click node_reports_api "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/reports/views.py"
click node_reports "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/reports/models.py"
click node_expiry_engine "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/services.py"
click node_expiry_task "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/tasks.py"
click node_notification_data "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/models.py"
click node_push_delivery "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/firebase.py"
click node_activity_helper "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/common/utils.py"
click node_activity_data "https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/common/models.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_user_api,node_user_admin,node_users,node_apartment_api,node_apartments toneBlue
class node_food_api,node_food_data,node_share_api,node_share_data toneAmber
class node_analytics,node_reports_api,node_reports toneMint
class node_expiry_engine,node_expiry_task,node_notification_data,node_push_delivery,node_activity_helper,node_activity_data toneRose
class node_resident toneIndigo
```

## Components

### Residents & Apartments

- [User API](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/views.py): `apps/users/views.py`
- [User Administration](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/views_admin.py): `apps/users/views_admin.py`
- [Users & Settings](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/users/models.py): `apps/users/models.py`
- [Apartment API](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/apartments/views.py): `apps/apartments/views.py`
- [Apartments](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/apartments/models.py): `apps/apartments/models.py`

### Food & Sharing

- [Food Inventory API](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/foods/views.py): `apps/foods/views.py`
- [Food & Consumption](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/foods/models.py): `apps/foods/models.py`
- [Sharing API](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/shares/views.py): `apps/shares/views.py`
- [Shares & Requests](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/shares/models.py): `apps/shares/models.py`

### Insights & Moderation

- [Analytics](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/analytics/views.py): `apps/analytics/views.py`
- [Reports & Review](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/reports/views.py): `apps/reports/views.py`
- [Report Records](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/reports/models.py): `apps/reports/models.py`

### Notifications & Activity

- [Expiry Engine](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/services.py): `apps/notifications/services.py`
- [Expiry Task](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/tasks.py): `apps/notifications/tasks.py`
- [Notifications & Tokens](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/models.py): `apps/notifications/models.py`
- [Firebase Push](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/notifications/firebase.py): `apps/notifications/firebase.py`
- [Activity Logging](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/common/utils.py): `apps/common/utils.py`
- [Activity Records](https://github.com/bhuvanchebrolu/foodloop_backend/blob/main/apps/common/models.py): `apps/common/models.py`

### Other components

- **Resident / Admin**

## Connections

- Resident / Admin → User API: uses
- Resident / Admin → Food Inventory API: manages food
- Resident / Admin → Sharing API: shares food
- Resident / Admin → Reports & Review: submits reports
- Apartment API → Apartments: reads/writes (evidence: `apps/apartments/views.py`)
- User API → Users & Settings: uses
- User Administration → Users & Settings: manages (evidence: `apps/users/views_admin.py`)
- User Administration → Apartments: uses (evidence: `apps/users/views_admin.py`)
- User Administration → Shares & Requests: uses (evidence: `apps/users/views_admin.py`)
- User Administration → Food & Consumption: uses (evidence: `apps/users/views_admin.py`)
- User Administration → Report Records: uses (evidence: `apps/users/views_admin.py`)
- Food Inventory API → Food & Consumption: uses (evidence: `apps/foods/views.py`)
- Sharing API → Shares & Requests: uses (evidence: `apps/shares/views.py`)
- Sharing API → Food & Consumption: uses (evidence: `apps/shares/views.py`)
- Analytics → Food & Consumption: reads (evidence: `apps/analytics/views.py`)
- Analytics → Shares & Requests: reads (evidence: `apps/analytics/views.py`)
- Reports & Review → Report Records: uses (evidence: `apps/reports/views.py`)
- Reports & Review → Notifications & Tokens: creates (evidence: `apps/reports/views.py`)
- Expiry Task → Expiry Engine: runs (evidence: `apps/notifications/tasks.py`)
- Expiry Engine → Food & Consumption: scans/updates (evidence: `apps/notifications/services.py`)
- Expiry Engine → Users & Settings: checks settings (evidence: `apps/notifications/services.py`)
- Expiry Engine → Notifications & Tokens: creates (evidence: `apps/notifications/services.py`)
- Expiry Engine → Activity Logging: logs activity (evidence: `apps/notifications/services.py`)
- Expiry Engine → Firebase Push: sends push (evidence: `apps/notifications/services.py`)
- Notifications & Tokens → Firebase Push: triggers push (evidence: `apps/notifications/models.py`)
- Activity Logging → Activity Records: writes (evidence: `apps/common/utils.py`)
