# salkeomkar578-lab/skipline-go architecture

> Architecture diagram of the GitHub repository salkeomkar578-lab/skipline-go, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/salkeomkar578-lab/skipline-go
- Repository: https://github.com/salkeomkar578-lab/skipline-go

## Overview

Skipline Go is a scan-and-go retail checkout app with customer shopping, staff exit verification, and store administration. The documented customer journey is product scanning, in-app payment, and an exit QR; staff verify the QR and items. The graph preserves preorder, AI assistance, multilingual UI, and transaction/Firebase services. Some feature links come from README descriptions or the SOURCE INDEX; unsampled implementation details and payment-provider wiring are not asserted.

Main entry points: [`views/CustomerView.tsx`](https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/CustomerView.tsx) (Customer Checkout), [`App.tsx`](https://github.com/salkeomkar578-lab/skipline-go/blob/main/App.tsx) (App Shell), [`views/StaffView.tsx`](https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/StaffView.tsx) (Exit Verification), [`services/firebaseService.ts`](https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/firebaseService.ts) (Cloud Data Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shopping["Customer Shopping"]
  node_app["App Shell<br/>[App.tsx]"]
  node_customer["Customer Checkout<br/>[CustomerView.tsx]"]
  node_scanner["Product Scanner<br/>[CameraScanner.tsx]"]
  node_preorder_qr["Preorder QR<br/>[PreorderQRCode.tsx]"]
  node_exit_qr["Exit QR<br/>[ExitQRCode.tsx]"]
  node_chatbot["AI Shopping Help<br/>[AIChatbot.tsx]"]
end

subgraph group_verification["Store Operations"]
  node_staff["Exit Verification<br/>[StaffView.tsx]"]
  node_admin["Store Admin<br/>[AdminView.tsx]"]
end

subgraph group_services["Application Services"]
  node_catalog["Product Catalog<br/>[constants.ts]"]
  node_transactions[("Local Transactions")]
  node_firebase_service["Cloud Data Service<br/>[firebaseService.ts]"]
  node_firebase_config["Firebase Setup<br/>[firebase.ts]"]
  node_gemini["Gemini AI Service<br/>[geminiService.ts]"]
end

subgraph group_experience["Shared Experience"]
  node_language_context["Language Context"]
  node_language_service["Translations<br/>[languageService.ts]"]
  node_language_selector["Language Selector"]
end

node_shopper(("Shopper"))
node_staff_user(("Store Staff"))
node_firebase[("Firebase")]
node_gemini_service{{"Gemini API"}}

node_shopper -->|"starts session"| node_app
node_app -->|"opens mode"| node_customer
node_app -->|"opens mode"| node_staff
node_app -->|"opens mode"| node_admin
node_customer -->|"uses scanner"| node_scanner
node_scanner -->|"scans products"| node_catalog
node_customer -.->|"uses product data"| node_catalog
node_customer -->|"stores checkout"| node_transactions
node_customer -->|"reads transaction"| node_firebase_service
node_customer -->|"shows exit QR"| node_exit_qr
node_customer -.->|"creates preorder QR"| node_preorder_qr
node_staff_user -->|"verifies purchase"| node_staff
node_staff -->|"decodes preorder QR"| node_preorder_qr
node_staff -.->|"updates status"| node_transactions
node_admin -->|"loads store data"| node_firebase_service
node_admin -->|"requests analysis"| node_gemini
node_customer -.->|"offers shopping help"| node_chatbot
node_chatbot -.->|"requests AI help"| node_gemini
node_gemini -.->|"calls model"| node_gemini_service
node_firebase_service -->|"uses setup"| node_firebase_config
node_firebase_service -->|"uses local store"| node_transactions
node_firebase_service -.->|"reads and writes"| node_firebase
node_app -->|"renders selector"| node_language_selector
node_customer -->|"renders selector"| node_language_selector
node_staff -->|"renders selector"| node_language_selector
node_language_selector -->|"changes language"| node_language_context
node_language_context -->|"loads translations"| node_language_service

click node_app "https://github.com/salkeomkar578-lab/skipline-go/blob/main/App.tsx"
click node_customer "https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/CustomerView.tsx"
click node_scanner "https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/CameraScanner.tsx"
click node_catalog "https://github.com/salkeomkar578-lab/skipline-go/blob/main/constants.ts"
click node_preorder_qr "https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/PreorderQRCode.tsx"
click node_exit_qr "https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/ExitQRCode.tsx"
click node_chatbot "https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/AIChatbot.tsx"
click node_staff "https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/StaffView.tsx"
click node_admin "https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/AdminView.tsx"
click node_transactions "https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/transactionStore.ts"
click node_firebase_service "https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/firebaseService.ts"
click node_firebase_config "https://github.com/salkeomkar578-lab/skipline-go/blob/main/config/firebase.ts"
click node_gemini "https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/geminiService.ts"
click node_language_context "https://github.com/salkeomkar578-lab/skipline-go/blob/main/context/LanguageContext.tsx"
click node_language_service "https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/languageService.ts"
click node_language_selector "https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/LanguageSelector.tsx"

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_customer,node_scanner,node_preorder_qr,node_exit_qr,node_chatbot toneBlue
class node_staff,node_admin,node_firebase toneAmber
class node_catalog,node_transactions,node_firebase_service,node_firebase_config,node_gemini,node_gemini_service toneMint
class node_language_context,node_language_service,node_language_selector toneRose
class node_shopper,node_staff_user toneIndigo
```

## Components

### Customer Shopping

- [App Shell](https://github.com/salkeomkar578-lab/skipline-go/blob/main/App.tsx): `App.tsx`
- [Customer Checkout](https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/CustomerView.tsx): `views/CustomerView.tsx`
- [Product Scanner](https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/CameraScanner.tsx): `components/CameraScanner.tsx`
- [Preorder QR](https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/PreorderQRCode.tsx): `components/PreorderQRCode.tsx`
- [Exit QR](https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/ExitQRCode.tsx): `components/ExitQRCode.tsx`
- [AI Shopping Help](https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/AIChatbot.tsx): `components/AIChatbot.tsx`

### Store Operations

- [Exit Verification](https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/StaffView.tsx): `views/StaffView.tsx`
- [Store Admin](https://github.com/salkeomkar578-lab/skipline-go/blob/main/views/AdminView.tsx): `views/AdminView.tsx`

### Application Services

- [Product Catalog](https://github.com/salkeomkar578-lab/skipline-go/blob/main/constants.ts): `constants.ts`
- [Local Transactions](https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/transactionStore.ts): `services/transactionStore.ts`
- [Cloud Data Service](https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/firebaseService.ts): `services/firebaseService.ts`
- [Firebase Setup](https://github.com/salkeomkar578-lab/skipline-go/blob/main/config/firebase.ts): `config/firebase.ts`
- [Gemini AI Service](https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/geminiService.ts): `services/geminiService.ts`

### Shared Experience

- [Language Context](https://github.com/salkeomkar578-lab/skipline-go/blob/main/context/LanguageContext.tsx): `context/LanguageContext.tsx`
- [Translations](https://github.com/salkeomkar578-lab/skipline-go/blob/main/services/languageService.ts): `services/languageService.ts`
- [Language Selector](https://github.com/salkeomkar578-lab/skipline-go/blob/main/components/LanguageSelector.tsx): `components/LanguageSelector.tsx`

### Other components

- **Shopper**
- **Store Staff**
- **Firebase**
- **Gemini API**

## Connections

- Shopper → App Shell: starts session (evidence: `README.md`)
- App Shell → Customer Checkout: opens mode (evidence: `App.tsx`)
- App Shell → Exit Verification: opens mode (evidence: `App.tsx`)
- App Shell → Store Admin: opens mode (evidence: `App.tsx`)
- Customer Checkout → Product Scanner: uses scanner (evidence: `views/CustomerView.tsx`)
- Product Scanner → Product Catalog: scans products (evidence: `README.md`)
- Customer Checkout → Product Catalog: uses product data (evidence: `views/CustomerView.tsx`)
- Customer Checkout → Local Transactions: stores checkout (evidence: `views/CustomerView.tsx`)
- Customer Checkout → Cloud Data Service: reads transaction (evidence: `views/CustomerView.tsx`)
- Customer Checkout → Exit QR: shows exit QR (evidence: `README.md`)
- Customer Checkout → Preorder QR: creates preorder QR (evidence: `views/CustomerView.tsx`)
- Store Staff → Exit Verification: verifies purchase (evidence: `README.md`)
- Exit Verification → Preorder QR: decodes preorder QR (evidence: `views/StaffView.tsx`)
- Exit Verification → Local Transactions: updates status (evidence: `views/StaffView.tsx`)
- Store Admin → Cloud Data Service: loads store data (evidence: `views/AdminView.tsx`)
- Store Admin → Gemini AI Service: requests analysis (evidence: `views/AdminView.tsx`)
- Customer Checkout → AI Shopping Help: offers shopping help (evidence: `views/CustomerView.tsx`)
- AI Shopping Help → Gemini AI Service: requests AI help
- Gemini AI Service → Gemini API: calls model
- Cloud Data Service → Firebase Setup: uses setup (evidence: `services/firebaseService.ts`)
- Cloud Data Service → Local Transactions: uses local store (evidence: `services/firebaseService.ts`)
- Cloud Data Service → Firebase: reads and writes
- App Shell → Language Selector: renders selector (evidence: `App.tsx`)
- Customer Checkout → Language Selector: renders selector (evidence: `views/CustomerView.tsx`)
- Exit Verification → Language Selector: renders selector (evidence: `views/StaffView.tsx`)
- Language Selector → Language Context: changes language (evidence: `components/LanguageSelector.tsx`)
- Language Context → Translations: loads translations (evidence: `context/LanguageContext.tsx`)
