# siddharthkaulagi/unified-retail-intelligence-platform-urip- architecture

> Architecture diagram of the GitHub repository siddharthkaulagi/unified-retail-intelligence-platform-urip-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-
- Repository: https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-

## Overview

URIP is a Streamlit retail intelligence application: users enter through the landing/authentication app, then navigate to data upload and specialized analytics pages for forecasting, inventory, CRM, GIS, facility layout, dashboards, reports, and AI assistance. The sampled app code confirms authentication/session handling and navigation to upload and forecasting; the README documents the broader capabilities. Page-level wiring and most analytics implementations were not sampled, so those modules are represented without speculative processing links.

Main entry points: [`workspace/streamlit_template/app.py`](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/app.py) (App and Login), [`workspace/streamlit_template/utils/gemini_ai.py`](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/gemini_ai.py) (Gemini Integration), [`workspace/streamlit_template/pages/09_AI_Chatbot.py`](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/09_AI_Chatbot.py) (AI Chatbot), [`workspace/streamlit_template/utils/floating_chatbot.py`](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/floating_chatbot.py) (Floating Chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and Data"]
  node_app["App and Login<br/>[app.py]"]
  node_upload["Data Upload<br/>[01_Upload_Data.py]"]
end

subgraph group_analytics["Retail Analytics"]
  node_selection["Model Selection"]
  node_forecast["Demand Forecasting"]
  node_crm["CRM Analytics"]
  node_facility["Facility Layout"]
  node_gis["Store Location GIS"]
  node_inventory["Inventory Analytics"]
end

subgraph group_insights["Decision Support"]
  node_dashboard["KPI Dashboard<br/>[03_Dashboard.py]"]
  node_reports["Reports<br/>[04_Reports.py]"]
  node_chat["AI Chatbot<br/>[09_AI_Chatbot.py]"]
end

subgraph group_services["Shared Services"]
  node_store[("User Sessions<br/>[database.py]")]
  node_models["Forecast Models<br/>[models.py]"]
  node_settings["Settings<br/>[05_Settings.py]"]
  node_gemini["Gemini Integration<br/>[gemini_ai.py]"]
  node_floating["Floating Chat"]
end

node_user(("Retail User"))
node_gemini_service{{"Gemini API"}}

node_user -->|"opens"| node_app
node_app -->|"authenticates with"| node_store
node_app -->|"navigates to"| node_upload
node_app -->|"navigates to"| node_forecast
node_app -->|"offers navigation"| node_selection
node_app -->|"offers navigation"| node_dashboard
node_app -->|"offers navigation"| node_reports
node_app -->|"offers navigation"| node_settings
node_app -->|"offers navigation"| node_crm
node_app -->|"offers navigation"| node_facility
node_app -->|"offers navigation"| node_chat
node_app -->|"offers navigation"| node_gis
node_app -->|"offers navigation"| node_inventory
node_chat -.->|"requests AI"| node_gemini
node_floating -.->|"requests AI"| node_gemini
node_gemini -.->|"calls"| node_gemini_service

click node_app "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/app.py"
click node_store "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/database.py"
click node_upload "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/01_Upload_Data.py"
click node_selection "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/02_Model_Selection.py"
click node_models "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/models.py"
click node_dashboard "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/03_Dashboard.py"
click node_reports "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/04_Reports.py"
click node_settings "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/05_Settings.py"
click node_forecast "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/06_Demand_Forecasting.py"
click node_crm "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/07_CRM_Analytics.py"
click node_facility "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/08_Facility_Layout.py"
click node_chat "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/09_AI_Chatbot.py"
click node_gis "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/10_Store_Location_GIS.py"
click node_inventory "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/11_Inventory_Analytics.py"
click node_gemini "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/gemini_ai.py"
click node_floating "https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/floating_chatbot.py"

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_upload,node_user toneBlue
class node_selection,node_forecast,node_crm,node_facility,node_gis,node_inventory toneAmber
class node_dashboard,node_reports,node_chat,node_gemini_service toneMint
class node_store,node_models,node_settings,node_gemini,node_floating toneRose
```

## Components

### Access and Data

- [App and Login](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/app.py): `workspace/streamlit_template/app.py`
- [Data Upload](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/01_Upload_Data.py): `workspace/streamlit_template/pages/01_Upload_Data.py`

### Retail Analytics

- [Model Selection](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/02_Model_Selection.py): `workspace/streamlit_template/pages/02_Model_Selection.py`
- [Demand Forecasting](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/06_Demand_Forecasting.py): `workspace/streamlit_template/pages/06_Demand_Forecasting.py`
- [CRM Analytics](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/07_CRM_Analytics.py): `workspace/streamlit_template/pages/07_CRM_Analytics.py`
- [Facility Layout](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/08_Facility_Layout.py): `workspace/streamlit_template/pages/08_Facility_Layout.py`
- [Store Location GIS](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/10_Store_Location_GIS.py): `workspace/streamlit_template/pages/10_Store_Location_GIS.py`
- [Inventory Analytics](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/11_Inventory_Analytics.py): `workspace/streamlit_template/pages/11_Inventory_Analytics.py`

### Decision Support

- [KPI Dashboard](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/03_Dashboard.py): `workspace/streamlit_template/pages/03_Dashboard.py`
- [Reports](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/04_Reports.py): `workspace/streamlit_template/pages/04_Reports.py`
- [AI Chatbot](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/09_AI_Chatbot.py): `workspace/streamlit_template/pages/09_AI_Chatbot.py`

### Shared Services

- [User Sessions](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/database.py): `workspace/streamlit_template/utils/database.py`
- [Forecast Models](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/models.py): `workspace/streamlit_template/utils/models.py`
- [Settings](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/pages/05_Settings.py): `workspace/streamlit_template/pages/05_Settings.py`
- [Gemini Integration](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/gemini_ai.py): `workspace/streamlit_template/utils/gemini_ai.py`
- [Floating Chat](https://github.com/siddharthkaulagi/unified-retail-intelligence-platform-urip-/blob/main/workspace/streamlit_template/utils/floating_chatbot.py): `workspace/streamlit_template/utils/floating_chatbot.py`

### Other components

- **Retail User**
- **Gemini API**

## Connections

- Retail User → App and Login: opens
- App and Login → User Sessions: authenticates with
- App and Login → Data Upload: navigates to
- App and Login → Demand Forecasting: navigates to
- App and Login → Model Selection: offers navigation
- App and Login → KPI Dashboard: offers navigation
- App and Login → Reports: offers navigation
- App and Login → Settings: offers navigation
- App and Login → CRM Analytics: offers navigation
- App and Login → Facility Layout: offers navigation
- App and Login → AI Chatbot: offers navigation
- App and Login → Store Location GIS: offers navigation
- App and Login → Inventory Analytics: offers navigation
- AI Chatbot → Gemini Integration: requests AI
- Floating Chat → Gemini Integration: requests AI
- Gemini Integration → Gemini API: calls