# vimalskatiyar-stack/neet2026-rank architecture

> Architecture diagram of the GitHub repository vimalskatiyar-stack/neet2026-rank, 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/vimalskatiyar-stack/neet2026-rank
- Repository: https://github.com/vimalskatiyar-stack/neet2026-rank

## Overview

This is a single-file Streamlit app that accepts a student’s name and NEET score, rejects mathematically impossible scores, estimates a rank, and presents guidance based on the result with a downloadable text report. The logic and UI are all in app.py, so the diagram separates responsibilities rather than implying separate modules.

Main entry points: [`app.py`](https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py) (Streamlit app)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_student(("Student"))
node_app["Streamlit app<br/>[app.py]"]
node_validation["Score validation<br/>[app.py]"]
node_rank["Rank estimation<br/>[app.py]"]
node_guidance["Rank guidance<br/>[app.py]"]
node_report["Text report<br/>[app.py]"]

node_student -->|"enters details"| node_app
node_app -->|"checks score"| node_validation
node_app -->|"estimates rank"| node_rank
node_rank -->|"supplies rank"| node_guidance
node_app -->|"generates report"| node_report
node_app -->|"shows result"| node_student
node_report -->|"downloads"| node_student

click node_app "https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py"
click node_validation "https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py"
click node_rank "https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py"
click node_guidance "https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py"
click node_report "https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.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_student toneIndigo
class node_app,node_validation,node_rank,node_guidance,node_report toneTeal
```

## Components

### Other components

- **Student**
- [Streamlit app](https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py): `app.py`
- [Score validation](https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py): `app.py`
- [Rank estimation](https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py): `app.py`
- [Rank guidance](https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py): `app.py`
- [Text report](https://github.com/vimalskatiyar-stack/neet2026-rank/blob/main/app.py): `app.py`

## Connections

- Student → Streamlit app: enters details
- Streamlit app → Score validation: checks score
- Streamlit app → Rank estimation: estimates rank
- Rank estimation → Rank guidance: supplies rank
- Streamlit app → Text report: generates report
- Streamlit app → Student: shows result
- Text report → Student: downloads