• Super Admin Panel — The central control hub for platform owners. Manage tenants, subscription plans, payments, landing page CMS, knowledge base, email templates, payment gateways, and all platform-wide settings.
• Tenant Panel — The workspace for each tenant (business). A complete inventory management system with POS, online store, sales, purchases, customers, suppliers, reports, and much more.

• Multi-Tenant Architecture — Each tenant gets an isolated database and workspace
• Subscription Plans — Create flexible plans with usage limits and feature toggles
• Multiple Payment Gateways — Stripe, PayPal, Paystack, Flutterwave
• Landing Page CMS — Fully customizable public landing page with hero, features, pricing, testimonials, FAQ sections
• SEO Management — Configure meta tags and keywords for your landing page
• Knowledge Base — Self-service help center for tenants
• Email Templates — Customizable notification emails with multi-language support
• Tenant Lifecycle Management — Create, approve, suspend, cancel, and reprovision tenants
• Revenue Dashboard — Track payments, invoices, and monthly revenue trends
• Role-Based Admin Access — Super admin and admin roles with granular permissions
• VPS & Shared Hosting Support — Automatic or manual tenant provisioning

• Easy POS and Dynamic Dashboard
• Online Store Integration
• Products, Adjustments, Transfers
• Quotations, Sales, Purchases
• Sale Returns & Purchase Returns
• Customers, Suppliers, Users Management
• Accounts, Expenses, Deposits, Transfer Money
• Projects & Tasks Management
• Comprehensive Reports (Sales, Purchases, Inventory, Payments, and more)
• Multilingual — 24+ languages with RTL support
• Dark Mode Included
• Barcode/Label Printing & POS Receipt Printing
• Mail & SMS Notification System
• Role-Based Permissions (110+ permissions)

• Backend — Laravel 12, PHP 8.2+
• Frontend — Vue.js, Vuex, Vue Router, Bootstrap Vue
• Database — MySQL 5.7+
• Multi-Tenancy — Separate databases per tenant

• PHP >= 8.2.0
• MySQL 5.7 or higher
• BCMath PHP Extension
• Ctype PHP Extension
• cURL PHP Extension
• Fileinfo PHP Extension
• GD2 PHP Extension
• JSON PHP Extension
• Mbstring PHP Extension
• OpenSSL PHP Extension
• PDO PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension
• ZIP PHP Extension

• Install XAMPP from apachefriends.org
• Step 1: Extract the stocky_saas.zip to C:/xampp/htdocs/
• Step 2: Go to C:\Windows\system32\drivers\etc\ and open the hosts file in Administrator mode. Add: 127.0.0.1 stocky.local
• Step 3: Go to C:\xampp\apache\conf\extra and open httpd-vhosts.conf. Add the VirtualHost configuration below.
• Step 4: Restart your XAMPP
• Setup: Access the URL http://stocky.local/setup

• Download Laragon from laragon.org and install it
• Step 1: Extract the stocky_saas.zip to C:/laragon/www/stocky
• Step 2: Start your Laragon
• Setup: Access the pretty URL http://stocky.test

• Step 1: Login to cPanel and navigate to File Manager
• Step 2: Upload the files to your root domain's public directory (e.g., public_html)
• Step 3: Upload your stocky_saas.zip file and wait for the upload to complete
• Step 4: Unzip the uploaded file
• Step 5: Go back to cPanel and navigate to Databases to create a new database

• Name your application
• Select Environment: Local (localhost) or Production (server)
• App Debug: set to false on production servers

• DB Host — Database server address (usually localhost or 127.0.0.1)
• DB Port — Database port (default 3306)
• DB Database — The name of the database you created
• DB Username — The database user
• DB Password — The database user's password
• Use the Test Connection button to verify your database credentials

• Click Confirm and wait for the database to be generated
• Do not close the browser or stop the process during installation

• Log in to the Super Admin panel and go to /super/settings/general#tab=backup.
• Click Create Backup Now and wait for the file to generate.
• Click the Download icon next to the new backup and save the .sql file to your computer.

