# chandakasaikiran54-source/food-safety architecture

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

- Interactive diagram: https://gitdiagram.com/chandakasaikiran54-source/food-safety
- Repository: https://github.com/chandakasaikiran54-source/food-safety

## Overview

FoodSafe AI provides user and officer workflows for food-image assessment, assessment history and feedback, restaurant inspections, and complaints. The main flow is a user submitting an image through the web app; the backend routes the request to an AI service, persists an assessment, and returns it for display. Tomato and microbial analysis are distinct assessment capabilities, alongside raw-food and general scans. Source excerpts establish key backend-to-AI and persistence calls; several page-to-API and unsampled feature links are therefore omitted or marked unverified.

Main entry points: [`backend/server.js`](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/server.js) (API server), [`frontend/src/App.jsx`](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/App.jsx) (Web routes), [`frontend/src/utils/api.js`](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/utils/api.js) (HTTP client), [`backend/models/Scan.js`](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/models/Scan.js) (MongoDB models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Web routes<br/>[App.jsx]"]
  node_authui["Session context<br/>[AuthContext.jsx]"]
  node_foodui["Food scan pages<br/>[ScanFood.jsx]"]
  node_rawui["Raw food pages<br/>[RawFoodScan.jsx]"]
  node_tomatoui["Tomato pages<br/>[TomatoAnalysis.jsx]"]
  node_microbialui["Microbial pages"]
  node_oversightui["Inspection pages<br/>[InspectionForm.jsx]"]
  node_apiutil["HTTP client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_server["API server<br/>[server.js]"]
end

subgraph group_assessment["Food assessment"]
  node_scanctrl["Food scan handler<br/>[scanController.js]"]
  node_rawctrl["Raw food handler"]
  node_tomatctrl["Tomato handler"]
  node_microctrl["Microbial handler"]
  node_aiservice["Image analysis API<br/>[app.py]"]
  node_tomatoan["Tomato analysis<br/>[tomato.py]"]
  node_microan["Microbial detection"]
end

subgraph group_oversight["Safety oversight"]
  node_restaurant["Restaurant records"]
  node_officerctrl["Officer workflows"]
  node_complaint["Complaint handling"]
end

subgraph group_data["Assessment data"]
  node_mongo[("MongoDB models<br/>[Scan.js]")]
end

node_user(("User"))
node_officer(("Officer"))

node_user -->|"uses"| node_webapp
node_officer -->|"uses"| node_webapp
node_webapp -->|"provides session"| node_authui
node_webapp -->|"routes to"| node_foodui
node_webapp -->|"routes to"| node_rawui
node_webapp -->|"routes to"| node_tomatoui
node_webapp -->|"routes to"| node_microbialui
node_webapp -->|"routes to"| node_oversightui
node_authui -->|"requests"| node_apiutil
node_foodui -.->|"submits scan"| node_apiutil
node_rawui -.->|"submits image"| node_apiutil
node_tomatoui -.->|"submits images"| node_apiutil
node_microbialui -.->|"requests analysis"| node_apiutil
node_oversightui -.->|"requests records"| node_apiutil
node_apiutil -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_scanctrl
node_server -->|"mounts routes"| node_restaurant
node_server -->|"mounts routes"| node_officerctrl
node_server -->|"mounts routes"| node_complaint
node_server -->|"mounts routes"| node_rawctrl
node_server -->|"mounts routes"| node_tomatctrl
node_server -->|"mounts routes"| node_microctrl
node_scanctrl -->|"posts image"| node_aiservice
node_rawctrl -->|"posts image"| node_aiservice
node_tomatctrl -->|"requests analysis"| node_aiservice
node_aiservice -->|"uses analyzer"| node_tomatoan
node_aiservice -->|"uses detector"| node_microan
node_scanctrl -->|"stores scans"| node_mongo
node_rawctrl -.->|"stores assessments"| node_mongo
node_tomatctrl -.->|"stores assessments"| node_mongo
node_microctrl -.->|"stores results"| node_mongo
node_restaurant -.->|"reads records"| node_mongo
node_officerctrl -.->|"uses records"| node_mongo
node_complaint -.->|"stores complaints"| node_mongo

click node_webapp "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/context/AuthContext.jsx"
click node_foodui "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/ScanFood.jsx"
click node_rawui "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/RawFoodScan.jsx"
click node_tomatoui "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/TomatoAnalysis.jsx"
click node_microbialui "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/MicrobialAnalysis.jsx"
click node_oversightui "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/InspectionForm.jsx"
click node_apiutil "https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/utils/api.js"
click node_server "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/server.js"
click node_scanctrl "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/scanController.js"
click node_rawctrl "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/rawFoodController.js"
click node_tomatctrl "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/tomatoController.js"
click node_microctrl "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/microbialController.js"
click node_aiservice "https://github.com/chandakasaikiran54-source/food-safety/blob/main/ai-service/app.py"
click node_tomatoan "https://github.com/chandakasaikiran54-source/food-safety/blob/main/ai-service/food_analyzers/tomato.py"
click node_microan "https://github.com/chandakasaikiran54-source/food-safety/blob/main/ai-service/microbial/microbial_detector.py"
click node_restaurant "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/restaurantController.js"
click node_officerctrl "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/officerController.js"
click node_complaint "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/complaintController.js"
click node_mongo "https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/models/Scan.js"

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_webapp,node_authui,node_foodui,node_rawui,node_tomatoui,node_microbialui,node_oversightui,node_apiutil,node_user toneBlue
class node_server toneAmber
class node_scanctrl,node_rawctrl,node_tomatctrl,node_microctrl,node_aiservice,node_tomatoan,node_microan toneMint
class node_restaurant,node_officerctrl,node_complaint toneRose
class node_mongo,node_officer toneIndigo
```

## Components

### Web application

- [Web routes](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session context](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Food scan pages](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/ScanFood.jsx): `frontend/src/pages/ScanFood.jsx`
- [Raw food pages](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/RawFoodScan.jsx): `frontend/src/pages/RawFoodScan.jsx`
- [Tomato pages](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/TomatoAnalysis.jsx): `frontend/src/pages/TomatoAnalysis.jsx`
- [Microbial pages](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/MicrobialAnalysis.jsx): `frontend/src/pages/MicrobialAnalysis.jsx`
- [Inspection pages](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/pages/InspectionForm.jsx): `frontend/src/pages/InspectionForm.jsx`
- [HTTP client](https://github.com/chandakasaikiran54-source/food-safety/blob/main/frontend/src/utils/api.js): `frontend/src/utils/api.js`

### Backend API

- [API server](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/server.js): `backend/server.js`

### Food assessment

- [Food scan handler](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/scanController.js): `backend/controllers/scanController.js`
- [Raw food handler](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/rawFoodController.js): `backend/controllers/rawFoodController.js`
- [Tomato handler](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/tomatoController.js): `backend/controllers/tomatoController.js`
- [Microbial handler](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/microbialController.js): `backend/controllers/microbialController.js`
- [Image analysis API](https://github.com/chandakasaikiran54-source/food-safety/blob/main/ai-service/app.py): `ai-service/app.py`
- [Tomato analysis](https://github.com/chandakasaikiran54-source/food-safety/blob/main/ai-service/food_analyzers/tomato.py): `ai-service/food_analyzers/tomato.py`
- [Microbial detection](https://github.com/chandakasaikiran54-source/food-safety/blob/main/ai-service/microbial/microbial_detector.py): `ai-service/microbial/microbial_detector.py`

### Safety oversight

- [Restaurant records](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/restaurantController.js): `backend/controllers/restaurantController.js`
- [Officer workflows](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/officerController.js): `backend/controllers/officerController.js`
- [Complaint handling](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/controllers/complaintController.js): `backend/controllers/complaintController.js`

### Assessment data

- [MongoDB models](https://github.com/chandakasaikiran54-source/food-safety/blob/main/backend/models/Scan.js): `backend/models/Scan.js`

### Other components

- **User**
- **Officer**

## Connections

- User → Web routes: uses (evidence: `frontend/src/App.jsx`)
- Officer → Web routes: uses (evidence: `frontend/src/App.jsx`)
- Web routes → Session context: provides session (evidence: `frontend/src/App.jsx`)
- Web routes → Food scan pages: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Raw food pages: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Tomato pages: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Microbial pages: routes to (evidence: `frontend/src/App.jsx`)
- Web routes → Inspection pages: routes to (evidence: `frontend/src/App.jsx`)
- Session context → HTTP client: requests (evidence: `frontend/src/context/AuthContext.jsx`)
- Food scan pages → HTTP client: submits scan
- Raw food pages → HTTP client: submits image
- Tomato pages → HTTP client: submits images
- Microbial pages → HTTP client: requests analysis
- Inspection pages → HTTP client: requests records
- HTTP client → API server: calls API
- API server → Food scan handler: mounts routes (evidence: `backend/server.js`)
- API server → Restaurant records: mounts routes (evidence: `backend/server.js`)
- API server → Officer workflows: mounts routes (evidence: `backend/server.js`)
- API server → Complaint handling: mounts routes (evidence: `backend/server.js`)
- API server → Raw food handler: mounts routes (evidence: `backend/server.js`)
- API server → Tomato handler: mounts routes (evidence: `backend/server.js`)
- API server → Microbial handler: mounts routes (evidence: `backend/server.js`)
- Food scan handler → Image analysis API: posts image (evidence: `backend/controllers/scanController.js`)
- Raw food handler → Image analysis API: posts image (evidence: `backend/controllers/rawFoodController.js`)
- Tomato handler → Image analysis API: requests analysis (evidence: `backend/controllers/tomatoController.js`)
- Image analysis API → Tomato analysis: uses analyzer (evidence: `ai-service/app.py`)
- Image analysis API → Microbial detection: uses detector (evidence: `ai-service/app.py`)
- Food scan handler → MongoDB models: stores scans (evidence: `backend/controllers/scanController.js`)
- Raw food handler → MongoDB models: stores assessments
- Tomato handler → MongoDB models: stores assessments
- Microbial handler → MongoDB models: stores results
- Restaurant records → MongoDB models: reads records
- Officer workflows → MongoDB models: uses records
- Complaint handling → MongoDB models: stores complaints
