Backroom12 is a comprehensive web application built with Laravel that provides a robust backend management system. This application is designed to streamline business operations through efficient management of vendors, products, promotions, and user authentication systems.
- Complete vendor profile management
- Vendor registration and verification
- Performance tracking and analytics
- Vendor communication tools
- Product catalog management
- Inventory tracking
- Product categorization
- Bulk product operations
- CSV import/export functionality
- Create and manage discount coupons
- Promotional campaign management
- Usage tracking and analytics
- Flexible discount rules
- Secure login/logout system
- Role-based access control
- Permission management
- User profile management
- Dashboard with analytics
- Data export capabilities (CSV)
- Responsive design
- RESTful API endpoints
- Framework: Laravel (PHP)
- Frontend: Blade Templates, JavaScript, CSS
- Database: MySQL/PostgreSQL
- Authentication: Laravel Auth
- Package Manager: Composer, NPM
Before you begin, ensure you have the following installed:
- PHP >= 8.1
- Composer
- Node.js & NPM
- MySQL or PostgreSQL
- Git
git clone https://github.com/FitreeCodeConnextDev/Backroomweb.git
cd Backroomweb# Install PHP dependencies
composer install
# Install Node.js dependencies
npm install
# Or Install bun.js dependencies
bun install# Copy environment file
cp .env.example .env
# Generate application key
php artisan key:generateEdit your .env file with your database credentials:
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password# Compile assets
npm run dev
# Compile assets with bun.js
bun run dev
# For production
npm run build
# or bun run build
bun run build# Start the development server
php artisan serveThe application will be available at http://localhost:8000
- Navigate to
http://localhost:8000 - Register a new account or login with existing credentials
- Access the dashboard to manage vendors, products, and promotions
/dashboard- Main dashboard/vendors- Vendor management/products- Product management/coupons- Coupon management/users- User management
# Run PHPUnit tests
php artisan test
# Run specific test suite
php artisan test --testsuite=Feature# Format code using Laravel Pint
./vendor/bin/pint# Create new migration
php artisan make:migration create_table_name
# Create new model
php artisan make:model ModelName
# Create controller
php artisan make:controller ControllerNameThe application provides RESTful API endpoints for integration:
GET /api/vendors- List all vendorsPOST /api/vendors- Create new vendorGET /api/products- List all productsPOST /api/products- Create new productGET /api/coupons- List all coupons
We welcome contributions to Backroom12! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow PSR-12 coding standards
- Write tests for new features
- Update documentation as needed
- Ensure all tests pass before submitting
If you discover any security vulnerabilities, please send an email to the development team. All security vulnerabilities will be promptly addressed.
- CSRF protection
- SQL injection prevention
- XSS protection
- Secure authentication
- Input validation and sanitization
Issue: Database connection error
Solution: Check your .env database credentials and ensure your database server is running
Issue: Permission denied errors Solution: Set proper file permissions:
chmod -R 755 storage bootstrap/cacheIssue: Assets not loading Solution: Run asset compilation:
npm run devThis project is licensed under the MIT License - see the LICENSE file for details.
For support and questions:
- Create an issue on GitHub
- Check the Laravel Documentation
- Visit Laravel Community
- Built with Laravel Framework
- Thanks to all contributors
- Special thanks to the Laravel community
Backroom12 - Streamlining business operations with powerful backend management tools.