# pavankumar127-lang/e025-ece-005 architecture

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

- Interactive diagram: https://gitdiagram.com/pavankumar127-lang/e025-ece-005
- Repository: https://github.com/pavankumar127-lang/e025-ece-005

## Overview

This repository is a command-driven prepaid IoT SIM pooled-data engine. Its main workflow reads commands and CSV inputs, applies dated account/SIM/pack operations, processes usage and pooled balances chronologically, then exports state, pool, error, and billing results. The sampled implementation concentrates most domain behavior in engine.py, with main.py coordinating it. models.py contains a separate, simpler account/SIM/pack and usage API; the excerpts do not show it wired into the command-line workflow. Several engine internals and command-file contents were not sampled, so those links are omitted.

Main entry points: [`engine.py`](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py) (Pooled data engine), [`main.py`](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/main.py) (Command runner), [`commands.txt`](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/commands.txt) (Command input), [`models.py`](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/models.py) (Basic management API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Command workflow"]
  node_commands["Command input<br/>[commands.txt]"]
  node_runner["Command runner<br/>[main.py]"]
end

subgraph group_domain["SIM and pool domain"]
  node_engine["Pooled data engine<br/>[engine.py]"]
  node_accounts["Accounts<br/>[engine.py]"]
  node_sims["SIM lifecycle<br/>[engine.py]"]
  node_packs["Pack purchasing<br/>[engine.py]"]
end

subgraph group_billing["Usage and billing"]
  node_usage["Usage validation<br/>[engine.py]"]
  node_pooling["Pool accounting<br/>[engine.py]"]
  node_statements["Statement generation<br/>[engine.py]"]
end

subgraph group_artifacts["CSV artifacts"]
  node_simstates["SIM state export<br/>[sim_states.csv]"]
  node_errors["Error export<br/>[errors.csv]"]
  node_poollog["Pool log export<br/>[pool_log.csv]"]
  node_statementfile["Statements export<br/>[statements.csv]"]
end

subgraph group_legacy["Standalone model API"]
  node_modelapi["Basic management API<br/>[models.py]"]
  node_modeldata[("In-memory model data<br/>[models.py]")]
end

node_operator(("Operator"))

node_operator -->|"runs"| node_runner
node_commands -->|"reads"| node_runner
node_runner -->|"dispatches"| node_engine
node_engine -->|"manages"| node_accounts
node_engine -->|"manages"| node_sims
node_engine -->|"purchases"| node_packs
node_engine -->|"validates"| node_usage
node_engine -->|"calculates"| node_pooling
node_engine -->|"generates"| node_statements
node_runner -->|"processes days"| node_engine
node_engine -->|"writes"| node_simstates
node_engine -->|"writes"| node_errors
node_engine -->|"writes"| node_poollog
node_engine -->|"writes"| node_statementfile
node_modelapi -->|"updates"| node_modeldata

click node_commands "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/commands.txt"
click node_runner "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/main.py"
click node_engine "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_accounts "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_sims "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_packs "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_usage "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_pooling "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_statements "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py"
click node_simstates "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/sim_states.csv"
click node_errors "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/errors.csv"
click node_poollog "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/pool_log.csv"
click node_statementfile "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/statements.csv"
click node_modelapi "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/models.py"
click node_modeldata "https://github.com/pavankumar127-lang/e025-ece-005/blob/main/models.py"

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_commands,node_runner toneBlue
class node_engine,node_accounts,node_sims,node_packs toneAmber
class node_usage,node_pooling,node_statements toneMint
class node_simstates,node_errors,node_poollog,node_statementfile toneRose
class node_modelapi,node_modeldata,node_operator toneIndigo
```

## Components

### Command workflow

- [Command input](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/commands.txt): `commands.txt`
- [Command runner](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/main.py): `main.py`

### SIM and pool domain

- [Pooled data engine](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`
- [Accounts](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`
- [SIM lifecycle](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`
- [Pack purchasing](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`

### Usage and billing

- [Usage validation](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`
- [Pool accounting](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`
- [Statement generation](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/engine.py): `engine.py`

### CSV artifacts

- [SIM state export](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/sim_states.csv): `sim_states.csv`
- [Error export](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/errors.csv): `errors.csv`
- [Pool log export](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/pool_log.csv): `pool_log.csv`
- [Statements export](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/statements.csv): `statements.csv`

### Standalone model API

- [Basic management API](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/models.py): `models.py`
- [In-memory model data](https://github.com/pavankumar127-lang/e025-ece-005/blob/main/models.py): `models.py`

### Other components

- **Operator**

## Connections

- Operator → Command runner: runs (evidence: `README.md`)
- Command input → Command runner: reads (evidence: `main.py`)
- Command runner → Pooled data engine: dispatches (evidence: `main.py`)
- Pooled data engine → Accounts: manages (evidence: `engine.py`)
- Pooled data engine → SIM lifecycle: manages (evidence: `engine.py`)
- Pooled data engine → Pack purchasing: purchases (evidence: `engine.py`)
- Pooled data engine → Usage validation: validates (evidence: `engine.py`)
- Pooled data engine → Pool accounting: calculates (evidence: `engine.py`)
- Pooled data engine → Statement generation: generates (evidence: `engine.py`)
- Command runner → Pooled data engine: processes days (evidence: `main.py`)
- Pooled data engine → SIM state export: writes (evidence: `engine.py`)
- Pooled data engine → Error export: writes (evidence: `engine.py`)
- Pooled data engine → Pool log export: writes (evidence: `engine.py`)
- Pooled data engine → Statements export: writes (evidence: `engine.py`)
- Basic management API → In-memory model data: updates (evidence: `models.py`)
