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.
- Host: GitHub
- URL: https://github.com/yeuner/margin-price-data-demo-app
- Owner: Yeuner
- Created: 2025-03-26T18:51:55.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-26T19:15:26.000Z (about 1 year ago)
- Last Synced: 2025-03-26T20:24:16.696Z (about 1 year ago)
- Topics: data-science, pycthon, sql
- Language: Python
- Homepage: https://margin-price-data-demo-app-dah8v5gx8khbx4xtzopbxd.streamlit.app/
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# π Technical Skills Showcase β Streamlit Demo App
[](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!