# saro0204/quantum-vision architecture

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

- Interactive diagram: https://gitdiagram.com/saro0204/quantum-vision
- Repository: https://github.com/saro0204/quantum-vision

## Overview

Quantum Vision is an agricultural monitoring application whose main workflow lets a farmer submit a leaf image, receive disease and severity predictions, and review a saved scan with treatment guidance. The React client reaches an Express API, which forwards scan images to a Flask inference service and stores scan results in MongoDB. Other product branches cover pest identification, weather and crop forecasts, fertilizer advice, voice assistance, analytics, and administration. The README documents the overall service flow; sampled files confirm scan persistence and voice integrations. Several unsampled feature implementations are represented at their existing directory paths.

Main entry points: [`backend/controllers`](https://github.com/saro0204/quantum-vision/tree/main/backend/controllers) (Feature handlers), [`backend/routes`](https://github.com/saro0204/quantum-vision/tree/main/backend/routes) (API routes), [`backend/controllers/scanController.js`](https://github.com/saro0204/quantum-vision/blob/main/backend/controllers/scanController.js) (Scan handling), [`frontend/src/App.jsx`](https://github.com/saro0204/quantum-vision/blob/main/frontend/src/App.jsx) (React application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Farmer application"]
  node_web["React application<br/>[App.jsx]"]
  node_scanui["Camera scanning<br/>[CameraScan.jsx]"]
  node_featuresui["Farm features"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_backend["API and records"]
  node_server["Express API<br/>[server.js]"]
  node_routes["API routes"]
  node_auth["Authentication<br/>[auth.js]"]
  node_scancontroller["Scan handling<br/>[scanController.js]"]
  node_othercontrollers["Feature handlers"]
  node_records[("MongoDB records")]
end

subgraph group_ai["Agricultural intelligence"]
  node_aiapp["Flask inference API<br/>[app.py]"]
  node_prediction["Image prediction<br/>[predict.py]"]
  node_pest["Pest detection<br/>[pest_detector.py]"]
  node_treatment["Treatment advice"]
  node_cropservices["Crop services"]
end

subgraph group_quantum["Quantum modeling"]
  node_qvpackage["Quantum modules"]
  node_qengine["Quantum engine<br/>[engine.py]"]
  node_qembed["Feature encoding<br/>[embeddings.py]"]
end

node_farmer(("Farmer"))
node_gemini["Gemini service"]
node_murf["Murf speech service"]

node_farmer -->|"uses"| node_web
node_web -->|"routes to"| node_scanui
node_web -->|"routes to"| node_featuresui
node_scanui -->|"submits scans"| node_api
node_api -->|"calls API"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"protects routes"| node_auth
node_routes -->|"dispatches"| node_scancontroller
node_routes -->|"dispatches"| node_othercontrollers
node_scancontroller -->|"forwards image"| node_aiapp
node_aiapp -->|"invokes"| node_prediction
node_aiapp -->|"uses"| node_pest
node_scancontroller -->|"stores scan"| node_records
node_scancontroller -->|"creates alerts"| node_records
node_prediction -->|"uses quantum layer"| node_qvpackage
node_qengine -->|"pads features"| node_qembed
node_treatment -.->|"optimizes treatment"| node_qvpackage
node_othercontrollers -.->|"feature services"| node_cropservices
node_othercontrollers -.->|"uses records"| node_records
node_othercontrollers -->|"requests chat"| node_gemini
node_othercontrollers -->|"requests speech"| node_murf

click node_web "https://github.com/saro0204/quantum-vision/blob/main/frontend/src/App.jsx"
click node_scanui "https://github.com/saro0204/quantum-vision/blob/main/frontend/src/pages/CameraScan.jsx"
click node_featuresui "https://github.com/saro0204/quantum-vision/tree/main/frontend/src/pages"
click node_api "https://github.com/saro0204/quantum-vision/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/saro0204/quantum-vision/blob/main/backend/server.js"
click node_routes "https://github.com/saro0204/quantum-vision/tree/main/backend/routes"
click node_auth "https://github.com/saro0204/quantum-vision/blob/main/backend/middleware/auth.js"
click node_scancontroller "https://github.com/saro0204/quantum-vision/blob/main/backend/controllers/scanController.js"
click node_othercontrollers "https://github.com/saro0204/quantum-vision/tree/main/backend/controllers"
click node_records "https://github.com/saro0204/quantum-vision/tree/main/backend/models"
click node_aiapp "https://github.com/saro0204/quantum-vision/blob/main/ai/app.py"
click node_prediction "https://github.com/saro0204/quantum-vision/blob/main/ai/predict.py"
click node_pest "https://github.com/saro0204/quantum-vision/blob/main/ai/pest_detector.py"
click node_treatment "https://github.com/saro0204/quantum-vision/blob/main/ai/treatment_engine.py"
click node_cropservices "https://github.com/saro0204/quantum-vision/tree/main/ai"
click node_qvpackage "https://github.com/saro0204/quantum-vision/tree/main/pennylane_qv/pennylane_qv"
click node_qengine "https://github.com/saro0204/quantum-vision/blob/main/pennylane_qv/pennylane_qv/engine.py"
click node_qembed "https://github.com/saro0204/quantum-vision/blob/main/pennylane_qv/pennylane_qv/embeddings.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_web,node_scanui,node_featuresui,node_api toneBlue
class node_server,node_routes,node_auth,node_scancontroller,node_othercontrollers,node_records toneAmber
class node_aiapp,node_prediction,node_pest,node_treatment,node_cropservices toneMint
class node_qvpackage,node_qengine,node_qembed toneRose
class node_farmer,node_gemini,node_murf toneIndigo
```

## Components

### Farmer application

- [React application](https://github.com/saro0204/quantum-vision/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Camera scanning](https://github.com/saro0204/quantum-vision/blob/main/frontend/src/pages/CameraScan.jsx): `frontend/src/pages/CameraScan.jsx`
- [Farm features](https://github.com/saro0204/quantum-vision/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/saro0204/quantum-vision/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and records

- [Express API](https://github.com/saro0204/quantum-vision/blob/main/backend/server.js): `backend/server.js`
- [API routes](https://github.com/saro0204/quantum-vision/tree/main/backend/routes): `backend/routes`
- [Authentication](https://github.com/saro0204/quantum-vision/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Scan handling](https://github.com/saro0204/quantum-vision/blob/main/backend/controllers/scanController.js): `backend/controllers/scanController.js`
- [Feature handlers](https://github.com/saro0204/quantum-vision/tree/main/backend/controllers): `backend/controllers`
- [MongoDB records](https://github.com/saro0204/quantum-vision/tree/main/backend/models): `backend/models`

### Agricultural intelligence

- [Flask inference API](https://github.com/saro0204/quantum-vision/blob/main/ai/app.py): `ai/app.py`
- [Image prediction](https://github.com/saro0204/quantum-vision/blob/main/ai/predict.py): `ai/predict.py`
- [Pest detection](https://github.com/saro0204/quantum-vision/blob/main/ai/pest_detector.py): `ai/pest_detector.py`
- [Treatment advice](https://github.com/saro0204/quantum-vision/blob/main/ai/treatment_engine.py): `ai/treatment_engine.py`
- [Crop services](https://github.com/saro0204/quantum-vision/tree/main/ai): `ai`

### Quantum modeling

- [Quantum modules](https://github.com/saro0204/quantum-vision/tree/main/pennylane_qv/pennylane_qv): `pennylane_qv/pennylane_qv`
- [Quantum engine](https://github.com/saro0204/quantum-vision/blob/main/pennylane_qv/pennylane_qv/engine.py): `pennylane_qv/pennylane_qv/engine.py`
- [Feature encoding](https://github.com/saro0204/quantum-vision/blob/main/pennylane_qv/pennylane_qv/embeddings.py): `pennylane_qv/pennylane_qv/embeddings.py`

### Other components

- **Farmer**
- **Gemini service**
- **Murf speech service**

## Connections

- Farmer → React application: uses
- React application → Camera scanning: routes to (evidence: `frontend/src/App.jsx`)
- React application → Farm features: routes to (evidence: `frontend/src/App.jsx`)
- Camera scanning → API client: submits scans (evidence: `frontend/src/pages/CameraScan.jsx`)
- API client → Express API: calls API
- Express API → API routes: mounts (evidence: `backend/server.js`)
- API routes → Authentication: protects routes (evidence: `backend/routes/scanRoutes.js`)
- API routes → Scan handling: dispatches (evidence: `backend/routes/scanRoutes.js`)
- API routes → Feature handlers: dispatches (evidence: `backend/routes/pestRoutes.js`)
- Scan handling → Flask inference API: forwards image (evidence: `backend/controllers/scanController.js`)
- Flask inference API → Image prediction: invokes (evidence: `ai/app.py`)
- Flask inference API → Pest detection: uses (evidence: `ai/app.py`)
- Scan handling → MongoDB records: stores scan (evidence: `backend/controllers/scanController.js`)
- Scan handling → MongoDB records: creates alerts (evidence: `backend/controllers/scanController.js`)
- Image prediction → Quantum modules: uses quantum layer (evidence: `ai/predict.py`)
- Quantum engine → Feature encoding: pads features (evidence: `pennylane_qv/pennylane_qv/engine.py`)
- Treatment advice → Quantum modules: optimizes treatment (evidence: `ai/treatment_engine.py`)
- Feature handlers → Crop services: feature services
- Feature handlers → MongoDB records: uses records (evidence: `backend/controllers/scanController.js`)
- Feature handlers → Gemini service: requests chat (evidence: `backend/controllers/voiceController.js`)
- Feature handlers → Murf speech service: requests speech (evidence: `backend/controllers/voiceController.js`)
