# freyapayee/djangoviscane_final architecture

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

- Interactive diagram: https://gitdiagram.com/freyapayee/djangoviscane_final
- Repository: https://github.com/freyapayee/djangoviscane_final

## Overview

VISCANE is a sugarcane-farming service: farmers submit scans and agronomic inputs, receive predictions, calculations and recommendations, and retain assessment history. The Django website provides online workflows; a full Android client adds offline scanning, cached farmer content and synchronization, while android-offline is a separate manual-calculation foundation with optional on-device image recognition and JSON export. The graph reflects documented and indexed references; unsampled implementation details are not inferred.

Main entry points: [`android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt) (Offline Scan UI), [`android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/MainActivity.java) (Offline Calculator UI), [`core/views.py`](https://github.com/freyapayee/djangoviscane_final/blob/main/core/views.py) (Web Workflows), [`android/app/src/main/java/com/viscane/app/OfflineSync.kt`](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/OfflineSync.kt) (Sync and Refresh)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Django Farmer Service"]
  node_web_views["Web Workflows<br/>[views.py]"]
  node_web_routes["HTTP Routes<br/>[urls.py]"]
  node_prediction_api{{"Classifier API"}}
end

subgraph group_android["Android Farmer Client"]
  node_android_app["Mobile Shell<br/>[MainActivity.kt]"]
  node_scan_ui["Offline Scan UI"]
  node_mobile_sync["Sync and Refresh<br/>[OfflineSync.kt]"]
  node_scan_store[("Queued Scans")]
  node_assessment_store[("Assessment History")]
  node_farmer_cache[("Farmer Cache")]
  node_offline_classifier["On-device Classifier"]
  node_offline_recs["Offline Recommendations"]
  node_navigation["Farmer Navigation"]
end

subgraph group_offline["Offline Assessment App"]
  node_offline_home["Offline Calculator UI<br/>[MainActivity.java]"]
  node_calculator["Offline Calculator"]
  node_offline_rules["Offline Agronomy Rules<br/>[OfflineRules.java]"]
  node_offline_store[("Local Assessments")]
  node_offline_recognizer["Offline Image Recognition"]
  node_preprocessor["Image Preprocessing"]
  node_json_export["JSON Export<br/>[MainActivity.java]"]
end

subgraph group_domain["Agronomy and Language"]
  node_records[("Farm Records<br/>[models.py]")]
  node_agronomy["Agronomy Services<br/>[services.py]"]
  node_translation["Hiligaynon Text<br/>[language.py]"]
end

node_farmer(("Farmer"))

node_farmer -->|"uses workflows"| node_web_routes
node_web_routes -->|"routes requests"| node_web_views
node_web_views -->|"reads and writes"| node_records
node_web_views -->|"builds recommendations"| node_agronomy
node_web_views -->|"translates display"| node_translation
node_web_views -.->|"requests predictions"| node_prediction_api
node_farmer -->|"uses mobile app"| node_android_app
node_android_app -->|"opens scanner"| node_scan_ui
node_android_app -->|"starts sync"| node_mobile_sync
node_android_app -->|"configures navigation"| node_navigation
node_scan_ui -->|"runs recognition"| node_offline_classifier
node_scan_ui -->|"loads recommendations"| node_offline_recs
node_scan_ui -->|"reads assessments"| node_assessment_store
node_scan_ui -->|"loads cached content"| node_farmer_cache
node_scan_ui -->|"uses scan queue"| node_scan_store
node_mobile_sync -->|"syncs queued scans"| node_scan_store
node_mobile_sync -->|"syncs assessments"| node_assessment_store
node_mobile_sync -->|"refreshes cached data"| node_farmer_cache
node_mobile_sync -->|"calls mobile endpoints"| node_web_views
node_farmer -->|"enters assessments"| node_offline_home
node_offline_home -->|"calculates estimates"| node_calculator
node_offline_home -->|"builds agronomy guidance"| node_offline_rules
node_offline_home -->|"saves and exports"| node_offline_store
node_offline_home -->|"requests recognition"| node_offline_recognizer
node_offline_recognizer -->|"prepares images"| node_preprocessor
node_offline_home -->|"exports records"| node_json_export

click node_web_views "https://github.com/freyapayee/djangoviscane_final/blob/main/core/views.py"
click node_web_routes "https://github.com/freyapayee/djangoviscane_final/blob/main/core/urls.py"
click node_records "https://github.com/freyapayee/djangoviscane_final/blob/main/core/models.py"
click node_agronomy "https://github.com/freyapayee/djangoviscane_final/blob/main/core/services.py"
click node_translation "https://github.com/freyapayee/djangoviscane_final/blob/main/core/language.py"
click node_android_app "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/MainActivity.kt"
click node_scan_ui "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt"
click node_mobile_sync "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/OfflineSync.kt"
click node_scan_store "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineScanStore.kt"
click node_assessment_store "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineAssessmentStore.kt"
click node_farmer_cache "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineFarmerCache.kt"
click node_offline_classifier "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineClassifier.kt"
click node_offline_recs "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineRecommendations.kt"
click node_navigation "https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/FarmerNavigation.kt"
click node_offline_home "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/MainActivity.java"
click node_calculator "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/OfflineCalculator.java"
click node_offline_rules "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/OfflineRules.java"
click node_offline_store "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/AssessmentStore.java"
click node_offline_recognizer "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/OfflineImageClassifier.java"
click node_preprocessor "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/ImagePreprocessor.java"
click node_json_export "https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/MainActivity.java"

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_views,node_web_routes,node_prediction_api toneBlue
class node_android_app,node_scan_ui,node_mobile_sync,node_scan_store,node_assessment_store,node_farmer_cache,node_offline_classifier,node_offline_recs,node_navigation toneAmber
class node_offline_home,node_calculator,node_offline_rules,node_offline_store,node_offline_recognizer,node_preprocessor,node_json_export toneMint
class node_records,node_agronomy,node_translation toneRose
class node_farmer toneIndigo
```

## Components

### Django Farmer Service

- [Web Workflows](https://github.com/freyapayee/djangoviscane_final/blob/main/core/views.py): `core/views.py`
- [HTTP Routes](https://github.com/freyapayee/djangoviscane_final/blob/main/core/urls.py): `core/urls.py`
- **Classifier API**

### Android Farmer Client

- [Mobile Shell](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/MainActivity.kt): `android/app/src/main/java/com/viscane/app/MainActivity.kt`
- [Offline Scan UI](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt): `android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`
- [Sync and Refresh](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/OfflineSync.kt): `android/app/src/main/java/com/viscane/app/OfflineSync.kt`
- [Queued Scans](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineScanStore.kt): `android/app/src/main/java/com/viscane/offline/OfflineScanStore.kt`
- [Assessment History](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineAssessmentStore.kt): `android/app/src/main/java/com/viscane/offline/OfflineAssessmentStore.kt`
- [Farmer Cache](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineFarmerCache.kt): `android/app/src/main/java/com/viscane/offline/OfflineFarmerCache.kt`
- [On-device Classifier](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineClassifier.kt): `android/app/src/main/java/com/viscane/offline/OfflineClassifier.kt`
- [Offline Recommendations](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/offline/OfflineRecommendations.kt): `android/app/src/main/java/com/viscane/offline/OfflineRecommendations.kt`
- [Farmer Navigation](https://github.com/freyapayee/djangoviscane_final/blob/main/android/app/src/main/java/com/viscane/app/FarmerNavigation.kt): `android/app/src/main/java/com/viscane/app/FarmerNavigation.kt`

### Offline Assessment App

- [Offline Calculator UI](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/MainActivity.java): `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`
- [Offline Calculator](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/OfflineCalculator.java): `android-offline/app/src/main/java/com/viscane/offline/OfflineCalculator.java`
- [Offline Agronomy Rules](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/OfflineRules.java): `android-offline/app/src/main/java/com/viscane/offline/OfflineRules.java`
- [Local Assessments](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/AssessmentStore.java): `android-offline/app/src/main/java/com/viscane/offline/AssessmentStore.java`
- [Offline Image Recognition](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/OfflineImageClassifier.java): `android-offline/app/src/main/java/com/viscane/offline/OfflineImageClassifier.java`
- [Image Preprocessing](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/ImagePreprocessor.java): `android-offline/app/src/main/java/com/viscane/offline/ImagePreprocessor.java`
- [JSON Export](https://github.com/freyapayee/djangoviscane_final/blob/main/android-offline/app/src/main/java/com/viscane/offline/MainActivity.java): `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`

### Agronomy and Language

- [Farm Records](https://github.com/freyapayee/djangoviscane_final/blob/main/core/models.py): `core/models.py`
- [Agronomy Services](https://github.com/freyapayee/djangoviscane_final/blob/main/core/services.py): `core/services.py`
- [Hiligaynon Text](https://github.com/freyapayee/djangoviscane_final/blob/main/core/language.py): `core/language.py`

### Other components

- **Farmer**

## Connections

- Farmer → HTTP Routes: uses workflows (evidence: `README.md`)
- HTTP Routes → Web Workflows: routes requests (evidence: `core/urls.py`)
- Web Workflows → Farm Records: reads and writes (evidence: `core/views.py`)
- Web Workflows → Agronomy Services: builds recommendations (evidence: `core/views.py`)
- Web Workflows → Hiligaynon Text: translates display (evidence: `core/views.py`)
- Web Workflows → Classifier API: requests predictions (evidence: `README.md`)
- Farmer → Mobile Shell: uses mobile app (evidence: `README.md`)
- Mobile Shell → Offline Scan UI: opens scanner (evidence: `android/app/src/main/java/com/viscane/app/MainActivity.kt`)
- Mobile Shell → Sync and Refresh: starts sync (evidence: `android/app/src/main/java/com/viscane/app/MainActivity.kt`)
- Mobile Shell → Farmer Navigation: configures navigation (evidence: `android/app/src/main/java/com/viscane/app/MainActivity.kt`)
- Offline Scan UI → On-device Classifier: runs recognition (evidence: `android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`)
- Offline Scan UI → Offline Recommendations: loads recommendations (evidence: `android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`)
- Offline Scan UI → Assessment History: reads assessments (evidence: `android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`)
- Offline Scan UI → Farmer Cache: loads cached content (evidence: `android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`)
- Offline Scan UI → Queued Scans: uses scan queue (evidence: `android/app/src/main/java/com/viscane/offline/OfflineScanActivity.kt`)
- Sync and Refresh → Queued Scans: syncs queued scans (evidence: `android/app/src/main/java/com/viscane/app/OfflineSync.kt`)
- Sync and Refresh → Assessment History: syncs assessments (evidence: `android/app/src/main/java/com/viscane/app/OfflineSync.kt`)
- Sync and Refresh → Farmer Cache: refreshes cached data (evidence: `android/app/src/main/java/com/viscane/app/OfflineSync.kt`)
- Sync and Refresh → Web Workflows: calls mobile endpoints (evidence: `android/app/src/main/java/com/viscane/app/OfflineSync.kt`)
- Farmer → Offline Calculator UI: enters assessments (evidence: `README.md`)
- Offline Calculator UI → Offline Calculator: calculates estimates (evidence: `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`)
- Offline Calculator UI → Offline Agronomy Rules: builds agronomy guidance (evidence: `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`)
- Offline Calculator UI → Local Assessments: saves and exports (evidence: `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`)
- Offline Calculator UI → Offline Image Recognition: requests recognition (evidence: `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`)
- Offline Image Recognition → Image Preprocessing: prepares images (evidence: `android-offline/app/src/main/java/com/viscane/offline/OfflineImageClassifier.java`)
- Offline Calculator UI → JSON Export: exports records (evidence: `android-offline/app/src/main/java/com/viscane/offline/MainActivity.java`)
