🚀 Overview

Full Tenancy is a robust multi-tenant application framework that lets you launch SaaS products with clean tenant isolation, flexible role-based access control, custom domain/subdomain routing, and per-tenant settings.

Built from real-world SaaS experience, it supports both single-database (row-level) and multi-database (per-tenant) tenancy models, giving you the freedom to choose performance, security and cost trade-offs for each project.

Best for: founders, agencies, and engineering teams building white-label SaaS, marketplaces, LMS/CRM platforms, analytics dashboards or regionalized B2B apps.

✨ Key Features

• Tenant Provisioning: programmatic tenant create/suspend/delete with onboarding wizard and plan limits.
• Custom Domains & Subdomains: tenant.com or tenant.yourapp.com with auto-SSL (via API/CLI hooks).
• Database Isolation Modes: per-tenant database, schema, or row-level scoping with middleware guards.
• Users, Roles & Permissions: hierarchical roles, granular permissions, policy gates and audit logs.
• Per-Tenant Settings: branding, locales, timezones, billing, feature flags and storage configuration.
• Admin Superpanel: global view of tenants, metering, usage, health checks, and impersonation.
• Billing-Ready Hooks: events for trial start/expire, plan upgrades, seat changes and overages.
• Email & Notifications: tenant-scoped mail templates, queues and web/push notifications.
• Security: CSRF/XSS protection, password policies, 2FA ready, rate limits, signed URLs, backup jobs.
• Observability: request logs, job/queue metrics and per-tenant error tracking integration points.

⚙️ Technical Stack

• Backend: PHP 8.1+ (Laravel-style MVC) with tenancy middleware and service providers.
• Frontend: Blade/Twig templates or SPA frontends (Vue/React) with Bootstrap/Tailwind.
• Database: MySQL/MariaDB or PostgreSQL; Redis for cache/queues; optional Elasticsearch/OpenSearch for search.
• Routing: domain & subdomain resolvers, tenant context bootstrap, per-request scoping.
• Background Jobs: queues for onboarding, billing webhooks, backups and email dispatch.
• Server Requirements: Nginx/Apache, HTTPS/SSL, Composer, Node.js 18+, cron (scheduler), queue worker (Supervisor/PM2).

Technical insight: Tenant context is resolved early in the request lifecycle and injected into models/queries via scopes, ensuring strict data separation and predictable performance.

🧩 Installation Guide (Quick Start)

1. Deploy Code: upload/extract package to server; set writable permissions for storage/ and cache directories.
2. Environment: copy .env.example → .env; set DB/Redis, mail, queue, and app URL.
3. Install & Keygen: run composer install, php artisan key:generate, then php artisan migrate --seed.
4. Tenancy Config: choose isolation mode (per-DB / schema / row-level) and domain pattern for tenants.
5. Scheduler & Queues: set cron for schedule:run and start queue workers for async jobs.
6. Launch: create first tenant (CLI or admin), map domain/subdomain, add roles & invite users.

Tip: Use per-DB isolation for enterprise customers and row-level for high-volume, low-cost multi-tenant tiers.

📦 Deliverables

• Complete multi-tenant boilerplate source code (backend + optional SPA).
• Admin superpanel with tenant, user, role & settings management.
• Database migrations, seeders and example policies/permissions.
• Domain resolver, middleware, tenancy guards and sample tests.
• Documentation for provisioning, domain mapping, billing hooks and deployments.
• GPL license file permitting modification and redistribution.

📱 Supported Platforms

• Web App: responsive UI for Chrome, Safari, Edge, Firefox.
• Hosting: Linux (Ubuntu/Debian) or cPanel/Cloud hosting with PHP 8.1+.
• Integrations: email (SMTP/API), storage (local/S3-compatible), payments (via webhooks), and observability tools.

🧠 Notes

• License: distributed under the GNU General Public License (GPL).
• Customization Ideas: metered/seat billing, organization-wide SSO (SAML/OIDC), data residency by region, feature flags per plan.
• SEO Keywords: multi-tenant SaaS boilerplate, custom domains tenancy, roles & permissions, per-tenant settings.
• Security: enforce HTTPS, enable 2FA, rotate keys, run per-tenant backups and validate domain ownership (DNS/HTTP-01).

👨‍💻 Original Developer Credit

Full credit to the original author of the Full Tenancy codebase.
All product names, trademarks and brand assets remain the property of their respective owners.

🔒 Disclaimer

This GPL distribution of Full Tenancy – Domains, Database, Users, Roles, Permissions & Settings is intended for educational and self-hosted use.
We are not affiliated with or endorsed by the original vendor.
No official support or updates are included unless obtained from the original publisher.