# 25it038-beep/aura architecture

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

- Interactive diagram: https://gitdiagram.com/25it038-beep/aura
- Repository: https://github.com/25it038-beep/aura

## Overview

This repository is a browser-based cashierless smart-store simulation, presented as an interactive product walkthrough rather than a connected retail backend. The user explores product registration and expiry checks, AI/sensor-fusion concepts, store architecture and infrastructure, and a scan-to-exit shopping and payment journey. The React app owns the walkthrough and its simulated cart state; a Three.js canvas renders the store, while a status HUD exposes telemetry and view controls. The README is empty, so capabilities are taken from the sampled application and data excerpts; no external services or real operational systems are evidenced.

Main entry points: [`src/App.tsx`](https://github.com/25it038-beep/aura/blob/main/src/App.tsx) (Walkthrough and cart), [`src/main.tsx`](https://github.com/25it038-beep/aura/blob/main/src/main.tsx) (React mount), [`src/components/SmartStoreCanvas.tsx`](https://github.com/25it038-beep/aura/blob/main/src/components/SmartStoreCanvas.tsx) (Interactive 3D store), [`src/data/storeData.ts`](https://github.com/25it038-beep/aura/blob/main/src/data/storeData.ts) (Products and journey data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_mount["React mount<br/>[main.tsx]"]
end

subgraph group_walkthrough["Store walkthrough"]
  node_app["Walkthrough and cart<br/>[App.tsx]"]
  node_storedata["Products and journey data<br/>[storeData.ts]"]
end

subgraph group_simulation["Store simulation"]
  node_canvas["Interactive 3D store"]
  node_status["Telemetry and view controls"]
end

node_visitor(("Store explorer"))

node_visitor -->|"opens app"| node_mount
node_mount -->|"renders"| node_app
node_app -->|"uses products"| node_storedata
node_app -->|"renders"| node_canvas
node_app -->|"renders"| node_status
node_canvas -->|"uses scene data"| node_storedata

click node_mount "https://github.com/25it038-beep/aura/blob/main/src/main.tsx"
click node_app "https://github.com/25it038-beep/aura/blob/main/src/App.tsx"
click node_storedata "https://github.com/25it038-beep/aura/blob/main/src/data/storeData.ts"
click node_canvas "https://github.com/25it038-beep/aura/blob/main/src/components/SmartStoreCanvas.tsx"
click node_status "https://github.com/25it038-beep/aura/blob/main/src/components/LiveStoreStatusHUD.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_mount toneBlue
class node_app,node_storedata toneAmber
class node_canvas,node_status toneMint
class node_visitor toneIndigo
```

## Components

### App entry

- [React mount](https://github.com/25it038-beep/aura/blob/main/src/main.tsx): `src/main.tsx`

### Store walkthrough

- [Walkthrough and cart](https://github.com/25it038-beep/aura/blob/main/src/App.tsx): `src/App.tsx`
- [Products and journey data](https://github.com/25it038-beep/aura/blob/main/src/data/storeData.ts): `src/data/storeData.ts`

### Store simulation

- [Interactive 3D store](https://github.com/25it038-beep/aura/blob/main/src/components/SmartStoreCanvas.tsx): `src/components/SmartStoreCanvas.tsx`
- [Telemetry and view controls](https://github.com/25it038-beep/aura/blob/main/src/components/LiveStoreStatusHUD.tsx): `src/components/LiveStoreStatusHUD.tsx`

### Other components

- **Store explorer**

## Connections

- Store explorer → React mount: opens app
- React mount → Walkthrough and cart: renders (evidence: `src/main.tsx`)
- Walkthrough and cart → Products and journey data: uses products (evidence: `src/App.tsx`)
- Walkthrough and cart → Interactive 3D store: renders (evidence: `src/App.tsx`)
- Walkthrough and cart → Telemetry and view controls: renders (evidence: `src/App.tsx`)
- Interactive 3D store → Products and journey data: uses scene data (evidence: `src/components/SmartStoreCanvas.tsx`)
