# skygod07/smareet architecture

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

- Interactive diagram: https://gitdiagram.com/skygod07/smareet
- Repository: https://github.com/skygod07/smareet

## Overview

SMAREET is an Algorand event-ticketing dApp, with wallet-connected frontend features, a FastAPI ticketing backend, and on-chain ticket contracts. The main ticket workflow creates an event, requests a mint through the backend, calls the ticketing contract to create an ASA, and records ticket data; a background subscriber syncs chain state. The README also documents general-purpose Algorand features (NFT minting, ASA creation, opt-in, transfers, counter, and bank). Some subsystem links are based on README documentation because their implementation was not sampled.

Main entry points: [`projects/frontend/src/Home.tsx`](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/Home.tsx) (Feature hub), [`backend/app/routes.py`](https://github.com/skygod07/smareet/blob/main/backend/app/routes.py) (Ticket routes), [`backend/app/main.py`](https://github.com/skygod07/smareet/blob/main/backend/app/main.py) (FastAPI entry), [`backend/app/algorand_service.py`](https://github.com/skygod07/smareet/blob/main/backend/app/algorand_service.py) (Chain service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend dApp"]
  node_app["App shell<br/>[App.tsx]"]
  node_home["Feature hub<br/>[Home.tsx]"]
  node_mint["NFT minting<br/>[MintNFT.tsx]"]
  node_asa["Create ASA<br/>[CreateASA.tsx]"]
  node_optin["Asset opt-in<br/>[AssetOptIn.tsx]"]
  node_send["Send ALGO<br/>[SendAlgo.tsx]"]
  node_tickets["My tickets<br/>[MyTickets.tsx]"]
  node_counterui["Counter UI<br/>[AppCalls.tsx]"]
  node_bankui["Bank UI<br/>[Bank.tsx]"]
  node_api["Ticket API client<br/>[api.ts]"]
end

subgraph group_backend["Ticketing backend"]
  node_backend["FastAPI entry<br/>[main.py]"]
  node_routes["Ticket routes<br/>[routes.py]"]
  node_service["Chain service"]
  node_subscriber["Chain subscriber<br/>[subscriber.py]"]
  node_models["Ticket data models<br/>[models.py]"]
  node_database[("SQLite database<br/>[database.py]")]
end

subgraph group_chain["Algorand contracts"]
  node_ticketclient["Ticketing client"]
  node_ticketcontract["Ticketing contract<br/>[contract.py]"]
  node_countercontract["Counter contract<br/>[contract.py]"]
  node_bankcontract["Bank contract<br/>[contract.py]"]
end

subgraph group_integrations["External services"]
  node_pinata["Media pinning<br/>[pinata.ts]"]
  node_algorand{{"Algorand network"}}
  node_wallets{{"Algorand wallets"}}
end

node_attendee(("Attendee"))

node_attendee -->|"uses"| node_app
node_app -->|"renders"| node_home
node_home -->|"offers"| node_mint
node_home -->|"offers"| node_asa
node_home -->|"offers"| node_optin
node_home -->|"offers"| node_send
node_home -->|"offers"| node_tickets
node_home -->|"offers"| node_counterui
node_home -->|"offers"| node_bankui
node_mint -->|"pins media"| node_pinata
node_mint -->|"mints NFT"| node_algorand
node_asa -->|"creates asset"| node_algorand
node_optin -->|"opts in"| node_algorand
node_send -->|"sends payment"| node_algorand
node_tickets -->|"loads tickets"| node_api
node_api -.->|"requests API"| node_routes
node_counterui -->|"calls"| node_countercontract
node_bankui -->|"calls"| node_bankcontract
node_bankui -->|"reads history"| node_algorand
node_app -->|"provides wallet"| node_wallets
node_backend -->|"mounts"| node_routes
node_backend -->|"initializes"| node_database
node_backend -->|"initializes"| node_service
node_backend -->|"starts"| node_subscriber
node_routes -->|"mints on-chain"| node_service
node_routes -->|"reads and writes"| node_database
node_routes -->|"uses records"| node_models
node_service -->|"calls"| node_ticketclient
node_service -->|"submits transactions"| node_algorand
node_ticketclient -->|"invokes methods"| node_ticketcontract
node_ticketcontract -->|"creates ticket ASA"| node_algorand
node_subscriber -->|"syncs chain state"| node_database
node_subscriber -->|"polls indexer"| node_algorand

click node_app "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/App.tsx"
click node_home "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/Home.tsx"
click node_mint "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/MintNFT.tsx"
click node_asa "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/CreateASA.tsx"
click node_optin "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/AssetOptIn.tsx"
click node_send "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/SendAlgo.tsx"
click node_tickets "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/MyTickets.tsx"
click node_counterui "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/AppCalls.tsx"
click node_bankui "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/Bank.tsx"
click node_pinata "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/utils/pinata.ts"
click node_api "https://github.com/skygod07/smareet/blob/main/projects/frontend/src/services/api.ts"
click node_backend "https://github.com/skygod07/smareet/blob/main/backend/app/main.py"
click node_routes "https://github.com/skygod07/smareet/blob/main/backend/app/routes.py"
click node_service "https://github.com/skygod07/smareet/blob/main/backend/app/algorand_service.py"
click node_subscriber "https://github.com/skygod07/smareet/blob/main/backend/app/subscriber.py"
click node_models "https://github.com/skygod07/smareet/blob/main/backend/app/models.py"
click node_database "https://github.com/skygod07/smareet/blob/main/backend/app/database.py"
click node_ticketclient "https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/artifacts/ticketing/event_ticketing_client.py"
click node_ticketcontract "https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/ticketing/contract.py"
click node_countercontract "https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/counter/contract.py"
click node_bankcontract "https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/bank/contract.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_app,node_home,node_mint,node_asa,node_optin,node_send,node_tickets,node_counterui,node_bankui,node_api toneBlue
class node_backend,node_routes,node_service,node_subscriber,node_models,node_database toneAmber
class node_ticketclient,node_ticketcontract,node_countercontract,node_bankcontract toneMint
class node_pinata,node_algorand,node_wallets toneRose
class node_attendee toneIndigo
```

## Components

### Frontend dApp

- [App shell](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/App.tsx): `projects/frontend/src/App.tsx`
- [Feature hub](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/Home.tsx): `projects/frontend/src/Home.tsx`
- [NFT minting](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/MintNFT.tsx): `projects/frontend/src/components/MintNFT.tsx`
- [Create ASA](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/CreateASA.tsx): `projects/frontend/src/components/CreateASA.tsx`
- [Asset opt-in](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/AssetOptIn.tsx): `projects/frontend/src/components/AssetOptIn.tsx`
- [Send ALGO](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/SendAlgo.tsx): `projects/frontend/src/components/SendAlgo.tsx`
- [My tickets](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/MyTickets.tsx): `projects/frontend/src/components/MyTickets.tsx`
- [Counter UI](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/AppCalls.tsx): `projects/frontend/src/components/AppCalls.tsx`
- [Bank UI](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/components/Bank.tsx): `projects/frontend/src/components/Bank.tsx`
- [Ticket API client](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/services/api.ts): `projects/frontend/src/services/api.ts`

### Ticketing backend

- [FastAPI entry](https://github.com/skygod07/smareet/blob/main/backend/app/main.py): `backend/app/main.py`
- [Ticket routes](https://github.com/skygod07/smareet/blob/main/backend/app/routes.py): `backend/app/routes.py`
- [Chain service](https://github.com/skygod07/smareet/blob/main/backend/app/algorand_service.py): `backend/app/algorand_service.py`
- [Chain subscriber](https://github.com/skygod07/smareet/blob/main/backend/app/subscriber.py): `backend/app/subscriber.py`
- [Ticket data models](https://github.com/skygod07/smareet/blob/main/backend/app/models.py): `backend/app/models.py`
- [SQLite database](https://github.com/skygod07/smareet/blob/main/backend/app/database.py): `backend/app/database.py`

### Algorand contracts

- [Ticketing client](https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/artifacts/ticketing/event_ticketing_client.py): `projects/contracts/smart_contracts/artifacts/ticketing/event_ticketing_client.py`
- [Ticketing contract](https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/ticketing/contract.py): `projects/contracts/smart_contracts/ticketing/contract.py`
- [Counter contract](https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/counter/contract.py): `projects/contracts/smart_contracts/counter/contract.py`
- [Bank contract](https://github.com/skygod07/smareet/blob/main/projects/contracts/smart_contracts/bank/contract.py): `projects/contracts/smart_contracts/bank/contract.py`

### External services

- [Media pinning](https://github.com/skygod07/smareet/blob/main/projects/frontend/src/utils/pinata.ts): `projects/frontend/src/utils/pinata.ts`
- **Algorand network**
- **Algorand wallets**

### Other components

- **Attendee**

## Connections

- Attendee → App shell: uses
- App shell → Feature hub: renders (evidence: `projects/frontend/src/App.tsx`)
- Feature hub → NFT minting: offers (evidence: `projects/frontend/src/Home.tsx`)
- Feature hub → Create ASA: offers (evidence: `projects/frontend/src/Home.tsx`)
- Feature hub → Asset opt-in: offers (evidence: `projects/frontend/src/Home.tsx`)
- Feature hub → Send ALGO: offers (evidence: `projects/frontend/src/Home.tsx`)
- Feature hub → My tickets: offers (evidence: `projects/frontend/src/Home.tsx`)
- Feature hub → Counter UI: offers (evidence: `projects/frontend/src/Home.tsx`)
- Feature hub → Bank UI: offers (evidence: `projects/frontend/src/Home.tsx`)
- NFT minting → Media pinning: pins media (evidence: `projects/frontend/src/components/MintNFT.tsx`)
- NFT minting → Algorand network: mints NFT
- Create ASA → Algorand network: creates asset
- Asset opt-in → Algorand network: opts in
- Send ALGO → Algorand network: sends payment
- My tickets → Ticket API client: loads tickets (evidence: `projects/frontend/src/components/MyTickets.tsx`)
- Ticket API client → Ticket routes: requests API
- Counter UI → Counter contract: calls
- Bank UI → Bank contract: calls (evidence: `projects/frontend/src/components/Bank.tsx`)
- Bank UI → Algorand network: reads history (evidence: `projects/frontend/src/components/Bank.tsx`)
- App shell → Algorand wallets: provides wallet (evidence: `projects/frontend/src/App.tsx`)
- FastAPI entry → Ticket routes: mounts (evidence: `backend/app/main.py`)
- FastAPI entry → SQLite database: initializes (evidence: `backend/app/main.py`)
- FastAPI entry → Chain service: initializes (evidence: `backend/app/main.py`)
- FastAPI entry → Chain subscriber: starts (evidence: `backend/app/main.py`)
- Ticket routes → Chain service: mints on-chain (evidence: `backend/app/routes.py`)
- Ticket routes → SQLite database: reads and writes (evidence: `backend/app/routes.py`)
- Ticket routes → Ticket data models: uses records (evidence: `backend/app/routes.py`)
- Chain service → Ticketing client: calls (evidence: `backend/app/algorand_service.py`)
- Chain service → Algorand network: submits transactions (evidence: `backend/app/algorand_service.py`)
- Ticketing client → Ticketing contract: invokes methods
- Ticketing contract → Algorand network: creates ticket ASA
- Chain subscriber → SQLite database: syncs chain state (evidence: `backend/app/subscriber.py`)
- Chain subscriber → Algorand network: polls indexer
