If you are here for the nitty-gritty details, you can check out the technical documentation for the system design, architecture, and design patterns used in the application. You can also check out the features page for a detailed list of features, and screenshots with key highlights, and live demo.
- 📗 Table of Contents
- 📖 About Bazaar
- 💻 Getting Started
- 🔭 Future Features
- 🤝 Contributing
- 👥 Authors
- ❓ FAQ
- 📝 License
- ⭐️ Support
Bazaar is an auction marketplace where users can buy and sell items. Users can create an account, list items for sale, bid on items, and view their own items and bids.
Bazaaar is built with on PHP Laravel framework and uses MySQL for the database. The front end is also handled by Laravel's Blade templating engine.
 |
 |
 |
 |
 |
 |
Bazaar is a full-stack web application that allows users to:
- 📢 Ad Auction Marketplace - Users can create an account, list items for sale, and manage their listings. Share your listings with friends and family on social media.
- 💰 Bidding - Users can bid on items and view their bids, get notified when they are outbid, and get notified when they win an auction.
- 🔎 Search - Users can search for items by name, description, or category.
- 📊 Advanced Analytics - Users can view their sales and bids in a dashboard with charts and graphs.
- 👨👩👦 User Dashboard - Users can view their listings, bids, payments, and payouts history.
- 📱 Admin Dashboard - Admins can manage users, listings, and bids .etc
- 🔒 Authentication - Users can create an account and login to the application. Manage their account settings and password.
- 📧 In-built Blog CMS - Admins can create blog posts and manage them. Users can view blog posts and comment on them.
- 📧 Comment Moderation - Admins can moderate comments on blog posts.
- 📧 Email Notifications - Users get email notifications on events such as outbid, winning an auction, payment confirmation, and more.
- 📧 Payment Processor - Users can pay for items using payment gateways such as Paystack, and Flutterwave.
- 📧 Payouts Processor - Job workflow for paying Ad Owners for sales of ads auctioned automatically.
- 📤 Support Ticketing - Users can create support tickets and admins can respond to them.
- 🔒 Fully Open Source: You can self-host the entire stack on your servers.
If you want to see a detailed list of features, and screenshots with key highlights, and live demo check out the features page.
You can watch a live demo of the application below.
live-demo.mp4
You need to have the following installed on your machine to run the application locally.
Click to expand installation instructions for local machine
-
Step 1: To get started, you need to clone the repository to your local machine. You can do this by running the command below in your terminal.
git clone https://github.com/hendurhance/bazaar.git
-
Step 2: Navigate to the root directory using the command below.
cd bazaar -
Step 3: Install the dependencies using the bash script below. Make sure you give the script execution permission by running
chmod +x ./scripts/*.shbefore running the script../scripts/dependencies.sh
-
Step 4: Create a
.envfile in the root directory of the project. You can do this by copying the.env.examplefile and renaming it to.env.cp .env.example .env
-
Step 5: Set up your environment variables for database credentials and other settings. You can do this by filling these values in the
.envfile.... DB_CONNECTION=mysql DB_HOST=<YOUR_DB_HOST> DB_PORT=<YOUR_DB_PORT> DB_DATABASE=<YOUR_DB_NAME> DB_USERNAME=<YOUR_DB_USERNAME> DB_PASSWORD=<YOUR_DB_PASSWORD> ... FLUTTERWAVE_SECRET_KEY=<FLUTTERWAVE_SECRET_KEY> FLUTTERWAVE_PUBLIC_KEY=<FLUTTERWAVE_PUBLIC_KEY> FLUTTERWAVE_ENCRYPTION_KEY=<FLUTTERWAVE_ENCRYPTION_KEY> FLUTTERWAVE_REDIRECT_URL=<FLUTTERWAVE_REDIRECT_URL> PAYSTACK_SECRET_KEY=<PAYSTACK_SECRET_KEY> PAYSTACK_PUBLIC_KEY=<PAYSTACK_PUBLIC_KEY> PAYSTACK_REDIRECT_URL=<PAYSTACK_REDIRECT_URL> RECAPTCHA_SITE_KEY=<RECAPTCHA_SITE_KEY> RECAPTCHA_SECRET_KEY=<RECAPTCHA_SECRET_KEY>
You mainly need to fill in the database credentials which is important for the application to run. The other values are for the payment gateways and recaptcha. You can get the payment gateway credentials by creating an account on Paystack and Flutterwave. You can get the recaptcha credentials by creating an account on Google Recaptcha.
-
Step 6: After setting up dependencies and environment variables, you need to run the database migrations to create the database tables. You can do this by using the script below.
./scripts/localize.sh
-
Step 7: After running the script above, you get a link to the application. You can visit the link to view the application.
Click to expand installation instructions for docker
- Step 1: To get started, you need to clone the repository to your local machine. You can do this by running the command below in your terminal.
git clone https://github.com/hendurhance/bazaar.git
- Step 2: Navigate to the root directory using the command below.
cd bazaar - Step 3: Create a
.envfile in the root directory of the project. You can do this by copying the.env.dockerfile and renaming it to.env.cp .env.docker .env
- Step 4: Run the docker compose command below to start the application.
docker-compose up -d
- Step 5: Open bash in the container using the command below.
docker exec -it bazaar-app-1 bash - Step 6: Make sure you are in the root directory of the project in the container. You can do this by running the command below.
cd /var/www/html - Step 7: Run the database migrations to create the database tables. You can do this by using the script below. Make sure you give the script execution permission by running
chmod +x ./scripts/*.shbefore running the script../scripts/dockerize.sh
- Step 8: After running the script above, you get a link to the application. You can visit the link to view the application.
- Step 8: To stop the application, run the command below.
docker-compose down
You can watch a video on how to use the application below.
There are a few accounts you can use to test the application after proper installation. You can find the credentials below.
| Name | Password | Role | |
|---|---|---|---|
| Bazaar Admin | [email protected] | password | Admin |
| Bazaar User | [email protected] | password | User |
Coming Soon
You can deploy the application to a server using either the docker method or the local machine method. You can find the instructions for both methods below.
| Method | Link |
|---|---|
| 🐳 Docker | Docker Deployment |
| 💻 Local Machine | Local Machine Deployment |
The project adheres to Laravel's MVC architecture, employing design patterns for clean separation of concerns. The Repository Pattern is utilized to isolate business logic from controllers, promoting maintainability and scalability. Additionally, the Observer Pattern is employed to manage events on models.
graph TD
subgraph "App Layer"
subgraph "Controllers"
A[AdController]
B[BidController]
P[PaymentController]
...
end
subgraph "Models"
Ad[Ad]
Bid[Bid]
Media[Media]
Payment[Payment]
Payout[Payout]
PayoutMethod[PayoutMethod]
User[User]
...
end
subgraph "Repositories"
AR[AdRepository]
BR[BidRepository]
MR[MediaRepository]
PR[PaymentRepository]
POR[PayoutRepository]
PMR[PayoutMethodRepository]
UR[UserRepository]
...
end
subgraph "Services"
AS[AvatarService]
MS[MediaStorageService]
PGS[PaymentGatewayService]
...
end
subgraph "Observers"
AO[AdObserver]
BO[BidObserver]
MO[MediaObserver]
PORO[PayoutObserver]
PMO[PayoutMethodObserver]
UO[UserObserver]
...
end
subgraph "Handlers"
PPP[ProcessPaystackPayout]
...
end
subgraph "Jobs"
CTR[CreateTransferRecipient]
PD[ProcessDailyPayouts]
...
end
end
subgraph "Database"
Mysql
end
subgraph "Other Layers"
Routes["routes/web.php"]
Views["resources/views"]
Config["config"]
Tests["tests"]
Docker["docker"]
...
end
Routes --> A
Views --> A
Config --> `{Environment, Configurations}
Docker --> Mysql
Tests --> `{AR, BR, MR, PR, POR, PMR, UR, Routes}
Mysql --> `{Ad, Bid, Media, Payment, Payout, PayoutMethod, User}
A --> `{AR, AS, AO}
B --> `{BR, AS, BO}
P --> `{PR, AS}
AO --> `{AO, AS}
BO --> `{BO, AS}
MO --> `{MO, MS}
PORO --> `{PORO, AS}
PMO --> `{PMO, AS}
UO --> `{UO, AS}
A --> PPP
PPP --> PD
PD --> `{POR, PMR}
CTR --> PMR
Click to expand file structure
.
├── app
│ ├── Abstracts
│ │ ├── BaseAvatarService.php
│ │ ├── BaseCrudRepository.php
│ │ └── BaseMediaStorageService.php
│ ├── Console
│ │ ├── Commands
│ │ │ ├── MakeInterfaceCommand.php
│ │ │ └── MakeRepositoryCommand.php
│ │ └── Kernel.php
│ ├── Contracts
│ │ ├── Repositories
│ │ │ ├── AdRepositoryInterface.php
│ │ │ ├── AdminAdRepositoryInterface.php
│ │ │ ├── AdminBidRepositoryInterface.php
│ │ │ ├── AdminPaymentRepositoryInterface.php
│ │ │ ├── AdminPayoutMethodRepositoryInterface.php
│ │ │ ├── AdminPayoutRepositoryInterface.php
│ │ │ ├── AnalyticRepositoryInterface.php
│ │ │ ├── AuthenticateRepositoryInterface.php
│ │ │ ├── BidRepositoryInterface.php
│ │ │ ├── CategoryRepositoryInterface.php
│ │ │ ├── CommentRepositoryInterface.php
│ │ │ ├── CountryRepositoryInterface.php
│ │ │ ├── MediaRepositoryInterface.php
│ │ │ ├── MetricRepositoryInterface.php
│ │ │ ├── PaymentRepositoryInterface.php
│ │ │ ├── PayoutMethodRepositoryInterface.php
│ │ │ ├── PayoutRepositoryInterface.php
│ │ │ ├── PostRepositoryInterface.php
│ │ │ ├── SupportRepositoryInterface.php
│ │ │ ├── TagRepositoryInterface.php
│ │ │ └── UserRepositoryInterface.php
│ │ ├── Services
│ │ │ ├── AvatarServiceInterface.php
│ │ │ ├── BankCodeServiceInterface.php
│ │ │ ├── MediaStorageServiceInterface.php
│ │ │ └── PaymentGatewayServiceInterface.php
│ │ └── Types
│ │ ├── HasAll.php
│ │ ├── HasColor.php
│ │ └── HasLabel.php
│ ├── Enums
│ │ ├── AdStatus.php
│ │ ├── AdType.php
│ │ ├── CommentStatus.php
│ │ ├── Gender.php
│ │ ├── MediaType.php
│ │ ├── PaymentGateway.php
│ │ ├── PaymentStatus.php
│ │ ├── PayoutGateway.php
│ │ ├── PayoutStatus.php
│ │ ├── PriceRange.php
│ │ ├── StorageDiskType.php
│ │ └── SupportStatusEnum.php
│ ├── Exceptions
│ │ ├── AdException.php
│ │ ├── AuthenticateException.php
│ │ ├── BidCustomException.php
│ │ ├── BidException.php
│ │ ├── CommentException.php
│ │ ├── Handler.php
│ │ ├── MediaException.php
│ │ ├── PaymentException.php
│ │ ├── PayoutException.php
│ │ ├── PayoutMethodException.php
│ │ ├── PostException.php
│ │ ├── SupportException.php
│ │ └── UserException.php
│ ├── Handler
│ │ ├── PaystackWebhookSignature.php
│ │ ├── ProcessPaystackPayout.php
│ │ └── ProcessPaystackWebhook.php
│ ├── Helpers
│ │ └── Helpers.php
│ ├── Http
│ │ ├── Controllers
│ │ │ ├── Admin
│ │ │ │ ├── Ad
│ │ │ │ │ └── AdController.php
│ │ │ │ ├── Auth
│ │ │ │ │ ├── LoginController.php
│ │ │ │ │ └── PasswordController.php
│ │ │ │ ├── Bid
│ │ │ │ │ └── BidController.php
│ │ │ │ ├── Dashboard
│ │ │ │ │ └── MetricsController.php
│ │ │ │ ├── Media
│ │ │ │ │ └── MediaController.php
│ │ │ │ ├── Payment
│ │ │ │ │ └── PaymentController.php
│ │ │ │ ├── Payout
│ │ │ │ │ ├── PayoutController.php
│ │ │ │ │ └── PayoutMethodController.php
│ │ │ │ ├── Post
│ │ │ │ │ ├── CommentController.php
│ │ │ │ │ └── PostController.php
│ │ │ │ ├── Profile
│ │ │ │ │ └── ProfileController.php
│ │ │ │ ├── Search
│ │ │ │ │ └── SearchController.php
│ │ │ │ ├── Support
│ │ │ │ │ └── SupportController.php
│ │ │ │ └── User
│ │ │ │ └── UserController.php
│ │ │ ├── Api
│ │ │ │ ├── CategoryController.php
│ │ │ │ └── CountryController.php
│ │ │ ├── Controller.php
│ │ │ ├── Page
│ │ │ │ ├── BlogController.php
│ │ │ │ ├── CommentController.php
│ │ │ │ ├── ContactController.php
│ │ │ │ └── HomeController.php
│ │ │ └── User
│ │ │ ├── Ad
│ │ │ │ └── AdController.php
│ │ │ ├── Auth
│ │ │ │ ├── LoginController.php
│ │ │ │ ├── PasswordController.php
│ │ │ │ └── RegisterController.php
│ │ │ ├── Bid
│ │ │ │ └── BidController.php
│ │ │ ├── Payment
│ │ │ │ └── PaymentController.php
│ │ │ ├── Payout
│ │ │ │ ├── PayoutController.php
│ │ │ │ └── PayoutMethodController.php
│ │ │ └── Profile
│ │ │ └── ProfileController.php
│ │ ├── Kernel.php
│ │ ├── Middleware
│ │ │ ├── Authenticate.php
│ │ │ ├── EncryptCookies.php
│ │ │ ├── EnsureAccountActive.php
│ │ │ ├── EnsureEmailVerified.php
│ │ │ ├── IncreaseAdViews.php
│ │ │ ├── PreventRequestsDuringMaintenance.php
│ │ │ ├── RedirectIfAuthenticated.php
│ │ │ ├── TrimStrings.php
│ │ │ ├── TrustHosts.php
│ │ │ ├── TrustProxies.php
│ │ │ ├── ValidateSignature.php
│ │ │ └── VerifyCsrfToken.php
│ │ └── Requests
│ │ ├── Ad
│ │ │ ├── CreateAdRequest.php
│ │ │ ├── CreateBidRequest.php
│ │ │ ├── FilterAdRequest.php
│ │ │ ├── FilterAdminAdsRequest.php
│ │ │ ├── FilterUserAdsRequest.php
│ │ │ ├── ReportAdRequest.php
│ │ │ ├── UpdateAdAdminRequest.php
│ │ │ └── UpdateAdRequest.php
│ │ ├── Auth
│ │ │ ├── ForgotPasswordRequest.php
│ │ │ ├── LoginRequest.php
│ │ │ ├── RegisterRequest.php
│ │ │ └── ResetPasswordRequest.php
│ │ ├── Bid
│ │ │ ├── FilterAdminBidRequest.php
│ │ │ └── FilterUserBidRequest.php
│ │ ├── Media
│ │ │ └── FilterAdminMediaRequest.php
│ │ ├── Payment
│ │ │ ├── CreatePayRequest.php
│ │ │ ├── FilterAdminPaymentRequest.php
│ │ │ ├── FilterUserPaymentRequest.php
│ │ │ └── UpdatePaymentAdminStatus.php
│ │ ├── Payout
│ │ │ ├── CreatePayoutMethodRequest.php
│ │ │ ├── FilterAdminPayoutMethodRequest.php
│ │ │ ├── FilterAdminPayoutRequest.php
│ │ │ └── RequestPayout.php
│ │ ├── Post
│ │ │ ├── CreateCommentRequest.php
│ │ │ ├── CreatePostRequest.php
│ │ │ ├── FilterAdminCommentRequest.php
│ │ │ ├── FilterAdminPostRequest.php
│ │ │ ├── FilterPostRequest.php
│ │ │ ├── UpdateCommentRequest.php
│ │ │ └── UpdatePostRequest.php
│ │ ├── Profile
│ │ │ ├── UpdateAdminPasswordRequest.php
│ │ │ ├── UpdateAdminProfileRequest.php
│ │ │ └── UpdateProfileRequest.php
│ │ ├── Search
│ │ │ └── SearchQueryRequest.php
│ │ ├── Support
│ │ │ ├── CreateSupportRequest.php
│ │ │ ├── FilterAdminSupportRequest.php
│ │ │ └── UpdateSupportRequest.php
│ │ └── User
│ │ ├── CreateAdminUserRequest.php
│ │ ├── FilterAdminUserRequest.php
│ │ └── UpdateAdminUserRequest.php
│ ├── Jobs
│ │ ├── CreateTransferRecipient.php
│ │ ├── ProcessDailyPayouts.php
│ │ ├── ProcessHighestBidder.php
│ │ └── TieUserToAds.php
│ ├── Models
│ │ ├── Ad.php
│ │ ├── Admin.php
│ │ ├── Bid.php
│ │ ├── Category.php
│ │ ├── City.php
│ │ ├── Comment.php
│ │ ├── Country.php
│ │ ├── Media.php
│ │ ├── Payment.php
│ │ ├── Payout.php
│ │ ├── PayoutMethod.php
│ │ ├── Post.php
│ │ ├── ReportAd.php
│ │ ├── State.php
│ │ ├── Support.php
│ │ ├── Tag.php
│ │ ├── Timezone.php
│ │ └── User.php
│ ├── Notifications
│ │ ├── Ad
│ │ │ ├── AdCreatedNotification.php
│ │ │ └── AdStatusUpdatedNotification.php
│ │ ├── Bid
│ │ │ ├── BidAcceptedNotification.php
│ │ │ ├── BidCreatedNotification.php
│ │ │ └── BidRejectedNotification.php
│ │ ├── Payment
│ │ │ └── BidPaymentNotification.php
│ │ ├── Payout
│ │ │ ├── PayoutMethodCreatedNotification.php
│ │ │ ├── PayoutRequestNotification.php
│ │ │ └── PayoutStatusNotification.php
│ │ ├── Support
│ │ │ └── SupportTicketNotification.php
│ │ └── User
│ │ ├── PasswordResetNotification.php
│ │ ├── UserVerificationNotification.php
│ │ └── WelcomeEmailNotification.php
│ ├── Observers
│ │ ├── AdObserver.php
│ │ ├── MediaObserver.php
│ │ ├── PayoutMethodObserver.php
│ │ └── UserObserver.php
│ ├── Providers
│ │ ├── AppServiceProvider.php
│ │ ├── AuthServiceProvider.php
│ │ ├── BroadcastServiceProvider.php
│ │ ├── EventServiceProvider.php
│ │ ├── RepositoryServiceProvider.php
│ │ └── RouteServiceProvider.php
│ ├── Repositories
│ │ ├── Ad
│ │ │ ├── Admin
│ │ │ │ └── AdminAdRepository.php
│ │ │ └── User
│ │ │ └── AdRepository.php
│ │ ├── Analytic
│ │ │ └── AnalyticRepository.php
│ │ ├── Auth
│ │ │ └── AuthenticateRepository.php
│ │ ├── Bid
│ │ │ ├── Admin
│ │ │ │ └── AdminBidRepository.php
│ │ │ └── User
│ │ │ └── BidRepository.php
│ │ ├── Category
│ │ │ └── CategoryRepository.php
│ │ ├── Country
│ │ │ └── CountryRepository.php
│ │ ├── Media
│ │ │ └── MediaRepository.php
│ │ ├── Metric
│ │ │ └── MetricRepository.php
│ │ ├── Payment
│ │ │ ├── Admin
│ │ │ │ └── AdminPaymentRepository.php
│ │ │ └── User
│ │ │ └── PaymentRepository.php
│ │ ├── Payout
│ │ │ ├── Admin
│ │ │ │ ├── AdminPayoutMethodRepository.php
│ │ │ │ └── AdminPayoutRepository.php
│ │ │ └── User
│ │ │ ├── PayoutMethodRepository.php
│ │ │ └── PayoutRepository.php
│ │ ├── Post
│ │ │ ├── CommentRepository.php
│ │ │ ├── PostRepository.php
│ │ │ └── TagRepository.php
│ │ ├── Support
│ │ │ └── SupportRepository.php
│ │ └── User
│ │ └── UserRepository.php
│ ├── Rules
│ │ └── Username.php
│ ├── Services
│ │ ├── Avatar
│ │ │ ├── BoringAvatar.php
│ │ │ ├── DiceBear.php
│ │ │ ├── Gravatar.php
│ │ │ └── UIAvatar.php
│ │ ├── Media
│ │ │ ├── LocalStorage.php
│ │ │ ├── MediaStorageService.php
│ │ │ └── S3Storage.php
│ │ ├── Payment
│ │ │ ├── PayWithFlutterwave.php
│ │ │ ├── PayWithPaystack.php
│ │ │ └── PaymentGatewayService.php
│ │ └── Payout
│ │ └── BankCodeService.php
│ ├── Traits
│ │ ├── ApiResponse.php
│ │ ├── HasAvatar.php
│ │ ├── HasMedia.php
│ │ ├── HasNameSplit.php
│ │ ├── HasPayoutToken.php
│ │ ├── HasSlug.php
│ │ ├── HasTransactionID.php
│ │ ├── HasUuids.php
│ │ ├── HasVerifiedEmail.php
│ │ ├── MediaHandler.php
│ │ └── PasswordEnvironments.php
│ └── View
│ └── Components
│ ├── AdFilterComponent.php
│ ├── AdItemCard.php
│ ├── AdStatusSelectable.php
│ ├── AdminAdTable.php
│ ├── AdminPaymentTable.php
│ ├── AdminPayoutTable.php
│ ├── AdminSupportTable.php
│ ├── AgreeCheckbox.php
│ ├── Alert.php
│ ├── BlogFilterComponent.php
│ ├── CategoriesCard.php
│ ├── CategorySelectable.php
│ ├── CountriesSelectable.php
│ ├── EditProfileCard.php
│ ├── FilterAdminBidCard.php
│ ├── FilterAdminCommentCard.php
│ ├── FilterAdminMediaCard.php
│ ├── FilterAdminPaymentCard.php
│ ├── FilterAdminPayoutCard.php
│ ├── FilterAdminPayoutMethodCard.php
│ ├── FilterAdminPostCard.php
│ ├── FilterAdminSupportCard.php
│ ├── FilterAdminUserCard.php
│ ├── GenderSelectable.php
│ ├── InputField.php
│ ├── InputItemField.php
│ ├── LocationSelectable.php
│ ├── MetricCard.php
│ ├── PayableForm.php
│ ├── PaymentFilterComponent.php
│ ├── PayoutForm.php
│ ├── PhoneSelectable.php
│ ├── PostTagCard.php
│ ├── ProfileAvatarCard.php
│ ├── TagSelectable.php
│ └── TextareaField.php
├── artisan
├── bootstrap
│ ├── app.php
│ └── cache
│ ├── packages.php
│ └── services.php
├── composer.json
├── composer.lock
├── config
│ ├── app.php
│ ├── auth.php
│ ├── broadcasting.php
│ ├── cache.php
│ ├── cors.php
│ ├── database.php
│ ├── filesystems.php
│ ├── hashing.php
│ ├── image.php
│ ├── laracaptcha.php
│ ├── logging.php
│ ├── mail.php
│ ├── payment.php
│ ├── queue.php
│ ├── sanctum.php
│ ├── services.php
│ ├── session.php
│ ├── view.php
│ └── webhook-client.php
├── database
│ ├── dump
│ │ ├── cities.sql
│ │ ├── countries.sql
│ │ ├── states.sql
│ │ └── timezones.sql
│ ├── factories
│ │ ├── AdFactory.php
│ │ ├── AdminFactory.php
│ │ ├── BidFactory.php
│ │ ├── CategoryFactory.php
│ │ ├── CommentFactory.php
│ │ ├── CountryFactory.php
│ │ ├── MediaFactory.php
│ │ ├── PaymentFactory.php
│ │ ├── PayoutFactory.php
│ │ ├── PayoutMethodFactory.php
│ │ ├── PostFactory.php
│ │ ├── ReportAdFactory.php
│ │ ├── SupportFactory.php
│ │ ├── TagFactory.php
│ │ └── UserFactory.php
│ ├── migrations
│ │ ├── 2019_12_14_000001_create_personal_access_tokens_table.php
│ │ ├── 2021_08_21_191921_create_countries_table.php
│ │ ├── 2021_08_21_191945_create_states_table.php
│ │ ├── 2021_08_21_191951_create_cities_table.php
│ │ ├── 2021_08_21_191958_create_timezones_table.php
│ │ ├── 2022_10_12_000000_create_users_table.php
│ │ ├── 2022_10_12_100000_create_password_reset_tokens_table.php
│ │ ├── 2022_10_19_000000_create_failed_jobs_table.php
│ │ ├── 2023_08_18_112614_create_admins_table.php
│ │ ├── 2023_08_18_112634_create_categories_table.php
│ │ ├── 2023_08_18_112658_create_ads_table.php
│ │ ├── 2023_08_18_112706_create_media_table.php
│ │ ├── 2023_08_18_112709_create_bids_table.php
│ │ ├── 2023_08_18_112711_create_payments_table.php
│ │ ├── 2023_08_18_112802_create_report_ads_table.php
│ │ ├── 2023_08_18_112841_create_posts_table.php
│ │ ├── 2023_09_24_183644_create_payout_methods_table.php
│ │ ├── 2023_09_24_183648_create_payouts_table.php
│ │ ├── 2023_11_18_192504_create_tags_table.php
│ │ ├── 2023_11_18_192531_create_post_tag_table.php
│ │ ├── 2023_11_18_202848_create_comments_table.php
│ │ └── 2023_12_01_112830_create_supports_table.php
│ ├── schema
│ └── seeders
│ ├── AdSeeder.php
│ ├── AdminSeeder.php
│ ├── AtlasSeeder.php
│ ├── CategorySeeder.php
│ ├── DatabaseSeeder.php
│ ├── PayoutSeeder.php
│ ├── PostSeeder.php
│ ├── SupportSeeder.php
│ ├── TagSeeder.php
│ └── UserSeeder.php
├── docker
│ ├── 01-database.sql
│ └── Dockerfile
├── docker-compose.yml
├── docs
│ └── images
│ ├── bazaar-logo.png
│ └── header.png
├── package.json
├── phpunit.xml
├── resources
│ ├── css
│ │ └── app.css
│ ├── js
│ │ ├── app.js
│ │ └── bootstrap.js
│ └── views
│ ├── ads
│ │ ├── admin
│ │ │ ├── edit.blade.php
│ │ │ ├── index.blade.php
│ │ │ ├── report.blade.php
│ │ │ ├── show.blade.php
│ │ │ └── status
│ │ │ ├── active.blade.php
│ │ │ ├── expired.blade.php
│ │ │ ├── pending.blade.php
│ │ │ ├── rejected.blade.php
│ │ │ ├── reported.blade.php
│ │ │ └── upcoming.blade.php
│ │ └── user
│ │ ├── edit.blade.php
│ │ ├── index.blade.php
│ │ └── show.blade.php
│ ├── auth
│ │ ├── admin
│ │ │ ├── login.blade.php
│ │ │ └── password
│ │ │ ├── forgot.blade.php
│ │ │ └── reset.blade.php
│ │ └── user
│ │ ├── login.blade.php
│ │ ├── password
│ │ │ ├── forgot.blade.php
│ │ │ └── reset.blade.php
│ │ └── register.blade.php
│ ├── bids
│ │ ├── admin
│ │ │ ├── index.blade.php
│ │ │ └── show.blade.php
│ │ └── user
│ │ ├── index.blade.php
│ │ └── show.blade.php
│ ├── blogs
│ │ └── admin
│ │ ├── create.blade.php
│ │ ├── edit.blade.php
│ │ ├── index.blade.php
│ │ └── show.blade.php
│ ├── comments
│ │ └── admin
│ │ ├── edit.blade.php
│ │ └── index.blade.php
│ ├── components
│ │ ├── ad-filter-component.blade.php
│ │ ├── ad-item-card.blade.php
│ │ ├── ad-status-selectable.blade.php
│ │ ├── admin-ad-table.blade.php
│ │ ├── admin-payment-table.blade.php
│ │ ├── admin-payout-table.blade.php
│ │ ├── admin-support-table.blade.php
│ │ ├── agree-checkbox.blade.php
│ │ ├── alert.blade.php
│ │ ├── blog-filter-component.blade.php
│ │ ├── categories-card.blade.php
│ │ ├── category-selectable.blade.php
│ │ ├── countries-selectable.blade.php
│ │ ├── edit-profile-card.blade.php
│ │ ├── filter-admin-bid-card.blade.php
│ │ ├── filter-admin-comment-card.blade.php
│ │ ├── filter-admin-media-card.blade.php
│ │ ├── filter-admin-payment-card.blade.php
│ │ ├── filter-admin-payout-card.blade.php
│ │ ├── filter-admin-payout-method-card.blade.php
│ │ ├── filter-admin-post-card.blade.php
│ │ ├── filter-admin-support-card.blade.php
│ │ ├── filter-admin-user-card.blade.php
│ │ ├── gender-selectable.blade.php
│ │ ├── input-field.blade.php
│ │ ├── input-item-field.blade.php
│ │ ├── location-selectable.blade.php
│ │ ├── metric-card.blade.php
│ │ ├── payable-form.blade.php
│ │ ├── payment-filter-component.blade.php
│ │ ├── payout-form.blade.php
│ │ ├── phone-selectable.blade.php
│ │ ├── post-tag-card.blade.php
│ │ ├── profile-avatar-card.blade.php
│ │ ├── tag-selectable.blade.php
│ │ ├── text-area-field.blade.php
│ │ └── textarea-field.blade.php
│ ├── dashboard
│ │ ├── admin
│ │ │ ├── index.blade.php
│ │ │ └── search.blade.php
│ │ └── user
│ │ └── index.blade.php
│ ├── layouts
│ │ ├── breadcrumb.blade.php
│ │ ├── footer.blade.php
│ │ ├── header.blade.php
│ │ ├── notify.blade.php
│ │ ├── preloader.blade.php
│ │ ├── script.blade.php
│ │ ├── search.blade.php
│ │ ├── seo.blade.php
│ │ ├── sidebar.blade.php
│ │ ├── style.blade.php
│ │ ├── testimonials.blade.php
│ │ └── why-choose-us.blade.php
│ ├── media
│ │ └── admin
│ │ ├── index.blade.php
│ │ └── show.blade.php
│ ├── pages
│ │ ├── about
│ │ │ └── index.blade.php
│ │ ├── blog
│ │ │ ├── index.blade.php
│ │ │ └── show.blade.php
│ │ ├── contact
│ │ │ └── index.blade.php
│ │ ├── home
│ │ │ └── index.blade.php
│ │ ├── how-it-works
│ │ │ └── index.blade.php
│ │ └── live-auction
│ │ ├── create.blade.php
│ │ ├── index.blade.php
│ │ ├── report.blade.php
│ │ └── show.blade.php
│ ├── pagination
│ │ ├── admin.blade.php
│ │ ├── custom.blade.php
│ │ ├── search.blade.php
│ │ └── simple.blade.php
│ ├── partials
│ │ ├── admin.blade.php
│ │ └── app.blade.php
│ ├── payments
│ │ ├── admin
│ │ │ ├── index.blade.php
│ │ │ ├── show.blade.php
│ │ │ └── status
│ │ │ ├── failed.blade.php
│ │ │ ├── pending.blade.php
│ │ │ └── successful.blade.php
│ │ └── user
│ │ ├── index.blade.php
│ │ └── show.blade.php
│ ├── payout-methods
│ │ ├── admin
│ │ │ ├── index.blade.php
│ │ │ └── show.blade.php
│ │ └── user
│ │ ├── create.blade.php
│ │ ├── edit.blade.php
│ │ └── index.blade.php
│ ├── payouts
│ │ ├── admin
│ │ │ ├── index.blade.php
│ │ │ ├── show.blade.php
│ │ │ └── status
│ │ │ ├── failed.blade.php
│ │ │ ├── pending.blade.php
│ │ │ └── successful.blade.php
│ │ └── user
│ │ ├── index.blade.php
│ │ └── show.blade.php
│ ├── profile
│ │ ├── admin
│ │ │ └── index.blade.php
│ │ └── user
│ │ └── index.blade.php
│ ├── supports
│ │ └── admin
│ │ ├── create.blade.php
│ │ ├── index.blade.php
│ │ ├── show.blade.php
│ │ └── status
│ │ ├── pending.blade.php
│ │ └── resolved.blade.php
│ └── users
│ └── admin
│ ├── create.blade.php
│ ├── edit.blade.php
│ ├── index.blade.php
│ └── show.blade.php
├── routes
│ ├── admin.php
│ ├── api.php
│ ├── channels.php
│ ├── console.php
│ ├── user.php
│ └── web.php
├── scrape.py
├── scripts
│ ├── dependencies.sh
│ ├── dockerize.sh
│ └── localize.sh
├── stubs
│ ├── interface.stub
│ └── repository.stub
├── tests
│ ├── CreatesApplication.php
│ ├── Feature
│ │ └── ExampleTest.php
│ ├── TestCase.php
│ └── Unit
│ └── ExampleTest.php
└── vite.config.js
- Add tests
- Add more payment gateways
- Add more payout gateways
- Advertise on the platform
- Add more metrics
- Process and manage payouts with bank transfer by Admin
- Admin can manage tags and categories
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- What is the purpose of this project?
- This project is an open-source classified ads platform that allows users to buy and sell products by bidding on them. It you to easily create your own classified ads platform.
- What is the technology stack used?
- Laravel, JavaScript, MySQL, Docker, and more.
- How can I contribute to the project?
- You can contribute by forking the project and creating a pull request. You can also open an issue with the tag "enhancement".
- How can I support the project?
- You can support the project by starring ⭐ this repository.
Distributed under the GNU AFFERO GENERAL PUBLIC LICENSE. See LICENSE for more information.
If you like this project, You can support me with starring ⭐ this repository. You can also buy me a coffee ☕️ or become a sponsor using the links below ➡️ github sponsors. Thanks a bunch for your support!