# gracious26bcy10096/vityarthi-project architecture

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

- Interactive diagram: https://gitdiagram.com/gracious26bcy10096/vityarthi-project
- Repository: https://github.com/gracious26bcy10096/vityarthi-project

## Overview

This CLI takes a user from menu selection through currency-code validation and conversion to a displayed result. The frontend owns the workflow, using the display module for the currency list, the data module for supported codes and fixed rates, and the calculator for the conversion. The README describes 30 currencies and two-decimal results; sampled source confirms those behaviors. The graph reflects the inspected entry point and modules.

Main entry points: [`app/frontend.py`](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/frontend.py) (CLI workflow), [`app/display.py`](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/display.py) (Currency list), [`app/calculator.py`](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/calculator.py) (Rate calculator), [`app/data.py`](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/data.py) (Codes and rates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_main["Program entry<br/>[main.py]"]
end

subgraph group_workflow["Conversion workflow"]
  node_frontend["CLI workflow<br/>[frontend.py]"]
  node_display["Currency list<br/>[display.py]"]
  node_calculator["Rate calculator<br/>[calculator.py]"]
end

subgraph group_reference["Currency reference"]
  node_data["Codes and rates<br/>[data.py]"]
end

node_user(("User"))

node_user -->|"enters choices"| node_frontend
node_main -->|"starts app"| node_frontend
node_frontend -->|"prompts and reports"| node_user
node_frontend -->|"calls table"| node_display
node_display -->|"reads codes"| node_data
node_frontend -->|"reads codes and rates"| node_data
node_frontend -->|"calls conversion"| node_calculator
node_calculator -->|"returns amount"| node_frontend
node_display -->|"prints currency list"| node_user

click node_main "https://github.com/gracious26bcy10096/vityarthi-project/blob/main/main.py"
click node_frontend "https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/frontend.py"
click node_display "https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/display.py"
click node_calculator "https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/calculator.py"
click node_data "https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/data.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_main,node_user toneBlue
class node_frontend,node_display,node_calculator toneAmber
class node_data toneMint
```

## Components

### CLI entry

- [Program entry](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/main.py): `main.py`

### Conversion workflow

- [CLI workflow](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/frontend.py): `app/frontend.py`
- [Currency list](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/display.py): `app/display.py`
- [Rate calculator](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/calculator.py): `app/calculator.py`

### Currency reference

- [Codes and rates](https://github.com/gracious26bcy10096/vityarthi-project/blob/main/app/data.py): `app/data.py`

### Other components

- **User**

## Connections

- User → CLI workflow: enters choices
- Program entry → CLI workflow: starts app
- CLI workflow → User: prompts and reports
- CLI workflow → Currency list: calls table
- Currency list → Codes and rates: reads codes
- CLI workflow → Codes and rates: reads codes and rates
- CLI workflow → Rate calculator: calls conversion
- Rate calculator → CLI workflow: returns amount
- Currency list → User: prints currency list