# dilipanmano/electricitybill architecture

> Architecture diagram of the GitHub repository dilipanmano/electricitybill, 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/dilipanmano/electricitybill
- Repository: https://github.com/dilipanmano/electricitybill

## Overview

ElectricityBill is a small command-line electricity billing application. A user enters current and previous meter readings plus a connection type; EBMain passes them to ConnectionService, which validates the inputs, selects domestic or commercial tariff calculation, and formats a bill or error message for display. The entity layer contains the shared connection abstraction and the two tariff calculators. The excerpts show these main relationships; no broader capabilities are documented.

Main entry points: [`src/com/w/eb/service/ConnectionService.java`](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/service/ConnectionService.java) (ConnectionService), [`src/com/w/eb/main/EBMain.java`](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/main/EBMain.java) (EBMain), [`src/com/w/eb/entity/Domestic.java`](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Domestic.java) (Domestic tariff), [`src/com/w/eb/entity/Commercial.java`](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Commercial.java) (Commercial tariff)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command-line entry"]
  node_main["EBMain<br/>[EBMain.java]"]
end

subgraph group_service["Billing service"]
  node_service["ConnectionService"]
end

subgraph group_entities["Tariff entities"]
  node_domestic["Domestic tariff<br/>[Domestic.java]"]
  node_commercial["Commercial tariff<br/>[Commercial.java]"]
  node_connection["Connection base<br/>[Connection.java]"]
end

subgraph group_errors["Validation errors"]
  node_invalid_reading["Invalid reading"]
  node_invalid_connection["Invalid connection"]
end

node_user(("User"))

node_user -->|"enters readings"| node_main
node_main -->|"requests bill"| node_service
node_service -->|"calculates domestic"| node_domestic
node_service -->|"calculates commercial"| node_commercial
node_service -->|"throws or catches"| node_invalid_reading
node_service -->|"throws or catches"| node_invalid_connection
node_domestic -->|"extends"| node_connection
node_commercial -->|"extends"| node_connection
node_service -->|"returns bill text"| node_main
node_main -->|"displays result"| node_user

click node_main "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/main/EBMain.java"
click node_service "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/service/ConnectionService.java"
click node_domestic "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Domestic.java"
click node_commercial "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Commercial.java"
click node_connection "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Connection.java"
click node_invalid_reading "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/exception/InvalidReadingException.java"
click node_invalid_connection "https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/exception/InvalidConnectionException.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_service toneAmber
class node_domestic,node_commercial,node_connection toneMint
class node_invalid_reading,node_invalid_connection toneRose
```

## Components

### Command-line entry

- [EBMain](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/main/EBMain.java): `src/com/w/eb/main/EBMain.java`

### Billing service

- [ConnectionService](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/service/ConnectionService.java): `src/com/w/eb/service/ConnectionService.java`

### Tariff entities

- [Domestic tariff](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Domestic.java): `src/com/w/eb/entity/Domestic.java`
- [Commercial tariff](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Commercial.java): `src/com/w/eb/entity/Commercial.java`
- [Connection base](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/entity/Connection.java): `src/com/w/eb/entity/Connection.java`

### Validation errors

- [Invalid reading](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/exception/InvalidReadingException.java): `src/com/w/eb/exception/InvalidReadingException.java`
- [Invalid connection](https://github.com/dilipanmano/electricitybill/blob/master/src/com/w/eb/exception/InvalidConnectionException.java): `src/com/w/eb/exception/InvalidConnectionException.java`

### Other components

- **User**

## Connections

- User → EBMain: enters readings (evidence: `src/com/w/eb/main/EBMain.java`)
- EBMain → ConnectionService: requests bill (evidence: `src/com/w/eb/main/EBMain.java`)
- ConnectionService → Domestic tariff: calculates domestic (evidence: `src/com/w/eb/service/ConnectionService.java`)
- ConnectionService → Commercial tariff: calculates commercial (evidence: `src/com/w/eb/service/ConnectionService.java`)
- ConnectionService → Invalid reading: throws or catches (evidence: `src/com/w/eb/service/ConnectionService.java`)
- ConnectionService → Invalid connection: throws or catches (evidence: `src/com/w/eb/service/ConnectionService.java`)
- Domestic tariff → Connection base: extends (evidence: `src/com/w/eb/entity/Domestic.java`)
- Commercial tariff → Connection base: extends (evidence: `src/com/w/eb/entity/Commercial.java`)
- ConnectionService → EBMain: returns bill text (evidence: `src/com/w/eb/main/EBMain.java`)
- EBMain → User: displays result (evidence: `src/com/w/eb/main/EBMain.java`)
