# manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026 architecture

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

## Overview

This repository combines a working local pest-image classification service and browser UI with a documented AWS target architecture. The implemented user workflow is image selection and upload, validation and preprocessing, ViT classification, optional Grad-CAM generation, and display of results. The README also describes dataset preparation, model training, cloud deployment, authentication, storage, monitoring, and alerts; those are represented as documented architecture, not as inspected implementations. AWS relationships are based on README statements, while source excerpts establish the local API flow.

Main entry points: [`src/backend/app/main.py`](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/main.py) (FastAPI routes), [`src/aws/README.md`](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md) (Lambda request orchestration), [`src/backend/app/model_loader.py`](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/model_loader.py) (Model and class loading), [`src/frontend/js/app.js`](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/frontend/js/app.js) (Image upload UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_web["Image upload UI<br/>[app.js]"]
end

subgraph group_backend["Inference service"]
  node_api["FastAPI routes<br/>[main.py]"]
  node_schemas["API response schemas<br/>[schemas.py]"]
  node_logging["Request logging<br/>[logging_config.py]"]
  node_config["Runtime settings<br/>[config.py]"]
  node_image["Image validation and preprocessing<br/>[image_utils.py]"]
end

subgraph group_model["Model lifecycle"]
  node_inference["ViT classification<br/>[inference.py]"]
  node_loader["Model and class loading<br/>[model_loader.py]"]
  node_explain["Grad-CAM explanation<br/>[explainability.py]"]
  node_assets["Model and class assets"]
  node_dataset[("IP102 and field data")]
  node_prep["Dataset preprocessing"]
end

subgraph group_cloud["AWS target platform"]
  node_s3[("S3 image and artifacts store<br/>[README.md]")]
  node_training["SageMaker training and hosting<br/>[README.md]"]
  node_gateway["API Gateway<br/>[README.md]"]
  node_lambda["Lambda request orchestration<br/>[README.md]"]
  node_identity["Cognito identity<br/>[README.md]"]
  node_metadata[("DynamoDB or RDS metadata<br/>[README.md]")]
  node_monitor["CloudWatch monitoring<br/>[README.md]"]
  node_alerts["SNS notifications<br/>[README.md]"]
  node_iot["Optional IoT ingestion<br/>[README.md]"]
end

node_farmer(("Farmer or agronomist"))

node_farmer -->|"selects image"| node_web
node_web -->|"posts image"| node_api
node_api -->|"validates and preprocesses"| node_image
node_api -->|"classifies tensor"| node_inference
node_api -->|"requests explanation"| node_explain
node_api -->|"loads at startup"| node_loader
node_api -->|"shapes responses"| node_schemas
node_api -->|"configures logging"| node_logging
node_inference -->|"uses model bundle"| node_loader
node_explain -->|"uses model and lock"| node_loader
node_image -->|"reads preprocessing settings"| node_config
node_loader -->|"reads model settings"| node_config
node_inference -->|"reads top-k setting"| node_config
node_dataset -.->|"prepared for modeling"| node_prep
node_dataset -->|"training input"| node_training
node_s3 -->|"provides data and artifacts"| node_training
node_gateway -->|"routes requests"| node_lambda
node_lambda -->|"invokes hosted endpoint"| node_training
node_web -.->|"cloud client endpoint"| node_gateway
node_farmer -->|"authenticates"| node_identity
node_lambda -->|"stores uploaded images"| node_s3
node_lambda -->|"persists prediction metadata"| node_metadata
node_lambda -->|"emits logs and metrics"| node_monitor
node_monitor -->|"triggers risk alerts"| node_alerts
node_iot -.->|"ingests canopy imagery"| node_s3
node_training -->|"registers model artifacts"| node_s3
node_loader -->|"loads checkpoint and labels"| node_assets

click node_web "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/frontend/js/app.js"
click node_api "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/main.py"
click node_schemas "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/schemas.py"
click node_logging "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/logging_config.py"
click node_config "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/config.py"
click node_image "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/image_utils.py"
click node_inference "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/inference.py"
click node_loader "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/model_loader.py"
click node_explain "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/explainability.py"
click node_assets "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/tree/main/src/ai_model"
click node_dataset "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/tree/main/dataset"
click node_prep "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/dataset/preprocessing_scripts/pytorch-vit-insect-classifier%20(3).ipynb"
click node_s3 "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_training "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_gateway "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_lambda "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_identity "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_metadata "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_monitor "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_alerts "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"
click node_iot "https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md"

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 toneBlue
class node_api,node_schemas,node_logging,node_config,node_image toneAmber
class node_inference,node_loader,node_explain,node_assets,node_dataset,node_prep toneMint
class node_s3,node_training,node_gateway,node_lambda,node_identity,node_metadata,node_monitor,node_alerts,node_iot toneRose
class node_farmer toneIndigo
```

## Components

### Client experience

- [Image upload UI](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/frontend/js/app.js): `src/frontend/js/app.js`

### Inference service

- [FastAPI routes](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/main.py): `src/backend/app/main.py`
- [API response schemas](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/schemas.py): `src/backend/app/schemas.py`
- [Request logging](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/logging_config.py): `src/backend/app/logging_config.py`
- [Runtime settings](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/config.py): `src/backend/app/config.py`
- [Image validation and preprocessing](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/image_utils.py): `src/backend/app/image_utils.py`

### Model lifecycle

- [ViT classification](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/inference.py): `src/backend/app/inference.py`
- [Model and class loading](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/model_loader.py): `src/backend/app/model_loader.py`
- [Grad-CAM explanation](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/backend/app/explainability.py): `src/backend/app/explainability.py`
- [Model and class assets](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/tree/main/src/ai_model): `src/ai_model`
- [IP102 and field data](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/tree/main/dataset): `dataset`
- [Dataset preprocessing](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/dataset/preprocessing_scripts/pytorch-vit-insect-classifier%20(3).ipynb): `dataset/preprocessing_scripts/pytorch-vit-insect-classifier (3).ipynb`

### AWS target platform

- [S3 image and artifacts store](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [SageMaker training and hosting](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [API Gateway](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [Lambda request orchestration](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [Cognito identity](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [DynamoDB or RDS metadata](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [CloudWatch monitoring](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [SNS notifications](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`
- [Optional IoT ingestion](https://github.com/manoj-dj/visiontransformerpestdetection_aws_cloud_project_2026/blob/main/src/aws/README.md): `src/aws/README.md`

### Other components

- **Farmer or agronomist**

## Connections

- Farmer or agronomist → Image upload UI: selects image (evidence: `src/frontend/js/app.js`)
- Image upload UI → FastAPI routes: posts image (evidence: `src/frontend/js/app.js`)
- FastAPI routes → Image validation and preprocessing: validates and preprocesses (evidence: `src/backend/app/main.py`)
- FastAPI routes → ViT classification: classifies tensor (evidence: `src/backend/app/main.py`)
- FastAPI routes → Grad-CAM explanation: requests explanation (evidence: `src/backend/app/main.py`)
- FastAPI routes → Model and class loading: loads at startup (evidence: `src/backend/app/main.py`)
- FastAPI routes → API response schemas: shapes responses (evidence: `src/backend/app/main.py`)
- FastAPI routes → Request logging: configures logging (evidence: `src/backend/app/main.py`)
- ViT classification → Model and class loading: uses model bundle (evidence: `src/backend/app/inference.py`)
- Grad-CAM explanation → Model and class loading: uses model and lock (evidence: `src/backend/app/explainability.py`)
- Image validation and preprocessing → Runtime settings: reads preprocessing settings (evidence: `src/backend/app/image_utils.py`)
- Model and class loading → Runtime settings: reads model settings (evidence: `src/backend/app/model_loader.py`)
- ViT classification → Runtime settings: reads top-k setting (evidence: `src/backend/app/inference.py`)
- IP102 and field data → Dataset preprocessing: prepared for modeling (evidence: `README.md`)
- IP102 and field data → SageMaker training and hosting: training input (evidence: `README.md`)
- S3 image and artifacts store → SageMaker training and hosting: provides data and artifacts (evidence: `README.md`)
- API Gateway → Lambda request orchestration: routes requests (evidence: `README.md`)
- Lambda request orchestration → SageMaker training and hosting: invokes hosted endpoint (evidence: `README.md`)
- Image upload UI → API Gateway: cloud client endpoint (evidence: `README.md`)
- Farmer or agronomist → Cognito identity: authenticates (evidence: `README.md`)
- Lambda request orchestration → S3 image and artifacts store: stores uploaded images (evidence: `README.md`)
- Lambda request orchestration → DynamoDB or RDS metadata: persists prediction metadata (evidence: `README.md`)
- Lambda request orchestration → CloudWatch monitoring: emits logs and metrics (evidence: `README.md`)
- CloudWatch monitoring → SNS notifications: triggers risk alerts (evidence: `README.md`)
- Optional IoT ingestion → S3 image and artifacts store: ingests canopy imagery (evidence: `README.md`)
- SageMaker training and hosting → S3 image and artifacts store: registers model artifacts (evidence: `README.md`)
- Model and class loading → Model and class assets: loads checkpoint and labels (evidence: `src/backend/app/model_loader.py`)
