# muhtasim-apon/infinity_ai_buildfest architecture

> Architecture diagram of the GitHub repository muhtasim-apon/infinity_ai_buildfest, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muhtasim-apon/infinity_ai_buildfest
- Repository: https://github.com/muhtasim-apon/infinity_ai_buildfest

## Overview

CropGuardian is an agriculture-focused web application for detecting crop pests and disease from imagery, with farmer-facing scan flows, authentication, localized UX, and alert/review capabilities. The apparent user journey is to enter through the web app, authenticate, submit or view a scan, then receive advice or alerts; reviewer and admin areas are separate product branches. The tree also includes backend services, ML data preparation, and knowledge-base search. README claims are aspirational and explicitly says the template has no trained model or deployed application; sampled code confirms some runtime pieces, but not the full scan or inference path.

Main entry points: [`cropguardian/frontend/src/app/router.tsx`](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/router.tsx) (Route access), [`cropguardian/frontend/src/app/App.tsx`](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/App.tsx) (App shell), [`cropguardian/backend/app/services/auth.py`](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/auth.py) (Auth service), [`cropguardian/backend/app/main.py`](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/main.py) (API application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App shell<br/>[App.tsx]"]
  node_router["Route access<br/>[router.tsx]"]
  node_farmer_pages["Farmer scan UX<br/>[farmer.tsx]"]
  node_review_pages["Alert review<br/>[review.tsx]"]
  node_i18n["Language UX<br/>[index.ts]"]
  node_api_client["HTTP client<br/>[api.ts]"]
  node_scan_client["Scan API client<br/>[api.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_ui["Auth state<br/>[auth.tsx]"]
  node_auth_pages["Sign-in flows<br/>[auth.tsx]"]
  node_auth_client["Auth API client<br/>[authApi.ts]"]
  node_auth_routes["Auth routes<br/>[auth.py]"]
  node_auth_service["Auth service<br/>[auth.py]"]
  node_session_store[("Session store<br/>[sessions.py]")]
end

subgraph group_backend["Backend services"]
  node_api_app["API application<br/>[main.py]"]
  node_db_sessions[("DB session scope<br/>[session.py]")]
  node_scan_routes["Scan routes<br/>[scans.py]"]
  node_scan_service["Scan service<br/>[scans.py]"]
end

subgraph group_knowledge["Knowledge and alerts"]
  node_decision["Decision rules<br/>[decision.py]"]
  node_outbreaks["Outbreak rules<br/>[outbreak_rules.py]"]
  node_kb_search["Knowledge search<br/>[kb_search.py]"]
  node_kb_server["KB server<br/>[kb_server.py]"]
  node_llm["LLM integration<br/>[llm.py]"]
end

subgraph group_ml["ML data tooling"]
  node_ml_entry["ML data commands<br/>[__main__.py]"]
  node_ml_prepare["Dataset preparation<br/>[prepare.py]"]
  node_ml_manifest["Dataset manifest<br/>[manifest.py]"]
end

node_farmer(("Farmer"))

node_farmer -->|"uses"| node_app
node_app -->|"provides auth"| node_auth_ui
node_app -->|"renders routes"| node_router
node_router -->|"routes to"| node_auth_pages
node_router -->|"routes to"| node_farmer_pages
node_router -->|"routes to"| node_review_pages
node_farmer_pages -->|"requests scans"| node_scan_client
node_review_pages -->|"requests alerts"| node_scan_client
node_auth_ui -->|"loads auth state"| node_auth_client
node_auth_pages -->|"uses"| node_auth_client
node_auth_client -->|"uses transport"| node_api_client
node_scan_client -->|"uses transport"| node_api_client
node_api_client -.->|"calls API"| node_api_app
node_api_app -->|"mounts routes"| node_auth_routes
node_auth_routes -->|"delegates auth"| node_auth_service
node_auth_service -->|"uses sessions"| node_session_store
node_auth_service -->|"uses DB scope"| node_db_sessions
node_api_app -->|"mounts routes"| node_scan_routes
node_scan_routes -.->|"delegates scans"| node_scan_service
node_scan_service -.->|"applies decisions"| node_decision
node_scan_service -.->|"checks outbreaks"| node_outbreaks
node_kb_server -->|"uses search"| node_kb_search
node_ml_entry -->|"runs preparation"| node_ml_prepare
node_ml_entry -->|"runs manifest"| node_ml_manifest

click node_app "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/App.tsx"
click node_router "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/router.tsx"
click node_farmer_pages "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/pages/farmer.tsx"
click node_review_pages "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/pages/review.tsx"
click node_i18n "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/i18n/index.ts"
click node_auth_ui "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/auth.tsx"
click node_auth_pages "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/pages/auth.tsx"
click node_auth_client "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/lib/authApi.ts"
click node_api_client "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/lib/api.ts"
click node_scan_client "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/features/scans/api.ts"
click node_api_app "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/main.py"
click node_auth_routes "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/api/v1/auth.py"
click node_auth_service "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/auth.py"
click node_session_store "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/core/sessions.py"
click node_db_sessions "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/db/session.py"
click node_scan_routes "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/api/v1/scans.py"
click node_scan_service "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/scans.py"
click node_decision "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/domain/decision.py"
click node_outbreaks "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/domain/outbreak_rules.py"
click node_kb_search "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/domain/kb_search.py"
click node_kb_server "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/mcp/kb_server.py"
click node_llm "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/llm.py"
click node_ml_entry "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/ml/cg_ml/__main__.py"
click node_ml_prepare "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/ml/cg_ml/data/prepare.py"
click node_ml_manifest "https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/ml/cg_ml/data/manifest.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_app,node_router,node_farmer_pages,node_review_pages,node_i18n,node_api_client,node_scan_client toneBlue
class node_auth_ui,node_auth_pages,node_auth_client,node_auth_routes,node_auth_service,node_session_store toneAmber
class node_api_app,node_db_sessions,node_scan_routes,node_scan_service toneMint
class node_decision,node_outbreaks,node_kb_search,node_kb_server,node_llm toneRose
class node_ml_entry,node_ml_prepare,node_ml_manifest,node_farmer toneIndigo
```

## Components

### Web application

- [App shell](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/App.tsx): `cropguardian/frontend/src/app/App.tsx`
- [Route access](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/router.tsx): `cropguardian/frontend/src/app/router.tsx`
- [Farmer scan UX](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/pages/farmer.tsx): `cropguardian/frontend/src/app/pages/farmer.tsx`
- [Alert review](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/pages/review.tsx): `cropguardian/frontend/src/app/pages/review.tsx`
- [Language UX](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/i18n/index.ts): `cropguardian/frontend/src/i18n/index.ts`
- [HTTP client](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/lib/api.ts): `cropguardian/frontend/src/lib/api.ts`
- [Scan API client](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/features/scans/api.ts): `cropguardian/frontend/src/features/scans/api.ts`

### Identity and access

- [Auth state](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/auth.tsx): `cropguardian/frontend/src/app/auth.tsx`
- [Sign-in flows](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/app/pages/auth.tsx): `cropguardian/frontend/src/app/pages/auth.tsx`
- [Auth API client](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/frontend/src/lib/authApi.ts): `cropguardian/frontend/src/lib/authApi.ts`
- [Auth routes](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/api/v1/auth.py): `cropguardian/backend/app/api/v1/auth.py`
- [Auth service](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/auth.py): `cropguardian/backend/app/services/auth.py`
- [Session store](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/core/sessions.py): `cropguardian/backend/app/core/sessions.py`

### Backend services

- [API application](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/main.py): `cropguardian/backend/app/main.py`
- [DB session scope](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/db/session.py): `cropguardian/backend/app/db/session.py`
- [Scan routes](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/api/v1/scans.py): `cropguardian/backend/app/api/v1/scans.py`
- [Scan service](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/scans.py): `cropguardian/backend/app/services/scans.py`

### Knowledge and alerts

- [Decision rules](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/domain/decision.py): `cropguardian/backend/app/domain/decision.py`
- [Outbreak rules](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/domain/outbreak_rules.py): `cropguardian/backend/app/domain/outbreak_rules.py`
- [Knowledge search](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/domain/kb_search.py): `cropguardian/backend/app/domain/kb_search.py`
- [KB server](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/mcp/kb_server.py): `cropguardian/mcp/kb_server.py`
- [LLM integration](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/backend/app/services/llm.py): `cropguardian/backend/app/services/llm.py`

### ML data tooling

- [ML data commands](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/ml/cg_ml/__main__.py): `cropguardian/ml/cg_ml/__main__.py`
- [Dataset preparation](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/ml/cg_ml/data/prepare.py): `cropguardian/ml/cg_ml/data/prepare.py`
- [Dataset manifest](https://github.com/muhtasim-apon/infinity_ai_buildfest/blob/main/cropguardian/ml/cg_ml/data/manifest.py): `cropguardian/ml/cg_ml/data/manifest.py`

### Other components

- **Farmer**

## Connections

- Farmer → App shell: uses
- App shell → Auth state: provides auth (evidence: `cropguardian/frontend/src/app/App.tsx`)
- App shell → Route access: renders routes (evidence: `cropguardian/frontend/src/app/App.tsx`)
- Route access → Sign-in flows: routes to (evidence: `cropguardian/frontend/src/app/router.tsx`)
- Route access → Farmer scan UX: routes to (evidence: `cropguardian/frontend/src/app/router.tsx`)
- Route access → Alert review: routes to (evidence: `cropguardian/frontend/src/app/router.tsx`)
- Farmer scan UX → Scan API client: requests scans (evidence: `cropguardian/frontend/src/app/pages/farmer.tsx`)
- Alert review → Scan API client: requests alerts (evidence: `cropguardian/frontend/src/app/pages/review.tsx`)
- Auth state → Auth API client: loads auth state (evidence: `cropguardian/frontend/src/app/auth.tsx`)
- Sign-in flows → Auth API client: uses (evidence: `cropguardian/frontend/src/app/pages/auth.tsx`)
- Auth API client → HTTP client: uses transport (evidence: `cropguardian/frontend/src/lib/authApi.ts`)
- Scan API client → HTTP client: uses transport (evidence: `cropguardian/frontend/src/features/scans/api.ts`)
- HTTP client → API application: calls API
- API application → Auth routes: mounts routes (evidence: `cropguardian/backend/app/main.py`)
- Auth routes → Auth service: delegates auth (evidence: `cropguardian/backend/app/api/v1/auth.py`)
- Auth service → Session store: uses sessions (evidence: `cropguardian/backend/app/services/auth.py`)
- Auth service → DB session scope: uses DB scope (evidence: `cropguardian/backend/app/services/auth.py`)
- API application → Scan routes: mounts routes (evidence: `cropguardian/backend/app/main.py`)
- Scan routes → Scan service: delegates scans
- Scan service → Decision rules: applies decisions
- Scan service → Outbreak rules: checks outbreaks
- KB server → Knowledge search: uses search (evidence: `cropguardian/mcp/kb_server.py`)
- ML data commands → Dataset preparation: runs preparation (evidence: `cropguardian/ml/cg_ml/__main__.py`)
- ML data commands → Dataset manifest: runs manifest (evidence: `cropguardian/ml/cg_ml/__main__.py`)
