Multi-Branch Vendor Contract CMS

Simplify vendor and contract management across multiple business locations with a centralized PHP and MySQL application. Organize service providers, maintain contract records, monitor expiration dates, and review branch-level spending through a responsive administrative interface.

Key Features

• Multi-Branch Contract Management: Organize vendor contracts by location and manage agreements from a centralized system.
• Role-Based Access Control: Give Super Administrators global control while restricting Branch Managers to the contracts and vendors assigned to their own branch.
• Contract Expiry Alerts: Highlight upcoming and expired agreements with warning indicators and countdown badges. Configure the warning period through the application settings.
• Financial Spend Reports: Review location-based spending comparisons, service category distributions, and vendor budget breakdowns.
• Vendor Records: Maintain organized vendor information and associate service providers with relevant contracts.
• Document Attachments: Upload contract documents and supporting files using the dedicated uploads directory.
• Responsive Bootstrap 5 Interface: Work through a modern dashboard with a dark sidebar layout and responsive design.
• Browser-Based Installer: Configure the application, create database tables, import demo data, and generate the application configuration through a guided setup wizard.
• Security-Focused Architecture: Uses PDO prepared statements, CSRF validation for state-changing operations, input sanitization, and protections for uploaded files.

User Roles

• Super Administrator: Manage the system globally across branches.
• Branch Manager: View and manage vendors and contracts within their authorized branch.

Contract Expiration Monitoring

Keep track of important contract deadlines with visual warning flags and countdown indicators. The default warning threshold is 30 days and can be customized through the application configuration.

Financial Reporting

Review financial information with branch comparison tables, service class distributions, and vendor spending breakdowns. These summaries help teams organize contract expenditure information across locations.

Technology Stack

• PHP 8.0 or higher
• MySQL 5.7+ or MariaDB 10.3+
• PDO with the PDO MySQL driver
• Apache web server with .htaccess support
• Bootstrap 5, CSS, and JavaScript

Installation

Deploy locally using XAMPP or WAMP, or install on compatible shared hosting through cPanel or FTP. Create your database, open the included installer, enter the required configuration details, and create the Super Administrator account. The installer initializes the database and creates a lock file after successful setup.

Included Files

• PHP administrative dashboard and management interfaces
• Authentication and role-based access utilities
• Database installation schema and demo data
• Browser-based installation wizard
• Application configuration sample
• CSS, JavaScript, and interface resources
• Protected document upload directory
• License file and changelog

System Requirements

PHP 8.0+, MySQL 5.7+ or MariaDB 10.3+, the PDO MySQL extension, and a compatible Apache server. The uploads directory must have appropriate write permissions for document attachments.

Security Recommendations

Change demo credentials before production use, configure strong database credentials, restrict file and directory permissions, and verify the installer is locked after setup. Review your hosting configuration before deploying sensitive business contract information.

Ideal For

• Companies operating across multiple branches or offices
• Procurement and vendor management teams
• Businesses monitoring service agreements and renewals
• Operations teams reviewing location-based expenditure
• Developers looking for a PHP/MySQL contract management system to customize

Bring vendor records, contract deadlines, and branch-level spending into one organized management system.