Installation

1. Download the archive or clone the project using git
2. Create database schema as brandboost
3. Create .env file from .env.example file and adjust database parameters
4. Run composer install
5. Go to the public folder
6. Start php server by running command php -S 127.0.0.1:8000
7. Open in browser http://127.0.0.1:8000

---

BrandBoost

BrandBoost is a marketplace platform that connects businessmen (buyers) with influencers and designers (sellers) who offer various creative services. The platform manages the entire transaction lifecycle from service discovery to delivery, handling orders, payments, communications, and dispute resolution.

This document provides a high-level overview of the BrandBoost system, its key user roles, core architecture, and primary functionalities.

For detailed information about specific subsystems, refer to:

• System Architecture
• Order Management System
• Payment and Transaction System
• User Management and Authentication

---

🧩 System Architecture

BrandBoost follows an MVC (Model-View-Controller) architectural pattern with a clear separation of concerns:

Layers:

• Database
• Models (e.g., User, Order, Transaction, Service, Wallet)
• Controllers
  • AuthController
  • OrderController
  • PaymentController
  • ServiceController
  • BusinessmanController
  • InfluencerController
  • DesignerController
  • AdminController
• Routing Layer (via public/index.php)
• User Interfaces:
  • Businessman UI
  • Influencer UI
  • Designer UI
  • Admin UI
  • Guest UI

📁 Related Code:

• controllers/OrderController.php (lines 5–20)
• controllers/PaymentController.php (lines 5–11)
• public/index.php (lines 1–17)
• core/Database/Database.php (lines 11–45)

---

👥 User Roles and Capabilities

BrandBoost supports four primary user roles, each with distinct permissions and capabilities:

Role	Description	Key Capabilities
Businessman	Buyers who purchase creative services	Browse services, place orders, request revisions, submit reviews, file complaints
Influencer	Sellers who offer promotion services	Create promotions, fulfill orders, manage earnings, withdraw funds
Designer	Sellers who offer design services	Create gigs, fulfill orders, manage earnings, withdraw funds
Admin	Platform administrators	Manage users, verify accounts, resolve disputes, monitor transactions

Access Control:
Role-based access is enforced through the AuthHelper class to ensure users can only access authorized functionality.

📁 Related Code:

• controllers/AuthController.php (lines 10–90)
• public/index.php (lines 38–83)
• controllers/BusinessmanController.php (lines 8–14)
• controllers/InfluencerController.php (lines 8–14)

---

🔄 Order Lifecycle

One of the core components of BrandBoost is the order management system. The lifecycle typically follows these stages:

1. Order Creation

   • Method: createOrder() – OrderController
   • Triggers createTransaction() in PaymentController to hold funds

2. Delivery by Seller

   • Method: createDelivery() – OrderController

3. Review by Buyer

   • Method: createReview()

4. Optional Actions:

   • Request Revision – requestRevision()
   • Submit Complaint – submitComplaint()
   • Admin Resolution:
     • Resolve for Buyer → Refund
     • Resolve for Seller → Continue process

5. Funds Release

   • Method: releaseFunds() – PaymentController
   • Funds credited to seller's wallet
   • Sellers can withdraw using withdrawFunds()

---

🔗 Repository

Explore the full codebase here:
👉 https://github.com/kavindadimuthu/Brandboost

---

📢 Contributors

• @kavindadimuthu
• @isurunvn
• @NadunD14
• @nethsilumarasinghe