Mobile Shop Manager - Python Flask POS

Mobile Shop Manager is a complete, production-ready management system 

for mobile phone and accessories shops, built with Python Flask.

Features: - Product Management (add/edit/delete, brand, model, category) - POS / Sales — multi-product transactions with stock validation - Customer Management with purchase history - Inventory tracking with real-time stock levels - Reports & Analytics with Chart.js charts - Invoice printing (auto invoice number) - CSV Export (sales & products) - Bengali & English UI support - Payment methods: Cash, bKash, Nagad, Rocket, Card

Tech Stack: Python 3.8+, Flask 3.0, SQLite, Bootstrap-style CSS, Chart.js

Installation: Extract ZIP → pip install -r requirements.txt → python app.py Windows: Double-click run.bat

Features

✔ Product Management — Add, edit, delete products with category, brand, model, purchase price, selling price and stock quantity

✔ POS / Sales System — Create sales with multiple products in one transaction, automatic stock deduction and invoice number generation ✔ Customer Management — Store customer profiles with phone, email, address and full purchase history ✔ Inventory Tracking — Real-time stock levels with low stock and out-of-stock alerts ✔ Sales Reports — Daily and monthly sales summary, profit analysis, top 10 best-selling products ✔ Payment Methods — Supports Cash, bKash, Nagad, Rocket and Card payments ✔ Chart.js Analytics — Visual revenue charts, category-wise sales breakdown and payment method analysis ✔ Invoice Printing — Browser-based invoice print with auto-generated invoice number ✔ CSV Export — Export sales and product data to CSV for Excel ✔ Demo Data Loader — seed_data.py script to populate sample products, customers and sales instantly ✔ One-Click Launcher — run.bat for Windows, run.sh for Linux/macOS ✔ Clean Codebase — Well-structured Flask app with separate models, routes and templates ✔ SQLite Database — Zero configuration, auto-created on first run, no server setup needed ✔ Bootstrap UI — Responsive design, works on desktop and tablet browsers

Requirements

- Python 3.8 or higher - pip (Python package manager) - Internet connection (for Chart.js, Font Awesome and Google Fonts CDN) - Modern web browser (Chrome, Firefox, Edge, Safari) - Windows / Linux / macOS supported

Python packages (auto-installed via requirements.txt): - Flask 3.0 - Flask-SQLAlchemy - Werkzeug

Instructions

# Installation & Setup

Step 1 — Extract the ZIP file

Extract the downloaded Mobile-Shop-Manager.zip file to your desired folder.

Step 2 — Install Python

Make sure Python 3.8 or higher is installed on your system. Download from: https://www.python.org/downloa...

Step 3 — Install dependencies

Open terminal or command prompt inside the project folder and run:

pip install -r requirements.txt

Step 4 — Run the application

Windows (Easy Method): Double-click run.bat — it will install dependencies and start the server automatically.

Windows (Manual): python app.py

Linux / macOS: bash run.sh

or manually:

python3 app.py

Step 5 — Load demo data (Optional)

To populate the system with sample products, customers and sales data:

python seed_data.py

Step 6 — Open in browser

http://localhost:5000

# Default Login

Username: admin Password: admin123

(Change the password after first login from the Settings page)

# File Structure

Mobile-Shop-Manager/ ├── app.py               — Main application and all routes ├── models.py            — Database models ├── extensions.py        — Flask extensions ├── requirements.txt     — Python dependencies ├── seed_data.py         — Demo data loader ├── .env.example         — Environment variable template ├── run.bat              — Windows one-click launcher ├── run.sh               — Linux/macOS launcher ├── static/              — CSS, JS, images └── templates/           — HTML templates

#Notes

- Database is created automatically on first run (no manual setup needed) - All data is stored locally in a SQLite database file - Internet connection required for CDN resources (Chart.js, Font Awesome, Google Fonts) - For production deployment, change the SECRET_KEY in .env file