https://github.com/devoloper-1/retailpulse
A dynamic data visualization dashboard analyzing global supermarket trends, competitors, and market insights
https://github.com/devoloper-1/retailpulse
amcharts5 bootstrap css data-visualization database flask html javascript pandas python sqlalchemy sqlite tailwind-css walmart
Last synced: 5 months ago
JSON representation
A dynamic data visualization dashboard analyzing global supermarket trends, competitors, and market insights
- Host: GitHub
- URL: https://github.com/devoloper-1/retailpulse
- Owner: DEVOLOPER-1
- License: mit
- Created: 2024-12-16T07:44:26.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-22T19:55:42.000Z (6 months ago)
- Last Synced: 2024-12-22T20:32:05.192Z (6 months ago)
- Topics: amcharts5, bootstrap, css, data-visualization, database, flask, html, javascript, pandas, python, sqlalchemy, sqlite, tailwind-css, walmart
- Language: JavaScript
- Homepage:
- Size: 53.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🛒 Target Market Intelligence Dashboard
Welcome to the **Target Market Intelligence Dashboard** repository! 🎉 This tool provides real-time insights into Target's financial and geographical data, comparing it with competitors Walmart and Carrefour. It integrates dynamic visualizations and real-time updates to assist stakeholders in making informed business decisions.
---
## 📽️ Showcase Video
_[Demo](https://mega.nz/file/sKoRTSia#pL4DvLnilsSuPEQRdELqXUdxEXY68JV1Jgz7ZirJKQY)_
---
## 🌟 Features
- **Competitor Analysis Cards**: Displays real-time financial data for Target, Walmart, and Carrefour, including:
- Stock prices 📈
- Net income 💵
- Price movements 🔼🔽
- **Interactive Map Visualization**:
- Visualize store locations globally using 3D and flat map projections 🌍🗺️.
- Clickable, color-coded markers for each company (Target: Red, Walmart: Yellow, Carrefour: Blue).
- **Real-time Updates**:
- Auto-refreshing data every 30 seconds 🔄.
- Live purchase simulations with animated toast notifications.
- **User-Friendly Interface**:
- Modern, responsive design with Tailwind CSS for seamless user experience 💻📱.
---
## 🚀 Getting Started
Follow these steps to set up and run the dashboard:
### Prerequisites
1. **Python 3.8+** installed.
2. Install the required Python libraries using the provided requirements file.
### Installation
1. Clone this repository to your local machine:
```bash
git clone https://github.com/DEVOLOPER-1/RetailPulse.git
2. Navigate to the project directory:
```bash
cd RetailPulse
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
### Usage
1. Start the Flask backend server:
```bash
python app.py
```
2. Open your browser and navigate to:
```
http://127.0.0.1:5000
```
### Project Structure
- **Backend**:
- Fetches data from `yfinance` and Google Local Search API.
- Simulates live purchase activity.
- Scrapped Data Stored into Sqlite DB.
- **Frontend**:
- Built with Tailwind CSS for responsive, visually appealing design.
- Dynamic charts powered by `amCharts 5`.
---
## 📊 How to Use the Dashboard
1. **Explore Financial Metrics**:
- Use the competitor analysis cards to monitor stock prices, net income, and price movements.
- Compare Target's performance with Walmart and Carrefour.
2. **Analyze Store Locations**:
- Switch between globe and flat map views to explore store locations globally.
- Hover or click on markers for more details and links to Google searches.
3. **Monitor Real-Time Activity**:
- Check live purchase simulations via toast notifications.
- Observe dynamic marker animations where **pulse motion adapts to order price**, highlighting significant transactions.
---
## 🎯 Goals Addressed by the Dashboard
- Analyze financial performance and trends.
- Explore geographical presence and overlaps between competitors.
- Identify market opportunities, purchase patterns, and regional strengths.
---
## 🤝 Contributing
We welcome contributions to improve the dashboard!
- Fork the repository.
- Create a feature branch: `git checkout -b feature-name`.
- Commit changes and create a pull request.
---
## 📜 License
This project is licensed under the [MIT License](LICENSE).
---
## 📬 Contact
For questions or feedback, feel free to reach out:
- **Linkedin**: [Youssef Mohammad](https://www.linkedin.com/in/youssef-mohammad-9341a71a7)
- **GitHub**: [DEVOLOPER-1](https://github.com/DEVOLOPER-1)
---
✨ Happy analyzing! ✨
```
Youssef Mohammad 🙂
```