# karthik0747/python-at-codegnan architecture

> Architecture diagram of the GitHub repository karthik0747/python-at-codegnan, 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/karthik0747/python-at-codegnan
- Repository: https://github.com/karthik0747/python-at-codegnan

## Overview

This repository is a collection of Python learning exercises and small CLI projects, not one integrated application. Its clearest user-to-result workflows are the government-service queue CLI (register or serve citizens, inspect queues, and export reports), the mini-bank CLI, and the calculator. The graph emphasizes those projects and the arithmetic module, while grouping standalone educational examples. The queue system also appears in a second `src/` tree; its sampled files largely duplicate the `modules/` implementation. Unsampled bank and queue details are represented only where the source index or excerpts establish them.

Main entry points: [`bank modules/mainbank.py`](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/mainbank.py) (Bank CLI), [`digital queue management system for government services/modules/main.py`](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/main.py) (Queue CLI), [`modules/small_cal.py`](https://github.com/karthik0747/python-at-codegnan/blob/main/modules/small_cal.py) (Calculator CLI), [`digital queue management system for government services/modules/file_manager.py`](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/file_manager.py) (File Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_queue["Government Queue"]
  node_queue_cli["Queue CLI<br/>[main.py]"]
  node_queue_model["Queue Operations<br/>[models.py]"]
  node_queue_utils["Input &amp; Display<br/>[utils.py]"]
  node_hours["Business Hours<br/>[service_hours.py]"]
  node_file_manager["File Manager<br/>[file_manager.py]"]
  node_queue_data[("Citizen Records &amp; Logs")]
  node_queue_errors["Queue Exceptions<br/>[exceptions.py]"]
end

subgraph group_bank["Mini Bank"]
  node_bank_cli["Bank CLI<br/>[mainbank.py]"]
  node_register["Registration<br/>[register.py]"]
  node_login["Login<br/>[login.py]"]
  node_balance["Balance Lookup<br/>[getbalance.py]"]
  node_deposit["Deposit<br/>[deposit.py]"]
  node_transfer["Transfer<br/>[transfer.py]"]
  node_statement["Mini Statement<br/>[ministatement.py]"]
  node_logout["Logout<br/>[logout.py]"]
  node_withdraw["Withdrawal<br/>[withdraw.py]"]
end

subgraph group_calc["Calculator"]
  node_calculator["Calculator CLI<br/>[small_cal.py]"]
  node_addition["Addition<br/>[addition.py]"]
  node_subtraction["Subtraction<br/>[subtraction.py]"]
  node_multiplication["Multiplication<br/>[multiplication.py]"]
  node_division["Division<br/>[division.py]"]
end

subgraph group_learning["Learning Examples"]
  node_search["Search Exercises<br/>[binarysearch.py]"]
  node_other_examples["Python Exercises"]
end

node_operator(("Citizen / Operator"))
node_bank_user(("Bank Customer"))

node_operator -->|"uses CLI"| node_queue_cli
node_queue_cli -->|"validates input"| node_queue_utils
node_queue_cli -->|"checks hours"| node_hours
node_queue_cli -->|"dispatches operations"| node_queue_model
node_queue_cli -->|"loads and saves"| node_file_manager
node_queue_cli -->|"handles errors"| node_queue_errors
node_file_manager -->|"restores citizens"| node_queue_model
node_file_manager -->|"reads and writes"| node_queue_data
node_queue_model -->|"raises exceptions"| node_queue_errors
node_bank_user -->|"uses CLI"| node_bank_cli
node_bank_cli -->|"calls registration"| node_register
node_bank_cli -->|"calls login"| node_login
node_bank_cli -->|"calls lookup"| node_balance
node_bank_cli -->|"calls deposit"| node_deposit
node_bank_cli -->|"calls transfer"| node_transfer
node_bank_cli -->|"calls statement"| node_statement
node_bank_cli -->|"calls logout"| node_logout
node_bank_cli -->|"calls withdrawal"| node_withdraw
node_calculator -->|"calls addition"| node_addition
node_calculator -->|"calls subtraction"| node_subtraction
node_calculator -->|"calls multiplication"| node_multiplication
node_calculator -->|"calls division"| node_division

click node_queue_cli "https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/main.py"
click node_queue_model "https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/models.py"
click node_queue_utils "https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/utils.py"
click node_hours "https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/service_hours.py"
click node_file_manager "https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/file_manager.py"
click node_queue_errors "https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/exceptions.py"
click node_bank_cli "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/mainbank.py"
click node_register "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/register.py"
click node_login "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/login.py"
click node_balance "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/getbalance.py"
click node_deposit "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/deposit.py"
click node_transfer "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/transfer.py"
click node_statement "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/ministatement.py"
click node_logout "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/logout.py"
click node_withdraw "https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/withdraw.py"
click node_calculator "https://github.com/karthik0747/python-at-codegnan/blob/main/modules/small_cal.py"
click node_addition "https://github.com/karthik0747/python-at-codegnan/blob/main/modules/addition.py"
click node_subtraction "https://github.com/karthik0747/python-at-codegnan/blob/main/modules/subtraction.py"
click node_multiplication "https://github.com/karthik0747/python-at-codegnan/blob/main/modules/multiplication.py"
click node_division "https://github.com/karthik0747/python-at-codegnan/blob/main/modules/division.py"
click node_search "https://github.com/karthik0747/python-at-codegnan/blob/main/DSA/binarysearch.py"
click node_other_examples "https://github.com/karthik0747/python-at-codegnan/tree/main/functions"

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_queue_cli,node_queue_model,node_queue_utils,node_hours,node_file_manager,node_queue_data,node_queue_errors toneBlue
class node_bank_cli,node_register,node_login,node_balance,node_deposit,node_transfer,node_statement,node_logout,node_withdraw toneAmber
class node_calculator,node_addition,node_subtraction,node_multiplication,node_division toneMint
class node_search,node_other_examples toneRose
class node_operator,node_bank_user toneIndigo
```

## Components

### Government Queue

- [Queue CLI](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/main.py): `digital queue management system for government services/modules/main.py`
- [Queue Operations](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/models.py): `digital queue management system for government services/modules/models.py`
- [Input & Display](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/utils.py): `digital queue management system for government services/modules/utils.py`
- [Business Hours](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/service_hours.py): `digital queue management system for government services/modules/service_hours.py`
- [File Manager](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/file_manager.py): `digital queue management system for government services/modules/file_manager.py`
- **Citizen Records & Logs**
- [Queue Exceptions](https://github.com/karthik0747/python-at-codegnan/blob/main/digital%20queue%20management%20system%20for%20government%20services/modules/exceptions.py): `digital queue management system for government services/modules/exceptions.py`

### Mini Bank

- [Bank CLI](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/mainbank.py): `bank modules/mainbank.py`
- [Registration](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/register.py): `bank modules/register.py`
- [Login](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/login.py): `bank modules/login.py`
- [Balance Lookup](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/getbalance.py): `bank modules/getbalance.py`
- [Deposit](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/deposit.py): `bank modules/deposit.py`
- [Transfer](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/transfer.py): `bank modules/transfer.py`
- [Mini Statement](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/ministatement.py): `bank modules/ministatement.py`
- [Logout](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/logout.py): `bank modules/logout.py`
- [Withdrawal](https://github.com/karthik0747/python-at-codegnan/blob/main/bank%20modules/withdraw.py): `bank modules/withdraw.py`

### Calculator

- [Calculator CLI](https://github.com/karthik0747/python-at-codegnan/blob/main/modules/small_cal.py): `modules/small_cal.py`
- [Addition](https://github.com/karthik0747/python-at-codegnan/blob/main/modules/addition.py): `modules/addition.py`
- [Subtraction](https://github.com/karthik0747/python-at-codegnan/blob/main/modules/subtraction.py): `modules/subtraction.py`
- [Multiplication](https://github.com/karthik0747/python-at-codegnan/blob/main/modules/multiplication.py): `modules/multiplication.py`
- [Division](https://github.com/karthik0747/python-at-codegnan/blob/main/modules/division.py): `modules/division.py`

### Learning Examples

- [Search Exercises](https://github.com/karthik0747/python-at-codegnan/blob/main/DSA/binarysearch.py): `DSA/binarysearch.py`
- [Python Exercises](https://github.com/karthik0747/python-at-codegnan/tree/main/functions): `functions`

### Other components

- **Citizen / Operator**
- **Bank Customer**

## Connections

- Citizen / Operator → Queue CLI: uses CLI (evidence: `digital queue management system for government services/modules/main.py`)
- Queue CLI → Input & Display: validates input (evidence: `digital queue management system for government services/modules/main.py`)
- Queue CLI → Business Hours: checks hours (evidence: `digital queue management system for government services/modules/main.py`)
- Queue CLI → Queue Operations: dispatches operations (evidence: `digital queue management system for government services/modules/main.py`)
- Queue CLI → File Manager: loads and saves (evidence: `digital queue management system for government services/modules/main.py`)
- Queue CLI → Queue Exceptions: handles errors (evidence: `digital queue management system for government services/modules/main.py`)
- File Manager → Queue Operations: restores citizens (evidence: `digital queue management system for government services/modules/file_manager.py`)
- File Manager → Citizen Records & Logs: reads and writes (evidence: `digital queue management system for government services/modules/file_manager.py`)
- Queue Operations → Queue Exceptions: raises exceptions (evidence: `digital queue management system for government services/modules/models.py`)
- Bank Customer → Bank CLI: uses CLI (evidence: `bank modules/mainbank.py`)
- Bank CLI → Registration: calls registration (evidence: `bank modules/mainbank.py`)
- Bank CLI → Login: calls login (evidence: `bank modules/mainbank.py`)
- Bank CLI → Balance Lookup: calls lookup (evidence: `bank modules/mainbank.py`)
- Bank CLI → Deposit: calls deposit (evidence: `bank modules/mainbank.py`)
- Bank CLI → Transfer: calls transfer (evidence: `bank modules/mainbank.py`)
- Bank CLI → Mini Statement: calls statement (evidence: `bank modules/mainbank.py`)
- Bank CLI → Logout: calls logout (evidence: `bank modules/mainbank.py`)
- Bank CLI → Withdrawal: calls withdrawal (evidence: `bank modules/mainbank.py`)
- Calculator CLI → Addition: calls addition (evidence: `modules/small_cal.py`)
- Calculator CLI → Subtraction: calls subtraction (evidence: `modules/small_cal.py`)
- Calculator CLI → Multiplication: calls multiplication (evidence: `modules/small_cal.py`)
- Calculator CLI → Division: calls division (evidence: `modules/small_cal.py`)
