# oopnv70-lab/iknow-scanner-2 architecture

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

- Interactive diagram: https://gitdiagram.com/oopnv70-lab/iknow-scanner-2
- Repository: https://github.com/oopnv70-lab/iknow-scanner-2

## Overview

This Android app scans an identifier range against the iKnow service, presents and saves classified results, and supports resuming after rate limiting. Settings tune scan behavior and import/organize logs; History searches categorized saved records. MainActivity is the evidenced orchestration point for scanning and result handling. Source excerpts are partial, so links to details not shown are omitted rather than inferred.

Main entry points: [`iknow-scanner2/java/com/iknowscanner2/MainActivity.java`](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/MainActivity.java) (Scan UI and control), [`iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java`](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java) (History browsing), [`iknow-scanner2/java/com/iknowscanner2/SettingsActivity.java`](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/SettingsActivity.java) (Scan settings and log import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Scanning"]
  node_main["Scan UI and control<br/>[MainActivity.java]"]
end

subgraph group_records["Records"]
  node_scanresults["Result classification and saving<br/>[MainActivity.java]"]
  node_files[("Category files")]
  node_history["History browsing"]
end

subgraph group_preferences["Preferences"]
  node_settings["Scan settings and log import"]
end

node_user(("User"))
node_service["iKnow service"]

node_user -->|"starts scans"| node_main
node_main -->|"requests records"| node_service
node_main -->|"processes results"| node_scanresults
node_scanresults -->|"writes categories"| node_files
node_history -->|"reads categories"| node_files
node_settings -->|"imports and organizes"| node_files
node_user -->|"browses records"| node_history
node_user -->|"configures scan"| node_settings
node_main -->|"references settings"| node_settings
node_main -->|"references history"| node_history

click node_main "https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/MainActivity.java"
click node_scanresults "https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/MainActivity.java"
click node_history "https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java"
click node_settings "https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/SettingsActivity.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_main,node_user toneBlue
class node_scanresults,node_files,node_history toneAmber
class node_settings toneMint
class node_service toneIndigo
```

## Components

### Scanning

- [Scan UI and control](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/MainActivity.java): `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`

### Records

- [Result classification and saving](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/MainActivity.java): `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`
- **Category files**
- [History browsing](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java): `iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java`

### Preferences

- [Scan settings and log import](https://github.com/oopnv70-lab/iknow-scanner-2/blob/main/iknow-scanner2/java/com/iknowscanner2/SettingsActivity.java): `iknow-scanner2/java/com/iknowscanner2/SettingsActivity.java`

### Other components

- **User**
- **iKnow service**

## Connections

- User → Scan UI and control: starts scans (evidence: `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`)
- Scan UI and control → iKnow service: requests records (evidence: `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`)
- Scan UI and control → Result classification and saving: processes results (evidence: `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`)
- Result classification and saving → Category files: writes categories (evidence: `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`)
- History browsing → Category files: reads categories (evidence: `iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java`)
- Scan settings and log import → Category files: imports and organizes (evidence: `iknow-scanner2/java/com/iknowscanner2/SettingsActivity.java`)
- User → History browsing: browses records (evidence: `iknow-scanner2/java/com/iknowscanner2/HistoryActivity.java`)
- User → Scan settings and log import: configures scan (evidence: `iknow-scanner2/java/com/iknowscanner2/SettingsActivity.java`)
- Scan UI and control → Scan settings and log import: references settings (evidence: `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`)
- Scan UI and control → History browsing: references history (evidence: `iknow-scanner2/java/com/iknowscanner2/MainActivity.java`)
