{"id":23555302,"url":"https://github.com/devoloper-1/retailpulse","last_synced_at":"2026-04-11T19:01:26.446Z","repository":{"id":269336207,"uuid":"904071075","full_name":"DEVOLOPER-1/RetailPulse","owner":"DEVOLOPER-1","description":" A dynamic data visualization dashboard analyzing global supermarket trends, competitors, and market insights","archived":false,"fork":false,"pushed_at":"2024-12-22T19:55:42.000Z","size":55668,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-22T20:32:05.192Z","etag":null,"topics":["amcharts5","bootstrap","css","data-visualization","database","flask","html","javascript","pandas","python","sqlalchemy","sqlite","tailwind-css","walmart"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DEVOLOPER-1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-16T07:44:26.000Z","updated_at":"2024-12-22T19:55:45.000Z","dependencies_parsed_at":"2024-12-22T20:42:10.435Z","dependency_job_id":null,"html_url":"https://github.com/DEVOLOPER-1/RetailPulse","commit_stats":null,"previous_names":["devoloper-1/retailpulse"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DEVOLOPER-1%2FRetailPulse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DEVOLOPER-1%2FRetailPulse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DEVOLOPER-1%2FRetailPulse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DEVOLOPER-1%2FRetailPulse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DEVOLOPER-1","download_url":"https://codeload.github.com/DEVOLOPER-1/RetailPulse/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239301938,"owners_count":19616451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amcharts5","bootstrap","css","data-visualization","database","flask","html","javascript","pandas","python","sqlalchemy","sqlite","tailwind-css","walmart"],"created_at":"2024-12-26T13:14:02.754Z","updated_at":"2025-11-01T15:30:32.601Z","avatar_url":"https://github.com/DEVOLOPER-1.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛒 Target Market Intelligence Dashboard\n\nWelcome 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.\n\n---\n\n## 📽️ Showcase Video  \n_[Demo](https://mega.nz/file/sKoRTSia#pL4DvLnilsSuPEQRdELqXUdxEXY68JV1Jgz7ZirJKQY)_\n\n---\n\n## 🌟 Features\n- **Competitor Analysis Cards**: Displays real-time financial data for Target, Walmart, and Carrefour, including:\n  - Stock prices 📈  \n  - Net income 💵  \n  - Price movements 🔼🔽\n- **Interactive Map Visualization**:  \n  - Visualize store locations globally using 3D and flat map projections 🌍🗺️.  \n  - Clickable, color-coded markers for each company (Target: Red, Walmart: Yellow, Carrefour: Blue).  \n- **Real-time Updates**:\n  - Auto-refreshing data every 30 seconds 🔄.  \n  - Live purchase simulations with animated toast notifications.  \n- **User-Friendly Interface**:\n  - Modern, responsive design with Tailwind CSS for seamless user experience 💻📱.\n\n---\n\n## 🚀 Getting Started  \nFollow these steps to set up and run the dashboard:\n\n### Prerequisites\n1. **Python 3.8+** installed.  \n2. Install the required Python libraries using the provided requirements file.  \n\n### Installation\n1. Clone this repository to your local machine:\n   ```bash\n   git clone https://github.com/DEVOLOPER-1/RetailPulse.git\n\n2. Navigate to the project directory:\n   ```bash\n   cd RetailPulse\n   ```\n3. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n### Usage\n1. Start the Flask backend server:\n   ```bash\n   python app.py\n   ```\n2. Open your browser and navigate to:\n   ```\n   http://127.0.0.1:5000\n   ```\n\n### Project Structure\n- **Backend**:\n  - Fetches data from `yfinance` and Google Local Search API.\n  - Simulates live purchase activity.\n  - Scrapped Data Stored into Sqlite DB.\n- **Frontend**:\n  - Built with Tailwind CSS for responsive, visually appealing design.  \n  - Dynamic charts powered by `amCharts 5`.  \n\n---\n\n## 📊 How to Use the Dashboard\n1. **Explore Financial Metrics**:\n   - Use the competitor analysis cards to monitor stock prices, net income, and price movements.  \n   - Compare Target's performance with Walmart and Carrefour.  \n\n2. **Analyze Store Locations**:\n   - Switch between globe and flat map views to explore store locations globally.  \n   - Hover or click on markers for more details and links to Google searches.  \n\n3. **Monitor Real-Time Activity**:\n   - Check live purchase simulations via toast notifications.  \n   - Observe dynamic marker animations where **pulse motion adapts to order price**, highlighting significant transactions.\n\n---\n\n## 🎯 Goals Addressed by the Dashboard\n- Analyze financial performance and trends.  \n- Explore geographical presence and overlaps between competitors.  \n- Identify market opportunities, purchase patterns, and regional strengths.  \n\n---\n\n## 🤝 Contributing\nWe welcome contributions to improve the dashboard!  \n- Fork the repository.  \n- Create a feature branch: `git checkout -b feature-name`.  \n- Commit changes and create a pull request.\n\n---\n\n## 📜 License\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## 📬 Contact\nFor questions or feedback, feel free to reach out:\n- **Linkedin**: [Youssef Mohammad](https://www.linkedin.com/in/youssef-mohammad-9341a71a7)\n- **GitHub**: [DEVOLOPER-1](https://github.com/DEVOLOPER-1)\n\n---\n✨ Happy analyzing! ✨\n```\nYoussef Mohammad 🙂\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevoloper-1%2Fretailpulse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevoloper-1%2Fretailpulse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevoloper-1%2Fretailpulse/lists"}