Skip to content

README.md

Latest commit

 

History

History
99 lines (69 loc) · 2.38 KB

README.md

File metadata and controls

99 lines (69 loc) · 2.38 KB

MarketUiPy 🛒

💻 GUI-based Python Market Management System

Built with CustomTkinter

📸 Preview

Add a screenshot of your UI here for better visibility

Preview

🚀 Features

  • 🔐 Login screen with username/password
  • 🧍‍♂️ User account creation, editing, and deletion
  • 🎓 Permission levels (C, B, A, A+, S, etc.)
  • 🛍️ Shopping panel to add/remove items via ItemID
  • 🧾 Bill generation with total prices
  • 🗃️ JSON-based local data storage
  • 🎨 Modern GUI with icons and color-coded permissions
  • ⚙️ Cross-platform support (Windows & Linux)

📁 File Structure

MarketUiPy/
├── main.py                  # Main application file
├── Assets/
│   ├── img/                 # Icons for UI (home, user, search, etc.)
│   └── data/
│       ├── UserManagement.json
│       ├── Item.json
│       ├── Payment.json
│       └── FastItem.json
└── README.md

🛠️ Requirements

  • Python 3.8+
  • Install dependencies:
pip install customtkinter pillow CTkListbox

▶️ How to Run

python main.py

🔐 Permission Levels

Code Description Access Level
C Only sales access 🔓 Basic
B Sales + stock management 📦 Intermediate
A Finance access 💰 Finance
A+ Advanced finance access 📈 Advanced
A++ Finance + auditing 🕵️‍♂️ Expert
S Full admin access 🔐 Admin
S+ Create/edit/delete users 👑 Super Admin

📌 TODO

  • Connect to SQLite or PostgreSQL
  • Export receipts as PDF
  • Add charts for sales visualization 📊
  • Dark mode theme 🌙

🧑‍💻 Developer

Made with ❤️ by CSDC-K

📄 License

MIT License – free to use, modify, and distribute.