Skip to content

Latest commit

 

History

History
114 lines (89 loc) · 3.56 KB

README.md

File metadata and controls

114 lines (89 loc) · 3.56 KB

🛒 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

🌟 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: 
    git clone https://github.com/DEVOLOPER-1/RetailPulse.git
  2. Navigate to the project directory: 
    cd RetailPulse
  3. Install dependencies: 
    pip install -r requirements.txt

Usage

  1. Start the Flask backend server: 
    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.

📬 Contact

For questions or feedback, feel free to reach out:

✨ Happy analyzing! ✨

Youssef Mohammad 🙂