# ayushrajak19/scan-mobi architecture

> Architecture diagram of the GitHub repository ayushrajak19/scan-mobi, 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/ayushrajak19/scan-mobi
- Repository: https://github.com/ayushrajak19/scan-mobi

## Overview

ReviewFlow lets vendors configure a branded review destination and share it via QR/NFC. Customers scan or tap, choose a rating and describe their experience, receive an editable draft, then submit their own review through Google. The server also handles vendor accounts, dashboard settings, scan/draft counts, QR generation, and persistent SQLite data. The excerpts show server-side routes and database operations; the customer UI implementation was not sampled, so UI relationships reflect README-documented behavior.

Main entry points: [`public/assets/app.js`](https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js) (Web interface), [`server.js`](https://github.com/ayushrajak19/scan-mobi/blob/main/server.js) (Draft generation), [`public/index.html`](https://github.com/ayushrajak19/scan-mobi/blob/main/public/index.html) (Branded review page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vendor["Vendor management"]
  node_vendor_auth["Vendor accounts<br/>[server.js]"]
  node_vendor_dashboard["Vendor settings<br/>[app.js]"]
  node_share_links["QR and NFC<br/>[server.js]"]
end

subgraph group_customer["Customer review flow"]
  node_web_ui["Web interface<br/>[app.js]"]
  node_review_page["Branded review page<br/>[index.html]"]
  node_experience["Experience input<br/>[app.js]"]
  node_google_handoff["Google submission<br/>[app.js]"]
end

subgraph group_server["Application server"]
  node_draft["Draft generation<br/>[server.js]"]
  node_http_server["HTTP routes<br/>[server.js]"]
  node_sqlite[("Application data<br/>[server.js]")]
end

subgraph group_integrations["External services"]
  node_groq["Groq API"]
  node_google["Google reviews"]
end

node_vendor(("Vendor"))
node_customer(("Customer"))

node_vendor -->|"uses dashboard"| node_web_ui
node_web_ui -->|"creates account"| node_vendor_auth
node_web_ui -->|"configures business"| node_vendor_dashboard
node_vendor_dashboard -->|"gets QR"| node_share_links
node_customer -->|"scans or taps"| node_review_page
node_review_page -->|"collects rating"| node_experience
node_experience -->|"requests draft"| node_draft
node_draft -->|"generates draft"| node_groq
node_experience -->|"reviews draft"| node_google_handoff
node_google_handoff -->|"opens review form"| node_google
node_http_server -->|"reads and writes"| node_sqlite
node_http_server -->|"routes draft requests"| node_draft

click node_web_ui "https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js"
click node_vendor_auth "https://github.com/ayushrajak19/scan-mobi/blob/main/server.js"
click node_vendor_dashboard "https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js"
click node_share_links "https://github.com/ayushrajak19/scan-mobi/blob/main/server.js"
click node_review_page "https://github.com/ayushrajak19/scan-mobi/blob/main/public/index.html"
click node_experience "https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js"
click node_draft "https://github.com/ayushrajak19/scan-mobi/blob/main/server.js"
click node_google_handoff "https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js"
click node_http_server "https://github.com/ayushrajak19/scan-mobi/blob/main/server.js"
click node_sqlite "https://github.com/ayushrajak19/scan-mobi/blob/main/server.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_vendor_auth,node_vendor_dashboard,node_share_links toneBlue
class node_web_ui,node_review_page,node_experience,node_google_handoff toneAmber
class node_draft,node_http_server,node_sqlite toneMint
class node_groq,node_google toneRose
class node_vendor,node_customer toneIndigo
```

## Components

### Vendor management

- [Vendor accounts](https://github.com/ayushrajak19/scan-mobi/blob/main/server.js): `server.js`
- [Vendor settings](https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js): `public/assets/app.js`
- [QR and NFC](https://github.com/ayushrajak19/scan-mobi/blob/main/server.js): `server.js`

### Customer review flow

- [Web interface](https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js): `public/assets/app.js`
- [Branded review page](https://github.com/ayushrajak19/scan-mobi/blob/main/public/index.html): `public/index.html`
- [Experience input](https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js): `public/assets/app.js`
- [Google submission](https://github.com/ayushrajak19/scan-mobi/blob/main/public/assets/app.js): `public/assets/app.js`

### Application server

- [Draft generation](https://github.com/ayushrajak19/scan-mobi/blob/main/server.js): `server.js`
- [HTTP routes](https://github.com/ayushrajak19/scan-mobi/blob/main/server.js): `server.js`
- [Application data](https://github.com/ayushrajak19/scan-mobi/blob/main/server.js): `server.js`

### External services

- **Groq API**
- **Google reviews**

### Other components

- **Vendor**
- **Customer**

## Connections

- Vendor → Web interface: uses dashboard (evidence: `README.md`)
- Web interface → Vendor accounts: creates account (evidence: `README.md`)
- Web interface → Vendor settings: configures business (evidence: `README.md`)
- Vendor settings → QR and NFC: gets QR (evidence: `README.md`)
- Customer → Branded review page: scans or taps (evidence: `README.md`)
- Branded review page → Experience input: collects rating (evidence: `README.md`)
- Experience input → Draft generation: requests draft (evidence: `README.md`)
- Draft generation → Groq API: generates draft (evidence: `README.md`)
- Experience input → Google submission: reviews draft (evidence: `README.md`)
- Google submission → Google reviews: opens review form (evidence: `README.md`)
- HTTP routes → Application data: reads and writes (evidence: `server.js`)
- HTTP routes → Draft generation: routes draft requests (evidence: `server.js`)
