An open API service indexing awesome lists of open source software.

https://github.com/yeuner/margin-price-data-demo-app

This Streamlit application is a hands-on demo designed to showcase core technical skills related to data analysis, pricing logic, SQL querying, and visualization. It simulates a simple real-world logistics dataset analysis workflow and serves as a personal project.
https://github.com/yeuner/margin-price-data-demo-app

data-science pycthon sql

Last synced: about 1 year ago
JSON representation

This Streamlit application is a hands-on demo designed to showcase core technical skills related to data analysis, pricing logic, SQL querying, and visualization. It simulates a simple real-world logistics dataset analysis workflow and serves as a personal project.

Awesome Lists containing this project

README

          

# πŸ“Š Technical Skills Showcase β€” Streamlit Demo App

[![Streamlit App](https://img.shields.io/badge/Live%20App-Click%20to%20View-brightgreen?style=for-the-badge&logo=streamlit)](https://margin-price-data-demo-app-dah8v5gx8khbx4xtzopbxd.streamlit.app/)

This Streamlit application is a hands-on demo designed to showcase core technical skills related to data analysis, pricing logic, SQL querying, and visualization. It simulates a simple real-world logistics dataset analysis workflow and serves as a personal project to practice and demonstrate the following:

- πŸ“Š **Data Analysis** with pandas
- πŸ’Έ **Pricing & Profitability Calculations**
- 🧠 **SQL Query Execution** using SQLite
- πŸ“ˆ **Visualization** using matplotlib
- πŸ“₯ **CSV Handling** and dynamic input management

---

## πŸš€ What This App Does

1. **Upload Data**: Accepts a logistics-style CSV file or uses a sample dataset (`demo_logistics_data.csv`).
2. **Preview Data**: Displays the first few rows and gives a shape + null count summary.
3. **Profit & Margin Analysis**: Automatically calculates unit profit and margin percent using `Price` and `Cost` columns.
4. **Histogram Visualization**: Shows the distribution of profit margins.
5. **SQL Query Engine**: Allows you to write SQL queries directly on the uploaded data.
6. **Insights Summary**: Shows top-performing products and key profitability metrics.

---

## πŸ“‚ How to Run

1. Clone this repository:
```bash
git clone https://github.com/yeuner/margin-price-data-demo-app.git
cd margin-price-data-demo-app
```

2. (Optional) Create and activate a virtual environment:
```bash
python -m venv env
source env/bin/activate # On Windows: .\env\Scripts\activate
```

3. Install dependencies:
```bash
pip install -r requirements.txt
```

4. Run the app:
```bash
streamlit run data-app-demo.py
```

---

## πŸ“¦ Sample Data

If you don’t upload a file, the app will use `demo_logistics_data.csv` located in the same folder. Make sure it’s present in the root directory.

---

## πŸ› οΈ Tech Stack

- **Streamlit**: UI and app engine
- **pandas**: Data manipulation
- **matplotlib**: Visualizations
- **sqlite3**: In-memory SQL engine

---

## πŸ“š Why This Project?

This project was created to **practice and demonstrate key technical skills** in a compact and professional way as part of my personal portfolio.

---

## πŸ“¬ Feedback & Contributions

Feel free to fork the repo, try it out, and share feedback or improvements!