# reihlinstinct/parking-reporter-app architecture

> Architecture diagram of the GitHub repository reihlinstinct/parking-reporter-app, 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/reihlinstinct/parking-reporter-app
- Repository: https://github.com/reihlinstinct/parking-reporter-app

## Overview

Parking Reporter is an Android preview for locally reviewing sidewalk-parking evidence, with guarded municipal submission code. The main user flow starts from the app or an entry shortcut, captures or selects evidence, reviews and corrects the report, then saves locally or proceeds through approval-gated submission. Registry status and offline plate recognition support review. The README documents capabilities not fully represented in sampled source; those links are marked unverified rather than inferred as confirmed calls.

Main entry points: [`app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt`](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt) (Report review), [`app/src/main/java/io/github/reihlinstinct/reporter/capture/CaptureScreen.kt`](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/capture/CaptureScreen.kt) (Evidence capture), [`app/src/main/java/io/github/reihlinstinct/reporter/MainActivity.kt`](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/MainActivity.kt) (Main activity), [`app/src/main/java/io/github/reihlinstinct/reporter/EntryIntents.kt`](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/EntryIntents.kt) (Shortcuts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and app shell"]
  node_shortcuts["Shortcuts<br/>[EntryIntents.kt]"]
  node_tile["Quick Settings tile"]
  node_assistant["Assistant entry"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_shell["App shell<br/>[AppShell.kt]"]
end

subgraph group_review["Capture and review"]
  node_capture["Evidence capture<br/>[CaptureScreen.kt]"]
  node_evidence["Evidence tools"]
  node_review_screen["Report review<br/>[ReviewScreen.kt]"]
  node_draft["Review draft<br/>[ReviewDraft.kt]"]
  node_ocr["Plate recognition"]
end

subgraph group_local["Local data and security"]
  node_ledger[("Encrypted ledger")]
  node_database[("Room database<br/>[ReportDatabase.kt]")]
  node_settings["Encrypted settings<br/>[SecureSettings.kt]"]
end

subgraph group_municipal["Municipal services"]
  node_topics["Topic catalog"]
  node_coordinator["Submission coordinator"]
  node_municipal_client["Municipal client<br/>[MunicipalClient.kt]"]
end

subgraph group_integrations["External lookups"]
  node_registry_ui["Registry status<br/>[RegistryStatus.kt]"]
  node_registry["Vehicle and tag lookup"]
end

node_person(("Reporter"))
node_municipality{{"Municipal service"}}
node_registry_service{{"Public registries"}}

node_person -->|"opens report"| node_tile
node_tile -->|"launches"| node_activity
node_person -.->|"requests entry"| node_assistant
node_assistant -->|"creates entry action"| node_shortcuts
node_shortcuts -.->|"routes entry"| node_activity
node_activity -->|"renders"| node_shell
node_person -.->|"captures evidence"| node_capture
node_capture -.->|"reads metadata"| node_evidence
node_capture -.->|"opens review"| node_review_screen
node_review_screen -->|"recognizes plate"| node_ocr
node_review_screen -->|"requests address suggestions"| node_evidence
node_review_screen -->|"updates draft"| node_draft
node_review_screen -.->|"loads topics"| node_topics
node_review_screen -.->|"shows status"| node_registry_ui
node_registry_ui -->|"checks registries"| node_registry
node_registry -.->|"queries"| node_registry_service
node_draft -.->|"saves locally"| node_ledger
node_ledger -.->|"reads and writes"| node_database
node_person -.->|"configures"| node_settings
node_review_screen -.->|"requests approved send"| node_coordinator
node_coordinator -.->|"dispatches submission"| node_municipal_client
node_municipal_client -->|"sends case and photo"| node_municipality

click node_shortcuts "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/EntryIntents.kt"
click node_tile "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ReportTileService.kt"
click node_assistant "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/assistant/BaseReportAppFunctionService.kt"
click node_activity "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/MainActivity.kt"
click node_shell "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/AppShell.kt"
click node_capture "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/capture/CaptureScreen.kt"
click node_evidence "https://github.com/reihlinstinct/parking-reporter-app/tree/main/app/src/main/java/io/github/reihlinstinct/reporter/evidence"
click node_review_screen "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt"
click node_draft "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/core/ReviewDraft.kt"
click node_ocr "https://github.com/reihlinstinct/parking-reporter-app/tree/main/app/src/main/java/io/github/reihlinstinct/reporter/recognition"
click node_topics "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/municipal/CityTopicRepository.kt"
click node_registry_ui "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/RegistryStatus.kt"
click node_registry "https://github.com/reihlinstinct/parking-reporter-app/tree/main/app/src/main/java/io/github/reihlinstinct/reporter/registry"
click node_ledger "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ledger/EncryptedLedgerRepository.kt"
click node_database "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ledger/ReportDatabase.kt"
click node_settings "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/security/SecureSettings.kt"
click node_coordinator "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/municipal/SubmissionCoordinator.kt"
click node_municipal_client "https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/municipal/MunicipalClient.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_shortcuts,node_tile,node_assistant,node_activity,node_shell toneBlue
class node_capture,node_evidence,node_review_screen,node_draft,node_ocr toneAmber
class node_ledger,node_database,node_settings toneMint
class node_topics,node_coordinator,node_municipal_client toneRose
class node_registry_ui,node_registry,node_person,node_municipality,node_registry_service toneIndigo
```

## Components

### Entry and app shell

- [Shortcuts](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/EntryIntents.kt): `app/src/main/java/io/github/reihlinstinct/reporter/EntryIntents.kt`
- [Quick Settings tile](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ReportTileService.kt): `app/src/main/java/io/github/reihlinstinct/reporter/ReportTileService.kt`
- [Assistant entry](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/assistant/BaseReportAppFunctionService.kt): `app/src/main/java/io/github/reihlinstinct/reporter/assistant/BaseReportAppFunctionService.kt`
- [Main activity](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/MainActivity.kt): `app/src/main/java/io/github/reihlinstinct/reporter/MainActivity.kt`
- [App shell](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/AppShell.kt): `app/src/main/java/io/github/reihlinstinct/reporter/ui/AppShell.kt`

### Capture and review

- [Evidence capture](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/capture/CaptureScreen.kt): `app/src/main/java/io/github/reihlinstinct/reporter/capture/CaptureScreen.kt`
- [Evidence tools](https://github.com/reihlinstinct/parking-reporter-app/tree/main/app/src/main/java/io/github/reihlinstinct/reporter/evidence): `app/src/main/java/io/github/reihlinstinct/reporter/evidence`
- [Report review](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt): `app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt`
- [Review draft](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/core/ReviewDraft.kt): `app/src/main/java/io/github/reihlinstinct/reporter/core/ReviewDraft.kt`
- [Plate recognition](https://github.com/reihlinstinct/parking-reporter-app/tree/main/app/src/main/java/io/github/reihlinstinct/reporter/recognition): `app/src/main/java/io/github/reihlinstinct/reporter/recognition`

### Local data and security

- [Encrypted ledger](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ledger/EncryptedLedgerRepository.kt): `app/src/main/java/io/github/reihlinstinct/reporter/ledger/EncryptedLedgerRepository.kt`
- [Room database](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ledger/ReportDatabase.kt): `app/src/main/java/io/github/reihlinstinct/reporter/ledger/ReportDatabase.kt`
- [Encrypted settings](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/security/SecureSettings.kt): `app/src/main/java/io/github/reihlinstinct/reporter/security/SecureSettings.kt`

### Municipal services

- [Topic catalog](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/municipal/CityTopicRepository.kt): `app/src/main/java/io/github/reihlinstinct/reporter/municipal/CityTopicRepository.kt`
- [Submission coordinator](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/municipal/SubmissionCoordinator.kt): `app/src/main/java/io/github/reihlinstinct/reporter/municipal/SubmissionCoordinator.kt`
- [Municipal client](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/municipal/MunicipalClient.kt): `app/src/main/java/io/github/reihlinstinct/reporter/municipal/MunicipalClient.kt`

### External lookups

- [Registry status](https://github.com/reihlinstinct/parking-reporter-app/blob/main/app/src/main/java/io/github/reihlinstinct/reporter/ui/RegistryStatus.kt): `app/src/main/java/io/github/reihlinstinct/reporter/ui/RegistryStatus.kt`
- [Vehicle and tag lookup](https://github.com/reihlinstinct/parking-reporter-app/tree/main/app/src/main/java/io/github/reihlinstinct/reporter/registry): `app/src/main/java/io/github/reihlinstinct/reporter/registry`

### Other components

- **Reporter**
- **Municipal service**
- **Public registries**

## Connections

- Reporter → Quick Settings tile: opens report (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ReportTileService.kt`)
- Quick Settings tile → Main activity: launches (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ReportTileService.kt`)
- Reporter → Assistant entry: requests entry (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/assistant/BaseReportAppFunctionService.kt`)
- Assistant entry → Shortcuts: creates entry action (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/assistant/BaseReportAppFunctionService.kt`)
- Shortcuts → Main activity: routes entry (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/EntryIntents.kt`)
- Main activity → App shell: renders (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/MainActivity.kt`)
- Reporter → Evidence capture: captures evidence (evidence: `README.md`)
- Evidence capture → Evidence tools: reads metadata (evidence: `README.md`)
- Evidence capture → Report review: opens review (evidence: `README.md`)
- Report review → Plate recognition: recognizes plate (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt`)
- Report review → Evidence tools: requests address suggestions (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt`)
- Report review → Review draft: updates draft (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ui/ReviewScreen.kt`)
- Report review → Topic catalog: loads topics (evidence: `README.md`)
- Report review → Registry status: shows status (evidence: `README.md`)
- Registry status → Vehicle and tag lookup: checks registries (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ui/RegistryStatus.kt`)
- Vehicle and tag lookup → Public registries: queries (evidence: `README.md`)
- Review draft → Encrypted ledger: saves locally (evidence: `README.md`)
- Encrypted ledger → Room database: reads and writes (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/ledger/EncryptedLedgerRepository.kt`)
- Reporter → Encrypted settings: configures (evidence: `README.md`)
- Report review → Submission coordinator: requests approved send (evidence: `README.md`)
- Submission coordinator → Municipal client: dispatches submission (evidence: `README.md`)
- Municipal client → Municipal service: sends case and photo (evidence: `app/src/main/java/io/github/reihlinstinct/reporter/municipal/MunicipalClient.kt`)
