# radicalsanta/bharatpcb2 architecture

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

- Interactive diagram: https://gitdiagram.com/radicalsanta/bharatpcb2
- Repository: https://github.com/radicalsanta/bharatpcb2

## Overview

Bharat PCB is an Android PCB-inspection app, with visible modules for image-based defect detection, policy/domain processing, inspection history and metrics, CSV output, and local advisory generation. The apparent user workflow is to start an inspection, process its image, and view results, with other screens for dashboards, history, and settings. The supplied material contains no README and no runtime source excerpts, so these connections are shown as unverified; component responsibilities are inferred from the file tree only.

Main entry points: [`app/src/main/java/com/example/domain/usecase/RunInspectionUseCase.kt`](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/usecase/RunInspectionUseCase.kt) (Run inspection), [`app/src/main/java/com/example/navigation/AppNavGraph.kt`](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/navigation/AppNavGraph.kt) (App navigation), [`app/src/main/java/com/example/data/repository/InspectionRepositoryImpl.kt`](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/repository/InspectionRepositoryImpl.kt) (Inspection repository), [`app/src/main/java/com/example/presentation/screens/HistoryScreen.kt`](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/HistoryScreen.kt) (History screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["App and navigation"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavGraph.kt]"]
  node_inspect_ui["Inspection screen<br/>[InspectScreen.kt]"]
  node_results_ui["Results screen<br/>[ResultsScreen.kt]"]
  node_history_ui["History screen<br/>[HistoryScreen.kt]"]
  node_advisory_ui["Advisory screen<br/>[AdvisoryScreen.kt]"]
  node_settings_ui["Settings screen<br/>[SettingsScreen.kt]"]
end

subgraph group_inspection["Inspection workflow"]
  node_inspect_vm["Inspection view model"]
  node_run_inspection["Run inspection"]
  node_image_decoder["Image decoder"]
  node_dashboard["Dashboard metrics"]
end

subgraph group_inference["Inference and advisory"]
  node_detection_engine["PCB detection engine"]
  node_transistor_engine["Transistor engine"]
  node_defect_refiner["Defect refinement"]
  node_advisory_engine["Local advisory engine"]
end

subgraph group_domain["Domain and policy"]
  node_policy["Inspection policy"]
  node_taxonomy["Defect taxonomy<br/>[DefectTaxonomy.kt]"]
end

subgraph group_data["Persistence and export"]
  node_repository["Inspection repository"]
  node_database[("Inspection database")]
  node_csv_export["CSV export"]
  node_csv_logger["Inspection CSV log"]
  node_settings_repo["Settings repository"]
end

node_user(("App user"))

node_user -.->|"opens"| node_activity
node_activity -.->|"launches"| node_navigation
node_navigation -.->|"routes to"| node_inspect_ui
node_inspect_ui -.->|"submits inspection"| node_inspect_vm
node_inspect_vm -.->|"requests run"| node_run_inspection
node_run_inspection -.->|"decodes image"| node_image_decoder
node_run_inspection -.->|"requests detection"| node_detection_engine
node_run_inspection -.->|"requests analysis"| node_transistor_engine
node_run_inspection -.->|"applies policy"| node_policy
node_policy -.->|"uses taxonomy"| node_taxonomy
node_run_inspection -.->|"saves inspection"| node_repository
node_repository -.->|"persists records"| node_database
node_navigation -.->|"routes to"| node_results_ui
node_dashboard -.->|"reads inspections"| node_repository
node_navigation -.->|"routes to"| node_history_ui
node_history_ui -.->|"loads history"| node_repository
node_run_inspection -.->|"logs inspection"| node_csv_logger
node_history_ui -.->|"exports history"| node_csv_export
node_navigation -.->|"routes to"| node_advisory_ui
node_advisory_ui -.->|"requests advice"| node_advisory_engine
node_navigation -.->|"routes to"| node_settings_ui
node_settings_ui -.->|"updates settings"| node_settings_repo

click node_activity "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/MainActivity.kt"
click node_navigation "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/navigation/AppNavGraph.kt"
click node_inspect_ui "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/InspectScreen.kt"
click node_inspect_vm "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/viewmodel/InspectViewModel.kt"
click node_run_inspection "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/usecase/RunInspectionUseCase.kt"
click node_image_decoder "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/imageprocessing/SafeImageDecoder.kt"
click node_detection_engine "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/cv/OnnxPcbDetectionEngine.kt"
click node_transistor_engine "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/cv/PatchCoreTransistorEngine.kt"
click node_defect_refiner "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/cv/GreenPcbDefectRefiner.kt"
click node_policy "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/policy/InspectionPolicyEngine.kt"
click node_taxonomy "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/policy/DefectTaxonomy.kt"
click node_repository "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/repository/InspectionRepositoryImpl.kt"
click node_database "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/local/database/PcbInspectorDatabase.kt"
click node_results_ui "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/ResultsScreen.kt"
click node_dashboard "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/usecase/ComputeDashboardMetricsUseCase.kt"
click node_history_ui "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/HistoryScreen.kt"
click node_csv_export "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/csv/CsvExportManagerImpl.kt"
click node_csv_logger "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/csv/InspectionCsvLoggerImpl.kt"
click node_advisory_ui "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/AdvisoryScreen.kt"
click node_advisory_engine "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/llm/ExecuTorchAdvisoryEngine.kt"
click node_settings_ui "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/SettingsScreen.kt"
click node_settings_repo "https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/local/preferences/SettingsRepositoryImpl.kt"

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_activity,node_navigation,node_inspect_ui,node_results_ui,node_history_ui,node_advisory_ui,node_settings_ui,node_user toneBlue
class node_inspect_vm,node_run_inspection,node_image_decoder,node_dashboard toneAmber
class node_detection_engine,node_transistor_engine,node_defect_refiner,node_advisory_engine toneMint
class node_policy,node_taxonomy toneRose
class node_repository,node_database,node_csv_export,node_csv_logger,node_settings_repo toneIndigo
```

## Components

### App and navigation

- [Main activity](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/MainActivity.kt): `app/src/main/java/com/example/MainActivity.kt`
- [App navigation](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/navigation/AppNavGraph.kt): `app/src/main/java/com/example/navigation/AppNavGraph.kt`
- [Inspection screen](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/InspectScreen.kt): `app/src/main/java/com/example/presentation/screens/InspectScreen.kt`
- [Results screen](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/ResultsScreen.kt): `app/src/main/java/com/example/presentation/screens/ResultsScreen.kt`
- [History screen](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/HistoryScreen.kt): `app/src/main/java/com/example/presentation/screens/HistoryScreen.kt`
- [Advisory screen](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/AdvisoryScreen.kt): `app/src/main/java/com/example/presentation/screens/AdvisoryScreen.kt`
- [Settings screen](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/screens/SettingsScreen.kt): `app/src/main/java/com/example/presentation/screens/SettingsScreen.kt`

### Inspection workflow

- [Inspection view model](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/presentation/viewmodel/InspectViewModel.kt): `app/src/main/java/com/example/presentation/viewmodel/InspectViewModel.kt`
- [Run inspection](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/usecase/RunInspectionUseCase.kt): `app/src/main/java/com/example/domain/usecase/RunInspectionUseCase.kt`
- [Image decoder](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/imageprocessing/SafeImageDecoder.kt): `app/src/main/java/com/example/imageprocessing/SafeImageDecoder.kt`
- [Dashboard metrics](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/usecase/ComputeDashboardMetricsUseCase.kt): `app/src/main/java/com/example/domain/usecase/ComputeDashboardMetricsUseCase.kt`

### Inference and advisory

- [PCB detection engine](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/cv/OnnxPcbDetectionEngine.kt): `app/src/main/java/com/example/inference/cv/OnnxPcbDetectionEngine.kt`
- [Transistor engine](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/cv/PatchCoreTransistorEngine.kt): `app/src/main/java/com/example/inference/cv/PatchCoreTransistorEngine.kt`
- [Defect refinement](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/cv/GreenPcbDefectRefiner.kt): `app/src/main/java/com/example/inference/cv/GreenPcbDefectRefiner.kt`
- [Local advisory engine](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/inference/llm/ExecuTorchAdvisoryEngine.kt): `app/src/main/java/com/example/inference/llm/ExecuTorchAdvisoryEngine.kt`

### Domain and policy

- [Inspection policy](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/policy/InspectionPolicyEngine.kt): `app/src/main/java/com/example/domain/policy/InspectionPolicyEngine.kt`
- [Defect taxonomy](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/domain/policy/DefectTaxonomy.kt): `app/src/main/java/com/example/domain/policy/DefectTaxonomy.kt`

### Persistence and export

- [Inspection repository](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/repository/InspectionRepositoryImpl.kt): `app/src/main/java/com/example/data/repository/InspectionRepositoryImpl.kt`
- [Inspection database](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/local/database/PcbInspectorDatabase.kt): `app/src/main/java/com/example/data/local/database/PcbInspectorDatabase.kt`
- [CSV export](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/csv/CsvExportManagerImpl.kt): `app/src/main/java/com/example/data/csv/CsvExportManagerImpl.kt`
- [Inspection CSV log](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/csv/InspectionCsvLoggerImpl.kt): `app/src/main/java/com/example/data/csv/InspectionCsvLoggerImpl.kt`
- [Settings repository](https://github.com/radicalsanta/bharatpcb2/blob/main/app/src/main/java/com/example/data/local/preferences/SettingsRepositoryImpl.kt): `app/src/main/java/com/example/data/local/preferences/SettingsRepositoryImpl.kt`

### Other components

- **App user**

## Connections

- App user → Main activity: opens
- Main activity → App navigation: launches
- App navigation → Inspection screen: routes to
- Inspection screen → Inspection view model: submits inspection
- Inspection view model → Run inspection: requests run
- Run inspection → Image decoder: decodes image
- Run inspection → PCB detection engine: requests detection
- Run inspection → Transistor engine: requests analysis
- Run inspection → Inspection policy: applies policy
- Inspection policy → Defect taxonomy: uses taxonomy
- Run inspection → Inspection repository: saves inspection
- Inspection repository → Inspection database: persists records
- App navigation → Results screen: routes to
- Dashboard metrics → Inspection repository: reads inspections
- App navigation → History screen: routes to
- History screen → Inspection repository: loads history
- Run inspection → Inspection CSV log: logs inspection
- History screen → CSV export: exports history
- App navigation → Advisory screen: routes to
- Advisory screen → Local advisory engine: requests advice
- App navigation → Settings screen: routes to
- Settings screen → Settings repository: updates settings
