Mallow-Technologies-Task

Python-based Flask web server app for Billing management. This application includes CSV, HTML/CSS, and Python files.

GIF Demonstration

Here is a GIF demonstration of the application:

Table of Contents

• Introduction
• Features
• Prerequisites
• Installation
• Configuration
• Running the Application
• Usage
• Project Structure
• License

Introduction

This project is a billing management system built using Python and Flask. It allows users to manage billing information, including customer details, purchased items, and payment denominations.

Features

• Add customer details
• Add purchased items
• Calculate total amount paid based on denominations
• Generate and print bills
• Store billing information in a database

Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.x
• pip (Python package installer)
• Git (optional, for version control)

Installation

1. Clone the repository:

   git clone https://github.com/Sva-Dagger
   cd Mallow-Technologies-Task

2. Create a virtual environment:

   python -m venv venv

3. Activate the virtual environment:

   • On Windows:

     venv\Scripts\activate

   • On macOS/Linux:

     source venv/bin/activate

4. Install the required packages:

   pip install -r requirements.txt

Configuration

1. Create a .env file in the root directory and add the following configuration:

   SECRET_KEY=your_secret_key
   DATABASE_URL=sqlite:///billing.db
   

2. Ensure the data directory exists for storing CSV files:

   mkdir -p data

3. Place your products.csv file in the data directory.

Running the Application

1. Initialize the database:

   flask db init
   flask db migrate
   flask db upgrade

2. Run the Flask application:

   flask run

3. Open your web browser and navigate to http://127.0.0.1:5000 to access the application.

Usage

1. Add Customer Details: Enter the customer's email ID.
2. Add Purchased Items: Select products and enter quantities.
3. Calculate Denomination: Enter the count for each denomination and click "Calculate Denomination".
4. Generate Bill: Click "Generate" to create and print the bill.

Project Structure