# harsha-18811/retailmind-ai architecture

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

- Interactive diagram: https://gitdiagram.com/harsha-18811/retailmind-ai
- Repository: https://github.com/harsha-18811/retailmind-ai

## Overview

RetailMind AI is a retail-operations dashboard for shop owners. The main workflow is shop login and data loading, followed by inventory and sales management; analytics then surface performance, stockout and expiry risks, purchase plans, and reports. The app also provides product and sales forms, sustainability estimates, voice input, and multilingual UI. The graph reflects documented imports and visible calls; several page implementations were not excerpted, so their internal behavior is represented only where the source index supports it.

Main entry points: [`retailmind-ai/src/App.jsx`](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/App.jsx) (App and routing), [`retailmind-ai/src/utils/calculations.js`](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/calculations.js) (Retail calculations), [`retailmind-ai/src/utils/aiEngine.js`](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/aiEngine.js) (Retail scoring engine), [`retailmind-ai/src/pages/PurchaseOptimizer.jsx`](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/PurchaseOptimizer.jsx) (Purchase optimizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_app["App and routing<br/>[App.jsx]"]
  node_login["Shop login<br/>[Login.jsx]"]
  node_sidebar["Navigation sidebar<br/>[Sidebar.jsx]"]
end

subgraph group_operations["Retail operations"]
  node_products["Product inventory<br/>[Products.jsx]"]
  node_productform["Product form<br/>[ProductForm.jsx]"]
  node_sales["Sales history<br/>[SalesHistory.jsx]"]
  node_saleform["Sale form<br/>[SaleForm.jsx]"]
  node_voice["Voice input"]
end

subgraph group_insights["Analytics and planning"]
  node_dashboard["Business dashboard<br/>[Dashboard.jsx]"]
  node_analysis["AI analysis<br/>[AIAnalysis.jsx]"]
  node_profit["Profit intelligence"]
  node_risk["Risk analysis<br/>[RiskAnalysis.jsx]"]
  node_optimizer["Purchase optimizer"]
  node_reports["Business reports<br/>[Reports.jsx]"]
  node_recommendations["Recommendation panel"]
end

subgraph group_shared["Shared services"]
  node_i18n["Language context<br/>[I18nContext.jsx]"]
  node_engine["Retail scoring engine<br/>[aiEngine.js]"]
  node_calculations["Retail calculations<br/>[calculations.js]"]
  node_sustainability["Sustainability estimates<br/>[sustainability.js]"]
  node_mockdata["Demo data and storage<br/>[mockData.js]"]
  node_supabaseclient["Supabase client<br/>[supabaseClient.js]"]
  node_export["Report export<br/>[export.js]"]
  node_voicehook["Voice recognition hook<br/>[useVoiceInput.js]"]
end

node_owner(("Shop owner"))
node_supabase[("Supabase service")]

node_owner -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_products
node_app -->|"routes to"| node_sales
node_app -->|"routes to"| node_analysis
node_app -->|"routes to"| node_profit
node_app -->|"routes to"| node_risk
node_app -->|"routes to"| node_optimizer
node_app -->|"routes to"| node_reports
node_app -->|"renders"| node_sidebar
node_app -->|"queries"| node_supabaseclient
node_supabaseclient -->|"connects to"| node_supabase
node_app -->|"passes profile"| node_login
node_products -->|"renders"| node_productform
node_sales -->|"renders"| node_saleform
node_productform -->|"uses"| node_voice
node_saleform -->|"uses"| node_voice
node_voice -->|"delegates to"| node_voicehook
node_products -->|"uses"| node_calculations
node_products -->|"uses"| node_mockdata
node_sales -->|"uses"| node_calculations
node_dashboard -->|"analyzes with"| node_engine
node_dashboard -->|"aggregates with"| node_calculations
node_dashboard -->|"renders"| node_recommendations
node_analysis -->|"analyzes with"| node_engine
node_profit -->|"analyzes with"| node_engine
node_profit -->|"uses"| node_calculations
node_risk -->|"analyzes with"| node_engine
node_risk -->|"uses"| node_calculations
node_risk -->|"estimates with"| node_sustainability
node_optimizer -->|"optimizes with"| node_engine
node_optimizer -->|"uses"| node_calculations
node_optimizer -->|"estimates with"| node_sustainability
node_optimizer -->|"reads budget key"| node_mockdata
node_reports -->|"analyzes with"| node_engine
node_reports -->|"aggregates with"| node_calculations
node_reports -->|"exports through"| node_export
node_engine -->|"uses"| node_calculations
node_app -->|"uses"| node_i18n

click node_app "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/App.jsx"
click node_login "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Login.jsx"
click node_sidebar "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/Sidebar.jsx"
click node_i18n "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/i18n/I18nContext.jsx"
click node_dashboard "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Dashboard.jsx"
click node_products "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Products.jsx"
click node_productform "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/ProductForm.jsx"
click node_sales "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/SalesHistory.jsx"
click node_saleform "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/SaleForm.jsx"
click node_analysis "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/AIAnalysis.jsx"
click node_profit "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/ProfitIntelligence.jsx"
click node_risk "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/RiskAnalysis.jsx"
click node_optimizer "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/PurchaseOptimizer.jsx"
click node_reports "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Reports.jsx"
click node_engine "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/aiEngine.js"
click node_calculations "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/calculations.js"
click node_sustainability "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/sustainability.js"
click node_mockdata "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/data/mockData.js"
click node_supabaseclient "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/supabaseClient.js"
click node_export "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/export.js"
click node_recommendations "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/AIRecommendationPanel.jsx"
click node_voice "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/VoiceInputButton.jsx"
click node_voicehook "https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/useVoiceInput.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_app,node_login,node_sidebar toneBlue
class node_products,node_productform,node_sales,node_saleform,node_voice,node_supabase toneAmber
class node_dashboard,node_analysis,node_profit,node_risk,node_optimizer,node_reports,node_recommendations toneMint
class node_i18n,node_engine,node_calculations,node_sustainability,node_mockdata,node_supabaseclient,node_export,node_voicehook toneRose
class node_owner toneIndigo
```

## Components

### Application shell

- [App and routing](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/App.jsx): `retailmind-ai/src/App.jsx`
- [Shop login](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Login.jsx): `retailmind-ai/src/pages/Login.jsx`
- [Navigation sidebar](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/Sidebar.jsx): `retailmind-ai/src/components/Sidebar.jsx`

### Retail operations

- [Product inventory](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Products.jsx): `retailmind-ai/src/pages/Products.jsx`
- [Product form](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/ProductForm.jsx): `retailmind-ai/src/components/ProductForm.jsx`
- [Sales history](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/SalesHistory.jsx): `retailmind-ai/src/pages/SalesHistory.jsx`
- [Sale form](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/SaleForm.jsx): `retailmind-ai/src/components/SaleForm.jsx`
- [Voice input](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/VoiceInputButton.jsx): `retailmind-ai/src/components/VoiceInputButton.jsx`

### Analytics and planning

- [Business dashboard](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Dashboard.jsx): `retailmind-ai/src/pages/Dashboard.jsx`
- [AI analysis](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/AIAnalysis.jsx): `retailmind-ai/src/pages/AIAnalysis.jsx`
- [Profit intelligence](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/ProfitIntelligence.jsx): `retailmind-ai/src/pages/ProfitIntelligence.jsx`
- [Risk analysis](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/RiskAnalysis.jsx): `retailmind-ai/src/pages/RiskAnalysis.jsx`
- [Purchase optimizer](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/PurchaseOptimizer.jsx): `retailmind-ai/src/pages/PurchaseOptimizer.jsx`
- [Business reports](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/pages/Reports.jsx): `retailmind-ai/src/pages/Reports.jsx`
- [Recommendation panel](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/components/AIRecommendationPanel.jsx): `retailmind-ai/src/components/AIRecommendationPanel.jsx`

### Shared services

- [Language context](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/i18n/I18nContext.jsx): `retailmind-ai/src/i18n/I18nContext.jsx`
- [Retail scoring engine](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/aiEngine.js): `retailmind-ai/src/utils/aiEngine.js`
- [Retail calculations](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/calculations.js): `retailmind-ai/src/utils/calculations.js`
- [Sustainability estimates](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/sustainability.js): `retailmind-ai/src/utils/sustainability.js`
- [Demo data and storage](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/data/mockData.js): `retailmind-ai/src/data/mockData.js`
- [Supabase client](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/supabaseClient.js): `retailmind-ai/src/utils/supabaseClient.js`
- [Report export](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/export.js): `retailmind-ai/src/utils/export.js`
- [Voice recognition hook](https://github.com/harsha-18811/retailmind-ai/blob/main/retailmind-ai/src/utils/useVoiceInput.js): `retailmind-ai/src/utils/useVoiceInput.js`

### Other components

- **Shop owner**
- **Supabase service**

## Connections

- Shop owner → App and routing: uses
- App and routing → Shop login: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Business dashboard: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Product inventory: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Sales history: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → AI analysis: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Profit intelligence: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Risk analysis: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Purchase optimizer: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Business reports: routes to (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Navigation sidebar: renders (evidence: `retailmind-ai/src/App.jsx`)
- App and routing → Supabase client: queries (evidence: `retailmind-ai/src/App.jsx`)
- Supabase client → Supabase service: connects to (evidence: `retailmind-ai/src/utils/supabaseClient.js`)
- App and routing → Shop login: passes profile (evidence: `retailmind-ai/src/App.jsx`)
- Product inventory → Product form: renders (evidence: `retailmind-ai/src/pages/Products.jsx`)
- Sales history → Sale form: renders (evidence: `retailmind-ai/src/pages/SalesHistory.jsx`)
- Product form → Voice input: uses (evidence: `retailmind-ai/src/components/ProductForm.jsx`)
- Sale form → Voice input: uses (evidence: `retailmind-ai/src/components/SaleForm.jsx`)
- Voice input → Voice recognition hook: delegates to (evidence: `retailmind-ai/src/components/VoiceInputButton.jsx`)
- Product inventory → Retail calculations: uses (evidence: `retailmind-ai/src/pages/Products.jsx`)
- Product inventory → Demo data and storage: uses (evidence: `retailmind-ai/src/pages/Products.jsx`)
- Sales history → Retail calculations: uses (evidence: `retailmind-ai/src/pages/SalesHistory.jsx`)
- Business dashboard → Retail scoring engine: analyzes with (evidence: `retailmind-ai/src/pages/Dashboard.jsx`)
- Business dashboard → Retail calculations: aggregates with (evidence: `retailmind-ai/src/pages/Dashboard.jsx`)
- Business dashboard → Recommendation panel: renders (evidence: `retailmind-ai/src/pages/Dashboard.jsx`)
- AI analysis → Retail scoring engine: analyzes with (evidence: `retailmind-ai/src/pages/AIAnalysis.jsx`)
- Profit intelligence → Retail scoring engine: analyzes with (evidence: `retailmind-ai/src/pages/ProfitIntelligence.jsx`)
- Profit intelligence → Retail calculations: uses (evidence: `retailmind-ai/src/pages/ProfitIntelligence.jsx`)
- Risk analysis → Retail scoring engine: analyzes with (evidence: `retailmind-ai/src/pages/RiskAnalysis.jsx`)
- Risk analysis → Retail calculations: uses (evidence: `retailmind-ai/src/pages/RiskAnalysis.jsx`)
- Risk analysis → Sustainability estimates: estimates with (evidence: `retailmind-ai/src/pages/RiskAnalysis.jsx`)
- Purchase optimizer → Retail scoring engine: optimizes with (evidence: `retailmind-ai/src/pages/PurchaseOptimizer.jsx`)
- Purchase optimizer → Retail calculations: uses (evidence: `retailmind-ai/src/pages/PurchaseOptimizer.jsx`)
- Purchase optimizer → Sustainability estimates: estimates with (evidence: `retailmind-ai/src/pages/PurchaseOptimizer.jsx`)
- Purchase optimizer → Demo data and storage: reads budget key (evidence: `retailmind-ai/src/pages/PurchaseOptimizer.jsx`)
- Business reports → Retail scoring engine: analyzes with (evidence: `retailmind-ai/src/pages/Reports.jsx`)
- Business reports → Retail calculations: aggregates with (evidence: `retailmind-ai/src/pages/Reports.jsx`)
- Business reports → Report export: exports through (evidence: `retailmind-ai/src/pages/Reports.jsx`)
- Retail scoring engine → Retail calculations: uses (evidence: `retailmind-ai/src/utils/aiEngine.js`)
- App and routing → Language context: uses (evidence: `retailmind-ai/src/App.jsx`)
