Core Tenant

FilamentPHP Tenant Based in Organization/Company (Single Database)

#About this Project

An example project demonstrating a MultiTenant Single Database system fully built in Laravel and Filament, integrated with Stripe for Subscription management. The system includes the following features:

1. Creation of Plans, Prices, and Features stored in the database and integrated via the Stripe API.
2. Admin Panel for Managing Tenants and Subscriptions.
3. API-based Client Creation when registering the Tenant
4. Modal for Tenant to choose Plans and Complete the Subscription (Stripe Management)
5. Feature for Tenant to create tickets for the Tenant's manager.
6. Profile editing with theme color customization.
7. Integration of Icons with FontAwesome.
8. Tested and working with MySQL and Postgresql

#Videos:

1. See Video - Administrative panel presentation

video

2. See Video - Creation of Products, prices and Features

video

3. See Video - Registering a new tenant

video

#The plugins used in this project may include:

• laravel
• Filament
• FontAwesome
• Brazilian Form Fields
• Edit Profile
• Spatie Laravel Backup

#Prerequisites

1. Create a Stripe account and enable trial mode - Stripe

2. Docker and docker-compose (The Dockerfile for this project already includes all the necessary resources to run the project.)

#Dockerfile includes the following functionalities:

1. The Docker File include all resources for execute this project.

#Installation

1. Clone the repository

git clone https://github.com/wallacemartinss/core_tenant.git
cd core_tenant

laravel new core_tenant --using=wallacemartinss/core_tenant
cd core_tenant

2. Copy .ENV file

cp .env.example .env

3. Configure your database in .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=db_coretenant_system
DB_USERNAME=your_username
DB_PASSWORD=your_password

4. Configure Stripe keys in .env

STRIPE_KEY=your_stripe_key
STRIPE_SECRET=your_stripe_secret

5. Run Docker

docker compose up -d

6. Access docker App container

docker compose exec app bash

7. Inside the container, Install PHP dependencies

composer install

8. Inside the container, configure environment variables

php artisan key:generate

9. Inside the container, Run migrations and seeders

php artisan migrate --seed

10. Inside the container, Link storage for file uploads

php artisan storage:link

11. Inside the container run the command below (To Listen Webhook stripe events) Ip 172.17.0.1 It is the default gateway for containers to communicate with the host.

stripe listen --forward-to http://172.17.0.1/stripe/webhook

12. The first time you run it, it will generate your webhook key. copy and paste it into your env file.

STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret

#Tips

When a user is registered (new tenant) they are asked to validate their email. use the address below to access the mailpit

http://localhost:8025/

#Contributing

1. Fork the repository
2. Create your feature changes in your branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

#Security

If you discover any security-related issues, please email wallacemartinss@gmail.com instead of using the issue tracker.

#License

This project is licensed under the MIT License - see the LICENSE.md file for details.

#Credits

• Wallace Martins
• All Contributors

#Support

For support, please email wallacemartinss@gmail.com or create an issue in the GitHub repository.

🚧 Project 🚀 under construction... 🚧