Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

thedhruvish/TMS-php

Open more actions menu

Repository files navigation

TMS-php — Textile Management System


📘 Description

What the project does

TMS-php digitizes the complete workflow of a textile business. It provides a centralized management system to handle:

  • Inventory Management: Products, categories, real-time stock updates.
  • Sales & Billing: Create invoices, manage payments, track dues.
  • Customer CRM: Maintain customer history and inquiries.
  • Staff Operations: Monitor staff activity with role-based control.
  • Notifications: Automated alerts sent via Telegram.

The application includes:

  • Admin Panel — full control over system operations.
  • Staff Panel — restricted access for daily tasks.

Why this project was built

Many textile businesses rely on notebooks, Excel files, or memory-based workflows. This system replaces those manual processes and was also developed as a major academic college project to demonstrate professional proficiency in Native PHP and MySQL.


Problems it solves

  • Removes Manual Errors: Automated billing, stock counting, and calculations.
  • Instant Overview: Dashboard with live sales and inventory analytics.
  • Secure Access Control: Admin vs. Staff permissions.

✨ Features

Core Modules

🔐 Role-Based Authentication

  • Secure login for Admin & Staff
  • Google OAuth Login support

📊 Dashboard

  • Sales overview
  • Stock status
  • Inquiries & orders summary
  • Graphs via ApexCharts

📦 Inventory Management

  • Manage categories & products
  • Live stock tracking
  • Stock update history

🧾 Invoicing System

  • Generate invoices dynamically
  • Auto-calculation of totals
  • Print-ready view
  • Invoice history

👥 Customer Management

  • Customer details
  • Inquiry tracking
  • Transaction logs

💰 Financial Module

  • Record partial/full payments
  • Outstanding balance tracking
  • Payment history

🤖 Smart Notifications

  • Integrated Telegram Bot API
  • Auto alerts for sales, low stock, inquiries, etc.

🛠 Tech Stack

  • Frontend: HTML5, CSS3, JavaScript, Bootstrap

  • Backend: Native PHP

  • Database: MySQL

  • Server: Apache (XAMPP)

  • Libraries & APIs:

    • Telegram Bot API
    • Google OAuth
    • SweetAlert2
    • ApexCharts

📂 Project Structure

tms-php/
├── public/             # Public files and project docs file -> public/tms_documentation.docx
├── admin/              # Admin panel (dashboard, users, products, etc.)
├── staff/              # Staff panel (limited features)
├── db_dump/            # SQL dump files
├── include/            # Common components (header, footer, auth, DB connection)
├── public/             # Images & static resources
├── src/                # CSS, JS, plugins, fonts
├── config.php          # Main configuration file
├── Database.php        # Database class
├── setup.php           # Auto database setup
├── send_tg_msg.php     # Telegram notification helper
├── index.php           # Landing to login
└── login.php           # Login screen

📌 Why PHP, MySQL & Apache?

This project aligns with academic guidelines requiring PHP & MySQL. Additional reasons:

  • Perfect for rapid development
  • Runs flawlessly on XAMPP
  • Zero build steps — simple deployment
  • Beginner-friendly yet powerful

🚀 Installation Guide

Prerequisites

  • XAMPP / WAMP / MAMP
  • Web browser

Step 1: Clone or Download

git clone https://github.com/thedhruvish/TMS-php.git

Move the folder to:

  • Windows: C:\xampp\htdocs\tms-php
  • Linux/Mac: /opt/lampp/htdocs/tms-php

Step 2: Configuration

  1. Go to the root directory
  2. Rename sample_config.phpconfig.php
  3. Update DB credentials:
define('DB_SERVER', 'localhost');
define('DB_USERNAME', 'root');
define('DB_PASSWORD', '');
define('DB_NAME', 'tms-php');

Step 3: Database Setup

Option A — Automatic (Recommended)

Start Apache & MySQL → visit:

http://localhost/tms-php/setup.php

Option B — Manual Import

  1. Open phpMyAdmin
  2. Create database tms-php
  3. Import db_dump/DATA-TMS.sql

Step 4: Run the App

Visit:

http://localhost/tms-php/

Login using credentials in documentation or register (if enabled).


🖼 Screenshots

image1 image2 image3 image4 image5 image6 image7 image8 image9 image10 image11 image12 image13 image14 image15 image16 image17 image18 image19 image20 image21 image22 image23 image24 image25 image26 image27 image28 image29 image30 image31 image32 image33 image34 image35


👨‍💻 Developers


Dhruvish Lathiya

Website GitHub X


Maunish Prajapati

GitHub


Sahil Vaghasiya

Website GitHub


📄 License

Distributed under the MIT License — free to use, modify, and distribute.

Morty Proxy This is a proxified and sanitized view of the page, visit original site.