Skip to content

πŸ“¦ A Flask-based supermarket management system with inventory tracking, POS, and sales analytics. Built with Python, MySQL, and love! πŸ›’βœ¨

Notifications You must be signed in to change notification settings

whitehathackerpr/City-Star-Supermarket

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›’ City Star Supermarket

A Python Flask-based supermarket management system designed to streamline inventory and sales operations for retail businesses. This system offers robust functionalities to enhance efficiency, manage stock, track sales, and generate insightful reports.

🌟 Key Features

πŸ”‘ User Management

  • Secure authentication system
  • Role-based access control (Admin, Cashier)
  • User profile management

πŸ“¦ Inventory Control

  • Comprehensive product management
  • Real-time stock tracking
  • Product categorization for easy browsing
  • Low stock and inventory alerts

πŸ›’ Sales Management

  • Intuitive Point of Sale (POS) interface
  • Automatic receipt generation
  • Detailed sales history tracking
  • Daily, weekly, and monthly sales reports

πŸ“Š Dashboard

  • Interactive sales analytics and visualizations
  • Real-time inventory status overview
  • Performance metrics and KPIs
  • Quick access to recent activities and alerts

πŸš€ Technology Stack

  • Backend: Python (Flask)
  • Frontend: HTML, CSS, Bootstrap
  • Database: MySQL
  • Authentication: Flask-Login, Flask-WTF

πŸ“‹ Prerequisites

βš™οΈ Installation Guide

Follow these steps to set up the project locally:

  1. Clone the repository:
    git clone https://github.com/whitehathackerpr/City-Star-Supermarket.git
    cd City-Star-Supermarket
    
  2. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate       # On Windows: venv\Scripts\activate

πŸ”’ Security Features

  • Password hashing
  • CSRF protection
  • Session management
  • SQL injection prevention

🀝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“ License

This project is open source and available under the MIT License.

πŸ‘₯ Authors

πŸ™ Acknowledgments

  • Flask community
  • Python developers
  • All contributors who help improve this project

πŸ“ž Contact

Project Link: https://github.com/whitehathackerpr/City-Star-Supermarket


⭐️ If you find this project useful, please consider giving it a star!

About

πŸ“¦ A Flask-based supermarket management system with inventory tracking, POS, and sales analytics. Built with Python, MySQL, and love! πŸ›’βœ¨

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published