• Open PhpMyAdmin (or your hosting panel's database tool).
• Select the central database used by Stocky SaaS.
• Click Export → Quick → Go and save the .sql file to your computer.
• If you have existing tenant databases, export each of them in the same way.

• Take a full copy of your current application folder (via FTP, SSH, or your hosting File Manager).
• This gives you a rollback path if anything goes wrong during the upgrade.

• Log in to CodeCanyon and go to your Downloads page.
• Download Stocky SaaS → All files & documentation.
• Extract the archive on your local computer so you have a fresh copy of the new version.

• .env file — holds your database credentials and app key
• storage/ folder — contains logs and the installed marker
• public/images/ folder — contains tenant-uploaded images and logos

• .env
• storage/
• public/images/

• The page shows a list of update targets — the central database plus every active tenant workspace.
• Click Start Update. The platform immediately enters maintenance mode and all visitors (central & tenants) see a "System Updating" page.
• Migrations run sequentially: central first, then each tenant. Progress bar and per-tenant status update in real time.
• Do not close or refresh the page until the run completes.
• When every target shows a green check, the lock is released automatically and the "Update complete" card appears.

• Do a hard refresh in your browser: Ctrl + Shift + R (Windows / Linux) or Cmd + Shift + R (macOS).
• If a page appears blank or broken, clear the browser cache entirely, then reload.
• Users on other machines should also hard-refresh the first time they load the app after the upgrade.

• Your application is now running on the new version.
• The maintenance lock has been released — central visitors and tenants can access the app normally.
• Verify the version number in the Super Admin footer and spot-check a few tenant workspaces.

• Blank page after upgrade: clear browser cache and delete the contents of bootstrap/cache/ (except .gitignore).
• One tenant failed: check storage/logs/laravel.log for the exact error, fix the underlying issue (missing column, disk space, credentials), then open /update again and re-run.
• Stuck in maintenance mode: if the browser closed mid-run, log back in to /super/login and re-open /update — a Re-run button appears. As a last resort, delete storage/app/platform-update.lock from the server.
• "Class not found" errors: run composer dump-autoload on the server (or via your hosting panel's Composer tool).

• Laragon Full installed from laragon.org.
• Stocky SaaS extracted to C:/laragon/www/stocky_saas.
• Setup wizard completed at http://stocky_saas.test/setup with APP_URL set to http://stocky_saas.test.

1. Right-click the Laragon tray icon → Apache (or Nginx) → sites-enabled → edit auto.stocky_saas.test.conf if it exists.
2. If the file does not exist yet, open Laragon once with the project in place — Laragon will auto-generate it.

Laragon can add hosts-file entries on the fly. When you sign up a new tenant in Stocky (e.g. tenant1), add the subdomain manually once:

1. Right-click Laragon tray → Quick app → Add a new hosts entry.
2. Or run (as Administrator) in a PowerShell window:

1. Install Acrylic DNS Proxy.
2. Edit C:/Program Files (x86)/Acrylic DNS Proxy/AcrylicHosts.txt and add:
   127.0.0.1 *.stocky_saas.test
3. From the Acrylic UI Settings, click Restart Acrylic Service.
4. In Windows Settings → Network → IPv4 Properties, set the preferred DNS to 127.0.0.1.

1. Open http://stocky_saas.test — the landing page should load.
2. Sign up a tenant with subdomain demo from the landing page.
3. Open http://demo.stocky_saas.test/login — the tenant login should load.
4. If it says ERR_NAME_NOT_RESOLVED, the hosts file / Acrylic step is missing.
5. If Apache returns 404 or the landing page, the ServerAlias *.stocky_saas.test line is missing or Laragon was not reloaded.

• XAMPP installed with Apache & MySQL running.
• Stocky SaaS extracted to C:/xampp/htdocs/stocky (Linux/macOS: /opt/lampp/htdocs/stocky).
• Setup wizard completed at http://stocky.local/setup with APP_URL set to http://stocky.local.

1. Open C:/xampp/apache/conf/httpd.conf.
2. Find the line # Include conf/extra/httpd-vhosts.conf and remove the leading #.

1. Install Acrylic DNS Proxy.
2. Edit C:/Program Files (x86)/Acrylic DNS Proxy/AcrylicHosts.txt and add:
   127.0.0.1 *.stocky.local
3. From the Acrylic UI, restart the Acrylic service.
4. In Windows IPv4 settings, set the preferred DNS server to 127.0.0.1.

1. http://stocky.local loads the landing page.
2. Sign up a tenant with subdomain demo.
3. http://demo.stocky.local redirects to the tenant login.
4. http://whatever.stocky.local hits Laravel and returns a 404 tenant page (not a white screen).

1. Wildcard DNS — a DNS record *.yourdomain.com pointing to the VPS IP, so that every tenant1.yourdomain.com, tenant2.yourdomain.com, etc. resolves without creating records one by one.
2. Wildcard Web Server Configuration — a single Apache/Nginx virtual host that responds to yourdomain.com and *.yourdomain.com and serves the same Laravel public/ directory.
3. Wildcard SSL Certificate — a certificate that covers yourdomain.com and *.yourdomain.com (Let's Encrypt DNS-01 wildcard, or a commercial wildcard certificate).
4. A MySQL user with CREATE, DROP and GRANT privileges — Stocky uses this user (the one in DB_USERNAME) to create a new database per tenant and run migrations inside it.

• A Linux VPS (Ubuntu 22.04 / 24.04, Debian 12, AlmaLinux 9, Rocky 9 or CloudLinux) with at least 2 GB RAM and root/sudo access.
• A registered domain name with access to its DNS zone (Cloudflare, Route 53, Namecheap, OVH, etc.).
• PHP 8.2+ with the extensions listed in the Installation chapter (BCMath, cURL, GD, Mbstring, OpenSSL, PDO, Tokenizer, XML, Zip, Fileinfo, Ctype, JSON).
• MySQL 5.7+ / MariaDB 10.4+.
• Composer, Node.js 18+ (only for building assets if you need to), and Git.
• One of the supported stacks: plain Nginx/Apache, cPanel/WHM, Plesk, Webmin/Virtualmin, CyberPanel or DirectAdmin.

1. Point yourdomain.com and *.yourdomain.com to the server IP (A records).
2. Create one vhost (or website) whose document root is /path/to/stocky_saas/public and that accepts ServerAlias *.yourdomain.com (Apache) / server_name yourdomain.com *.yourdomain.com (Nginx).
3. Issue a wildcard SSL certificate via DNS-01 challenge and bind it to that vhost.
4. Create a dedicated MySQL user and grant it the privileges required to create tenant databases.
5. Edit .env with your APP_URL, CENTRAL_DOMAINS and DB_* values.
6. Open the Super Admin → General Settings and switch Hosting Mode to VPS.
7. Configure the queue worker and Laravel scheduler as system services / cron jobs.

• Replace 203.0.113.10 with your VPS public IPv4 address.
• If your server has an IPv6 address, add matching AAAA records for @ and *.
• Do not use a CNAME at the apex (@) — most registrars refuse it.
• Keep TTL low (300–600 seconds) during setup, then raise it once you verify everything works.

• Enabling the orange cloud (proxy) on the wildcard record is fine, but a wildcard DNS record is only proxied on paid plans (Pro or higher). On the free plan, set the wildcard to DNS only (grey cloud).
• If you use Cloudflare proxy, set SSL/TLS mode to Full (strict) after installing the wildcard certificate on your origin.

• fullchain.pem — certificate + chain (use this as ssl_certificate)
• privkey.pem — private key (use this as ssl_certificate_key)

• CREATE and DROP on all databases (so new tenant databases can be created and removed).
• ALTER, INDEX, REFERENCES, CREATE ROUTINE, ALTER ROUTINE, EXECUTE, TRIGGER (so tenant migrations can run).
• Standard SELECT, INSERT, UPDATE, DELETE, LOCK TABLES.
• GRANT OPTION — optional, only needed if you want the app to create a dedicated DB user per tenant (not required by default; Stocky reuses the same user).

• In WHM → Account Functions → Create a New Account, create an account for yourdomain.com.
• Give it a package with enough quota for the central DB and all future tenant databases (or unlimited).
• Upload and extract stocky_saas.zip into /home/cpuser/public_html/.

1. Log into cPanel → Domains → Subdomains (or Subdomains in older themes).
2. Create a new subdomain with the name * on yourdomain.com.
3. Set the Document Root to /home/cpuser/public_html (the same folder as the main domain).

1. In WHM → DNS Functions → Edit DNS Zone, open the zone for yourdomain.com.
2. Add an A record: name *, type A, value = the server's IP.
3. Save. Wildcard DNS is now live.

• cPanel's AutoSSL cannot issue wildcards with the default Let's Encrypt HTTP-01 provider. You must either:
  • Install the Let's Encrypt provider for AutoSSL (/scripts/install_lets_encrypt_autossl_provider) and switch to DNS-01 validation, or
  • Generate a wildcard certificate off-box (certbot/acme.sh) and import it under cPanel → SSL/TLS → Install and Manage SSL for your site (HTTPS), pasting the certificate, key and chain.
• Make sure to install the wildcard on both yourdomain.com and the wildcard alias — cPanel should do this automatically once the wildcard subdomain exists.

1. Open a root SSH session and run the SQL from the Database Privileges section to create stocky_admin with ALL PRIVILEGES.
2. In WHM, go to SQL Services → Manage MySQL Profiles and confirm you are running a local MySQL (not an external managed instance that restricts CREATE).
3. Optionally, disable the Restrict MySQL commands to cPanel-prefixed databases tweak under WHM → Tweak Settings if your version enforces it.

1. In Plesk, click Websites & Domains → Add Domain and register yourdomain.com.
2. Upload your stocky_saas.zip to httpdocs/, extract it, then change the document root to httpdocs/public under Hosting Settings.
3. Set PHP 8.2 (or later) as the active PHP version.

1. Open Websites & Domains → yourdomain.com → Hosting & DNS → Domain Aliases.
2. Click Add Domain Alias.
3. In Domain alias name, type *.yourdomain.com.
4. Check Synchronize DNS zone with the primary domain and Web service. Leave Mail service unchecked.
5. Save. Plesk will generate the *.yourdomain.com vhost pointing to the same document root as yourdomain.com.

1. Install the free Let's Encrypt extension from Extensions if it is not already present.
2. Open Websites & Domains → yourdomain.com → SSL/TLS Certificates → Install.
3. Check Issue a wildcard certificate, Include www and Assign certificate to mail domain (optional).
4. Plesk will use the DNS-01 challenge. If your DNS is managed outside of Plesk, it will prompt you to add a _acme-challenge TXT record manually — add it and click Reload.
5. Once issued, the certificate is automatically bound to both yourdomain.com and *.yourdomain.com and auto-renews.

• Proxy mode is On (Nginx forwards PHP to Apache), or
• Disable proxy mode if you prefer pure Nginx + PHP-FPM (Plesk 18.0.30+).
• Do not set additional location overrides — Stocky relies on the default Laravel try_files rule.

1. In Virtualmin, click Create Virtual Server.
2. Domain name: yourdomain.com. Choose an administrator password.
3. In the Enabled features block, make sure Apache SSL website enabled? and MySQL database enabled? are checked.
4. Click Create Server. Upload stocky_saas.zip to /home/yourdomain/public_html and extract it.
5. Change Server Configuration → Website Options → Website documents sub-directory to public_html/public so Apache serves Laravel's public/ folder.

1. Open Server Configuration → Edit Virtual Server → Configurable settings.
2. In the Server alias field, add *.yourdomain.com.
3. Save — Virtualmin rewrites httpd.conf with ServerAlias *.yourdomain.com and reloads Apache.

1. Open Webmin → Servers → BIND DNS Server.
2. Select the yourdomain.com zone and click Address (A) record.
3. Create a new record: Name *, Address = your server IP.
4. Click Apply Configuration. If DNS is external, add the same record in your registrar's control panel.

• Option A: Issue the wildcard from the command line with certbot --dns-<provider> (see Wildcard SSL), then in Virtualmin Server Configuration → Manage SSL Certificate → Update Certificate, upload the fullchain.pem and privkey.pem.
• Option B: If you have configured Virtualmin to call a DNS hook (Cloudflare/Route53) for DNS-01, the Let's Encrypt tab can request a wildcard directly.

1. In CyberPanel, go to Websites → Create Website.
2. Pick a package, an owner, domain yourdomain.com, and PHP 8.2 or newer.
3. Check SSL, DKIM Support and Open Basedir Protection.
4. Upload stocky_saas.zip to /home/yourdomain.com/public_html and extract it.
5. Change the vhost document root to /home/yourdomain.com/public_html/public (edit the vhost from Websites → List Websites → Manage → vHost Conf).

1. From the website's Manage page, click Create Child Domain.
2. Child domain name: *.yourdomain.com.
3. Path: leave blank to use the parent's document root (Laravel serves everything).
4. Click Create. CyberPanel produces an OpenLiteSpeed vhost entry for the wildcard that reuses the same document root.

1. Go to DNS → Add/Delete Records and pick yourdomain.com.
2. Add an A record with name * pointing to your VPS IP.
3. If you use an external DNS provider, replicate the same record there.

• Open SSL → Hostname SSL (for the apex) and SSL → Mail Server SSL if needed.
• For the wildcard, use SSL → Manage SSL → Issue SSL — CyberPanel's Wildcard SSL mode uses acme.sh with DNS-01. Provide your Cloudflare/Route53 API credentials in the fields shown.
• Alternatively, run acme.sh manually on the server and import the certificate via SSL → Manage SSL → Add Custom SSL.

1. In DirectAdmin → Admin Level → Create User, add an account for yourdomain.com with a package that allows wildcard subdomains and enough MySQL databases for your tenants.
2. Switch to the user and upload/extract stocky_saas.zip under /home/diuser/domains/yourdomain.com/public_html.
3. From Account Manager → Domain Setup → yourdomain.com, set the Custom DocumentRoot to public_html/public.

1. Open Account Manager → Subdomains.
2. Create a subdomain called *.
3. DirectAdmin will add ServerAlias *.yourdomain.com to the vhost pointing to the same DocumentRoot.

1. Open Account Manager → DNS Management for yourdomain.com.
2. Add an A record: name *, value = VPS IP.

• In Account Manager → SSL Certificates, choose Free & automatic certificate from Let's Encrypt.
• Check Wildcard. DirectAdmin will require DNS-01; if DNS is on the same server it performs the challenge automatically, otherwise it prints the required TXT record.
• Once issued, the certificate is bound to yourdomain.com and *.yourdomain.com and renews automatically.

1. Log in to https://yourdomain.com/super/login as a super-admin.
2. Open General Settings.
3. Change Hosting Mode from Shared Hosting to VPS.
4. Save. New signups will now auto-provision (database created, migrations run, admin user seeded, workspace activated).

• Moving to a different domain after installation — update APP_URL (and clear caches below).
• Multiple central/admin domains (e.g. app.example.com and admin.example.com) — set CENTRAL_DOMAINS=app.example.com,admin.example.com. If this key is absent, the host of APP_URL is used automatically.
• Switching the queue to Redis for higher throughput — change QUEUE_CONNECTION=redis and configure REDIS_*.
• Turning debug off if it was left on after setup — set APP_DEBUG=false.

• cPanel: use cPanel → Advanced → Cron Jobs and add the command with the path to the account's PHP binary (for example /usr/local/bin/ea-php82).
• Plesk: use Websites & Domains → Scheduled Tasks → Add Task.
• Virtualmin: use Webmin → System → Scheduled Cron Jobs.
• CyberPanel: use Server Settings → Cron Jobs (or crontab -e as root).
• DirectAdmin: use Account Manager → Cron Jobs.

1. From the landing page, sign up for the Free or Trial plan with subdomain probe1.
2. Within a few seconds you should be redirected to https://probe1.yourdomain.com/login.
3. In MySQL: SHOW DATABASES LIKE 'tenant%'; — a new database should appear.
4. In the Super Admin → Tenants list, the new tenant should be marked Active.

• Tenant stuck on Provisioning: the queue worker is not running, or the DB user lacks CREATE. Inspect storage/logs/laravel.log and the worker log.
• HTTPS works on apex but fails on subdomains with ERR_CERT_COMMON_NAME_INVALID: the certificate is not a wildcard. Re-issue with -d "*.yourdomain.com".
• 403 Forbidden on subdomain: the vhost is not serving the wildcard. Double-check ServerAlias *.yourdomain.com / server_name *.yourdomain.com.
• Tenant loads but 500 errors everywhere: php artisan storage:link was not run, or storage/ and bootstrap/cache/ are not writable by the web user.
• Signup succeeds but landing page 404s on subdomains: Check APP_URL. It must be the apex domain (not a subdomain).
• cPanel rejects CREATE DATABASE: you are using the account's per-cPanel MySQL user. Switch to the server-level stocky_admin user you created in SSH.

• Dashboard — Real-time analytics on tenants, subscriptions, and revenue
• Tenant Management — Create, suspend, approve, and manage all tenant workspaces
• Plans — Configure subscription plans with feature limits and pricing
• Subscriptions — Monitor and manage all tenant subscriptions
• Payments & Billing — Track revenue, transactions, invoices, and refunds
• Admin Users — Manage super admin accounts with role-based permissions
• CMS – Landing Page — Customize your public landing page (hero, features, pricing, testimonials, FAQ)
• SEO Settings — Configure meta tags, keywords, and SEO for your landing page
• Knowledge Base — Create help articles and categories for your tenants
• Email Templates — Customize notification emails (subscription expired, payment success, etc.)
• Payment Gateways — Configure Stripe, PayPal, Paystack, and Flutterwave
• Mail Settings — Set up SMTP, Mailgun, Amazon SES, or Sendmail
• General Settings — Configure branding, currency, logo, and company info

• super_admin — Full unrestricted access to all features
• admin — Restricted access based on assigned permissions (Dashboard, Tenants, Plans, Subscriptions, Admins, Payments, Knowledge Base, CMS, Email Templates, Settings)

• Step 1 — User Registers: The user fills in company name, subdomain, email, and password on the signup page.
• Step 2 — Tenant Created: A new tenant record is created with provisioning status.
• Step 3 — Auto Database Setup: The system automatically creates a MySQL database (tenant_{uuid}), runs all migrations, seeds default data, creates the admin user, and installs Passport keys.
• Step 4 — Workspace Activated: The tenant status changes to active and the user can log in immediately.

• Step 1 — User Registers & Pays: The user selects a paid plan, fills in their details, and completes payment via the configured payment gateway.
• Step 2 — Payment Verified: The payment gateway sends a webhook to confirm the payment was successful.
• Step 3 — Auto Provisioning: The system automatically provisions the workspace (same as free/trial: creates database, runs migrations, seeds data, creates admin).
• Step 4 — Workspace Activated: The tenant is activated and the user can access their workspace.

• Step 1 — User Registers: The user fills in company name, subdomain, email, and password.
• Step 2 — Tenant Created as Pending: A new tenant record is created with pending status. No database is created yet.
• Step 3 — Emails Sent: The admin receives a notification email, and the user receives an "Under Review" email.
• Step 4 — User Sees Under Review Page: The user is shown a page indicating their application is being reviewed.
• Step 5 — Admin Creates Subdomain: The admin manually creates a subdomain in the hosting panel (cPanel/Plesk) for the tenant.
• Step 6 — Admin Creates Database & Configures Credentials: The admin creates a new database in the hosting panel and enters the credentials in the tenant management page.
• Step 7 — Connection Tested & Provisioned: The admin tests the database connection and triggers provisioning (migrations, seeding, admin creation).
• Step 8 — Tenant Activated & Email Sent: The tenant status changes to active and the user receives an approval email.

• Step 1 — User Registers & Pays: The user selects a paid plan and completes payment.
• Step 2 — Payment Verified: The payment gateway confirms the payment, but no provisioning happens yet.
• Step 3 — Tenant Created as Pending: The tenant is saved with pending status.
• Step 4 — User Redirected to Under Review Page: The user sees a page indicating their workspace is being set up.
• Step 5 — Admin Creates Subdomain & Database: The admin manually creates the subdomain and database in the hosting panel.
• Step 6 — Admin Configures & Approves: The admin enters database credentials, tests the connection, and triggers provisioning.
• Step 7 — Tenant Activated: The workspace is provisioned and the user receives a confirmation email.

• AES-256 Encrypted Passwords — All tenant database passwords are encrypted using Laravel's APP_KEY with AES-256 encryption
• Isolated Tenant Databases — Each tenant gets their own separate database, ensuring complete data isolation
• Test Connection — Use the "Test Connection" button in the tenant management page to verify database credentials before provisioning
• Re-run Migrations — If needed, use the "Re-run Migrations" button to update a tenant's database schema

Pending → Provisioning → Active

• Pending — Awaiting admin approval (shared hosting only)
• Provisioning — Database is being set up and migrations are running
• Active — Fully provisioned and accessible by the tenant
• Suspended — Temporarily disabled by the admin
• Cancelled — Subscription has been cancelled
• Failed — Provisioning failed (check logs and retry)

• Total Tenants — The total number of registered tenant workspaces
• Active Subscriptions — The number of currently active subscriptions
• Active Plans — The number of subscription plans currently available

• Subscription Status Breakdown — Donut chart showing active, trial, cancelled, and suspended subscriptions
• Tenants Created Per Month — 6-month area chart tracking new tenant registrations
• Top 5 Subscriptions by Plan — Bar chart showing the most popular plans

• Pending — Awaiting approval (shared hosting mode)
• Provisioning — Database and workspace are being set up
• Active — Fully operational tenant
• Suspended — Temporarily disabled by admin
• Cancelled — Tenant has been cancelled
• Failed — Provisioning failed (requires troubleshooting)

• Subdomain — The unique subdomain for the tenant (e.g., company.yourdomain.com)
• Company Name — The name of the tenant's business
• Admin Email — Email address for the tenant's admin account
• Admin Password — Password for the tenant's admin account
• Plan — Select the subscription plan to assign

• Edit — Update tenant information
• Suspend / Reactivate — Temporarily disable or re-enable a tenant
• Cancel — Permanently cancel a tenant
• Approve / Reject — Approve or reject pending tenants (shared hosting)
• Manage Domains — Add or remove custom subdomains for a tenant
• Manage Users — View, block, or unblock individual users within a tenant
• Database Tools — Test connection, rerun migrations, reseed data, or reset database
• Reprovision — Re-create the tenant workspace if provisioning failed

• Name & Slug — Display name and URL-friendly identifier
• Monthly Price — The monthly subscription cost
• Yearly Price — The annual subscription cost (discounted)
• Usage Limits — Set limits for: Products, Users, Warehouses, Customers, Suppliers
• Features — Toggle available features:
  • POS (Point of Sale)
  • Online Orders
  • HRM (Human Resource Management)
  • Accounting
  • WooCommerce Integration
  • Transfers
  • Service & Maintenance
  • AI Reports
• Trial Period — Enable/disable trial and set the number of trial days
• Active / Private — Active plans are available for signup; private plans are hidden from the public pricing page

• Tenant name and ID
• Assigned plan
• Subscription status (Active, Trial, Suspended, Cancelled)
• Trial end date (if applicable)
• Subscription end date

• Change Plan — Upgrade or downgrade the tenant to a different plan
• Change Status — Switch between active, suspended, cancelled, or trial
• Update Trial End Date — Extend or shorten the trial period
• Update Subscription End Date — Modify when the subscription expires

• Total Revenue — Sum of all successful payments
• Total Tax — Total tax collected
• Total Transactions — Number of payment transactions
• Status Breakdown — Paid, failed, refunded, and pending payment counts
• Monthly Revenue Chart — 12-month revenue trend with transaction count per month
• Payment Gateway Breakdown — Revenue distribution across gateways
• Recent Transactions — Quick view of the last 10 transactions

• View Details — See full payment information (tenant, amount, gateway, date)
• Create Manual Payment — Record an offline or manual payment
• Mark as Paid / Failed / Refunded — Update payment status
• Download Invoice — Generate and download an invoice PDF

• Name, Email & Password — Basic account credentials
• Role:
  • super_admin — Full unrestricted access to everything
  • admin — Access restricted to selected permissions only
• Permissions (for admin role) — Select which sections the admin can access:
  • Dashboard
  • Tenants
  • Plans
  • Subscriptions
  • Admins
  • Payments
  • Knowledge Base
  • CMS
  • Email Templates
  • Settings

• Title and subtitle text
• Description paragraph
• Primary and secondary call-to-action buttons with custom URLs
• Hero image upload

• Feature title and description
• Icon selection
• Feature image upload
• Drag-and-drop reordering

• Author name and image
• Testimonial content
• Star rating

• FAQ Section — Create and manage frequently asked questions with expandable answers
• CTA (Call to Action) — Configure headline, description, and button with custom URL
• Footer — Set footer text, links, and copyright information
• Multi-language Support — All CMS content can be translated into multiple languages (English, French, Hindi, Bengali, and more)

• Meta Title — The page title that appears in search engine results and browser tabs
• Meta Description — A brief summary of your page for search engine results
• Meta Keywords — Keywords associated with your platform for search indexing

• Category name and slug
• Description
• Icon selection
• Sort order (drag to reorder)

• Article title and slug
• Rich text content editor
• Publish / Unpublish toggle
• Sort order within category

• Subscription Expired — Sent when a tenant's subscription has ended
• Expiring Soon — Renewal reminder sent before expiration
• Payment Success — Confirmation after a successful payment
• Payment Failed — Notification when a payment attempt fails
• Plan Ended — Sent when the plan period is fully over
• Tenant Pending — Notification that the tenant is awaiting approval
• Tenant Under Review — Sent while the tenant application is being reviewed
• Tenant Approved — Confirmation that the tenant has been approved
• Tenant Rejected — Notification that the tenant application was rejected

• Edit the email subject line
• Customize the HTML email body with a rich editor
• Add translations for multiple languages
• Preview the email before saving
• Send a test email to verify the template

• Stripe — Credit/debit card payments worldwide
• PayPal — PayPal account and card payments
• Paystack — Popular payment gateway for Africa
• Flutterwave — Payment gateway for African businesses

• Enable / Disable — Toggle the gateway on or off
• Test / Live Mode — Switch between sandbox (testing) and production mode
• API Credentials — Enter your API keys and secret keys (stored encrypted)
• Supported Currencies — Set which currencies the gateway accepts
• Default Currency — Set the default currency for the gateway

• SMTP — Standard mail protocol (Gmail, Outlook, custom SMTP servers)
• Mailgun — Mailgun transactional email service
• Amazon SES — Amazon Simple Email Service
• Sendmail — Local server sendmail

• SMTP Host — Mail server address (e.g., smtp.gmail.com)
• SMTP Port — Port number (typically 587 for TLS or 465 for SSL)
• SMTP Username — Your email account username
• SMTP Password — Your email account password
• Encryption — TLS or SSL
• From Address — The sender email address
• From Name — The sender display name

• App Name — The name of your SaaS platform
• Currency Code & Symbol — Default currency for the platform (e.g., USD, $)
• Company Name — Your company's legal name
• Phone — Company contact phone number
• Email — Company contact email
• Address — Company physical address
• Website — Company website URL
• Logo — Upload your platform logo (PNG, JPG, JPEG, SVG, WebP)
• Favicon — Upload your browser tab icon (PNG, ICO, JPG, JPEG, SVG)
• Hosting Mode — Select VPS (automatic provisioning) or Shared Hosting (manual approval required)