# ikbalgumilar/cek-pbb-cianjur architecture

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

- Interactive diagram: https://gitdiagram.com/ikbalgumilar/cek-pbb-cianjur
- Repository: https://github.com/ikbalgumilar/cek-pbb-cianjur

## Overview

Cek PBB Cianjur is a cross-platform Flutter application for PBB-P2 checking and field operations. The user workflow starts with a bill lookup, presents payment and tax details, and supports QRIS/virtual-account payment; staff also manage DHKP records, monitor collections, analyze performance, and report results. The graph preserves the README’s major feature branches and uses listed source paths for implementation nodes. Dart implementation excerpts were not provided, so relationships are limited to capabilities explicitly documented in the README; unsampled internals are not asserted.

Main entry points: [`lib/main.dart`](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/main.dart) (Flutter app), [`lib/pbb_client.dart`](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/pbb_client.dart) (PBB lookup), [`lib/result_screen.dart`](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/result_screen.dart) (Bill results), [`lib/qris_view_screen.dart`](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/qris_view_screen.dart) (Digital payment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and lookup"]
  node_app["Flutter app<br/>[main.dart]"]
  node_bill["PBB lookup<br/>[pbb_client.dart]"]
  node_result["Bill results<br/>[result_screen.dart]"]
  node_payment["Digital payment"]
  node_batch["Batch checking"]
end

subgraph group_operations["Tax operations"]
  node_dhkp[("DHKP records")]
  node_calculator["Tax calculators"]
  node_analytics["Revenue analytics"]
  node_monitor["Area monitoring"]
  node_reports["Report exports"]
  node_map["Tax map"]
end

subgraph group_field["Field services"]
  node_staff["Staff portal"]
  node_vehicle["Vehicle tax"]
  node_desil["Benefits status<br/>[desil_view.dart]"]
end

subgraph group_support["Data and support"]
  node_imports["Data import<br/>[import_view.dart]"]
  node_spreadsheet["Spreadsheet viewer"]
  node_backup["Encrypted backup<br/>[backup_crypto.dart]"]
  node_guide["User guide"]
  node_connectivity["Connectivity status"]
end

node_user(("Field staff"))
node_bapenda["BAPENDA portal"]
node_bjb["Bank bjb"]
node_kemensos["Kemensos service"]
node_drive["Google Drive"]

node_user -->|"uses"| node_app
node_app -->|"offers lookup"| node_bill
node_bill -->|"queries"| node_bapenda
node_bill -->|"shows details"| node_result
node_result -->|"starts payment"| node_payment
node_payment -->|"creates account"| node_bjb
node_app -->|"offers batch checks"| node_batch
node_user -->|"manages records"| node_dhkp
node_user -->|"simulates tax"| node_calculator
node_user -->|"reviews trends"| node_analytics
node_user -->|"monitors areas"| node_monitor
node_monitor -->|"exports results"| node_reports
node_user -->|"views parcels"| node_map
node_user -->|"uses staff portal"| node_staff
node_user -->|"checks vehicle tax"| node_vehicle
node_user -->|"checks benefits"| node_desil
node_desil -->|"queries status"| node_kemensos
node_user -->|"imports records"| node_imports
node_imports -->|"opens sheets"| node_spreadsheet
node_user -->|"backs up data"| node_backup
node_backup -->|"stores backup"| node_drive
node_user -->|"consults guide"| node_guide
node_app -.->|"shows status"| node_connectivity

click node_app "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/main.dart"
click node_bill "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/pbb_client.dart"
click node_result "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/result_screen.dart"
click node_payment "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/qris_view_screen.dart"
click node_batch "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/batch_check_screen.dart"
click node_dhkp "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/blok_data_store.dart"
click node_calculator "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/calculator/pbb_calculator_models.dart"
click node_analytics "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/dhkp/dhkp_grafik_analytics.dart"
click node_monitor "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/monitoring/monitoring_wilayah_screen.dart"
click node_reports "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/blok_report_exporter.dart"
click node_map "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/map/dhkp_map_screen.dart"
click node_staff "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/staff_portal_client.dart"
click node_vehicle "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/kendaraan/kendaraan_view.dart"
click node_desil "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/desil/desil_view.dart"
click node_imports "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/import_view.dart"
click node_spreadsheet "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/spreadsheet_viewer_screen.dart"
click node_backup "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/backup_crypto.dart"
click node_guide "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/settings/user_guide_screen.dart"
click node_connectivity "https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/connectivity_monitor.dart"

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_bill,node_result,node_payment,node_batch toneBlue
class node_dhkp,node_calculator,node_analytics,node_monitor,node_reports,node_map toneAmber
class node_staff,node_vehicle,node_desil toneMint
class node_imports,node_spreadsheet,node_backup,node_guide,node_connectivity toneRose
class node_user,node_bapenda,node_bjb,node_kemensos,node_drive toneIndigo
```

## Components

### App and lookup

- [Flutter app](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/main.dart): `lib/main.dart`
- [PBB lookup](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/pbb_client.dart): `lib/pbb_client.dart`
- [Bill results](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/result_screen.dart): `lib/result_screen.dart`
- [Digital payment](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/qris_view_screen.dart): `lib/qris_view_screen.dart`
- [Batch checking](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/batch_check_screen.dart): `lib/batch_check_screen.dart`

### Tax operations

- [DHKP records](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/blok_data_store.dart): `lib/blok_data_store.dart`
- [Tax calculators](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/calculator/pbb_calculator_models.dart): `lib/calculator/pbb_calculator_models.dart`
- [Revenue analytics](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/dhkp/dhkp_grafik_analytics.dart): `lib/dhkp/dhkp_grafik_analytics.dart`
- [Area monitoring](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/monitoring/monitoring_wilayah_screen.dart): `lib/monitoring/monitoring_wilayah_screen.dart`
- [Report exports](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/blok_report_exporter.dart): `lib/blok_report_exporter.dart`
- [Tax map](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/map/dhkp_map_screen.dart): `lib/map/dhkp_map_screen.dart`

### Field services

- [Staff portal](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/staff_portal_client.dart): `lib/staff_portal_client.dart`
- [Vehicle tax](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/kendaraan/kendaraan_view.dart): `lib/kendaraan/kendaraan_view.dart`
- [Benefits status](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/desil/desil_view.dart): `lib/desil/desil_view.dart`

### Data and support

- [Data import](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/import_view.dart): `lib/import_view.dart`
- [Spreadsheet viewer](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/spreadsheet_viewer_screen.dart): `lib/spreadsheet_viewer_screen.dart`
- [Encrypted backup](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/backup_crypto.dart): `lib/backup_crypto.dart`
- [User guide](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/settings/user_guide_screen.dart): `lib/settings/user_guide_screen.dart`
- [Connectivity status](https://github.com/ikbalgumilar/cek-pbb-cianjur/blob/main/lib/connectivity_monitor.dart): `lib/connectivity_monitor.dart`

### Other components

- **Field staff**
- **BAPENDA portal**
- **Bank bjb**
- **Kemensos service**
- **Google Drive**

## Connections

- Field staff → Flutter app: uses (evidence: `README.md`)
- Flutter app → PBB lookup: offers lookup (evidence: `README.md`)
- PBB lookup → BAPENDA portal: queries (evidence: `README.md`)
- PBB lookup → Bill results: shows details (evidence: `README.md`)
- Bill results → Digital payment: starts payment (evidence: `README.md`)
- Digital payment → Bank bjb: creates account (evidence: `README.md`)
- Flutter app → Batch checking: offers batch checks (evidence: `README.md`)
- Field staff → DHKP records: manages records (evidence: `README.md`)
- Field staff → Tax calculators: simulates tax (evidence: `README.md`)
- Field staff → Revenue analytics: reviews trends (evidence: `README.md`)
- Field staff → Area monitoring: monitors areas (evidence: `README.md`)
- Area monitoring → Report exports: exports results (evidence: `README.md`)
- Field staff → Tax map: views parcels (evidence: `README.md`)
- Field staff → Staff portal: uses staff portal (evidence: `README.md`)
- Field staff → Vehicle tax: checks vehicle tax (evidence: `README.md`)
- Field staff → Benefits status: checks benefits (evidence: `README.md`)
- Benefits status → Kemensos service: queries status (evidence: `README.md`)
- Field staff → Data import: imports records (evidence: `README.md`)
- Data import → Spreadsheet viewer: opens sheets (evidence: `README.md`)
- Field staff → Encrypted backup: backs up data (evidence: `README.md`)
- Encrypted backup → Google Drive: stores backup (evidence: `README.md`)
- Field staff → User guide: consults guide (evidence: `README.md`)
- Flutter app → Connectivity status: shows status
