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

✔ 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

- 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

# 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