# tharun1305/onion-final architecture

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

- Interactive diagram: https://gitdiagram.com/tharun1305/onion-final
- Repository: https://github.com/tharun1305/onion-final

## Overview

This repository combines onion-image AI tooling with an inspection and synchronization backend, plus a Flutter application whose Dart sources are not present in the supplied tree. The documented workflow is image capture, detection and classification, confidence-aware assessment, inspector verification, grading, and recording. The backend excerpts show prediction and record-sync routes, model-service delegation, and storage operations; the README supplies the broader grading and human-review stages. Flutter-to-backend wiring and some AI internals are not shown, so those connections are omitted.

Main entry points: [`onion-main/backend/app/main.py`](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/main.py) (Backend routes), [`onion-ai/api.py`](https://github.com/tharun1305/onion-final/blob/main/onion-ai/api.py) (AI API), [`onion-main/backend/app/services/ai_service.py`](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/ai_service.py) (Model service), [`onion-main/backend/app/services/supabase_service.py`](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/supabase_service.py) (Inspection sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ai_data["AI data and training"]
  node_dataset_tools["Dataset preparation<br/>[group_and_split.py]"]
  node_classifier_training["Classifier training"]
  node_model_inspection["Model explanation<br/>[gradcam.py]"]
end

subgraph group_ai_runtime["AI inference"]
  node_predict_entry["Prediction pipeline<br/>[predict.py]"]
  node_api_inference["AI API<br/>[api.py]"]
  node_auth_service["Authentication<br/>[auth_service.py]"]
end

subgraph group_inspection_backend["Inspection backend"]
  node_backend_api["Backend routes<br/>[main.py]"]
  node_request_schemas["Inspection schemas<br/>[schemas.py]"]
  node_model_service["Model service<br/>[ai_service.py]"]
  node_inspection_store["Inspection sync"]
  node_verification["Inspector verification<br/>[schemas.py]"]
  node_quality_grade["Quality grading<br/>[schemas.py]"]
  node_digital_record["Digital inspection record"]
end

subgraph group_client_runtime["Client runtime"]
  node_image_input["Image input"]
  node_flutter_client["Flutter client"]
end

node_farmer_inspector(("Farmer / inspector"))
node_cloud_db[("Supabase database")]
node_local_auth_db[("Local auth store")]

node_farmer_inspector -->|"provides image"| node_image_input
node_image_input -.->|"submits image"| node_flutter_client
node_flutter_client -.->|"sends requests"| node_backend_api
node_dataset_tools -.->|"prepares data"| node_classifier_training
node_farmer_inspector -->|"uploads image"| node_api_inference
node_api_inference -->|"calls pipeline"| node_predict_entry
node_backend_api -->|"validates payloads"| node_request_schemas
node_backend_api -->|"requests prediction"| node_model_service
node_model_service -->|"loads and calls"| node_predict_entry
node_backend_api -->|"syncs and retrieves"| node_inspection_store
node_inspection_store -->|"reads and writes"| node_cloud_db
node_farmer_inspector -->|"reviews result"| node_verification
node_verification -->|"confirms grade"| node_quality_grade
node_quality_grade -->|"records assessment"| node_digital_record
node_auth_service -->|"stores accounts"| node_local_auth_db

click node_image_input "https://github.com/tharun1305/onion-final/tree/main/onion-main/onion_app"
click node_flutter_client "https://github.com/tharun1305/onion-final/tree/main/onion-main/onion_app"
click node_dataset_tools "https://github.com/tharun1305/onion-final/blob/main/onion-ai/group_and_split.py"
click node_classifier_training "https://github.com/tharun1305/onion-final/blob/main/onion-ai/train_multiclass.py"
click node_model_inspection "https://github.com/tharun1305/onion-final/blob/main/onion-ai/gradcam.py"
click node_predict_entry "https://github.com/tharun1305/onion-final/blob/main/onion-ai/predict.py"
click node_api_inference "https://github.com/tharun1305/onion-final/blob/main/onion-ai/api.py"
click node_backend_api "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/main.py"
click node_request_schemas "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/schemas.py"
click node_model_service "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/ai_service.py"
click node_inspection_store "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/supabase_service.py"
click node_auth_service "https://github.com/tharun1305/onion-final/blob/main/onion-ai/auth_service.py"
click node_verification "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/schemas.py"
click node_quality_grade "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/schemas.py"
click node_digital_record "https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/supabase_service.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_dataset_tools,node_classifier_training,node_model_inspection toneBlue
class node_predict_entry,node_api_inference,node_auth_service,node_cloud_db,node_local_auth_db toneAmber
class node_backend_api,node_request_schemas,node_model_service,node_inspection_store,node_verification,node_quality_grade,node_digital_record toneMint
class node_image_input,node_flutter_client toneRose
class node_farmer_inspector toneIndigo
```

## Components

### AI data and training

- [Dataset preparation](https://github.com/tharun1305/onion-final/blob/main/onion-ai/group_and_split.py): `onion-ai/group_and_split.py`
- [Classifier training](https://github.com/tharun1305/onion-final/blob/main/onion-ai/train_multiclass.py): `onion-ai/train_multiclass.py`
- [Model explanation](https://github.com/tharun1305/onion-final/blob/main/onion-ai/gradcam.py): `onion-ai/gradcam.py`

### AI inference

- [Prediction pipeline](https://github.com/tharun1305/onion-final/blob/main/onion-ai/predict.py): `onion-ai/predict.py`
- [AI API](https://github.com/tharun1305/onion-final/blob/main/onion-ai/api.py): `onion-ai/api.py`
- [Authentication](https://github.com/tharun1305/onion-final/blob/main/onion-ai/auth_service.py): `onion-ai/auth_service.py`

### Inspection backend

- [Backend routes](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/main.py): `onion-main/backend/app/main.py`
- [Inspection schemas](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/schemas.py): `onion-main/backend/app/schemas.py`
- [Model service](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/ai_service.py): `onion-main/backend/app/services/ai_service.py`
- [Inspection sync](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/supabase_service.py): `onion-main/backend/app/services/supabase_service.py`
- [Inspector verification](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/schemas.py): `onion-main/backend/app/schemas.py`
- [Quality grading](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/schemas.py): `onion-main/backend/app/schemas.py`
- [Digital inspection record](https://github.com/tharun1305/onion-final/blob/main/onion-main/backend/app/services/supabase_service.py): `onion-main/backend/app/services/supabase_service.py`

### Client runtime

- [Image input](https://github.com/tharun1305/onion-final/tree/main/onion-main/onion_app): `onion-main/onion_app`
- [Flutter client](https://github.com/tharun1305/onion-final/tree/main/onion-main/onion_app): `onion-main/onion_app`

### Other components

- **Farmer / inspector**
- **Supabase database**
- **Local auth store**

## Connections

- Farmer / inspector → Image input: provides image
- Image input → Flutter client: submits image
- Flutter client → Backend routes: sends requests
- Dataset preparation → Classifier training: prepares data
- Farmer / inspector → AI API: uploads image
- AI API → Prediction pipeline: calls pipeline (evidence: `onion-ai/api.py`)
- Backend routes → Inspection schemas: validates payloads (evidence: `onion-main/backend/app/main.py`)
- Backend routes → Model service: requests prediction (evidence: `onion-main/backend/app/main.py`)
- Model service → Prediction pipeline: loads and calls (evidence: `onion-main/backend/app/services/ai_service.py`)
- Backend routes → Inspection sync: syncs and retrieves (evidence: `onion-main/backend/app/main.py`)
- Inspection sync → Supabase database: reads and writes (evidence: `onion-main/backend/app/services/supabase_service.py`)
- Farmer / inspector → Inspector verification: reviews result
- Inspector verification → Quality grading: confirms grade (evidence: `onion-main/backend/app/schemas.py`)
- Quality grading → Digital inspection record: records assessment
- Authentication → Local auth store: stores accounts (evidence: `onion-ai/auth_service.py`)
