# hemantvs05/startup-peravai-scanner architecture

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

- Interactive diagram: https://gitdiagram.com/hemantvs05/startup-peravai-scanner
- Repository: https://github.com/hemantvs05/startup-peravai-scanner

## Overview

This is a React admin app for Startup Peravai event entry: an admin signs in, scans a participant’s QR pass, and receives a check-in result. A separate Rise Her tab lists submissions. The sampled code shows authentication and Firestore operations in the main app, with QR decoding delegated to a camera scanner. The README is only the generic React/Vite template, so it documents no further product capabilities; unsampled files are not inferred as features.

Main entry points: [`src/App.jsx`](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx) (Admin console), [`src/Scanner.jsx`](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/Scanner.jsx) (QR scanner), [`src/firebase.js`](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/firebase.js) (Firebase client), [`src/main.jsx`](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/main.jsx) (React entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Admin interface"]
  node_entry["React entry<br/>[main.jsx]"]
  node_app["Admin console<br/>[App.jsx]"]
end

subgraph group_gate["Gate operations"]
  node_signin["Admin sign-in<br/>[App.jsx]"]
  node_authorization["Admin authorization<br/>[App.jsx]"]
  node_qrscanner["QR scanner<br/>[Scanner.jsx]"]
  node_checkin["Pass check-in<br/>[App.jsx]"]
  node_submissions["Rise Her submissions<br/>[App.jsx]"]
end

subgraph group_platform["Firebase platform"]
  node_firebaseconfig["Firebase client<br/>[firebase.js]"]
  node_firebaseauth["Firebase Auth"]
  node_firestore[("Cloud Firestore")]
end

node_admin(("Admin"))
node_camera(("Device camera"))

node_entry -->|"renders"| node_app
node_admin -->|"uses"| node_app
node_app -->|"handles"| node_signin
node_app -->|"checks access"| node_authorization
node_app -->|"renders"| node_qrscanner
node_qrscanner -->|"decodes QR"| node_camera
node_qrscanner -->|"reports scan"| node_checkin
node_app -->|"processes pass"| node_checkin
node_app -->|"loads tab"| node_submissions
node_signin -->|"authenticates"| node_firebaseauth
node_authorization -->|"observes session"| node_firebaseauth
node_authorization -->|"checks admin"| node_firestore
node_checkin -->|"reads and updates"| node_firestore
node_submissions -->|"queries"| node_firestore
node_firebaseconfig -->|"initializes"| node_firebaseauth
node_firebaseconfig -->|"initializes"| node_firestore

click node_entry "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/main.jsx"
click node_app "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx"
click node_signin "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx"
click node_authorization "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx"
click node_qrscanner "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/Scanner.jsx"
click node_checkin "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx"
click node_submissions "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx"
click node_firebaseconfig "https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/firebase.js"

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_entry,node_app toneBlue
class node_signin,node_authorization,node_qrscanner,node_checkin,node_submissions toneAmber
class node_firebaseconfig,node_firebaseauth,node_firestore toneMint
class node_admin,node_camera toneIndigo
```

## Components

### Admin interface

- [React entry](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/main.jsx): `src/main.jsx`
- [Admin console](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx): `src/App.jsx`

### Gate operations

- [Admin sign-in](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx): `src/App.jsx`
- [Admin authorization](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx): `src/App.jsx`
- [QR scanner](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/Scanner.jsx): `src/Scanner.jsx`
- [Pass check-in](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx): `src/App.jsx`
- [Rise Her submissions](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/App.jsx): `src/App.jsx`

### Firebase platform

- [Firebase client](https://github.com/hemantvs05/startup-peravai-scanner/blob/main/src/firebase.js): `src/firebase.js`
- **Firebase Auth**
- **Cloud Firestore**

### Other components

- **Admin**
- **Device camera**

## Connections

- React entry → Admin console: renders (evidence: `src/main.jsx`)
- Admin → Admin console: uses
- Admin console → Admin sign-in: handles (evidence: `src/App.jsx`)
- Admin console → Admin authorization: checks access (evidence: `src/App.jsx`)
- Admin console → QR scanner: renders (evidence: `src/App.jsx`)
- QR scanner → Device camera: decodes QR (evidence: `src/Scanner.jsx`)
- QR scanner → Pass check-in: reports scan (evidence: `src/Scanner.jsx`)
- Admin console → Pass check-in: processes pass (evidence: `src/App.jsx`)
- Admin console → Rise Her submissions: loads tab (evidence: `src/App.jsx`)
- Admin sign-in → Firebase Auth: authenticates (evidence: `src/App.jsx`)
- Admin authorization → Firebase Auth: observes session (evidence: `src/App.jsx`)
- Admin authorization → Cloud Firestore: checks admin (evidence: `src/App.jsx`)
- Pass check-in → Cloud Firestore: reads and updates (evidence: `src/App.jsx`)
- Rise Her submissions → Cloud Firestore: queries (evidence: `src/App.jsx`)
- Firebase client → Firebase Auth: initializes (evidence: `src/firebase.js`)
- Firebase client → Cloud Firestore: initializes (evidence: `src/firebase.js`)
