# mhdn585/bc-rust architecture

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

- Interactive diagram: https://gitdiagram.com/mhdn585/bc-rust
- Repository: https://github.com/mhdn585/bc-rust

## Overview

Mercury is a local terminal application for generating a fixed supply of encrypted coin records, then mining coins incrementally to accrue fractional USD value. The user enters through the CLI; generation and mining are the principal workflows, with status reporting and integrity verification as supporting operations. SQLite stores coin, balance, and transaction state. Configuration, economics, cryptography, and key derivation provide shared internal rules and services. The map follows the main dispatch and documented module references; some subsystem internals were not sampled, so uncertain connections are omitted.

Main entry points: [`src/main.rs`](https://github.com/mhdn585/bc-rust/blob/main/src/main.rs) (CLI dispatcher), [`src/mining.rs`](https://github.com/mhdn585/bc-rust/blob/main/src/mining.rs) (Incremental mining), [`src/verification.rs`](https://github.com/mhdn585/bc-rust/blob/main/src/verification.rs) (Integrity verification), [`src/ui.rs`](https://github.com/mhdn585/bc-rust/blob/main/src/ui.rs) (Status and prompts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and operations"]
  node_app["CLI dispatcher<br/>[main.rs]"]
  node_terminal["Terminal input<br/>[terminal.rs]"]
  node_ui["Status and prompts<br/>[ui.rs]"]
  node_lock["Process lock<br/>[lock.rs]"]
  node_maintenance["Database maintenance<br/>[maintenance.rs]"]
end

subgraph group_coinwork["Coin workflows"]
  node_generation["Coin generation<br/>[generation.rs]"]
  node_mining["Incremental mining<br/>[mining.rs]"]
  node_verification["Integrity verification<br/>[verification.rs]"]
end

subgraph group_core["Domain services"]
  node_domain["Coin and account models<br/>[domain.rs]"]
  node_economics["Mining economics<br/>[economics.rs]"]
  node_crypto["Encryption and indexes<br/>[crypto.rs]"]
  node_keys["Key derivation<br/>[key.rs]"]
  node_config["Runtime configuration<br/>[config.rs]"]
  node_logging["Rotating logs<br/>[logging.rs]"]
end

subgraph group_persistence["Persistence and integrity"]
  node_repositories["Coin and ledger queries<br/>[repositories.rs]"]
  node_db[("SQLite connection<br/>[db.rs]")]
  node_migrations["Schema migrations<br/>[migrations.rs]"]
end

node_user(("Operator"))

node_user -->|"uses"| node_app
node_app -->|"dispatches"| node_generation
node_app -->|"dispatches"| node_mining
node_app -->|"dispatches"| node_verification
node_app -->|"dispatches"| node_maintenance
node_app -->|"acquires"| node_lock
node_app -->|"initializes"| node_db
node_app -->|"renders"| node_ui
node_app -->|"initializes"| node_logging
node_ui -->|"reads input"| node_terminal
node_generation -->|"encrypts IDs"| node_crypto
node_generation -->|"derives keys"| node_keys
node_generation -->|"persists coins"| node_repositories
node_generation -->|"builds records"| node_domain
node_generation -->|"reports progress"| node_ui
node_generation -->|"logs activity"| node_logging
node_mining -->|"updates ledger"| node_repositories
node_mining -->|"calculates increments"| node_economics
node_mining -->|"uses cryptography"| node_crypto
node_mining -->|"derives keys"| node_keys
node_mining -->|"uses coin state"| node_domain
node_mining -->|"reports progress"| node_ui
node_mining -->|"handles input"| node_terminal
node_mining -->|"logs activity"| node_logging
node_verification -->|"checks integrity"| node_db
node_verification -->|"checks schema"| node_migrations
node_verification -->|"checks statistics"| node_repositories
node_verification -->|"checks payloads"| node_crypto
node_verification -->|"uses derived keys"| node_keys
node_verification -->|"builds report"| node_domain
node_verification -->|"reports results"| node_ui
node_repositories -->|"maps records"| node_domain
node_repositories -->|"validates amounts"| node_economics
node_domain -->|"validates state"| node_economics
node_domain -->|"validates payloads"| node_crypto
node_domain -->|"checks limits"| node_config
node_crypto -->|"uses derived keys"| node_keys
node_crypto -->|"uses constants"| node_config
node_economics -->|"uses constants"| node_config
node_ui -->|"displays state"| node_domain
node_ui -->|"formats values"| node_economics
node_db -->|"runs migrations"| node_migrations
node_db -->|"selects database"| node_config
node_db -->|"logs initialization"| node_logging
node_maintenance -->|"maintains database"| node_db
node_maintenance -->|"reports operations"| node_ui
node_migrations -->|"uses schema limits"| node_config
node_lock -->|"uses lock path"| node_config

click node_app "https://github.com/mhdn585/bc-rust/blob/main/src/main.rs"
click node_terminal "https://github.com/mhdn585/bc-rust/blob/main/src/terminal.rs"
click node_ui "https://github.com/mhdn585/bc-rust/blob/main/src/ui.rs"
click node_lock "https://github.com/mhdn585/bc-rust/blob/main/src/lock.rs"
click node_maintenance "https://github.com/mhdn585/bc-rust/blob/main/src/maintenance.rs"
click node_generation "https://github.com/mhdn585/bc-rust/blob/main/src/generation.rs"
click node_mining "https://github.com/mhdn585/bc-rust/blob/main/src/mining.rs"
click node_verification "https://github.com/mhdn585/bc-rust/blob/main/src/verification.rs"
click node_domain "https://github.com/mhdn585/bc-rust/blob/main/src/domain.rs"
click node_economics "https://github.com/mhdn585/bc-rust/blob/main/src/economics.rs"
click node_crypto "https://github.com/mhdn585/bc-rust/blob/main/src/crypto.rs"
click node_keys "https://github.com/mhdn585/bc-rust/blob/main/src/key.rs"
click node_config "https://github.com/mhdn585/bc-rust/blob/main/src/config.rs"
click node_logging "https://github.com/mhdn585/bc-rust/blob/main/src/logging.rs"
click node_repositories "https://github.com/mhdn585/bc-rust/blob/main/src/repositories.rs"
click node_db "https://github.com/mhdn585/bc-rust/blob/main/src/db.rs"
click node_migrations "https://github.com/mhdn585/bc-rust/blob/main/src/migrations.rs"

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_terminal,node_ui,node_lock,node_maintenance toneBlue
class node_generation,node_mining,node_verification toneAmber
class node_domain,node_economics,node_crypto,node_keys,node_config,node_logging toneMint
class node_repositories,node_db,node_migrations toneRose
class node_user toneIndigo
```

## Components

### CLI and operations

- [CLI dispatcher](https://github.com/mhdn585/bc-rust/blob/main/src/main.rs): `src/main.rs`
- [Terminal input](https://github.com/mhdn585/bc-rust/blob/main/src/terminal.rs): `src/terminal.rs`
- [Status and prompts](https://github.com/mhdn585/bc-rust/blob/main/src/ui.rs): `src/ui.rs`
- [Process lock](https://github.com/mhdn585/bc-rust/blob/main/src/lock.rs): `src/lock.rs`
- [Database maintenance](https://github.com/mhdn585/bc-rust/blob/main/src/maintenance.rs): `src/maintenance.rs`

### Coin workflows

- [Coin generation](https://github.com/mhdn585/bc-rust/blob/main/src/generation.rs): `src/generation.rs`
- [Incremental mining](https://github.com/mhdn585/bc-rust/blob/main/src/mining.rs): `src/mining.rs`
- [Integrity verification](https://github.com/mhdn585/bc-rust/blob/main/src/verification.rs): `src/verification.rs`

### Domain services

- [Coin and account models](https://github.com/mhdn585/bc-rust/blob/main/src/domain.rs): `src/domain.rs`
- [Mining economics](https://github.com/mhdn585/bc-rust/blob/main/src/economics.rs): `src/economics.rs`
- [Encryption and indexes](https://github.com/mhdn585/bc-rust/blob/main/src/crypto.rs): `src/crypto.rs`
- [Key derivation](https://github.com/mhdn585/bc-rust/blob/main/src/key.rs): `src/key.rs`
- [Runtime configuration](https://github.com/mhdn585/bc-rust/blob/main/src/config.rs): `src/config.rs`
- [Rotating logs](https://github.com/mhdn585/bc-rust/blob/main/src/logging.rs): `src/logging.rs`

### Persistence and integrity

- [Coin and ledger queries](https://github.com/mhdn585/bc-rust/blob/main/src/repositories.rs): `src/repositories.rs`
- [SQLite connection](https://github.com/mhdn585/bc-rust/blob/main/src/db.rs): `src/db.rs`
- [Schema migrations](https://github.com/mhdn585/bc-rust/blob/main/src/migrations.rs): `src/migrations.rs`

### Other components

- **Operator**

## Connections

- Operator → CLI dispatcher: uses (evidence: `src/main.rs`)
- CLI dispatcher → Coin generation: dispatches (evidence: `src/main.rs`)
- CLI dispatcher → Incremental mining: dispatches (evidence: `src/main.rs`)
- CLI dispatcher → Integrity verification: dispatches (evidence: `src/main.rs`)
- CLI dispatcher → Database maintenance: dispatches (evidence: `src/main.rs`)
- CLI dispatcher → Process lock: acquires (evidence: `src/main.rs`)
- CLI dispatcher → SQLite connection: initializes (evidence: `src/main.rs`)
- CLI dispatcher → Status and prompts: renders (evidence: `src/main.rs`)
- CLI dispatcher → Rotating logs: initializes (evidence: `src/main.rs`)
- Status and prompts → Terminal input: reads input (evidence: `src/ui.rs`)
- Coin generation → Encryption and indexes: encrypts IDs (evidence: `src/generation.rs`)
- Coin generation → Key derivation: derives keys (evidence: `src/generation.rs`)
- Coin generation → Coin and ledger queries: persists coins (evidence: `src/generation.rs`)
- Coin generation → Coin and account models: builds records (evidence: `src/generation.rs`)
- Coin generation → Status and prompts: reports progress (evidence: `src/generation.rs`)
- Coin generation → Rotating logs: logs activity (evidence: `src/generation.rs`)
- Incremental mining → Coin and ledger queries: updates ledger (evidence: `src/mining.rs`)
- Incremental mining → Mining economics: calculates increments (evidence: `src/mining.rs`)
- Incremental mining → Encryption and indexes: uses cryptography (evidence: `src/mining.rs`)
- Incremental mining → Key derivation: derives keys (evidence: `src/mining.rs`)
- Incremental mining → Coin and account models: uses coin state (evidence: `src/mining.rs`)
- Incremental mining → Status and prompts: reports progress (evidence: `src/mining.rs`)
- Incremental mining → Terminal input: handles input (evidence: `src/mining.rs`)
- Incremental mining → Rotating logs: logs activity (evidence: `src/mining.rs`)
- Integrity verification → SQLite connection: checks integrity (evidence: `src/verification.rs`)
- Integrity verification → Schema migrations: checks schema (evidence: `src/verification.rs`)
- Integrity verification → Coin and ledger queries: checks statistics (evidence: `src/verification.rs`)
- Integrity verification → Encryption and indexes: checks payloads (evidence: `src/verification.rs`)
- Integrity verification → Key derivation: uses derived keys (evidence: `src/verification.rs`)
- Integrity verification → Coin and account models: builds report (evidence: `src/verification.rs`)
- Integrity verification → Status and prompts: reports results (evidence: `src/verification.rs`)
- Coin and ledger queries → Coin and account models: maps records (evidence: `src/repositories.rs`)
- Coin and ledger queries → Mining economics: validates amounts (evidence: `src/repositories.rs`)
- Coin and account models → Mining economics: validates state (evidence: `src/domain.rs`)
- Coin and account models → Encryption and indexes: validates payloads (evidence: `src/domain.rs`)
- Coin and account models → Runtime configuration: checks limits (evidence: `src/domain.rs`)
- Encryption and indexes → Key derivation: uses derived keys (evidence: `src/crypto.rs`)
- Encryption and indexes → Runtime configuration: uses constants (evidence: `src/crypto.rs`)
- Mining economics → Runtime configuration: uses constants (evidence: `src/economics.rs`)
- Status and prompts → Coin and account models: displays state (evidence: `src/ui.rs`)
- Status and prompts → Mining economics: formats values (evidence: `src/ui.rs`)
- SQLite connection → Schema migrations: runs migrations (evidence: `src/db.rs`)
- SQLite connection → Runtime configuration: selects database (evidence: `src/db.rs`)
- SQLite connection → Rotating logs: logs initialization (evidence: `src/db.rs`)
- Database maintenance → SQLite connection: maintains database (evidence: `src/maintenance.rs`)
- Database maintenance → Status and prompts: reports operations (evidence: `src/maintenance.rs`)
- Schema migrations → Runtime configuration: uses schema limits (evidence: `src/migrations.rs`)
- Process lock → Runtime configuration: uses lock path (evidence: `src/lock.rs`)
