Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚙️ Service & Solution — Professional Billing Software

মোবাইল সার্ভিস সেন্টার / রিপেয়ার শপের জন্য সম্পূর্ণ প্রফেশনাল বিলিং সফটওয়্যার অফলাইন + অনলাইন — দুই মোডেই চলে।

Flask + SQLite ভিত্তিক। কোনো ইন্টারনেট ছাড়াই আপনার কম্পিউটারে চলে, আবার Hosting দিলে যেকোনো জায়গা থেকে online ব্যবহার করা যায়।


🚀 চালানোর নিয়ম (অফলাইন)

Windows

  1. Python 3.10+ ইনস্টল করুন (https://python.org — ইনস্টলের সময় "Add to PATH" টিক দিন)
  2. billing_app ফোল্ডারটি আপনার কম্পিউটারে কপি করুন
  3. run.bat ডাবল-ক্লিক করুন
  4. ব্রাউজারে খুলুন: http://localhost:8000

Linux / Mac

cd billing_app
./run.sh

🌍 Online করার নিয়ম (ফ্রি হোস্টিং)

অপশন A — PythonAnywhere (সবচেয়ে সহজ, ফ্রি)

  1. https://www.pythonanywhere.com → Free Account তৈরি করুন
  2. Files → Uploadbilling_app.zip আপলোড করুন → unzip করুন
  3. Open Bash console:
cd ~
unzip billing_app.zip
pip3 install flask werkzeug itsdangerous --user
  1. Web → Add New Web App → Manual Config → Python 3.10
    • Source code: /home/আপনারইউজার/billing_app
    • WSGI file-এ লিখুন:
import sys
sys.path.insert(0, '/home/আপনারইউজার/billing_app')
from app import app as application
  1. Reload → আপনার URL: yourusername.pythonanywhere.com

অপশন B — Render / Railway (GitHub দিয়ে)

  1. billing_app GitHub-এ Push করুন
  2. Render → New Web Service → Repo Connect
    • Build: pip install -r requirements.txt
    • Start: gunicorn wsgi:application
  3. Deploy → your-app.onrender.com

ZIP ফাইলটিতে wsgi.py এবং Procfile আগে থেকেই আছে — হোস্টিং রেডি!


🔑 ডিফল্ট লগইন

Role Username Password দেখতে পাবে
Owner / Admin sobujmistri@icloud.com 774@@@nce সব ব্রাঞ্চ + সেটিংস + ব্রাঞ্চ/ইউজার
Kolkata Main kol1 1234 শুধু নিজের ব্রাঞ্চ
Salt Lake sl2 1234 শুধু নিজের ব্রাঞ্চ
Howrah how3 1234 শুধু নিজের ব্রাঞ্চ

✨ ফিচারসমূহ (ফুল লিস্ট)

🔐 অথ & নিরাপত্তা

  • Token-based auth (কুকি ছাড়াই, প্রকে্সি-সেফ) — login যায়গায় থাকে
  • OTP লগইন — Owner OTP generate করে, Staff OTP দিয়ে ঢোকে
  • Sign Up — নতুন অ্যাকাউন্ট তৈরি (branch select সহ)
  • Role-based access: Owner / Branch Admin / Staff
  • Socket/407 friendly — 404 ও 500 এরর পেজ

🧾 বিলিং & ইনভয়েস (১৩টি প্রিমিয়াম থিম)

  • Service + Parts আইটেম, GST (CGST/SGST), ডিসকাউন্ট, রাউন্ড অফ, টাকার অঙ্ক কথায়
  • ১৩টি ব্র্যান্ড থিম: Premium Dark, Royal Gold, Apple Minimal, OnePlus Bold, Samsung Blue, Pixel Pop, Nothing Dots, Realme Energy, Vivo Sky, Corporate, Xiaomi Orange, OPPO Green, Motorola Navy
  • Brand সিলেক্ট করলেই থিম + মডেল অটো সিলেক্ট
  • Print / PDF, WhatsApp Share, Email Share
  • Job Status ট্র্যাকিং: Pending → In Progress → Ready → Delivered → Closed

📱 ডিভাইস ডাটাবেস (৩৭৮ মডেল, ১৭ ব্র্যান্ড)

  • iPhone, Samsung, Google Pixel, Nothing, OnePlus, Realme, Vivo, Xiaomi, Redmi, OPPO, Motorola, Honor, Tecno, Infinix, iQOO, Asus
  • New Bill-এ ব্র্যান্ড বাছাই করলেই মডেল অটো-সাজেশন (টাইপ করে সার্চ)

📦 স্টক & পার্টস

  • ইনভেন্টরি, In/Out, লো-স্টক অ্যালার্ট, মুভমেন্ট হিস্ট্রি
  • বিল করলে স্টক অটো কমে, ভয়েড/ডিলিট করলে ফেরত
  • CSV Export

👥 কাস্টমার & 👤 ইউজার

  • কাস্টমার ডিরেক্টরি, হিস্ট্রি, স্পেন্ডিং, CSV Export
  • ইউজার ম্যানেজমেন্ট (Owner only)

🏬 ব্রাঞ্চ ম্যানেজমেন্ট

  • নতুন ব্রাঞ্চ যুক্ত করুন (ভবিষ্যৎ doorstep সেন্টার)
  • প্রতিটা ব্রাঞ্চের আলাদা লগইন, আলাদা ইনভয়েস নম্বর (SS01-00001...)
  • Branch staff শুধু নিজের ব্রাঞ্চের invoice delete করতে পারে; owner সব

📈 রিপোর্ট & GST

  • Revenue, Taxable Sales, Net Sales, Bills In Period
  • Daily chart, Payment Modes, Top Services/Parts
  • CSV Export (ইনভয়েস রিপোর্ট)

📊 ড্যাশবোর্ড

  • ৮টি স্ট্যাট কার্ড + Last 7 Days চার্ট + Payment Donut
  • Repair Job Board — Pending/In Progress/Ready বিজ্ঞপ্তি

💾 ব্যাকআপ (নতুন)

  • সার্ভার চালু হলেই অটো-ব্যাকআপ (backups ফোল্ডারে, সর্বোচ্চ ৩০ কপি)
  • Settings → Download Full Backup (.db) — owner-এর জন্য এক ক্লিক

⚙️ Settings

  • Company Info, Logo Upload, Colors, GST রেট, Currency, Date Format
  • Default Theme, Invoice show/hide (Logo/Warranty/Terms/Signature)

📁 ফাইল স্ট্রাকচার

billing_app/
├── app.py              # মূল অ্যাপ্লিকেশন (সব ব্যাকএন্ড)
├── wsgi.py             # প্রোডাকশন এন্ট্রি (Gunicorn)
├── Procfile            # Render/Railway ডিপ্লয়
├── runtime.txt         # Python ভার্সন
├── schema.sql          # ডেটাবেস স্কিমা
├── billing.db          # ডেটাবেস (অটো তৈরি)
├── backups/            # অটো-ব্যাকআপ ফোল্ডার
├── run.bat / run.sh    # অফলাইন চালানোর স্ক্রিপ্ট
├── requirements.txt    # ডিপেন্ডেন্সি
├── static/
│   ├── css/style.css   # অ্যাপ ডিজাইন
│   ├── css/themes.css  # ১৩ ইনভয়েস থিম
│   ├── js/app.js       # বিলিং পেজ লজিক
│   ├── devices.json    # ৩৭৮ মডেল ডাটাবেস
│   └── uploads/        # লোগো আপলোড
└── templates/          # HTML পেজ

💾 ব্যাকআপ / ডেটা নিরাপত্তা

  • পুরো billing_app ফোল্ডার কপি করলেই সম্পূর্ণ ব্যাকআপ
  • billing.db ফাইলটি আপনার সব ডেটা (Settings → Download Full Backup)
  • সার্ভার স্টার্টে অটো-ব্যাকআপ

🛠️ ভবিষ্যৎ সম্প্রসারণ

  • নতুন শপ/ডোরস্টেপ সেন্টার: Branches → Add New Branch → Users → Add User
  • ডেটা রিসেট: billing.db + backups/ ডিলিট করে run করলেই ফ্রেশ স্টার্ট

About

MyGSTEBill - Professional Billing & Invoice Software (Flask + SQLite)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages