# m000gg/unit-billing architecture

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

- Interactive diagram: https://gitdiagram.com/m000gg/unit-billing
- Repository: https://github.com/m000gg/unit-billing

## Overview

Unit Billing is a Spring-based modular monolith for subscriber administration and account billing. Admins manage subscriber profiles and post balance changes; subscribers use a self-service portal to view account status and transaction history. The ledger supports audited transaction types and multicurrency amounts, with platform base currency configured during setup. The graph emphasizes these evidenced runtime paths; the README also describes broader subscription/service-provisioning ambitions, but corresponding catalog and subscription modules are absent from the supplied tree. Some unexcerpted links are supported only by SOURCE INDEX references.

Main entry points: [`src/main/java/com.m000gg.billing/ledger/LedgerService.java`](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerService.java) (Ledger operations), [`src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java`](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java) (Ledger admin), [`src/main/java/com.m000gg.billing/subscribers/ApplicationUserManagementService.java`](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUserManagementService.java) (Account management), [`src/main/java/com.m000gg.billing/subscribers/ApplicationUserRepository.java`](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUserRepository.java) (Subscriber records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_admin_users["Subscriber admin"]
  node_admin_ledger["Ledger admin"]
  node_client_profile["Client portal"]
  node_setup_web["Setup endpoint"]
end

subgraph group_accounts["Subscriber accounts"]
  node_accounts_service["Account management"]
  node_accounts_store[("Subscriber records")]
  node_account_entity["Subscriber account"]
end

subgraph group_billing["Billing ledger"]
  node_ledger_service["Ledger operations<br/>[LedgerService.java]"]
  node_ledger_store[("Ledger entries")]
  node_ledger_entity["Ledger entry<br/>[LedgerEntry.java]"]
end

subgraph group_platform["Identity and setup"]
  node_identity_service["Login identity"]
  node_admin_store[("Admin records")]
  node_currency_setup["Currency settings"]
  node_settings_store[("System settings")]
end

node_admin_actor(("Administrator"))
node_subscriber_actor(("Subscriber"))

node_admin_actor -->|"manages users"| node_admin_users
node_admin_actor -->|"posts adjustments"| node_admin_ledger
node_subscriber_actor -->|"views account"| node_client_profile
node_admin_users -->|"manages accounts"| node_accounts_service
node_admin_users -->|"loads history"| node_ledger_service
node_admin_ledger -->|"loads subscriber"| node_accounts_service
node_admin_ledger -->|"posts transactions"| node_ledger_service
node_admin_ledger -->|"reads base currency"| node_currency_setup
node_client_profile -->|"loads profile"| node_accounts_service
node_client_profile -->|"loads history"| node_ledger_service
node_setup_web -->|"configures currency"| node_currency_setup
node_accounts_service -->|"reads and writes"| node_accounts_store
node_accounts_store -->|"persists"| node_account_entity
node_identity_service -->|"looks up users"| node_accounts_store
node_identity_service -->|"looks up admins"| node_admin_store
node_ledger_service -->|"reads and writes"| node_ledger_store
node_ledger_service -->|"updates balances"| node_accounts_store
node_ledger_store -->|"persists"| node_ledger_entity
node_currency_setup -->|"reads and writes"| node_settings_store

click node_admin_users "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/ApplicationUserAdminController.java"
click node_admin_ledger "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java"
click node_client_profile "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/client/UserProfileController.java"
click node_setup_web "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/AdminSetupController.java"
click node_accounts_service "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUserManagementService.java"
click node_accounts_store "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUserRepository.java"
click node_account_entity "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUser.java"
click node_identity_service "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/identity/ApplicationUserDetailsService.java"
click node_admin_store "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/identity/AdminRepository.java"
click node_ledger_service "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerService.java"
click node_ledger_store "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerEntryRepository.java"
click node_ledger_entity "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerEntry.java"
click node_currency_setup "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/settings/SystemSettingService.java"
click node_settings_store "https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/settings/SystemSettingRepository.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_admin_users,node_admin_ledger,node_client_profile,node_setup_web toneBlue
class node_accounts_service,node_accounts_store,node_account_entity toneAmber
class node_ledger_service,node_ledger_store,node_ledger_entity toneMint
class node_identity_service,node_admin_store,node_currency_setup,node_settings_store toneRose
class node_admin_actor,node_subscriber_actor toneIndigo
```

## Components

### Web workflows

- [Subscriber admin](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/ApplicationUserAdminController.java): `src/main/java/com.m000gg.billing/web/admin/ApplicationUserAdminController.java`
- [Ledger admin](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java): `src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java`
- [Client portal](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/client/UserProfileController.java): `src/main/java/com.m000gg.billing/web/client/UserProfileController.java`
- [Setup endpoint](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/web/admin/AdminSetupController.java): `src/main/java/com.m000gg.billing/web/admin/AdminSetupController.java`

### Subscriber accounts

- [Account management](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUserManagementService.java): `src/main/java/com.m000gg.billing/subscribers/ApplicationUserManagementService.java`
- [Subscriber records](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUserRepository.java): `src/main/java/com.m000gg.billing/subscribers/ApplicationUserRepository.java`
- [Subscriber account](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/subscribers/ApplicationUser.java): `src/main/java/com.m000gg.billing/subscribers/ApplicationUser.java`

### Billing ledger

- [Ledger operations](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerService.java): `src/main/java/com.m000gg.billing/ledger/LedgerService.java`
- [Ledger entries](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerEntryRepository.java): `src/main/java/com.m000gg.billing/ledger/LedgerEntryRepository.java`
- [Ledger entry](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/ledger/LedgerEntry.java): `src/main/java/com.m000gg.billing/ledger/LedgerEntry.java`

### Identity and setup

- [Login identity](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/identity/ApplicationUserDetailsService.java): `src/main/java/com.m000gg.billing/identity/ApplicationUserDetailsService.java`
- [Admin records](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/identity/AdminRepository.java): `src/main/java/com.m000gg.billing/identity/AdminRepository.java`
- [Currency settings](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/settings/SystemSettingService.java): `src/main/java/com.m000gg.billing/settings/SystemSettingService.java`
- [System settings](https://github.com/m000gg/unit-billing/blob/main/src/main/java/com.m000gg.billing/settings/SystemSettingRepository.java): `src/main/java/com.m000gg.billing/settings/SystemSettingRepository.java`

### Other components

- **Administrator**
- **Subscriber**

## Connections

- Administrator → Subscriber admin: manages users (evidence: `README.md`)
- Administrator → Ledger admin: posts adjustments (evidence: `README.md`)
- Subscriber → Client portal: views account (evidence: `README.md`)
- Subscriber admin → Account management: manages accounts (evidence: `src/main/java/com.m000gg.billing/web/admin/ApplicationUserAdminController.java`)
- Subscriber admin → Ledger operations: loads history (evidence: `src/main/java/com.m000gg.billing/web/admin/ApplicationUserAdminController.java`)
- Ledger admin → Account management: loads subscriber (evidence: `src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java`)
- Ledger admin → Ledger operations: posts transactions (evidence: `src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java`)
- Ledger admin → Currency settings: reads base currency (evidence: `src/main/java/com.m000gg.billing/web/admin/LedgerEntryAdminController.java`)
- Client portal → Account management: loads profile (evidence: `src/main/java/com.m000gg.billing/web/client/UserProfileController.java`)
- Client portal → Ledger operations: loads history (evidence: `src/main/java/com.m000gg.billing/web/client/UserProfileController.java`)
- Setup endpoint → Currency settings: configures currency (evidence: `src/main/java/com.m000gg.billing/web/admin/AdminSetupController.java`)
- Account management → Subscriber records: reads and writes (evidence: `src/main/java/com.m000gg.billing/subscribers/ApplicationUserManagementService.java`)
- Subscriber records → Subscriber account: persists (evidence: `src/main/java/com.m000gg.billing/subscribers/ApplicationUserRepository.java`)
- Login identity → Subscriber records: looks up users (evidence: `src/main/java/com.m000gg.billing/identity/ApplicationUserDetailsService.java`)
- Login identity → Admin records: looks up admins (evidence: `src/main/java/com.m000gg.billing/identity/ApplicationUserDetailsService.java`)
- Ledger operations → Ledger entries: reads and writes (evidence: `src/main/java/com.m000gg.billing/ledger/LedgerService.java`)
- Ledger operations → Subscriber records: updates balances (evidence: `src/main/java/com.m000gg.billing/ledger/LedgerService.java`)
- Ledger entries → Ledger entry: persists (evidence: `src/main/java/com.m000gg.billing/ledger/LedgerEntryRepository.java`)
- Currency settings → System settings: reads and writes (evidence: `src/main/java/com.m000gg.billing/settings/SystemSettingService.java`)
