Business Operations Management System (BOMS)

A Mini ERP System for managing business operations including inventory, sales, and finance tracking.

Features

1. User Management Module

• Admin and Staff roles
• Session-based login system
• Secure authentication

2. Inventory Module

• Add and manage products
• Update stock levels
• Track quantity changes with history

3. Sales Module

• Record sales transactions
• Auto-update inventory on sales
• Sales history tracking

4. Finance Simulation

• Track revenue from sales
• Basic profit summary dashboard
• Financial analytics

5. Dashboard UI

• Total products overview
• Total sales summary
• Revenue analytics

Tech Stack

• Backend: Python Flask
• Frontend: HTML5 + CSS3 + Vanilla JavaScript
• Database: SQLite
• API: REST endpoints
• Optional: Docker support

Installation

Prerequisites

• Python 3.8+
• pip
• SQLite3

Setup

1. Clone the repository:

   git clone https://github.com/ArcticPeeper/mini-erp-boms.git
   cd mini-erp-boms

2. Create virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Initialize the database:

   python init_db.py

5. Run the application:

   python app.py

6. Open your browser and navigate to:

   http://localhost:5000
   

Default Credentials

• Admin Login

  • Username: admin
  • Password: admin123

• Staff Login

  • Username: staff
  • Password: staff123

Project Structure

mini-erp-boms/
├── app.py                 # Main Flask application
├── init_db.py            # Database initialization
├── requirements.txt      # Python dependencies
├── config.py            # Configuration settings
├── models.py            # Database models
├── routes/
│   ├── auth.py          # Authentication routes
│   ├── dashboard.py     # Dashboard routes
│   ├── inventory.py     # Inventory management routes
│   ├── sales.py         # Sales module routes
│   └── finance.py       # Finance module routes
├── static/
│   ├── css/
│   │   ├── style.css
│   │   └── responsive.css
│   └── js/
│       ├── main.js
│       └── forms.js
└── templates/
    ├── base.html
    ├── login.html
    ├── dashboard.html
    ├── inventory/
    │   ├── products.html
    │   ├── add_product.html
    │   └── edit_product.html
    ├── sales/
    │   ├── transactions.html
    │   └── new_sale.html
    └── finance/
        └── summary.html

API Endpoints

Authentication

• POST /api/login - User login
• POST /api/logout - User logout

Inventory

• GET /api/products - List all products
• POST /api/products - Create new product
• PUT /api/products/<id> - Update product
• DELETE /api/products/<id> - Delete product

Sales

• GET /api/sales - List all sales
• POST /api/sales - Create new sale
• GET /api/sales/<id> - Get sale details

Finance

• GET /api/finance/summary - Get finance summary
• GET /api/finance/revenue - Get revenue data

Dashboard

• GET /api/dashboard - Get dashboard data

Usage

1. Login: Use admin or staff credentials
2. Manage Inventory: Add/Edit/Delete products and manage stock
3. Record Sales: Create sales transactions (inventory auto-updates)
4. View Analytics: Monitor revenue and profit on the dashboard

License

MIT License - Feel free to use this project for learning and development.

Author

ArcticPeeper