# kushpatel9089-ai/refillx architecture

> Architecture diagram of the GitHub repository kushpatel9089-ai/refillx, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kushpatel9089-ai/refillx
- Repository: https://github.com/kushpatel9089-ai/refillx

## Overview

RefillX is an ASP.NET Web Forms application for administering shopkeepers and bottle types and enabling shopkeepers to manage orders and view reports. The visible registration flow collects shop details, sends an email OTP, then verifies it before creating the account; users also authenticate by role. Admin and shopkeeper pages cover profiles, dashboards, orders, and reporting. The README provides no product detail, and most page implementations were not excerpted, so those capabilities are represented without guessed connections. Database and mail interactions are shown only where the supplied excerpts support them.

Main entry points: [`ShopRegistration.aspx.cs`](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopRegistration.aspx.cs) (Shop Registration), [`Login.aspx.cs`](https://github.com/kushpatel9089-ai/refillx/blob/main/Login.aspx.cs) (Role Login), [`PasswordHelper.cs`](https://github.com/kushpatel9089-ai/refillx/blob/main/PasswordHelper.cs) (Password Helper), [`AdminRegistration.aspx.cs`](https://github.com/kushpatel9089-ai/refillx/blob/main/AdminRegistration.aspx.cs) (Admin Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Registration"]
  node_login["Role Login<br/>[Login.aspx.cs]"]
  node_password["Password Helper<br/>[PasswordHelper.cs]"]
  node_shopreg["Shop Registration"]
  node_otp["OTP Verification"]
  node_adminreg["Admin Registration"]
end

subgraph group_admin["Administration"]
  node_adminhome["Admin Dashboard"]
  node_adminprofile["Admin Profile"]
  node_shopmanagement["Shopkeeper Management"]
  node_bottles["Bottle Catalog<br/>[BottleInfo.aspx.cs]"]
  node_ordersadmin["Order Management<br/>[Orders.aspx.cs]"]
end

subgraph group_shop["Shopkeeper Operations"]
  node_shopdashboard["Shop Dashboard"]
  node_shopprofile["Shop Profile"]
  node_shopbottles["Bottle Information"]
  node_createorder["Create Order"]
  node_shoporders["Shop Orders"]
  node_contact["Contact Page"]
end

subgraph group_insights["Reports and Insights"]
  node_adminreports["Admin Reports<br/>[Reports.aspx.cs]"]
  node_monthly["Monthly Report"]
  node_yearly["Yearly Report"]
  node_shopreport["Shop Report"]
end

node_user(("User"))
node_mail["Email Service"]
node_database[("SQL Database")]

node_user -->|"signs in"| node_login
node_user -->|"registers shop"| node_shopreg
node_login -->|"authenticates against"| node_database
node_login -->|"verifies password"| node_password
node_adminreg -->|"hashes password"| node_password
node_adminreg -->|"creates admin"| node_database
node_shopreg -->|"checks and stores OTP"| node_database
node_shopreg -->|"sends OTP email"| node_mail
node_shopreg -->|"redirects for verification"| node_otp
node_otp -->|"verifies and registers"| node_database
node_adminhome -->|"queries dashboard data"| node_database
node_adminprofile -->|"reads and updates profile"| node_database
node_adminprofile -->|"uses password helper"| node_password
node_shopmanagement -->|"manages shopkeepers"| node_database
node_bottles -->|"manages bottle types"| node_database
node_shopprofile -->|"reads and updates profile"| node_database
node_shopreport -->|"loads shop and orders"| node_database
node_ordersadmin -.->|"manages orders"| node_database
node_adminreports -.->|"loads report data"| node_database
node_monthly -.->|"loads monthly data"| node_database
node_yearly -.->|"loads yearly data"| node_database
node_shopdashboard -.->|"loads dashboard data"| node_database
node_shopbottles -.->|"loads bottle data"| node_database
node_createorder -.->|"creates order"| node_database
node_shoporders -.->|"loads shop orders"| node_database

click node_login "https://github.com/kushpatel9089-ai/refillx/blob/main/Login.aspx.cs"
click node_password "https://github.com/kushpatel9089-ai/refillx/blob/main/PasswordHelper.cs"
click node_shopreg "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopRegistration.aspx.cs"
click node_otp "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopRegistrationOTP.aspx.cs"
click node_adminreg "https://github.com/kushpatel9089-ai/refillx/blob/main/AdminRegistration.aspx.cs"
click node_adminhome "https://github.com/kushpatel9089-ai/refillx/blob/main/AdminDashboard.aspx.cs"
click node_adminprofile "https://github.com/kushpatel9089-ai/refillx/blob/main/AdminProfile.aspx.cs"
click node_shopmanagement "https://github.com/kushpatel9089-ai/refillx/blob/main/ManageShopkeeper.aspx.cs"
click node_bottles "https://github.com/kushpatel9089-ai/refillx/blob/main/BottleInfo.aspx.cs"
click node_ordersadmin "https://github.com/kushpatel9089-ai/refillx/blob/main/Orders.aspx.cs"
click node_adminreports "https://github.com/kushpatel9089-ai/refillx/blob/main/Reports.aspx.cs"
click node_monthly "https://github.com/kushpatel9089-ai/refillx/blob/main/MonthlyReport.aspx.cs"
click node_yearly "https://github.com/kushpatel9089-ai/refillx/blob/main/YearlyReport.aspx.cs"
click node_shopdashboard "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperDashboard.aspx.cs"
click node_shopprofile "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperProfile.aspx.cs"
click node_shopbottles "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperBottleInfo.aspx.cs"
click node_createorder "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperCreateOrder.aspx.cs"
click node_shoporders "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperOrders.aspx.cs"
click node_shopreport "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperReport.aspx.cs"
click node_contact "https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperContactus.aspx.cs"

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_login,node_password,node_shopreg,node_otp,node_adminreg,node_user toneBlue
class node_adminhome,node_adminprofile,node_shopmanagement,node_bottles,node_ordersadmin,node_database toneAmber
class node_shopdashboard,node_shopprofile,node_shopbottles,node_createorder,node_shoporders,node_contact toneMint
class node_adminreports,node_monthly,node_yearly,node_shopreport toneRose
class node_mail toneIndigo
```

## Components

### Identity and Registration

- [Role Login](https://github.com/kushpatel9089-ai/refillx/blob/main/Login.aspx.cs): `Login.aspx.cs`
- [Password Helper](https://github.com/kushpatel9089-ai/refillx/blob/main/PasswordHelper.cs): `PasswordHelper.cs`
- [Shop Registration](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopRegistration.aspx.cs): `ShopRegistration.aspx.cs`
- [OTP Verification](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopRegistrationOTP.aspx.cs): `ShopRegistrationOTP.aspx.cs`
- [Admin Registration](https://github.com/kushpatel9089-ai/refillx/blob/main/AdminRegistration.aspx.cs): `AdminRegistration.aspx.cs`

### Administration

- [Admin Dashboard](https://github.com/kushpatel9089-ai/refillx/blob/main/AdminDashboard.aspx.cs): `AdminDashboard.aspx.cs`
- [Admin Profile](https://github.com/kushpatel9089-ai/refillx/blob/main/AdminProfile.aspx.cs): `AdminProfile.aspx.cs`
- [Shopkeeper Management](https://github.com/kushpatel9089-ai/refillx/blob/main/ManageShopkeeper.aspx.cs): `ManageShopkeeper.aspx.cs`
- [Bottle Catalog](https://github.com/kushpatel9089-ai/refillx/blob/main/BottleInfo.aspx.cs): `BottleInfo.aspx.cs`
- [Order Management](https://github.com/kushpatel9089-ai/refillx/blob/main/Orders.aspx.cs): `Orders.aspx.cs`

### Shopkeeper Operations

- [Shop Dashboard](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperDashboard.aspx.cs): `ShopkeeperDashboard.aspx.cs`
- [Shop Profile](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperProfile.aspx.cs): `ShopkeeperProfile.aspx.cs`
- [Bottle Information](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperBottleInfo.aspx.cs): `ShopkeeperBottleInfo.aspx.cs`
- [Create Order](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperCreateOrder.aspx.cs): `ShopkeeperCreateOrder.aspx.cs`
- [Shop Orders](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperOrders.aspx.cs): `ShopkeeperOrders.aspx.cs`
- [Contact Page](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperContactus.aspx.cs): `ShopkeeperContactus.aspx.cs`

### Reports and Insights

- [Admin Reports](https://github.com/kushpatel9089-ai/refillx/blob/main/Reports.aspx.cs): `Reports.aspx.cs`
- [Monthly Report](https://github.com/kushpatel9089-ai/refillx/blob/main/MonthlyReport.aspx.cs): `MonthlyReport.aspx.cs`
- [Yearly Report](https://github.com/kushpatel9089-ai/refillx/blob/main/YearlyReport.aspx.cs): `YearlyReport.aspx.cs`
- [Shop Report](https://github.com/kushpatel9089-ai/refillx/blob/main/ShopkeeperReport.aspx.cs): `ShopkeeperReport.aspx.cs`

### Other components

- **User**
- **Email Service**
- **SQL Database**

## Connections

- User → Role Login: signs in
- User → Shop Registration: registers shop
- Role Login → SQL Database: authenticates against (evidence: `Login.aspx.cs`)
- Role Login → Password Helper: verifies password (evidence: `Login.aspx.cs`)
- Admin Registration → Password Helper: hashes password (evidence: `AdminRegistration.aspx.cs`)
- Admin Registration → SQL Database: creates admin (evidence: `AdminRegistration.aspx.cs`)
- Shop Registration → SQL Database: checks and stores OTP (evidence: `ShopRegistration.aspx.cs`)
- Shop Registration → Email Service: sends OTP email (evidence: `ShopRegistration.aspx.cs`)
- Shop Registration → OTP Verification: redirects for verification (evidence: `ShopRegistration.aspx.cs`)
- OTP Verification → SQL Database: verifies and registers (evidence: `ShopRegistrationOTP.aspx.cs`)
- Admin Dashboard → SQL Database: queries dashboard data (evidence: `AdminDashboard.aspx.cs`)
- Admin Profile → SQL Database: reads and updates profile (evidence: `AdminProfile.aspx.cs`)
- Admin Profile → Password Helper: uses password helper (evidence: `AdminProfile.aspx.cs`)
- Shopkeeper Management → SQL Database: manages shopkeepers (evidence: `ManageShopkeeper.aspx.cs`)
- Bottle Catalog → SQL Database: manages bottle types (evidence: `BottleInfo.aspx.cs`)
- Shop Profile → SQL Database: reads and updates profile (evidence: `ShopkeeperProfile.aspx.cs`)
- Shop Report → SQL Database: loads shop and orders (evidence: `ShopkeeperReport.aspx.cs`)
- Order Management → SQL Database: manages orders
- Admin Reports → SQL Database: loads report data
- Monthly Report → SQL Database: loads monthly data
- Yearly Report → SQL Database: loads yearly data
- Shop Dashboard → SQL Database: loads dashboard data
- Bottle Information → SQL Database: loads bottle data
- Create Order → SQL Database: creates order
- Shop Orders → SQL Database: loads shop orders
