Documentation 🎨 Visual Guide

🌐 Platform Overview

Water is Life is a multi-tenant SaaS platform for managing mineral water plant operations. It connects water plants with customers, enabling online ordering, delivery tracking, financial management, and much more.

The platform supports multiple user roles, each with their own portal and set of features:

• Customer — Order water, track deliveries, manage payments
• Company Admin — Run your water plant business end-to-end
• Rider — Manage deliveries, collect payments, track routes
• City Admin — Oversee operations in a specific city
• Super Admin — Manage the entire platform
• Monitor — Live TV dashboard for monitoring operations

⚡ Quick Start: Your First 10 Minutes

Select your role below and follow the illustrated steps to be fully set up in under 10 minutes.

🌐 System Stages

The Water is Life platform operates across five stages. Here's how everything flows from setup to growth:

👥 Who Uses What — Portal Overview

There are six types of users on the platform, each with their own dedicated portal:

👤 Customer Registration

Customers can sign up to discover water plants, place orders, and get water delivered to their doorstep.

How to Register

1. Go to the Register page by clicking "Register" in the top navigation or visiting /web/customer/register.php.
2. Fill in your full name, phone number, email address, and delivery address.
3. Choose a city from the dropdown list (136+ cities available across Pakistan).
4. Create a strong password and confirm it.
5. Click "Register" to create your account.
6. You will be redirected to the login page. Sign in with your email and password.

Customer Registration form — all fields are required; city is selected from a dropdown of 136+ Pakistani cities

🏭 Plant Registration

Water plant owners can register their business to start managing operations, accepting orders, and growing their customer base.

How to Register Your Plant

1. Visit /web/company/register.php or click "Register Your Plant" on the landing page.
2. Enter your company name, admin name, phone, email, and address.
3. Select your operating city.
4. Create your admin password.
5. Click "Register". Your company and admin account will be created.
6. Sign in to access the Company Admin Portal and start setting up your business.

Plant Registration form — creates both the company record and the Company Admin account in one step

🔒 Login

All users sign in through the unified login page at /web/login.php. The system automatically detects your role and redirects you to the right dashboard.

How to Sign In

1. Go to the Sign In page.
2. Enter your registered email address and password.
3. Click "Sign In".
4. You will be automatically redirected to the appropriate dashboard based on your role (Customer, Company, Rider, City Admin, or Super Admin).

Login screen — one page for all roles; the system routes you to the correct dashboard automatically

🔑 Password Reset

If you forget your password, you can request a reset link via email.

How to Reset Your Password

1. On the login page, click "Forgot Password?".
2. Enter your registered email address.
3. Click "Send Reset Link". A password reset email will be sent to your inbox.
4. Open the email and click the reset link.
5. Enter your new password and confirm it.
6. Click "Reset Password". You can now sign in with your new password.

📊 Customer Dashboard

The Customer Dashboard is your home screen after logging in. It gives you a quick overview of your water delivery activity.

What You See

• Balance Cards — Shows your total outstanding balance (amount you owe), advance balance (if you've paid ahead), bottles outstanding, deposit balance, total spent, connected plants count, and active schedules.
• My Water Plants — A table listing all plants you're connected to with per-plant balance, bottles, and a quick "Order" button.
• Recent Orders — Your latest orders with order number, plant name, total, status, and date.
• Recent Payments — Your latest payment receipts.
• Find & Order — A button to discover new plants and place orders.

Customer Dashboard — the sidebar links give you instant access to all features; balance cards update in real time

📍 Discover Plants

The Discover page is a public marketplace where you can find mineral water plants near your location.

How It Works

• Search — Search for plants by name or filter by city.
• Plant Cards — Each plant shows its name, city, address, rating, review count, and available products with prices.
• View Details — Click on a plant to see its full product catalog, customer reviews, and contact information.
• Order — From the plant detail page, you can directly place an order if you're logged in and connected to that plant.

🔗 Connect to Plants

Before ordering from a plant, you need to connect to it. This creates a customer-company relationship.

How to Connect

1. Go to My Plants in the sidebar.
2. Click "+ Add Company" or "Find Plants".
3. Search for the plant by name or browse available companies.
4. Click "Add" next to the plant you want to connect to.
5. The plant will appear in your My Plants list. You can now place orders from it.

You can connect to multiple plants simultaneously and order from any of them. Each plant tracks your balance, bottles, and orders independently.

📦 Place Orders

Ordering water is simple and takes just a few clicks.

How to Order

1. Go to New Order in the sidebar.
2. Select the water plant you want to order from. Your current balance with the plant will be displayed.
3. Browse the product catalog. Each product shows its name, description, unit, and price.
4. Enter the quantity for each product you want. For 19L bottles, select the bottle type (Exchange, Company, or Purchase).
5. Review the order summary showing subtotal, delivery charges, cargo charges (if applicable), tax (if the plant charges tax), and grand total.
6. Optionally add order notes for special instructions.
7. Toggle Emergency Order if you need urgent delivery (may have different charges).
8. Click "Place Order" to submit.

New Order form — select your plant, choose quantities, review the total, add notes, and submit

🚚 Delivery Journey

Every order follows a well-defined journey from the moment you click "Place Order" to the moment it arrives at your door. Here's the full lifecycle visualized:

Who Does What

• Customer — Places the order. Can view status in real time under Track Delivery.
• Company Admin — Reviews pending orders, confirms them, assigns a rider, and dispatches.
• Rider — Marks "Pick Up" at the plant, "In Transit" on the road, and "Deliver" at the customer's door. Collects cash payment if applicable.

📅 Recurring Schedules

Set up automatic recurring orders so you never run out of water.

How to Create a Schedule

1. Go to My Schedules in the sidebar.
2. Click "+ New Schedule".
3. Select the water plant and choose your products with quantities.
4. Choose a frequency: Daily, Every 2 Days, Every 3 Days, Every 4 Days, Weekly, Every 15 Days, or Monthly.
5. Set the start date for when orders should begin.
6. Click "Create Schedule".

The system automatically generates orders based on your schedule. You can pause, resume, or delete schedules anytime from the My Schedules page.

🚚 Track Deliveries

Track the status of your active deliveries in real-time.

Delivery Statuses

Each order moves through these statuses in order. Color-coded badges make it easy to know at a glance where your order is:

Go to Track Delivery in the sidebar to see all your active deliveries and their current status.

Track Delivery screen — each order card shows a live status bar highlighting exactly which stage your delivery is at

💰 Payments & Deposits

Manage your payments and submit deposit proofs to plants.

Submit Payment

1. Go to Submit Payment in the sidebar.
2. Select the water plant you're paying. Your current balance will be shown.
3. Enter the amount and select the payment method (Bank Transfer, JazzCash, Easypaisa, etc.).
4. Enter a reference number (transaction ID from your bank/wallet).
5. Upload a payment proof (screenshot of the transfer).
6. Add optional notes.
7. Click "Submit Deposit".

Your deposit will appear as "Pending" until the plant admin approves it. Once approved, it will be credited to your account.

My Deposits

View all your submitted deposits, their status (Pending, Approved, Rejected), and associated details under My Deposits.

Submit Payment form — upload a transfer screenshot as proof; the plant admin reviews and approves it

📄 Invoices & Receipts

Invoices

View all invoices generated by your connected plants under Invoices. Each invoice shows the invoice number, plant name, amount, status (Paid/Unpaid/Partial), due date, and issue date. You can view invoice details including line items.

Receipts

View payment receipts under Receipts. Each receipt shows the receipt number, plant name, amount, payment method, and date.

Billing Statements

View comprehensive billing statements per plant under Billing Statements. Statements show all transactions (orders, payments, adjustments) for a selected date range with running balance.

📋 Tax History

If your water plant charges tax (e.g., sales tax, withholding tax), you can view your tax history and download certificates.

What You See

• Fiscal Year Selector — Choose the fiscal year (Pakistan fiscal year: July 1 to June 30). Available years are auto-populated based on your order history.
• Per-Company Breakdown — Tax paid to each plant for the selected fiscal year.
• Monthly Detail — Month-by-month tax breakdown.
• Tax Certificates — Download tax certificates uploaded by the plant (if available).

The Dashboard also shows a "Tax Paid This Month" card if tax has been charged during the current month.

🍺 Bottle History

Track your 19L bottle transactions with each connected plant.

What You See

• Current Outstanding — How many bottles you currently have from each plant.
• Transaction History — A log of all bottle issued (delivered) and returned transactions with dates.

Bottles with type "Company" are tracked in your outstanding count. When the rider delivers company-owned bottles, they're added to your count. When you return empty bottles, they're deducted.

⭐ Reviews

Rate and review the water plants you've ordered from.

How to Leave a Review

1. Go to My Reviews in the sidebar.
2. You'll see all plants you're connected to.
3. Click "Write Review" for a plant.
4. Select a star rating (1-5 stars).
5. Write your review text.
6. Click "Submit Review".

Your reviews are visible to other customers on the plant's marketplace page, helping them make informed decisions.

💼 Company Admin Dashboard

The Company Admin Dashboard provides a comprehensive overview of your water plant's operations.

Dashboard Cards

The dashboard displays real-time metrics as clickable cards:

• Today's Orders — Total orders placed today. Click to view orders.
• Cash Collected — Cash collected today from deliveries. Click to view payments.
• Outstanding — Total outstanding balance across all customers. Click for aging report.
• Bottles Out — Total 19L bottles currently with customers. Click for returnables.
• Total Customers — Your registered customer count.
• Pending Orders — Orders awaiting processing.
• Today's Deliveries — Delivery progress for today.
• Active Riders — Number of riders currently online.
• Pending Deposits — Customer payment deposits awaiting approval.
• Today's Revenue / Monthly Revenue — Financial performance metrics.
• Monthly Expenses — Total expenses recorded this month.
• Advance Held — Total advance payments held from customers.
• Live Monitor — Opens the full-screen monitoring dashboard in a new tab.

Additional Dashboard Sections

• Emergency Orders — Alert banner showing active emergency orders requiring immediate attention.
• Delivery Completion — Progress bar showing today's delivery completion rate.
• Aging Buckets — Outstanding balances grouped by age (0-30, 31-60, 61-90, 90+ days).
• Top Bottle Defaulters — Customers with the most bottles outstanding.
• Recent Activity — Live feed of recent orders, payments, and deliveries.
• Credit Alerts — Customers approaching or exceeding their credit limits.
• Analytics Charts — Weekly sales, order status breakdown, top products, and revenue vs expenses.

Company Admin Dashboard — all key metrics visible at once; click any card to drill into the details

👥 Customer Management

Manage your customer base from the Customers section.

Features

• Customer List — View all customers with search, status filter, and pagination. Shows name, phone, balance, bottles outstanding, credit limit utilization, and join date.
• Add Customer — Register a new customer directly. Enter name, phone, email, address, and optional credit limit.
• Edit Customer — Update customer details, set credit limits, change status (active/suspended).
• View Statement — See a customer's complete transaction history with running balance.
• Reset Password — Reset a customer's login password.
• Delete Customer — Remove a customer (restricted to accounts older than 6 months by default).

🍩 Products & Pricing

Manage your product catalog and set prices.

Managing Products

• Product List — View all your products with name, unit, price, delivery chargeability, and status.
• Add Product — Create a new product with name, description, unit (e.g., "19L Bottle", "500ml Pack"), base price, and whether delivery charges apply.
• Edit Product — Update product details and pricing anytime.
• Activate/Deactivate — Toggle products on or off without deleting them. Inactive products won't appear in the customer's order form.

📦 Orders & Deliveries

Order Management

View and manage all orders from the Orders section:

• Order List — Filter by status (Pending, Confirmed, Dispatched, Delivered, Cancelled), date range, and search by order number or customer.
• View Order — See full order details including items, quantities, prices, delivery address, notes, and status history.
• Confirm Order — Accept a pending order for processing.
• Dispatch Order — Assign a rider and dispatch the order for delivery. Select a rider from available riders.
• Cancel Order — Cancel an order with a reason.
• Create Order — Place an order on behalf of a customer (useful for phone orders).

Order dispatch workflow — 3 clicks: Confirm → Dispatch → Assign Rider

Delivery Management

The Deliveries section shows all delivery assignments:

• Filter by date, rider, and delivery status.
• View delivery details including rider, customer, address, items, and payment status.
• Reassign deliveries to different riders if needed.
• Track delivery attempts and reschedule failed deliveries.

💳 Office Sales (POS)

Record walk-in/counter sales for customers who come directly to your plant.

How to Create an Office Sale

1. Go to Office Sales in the sidebar.
2. Click "+ New Sale".
3. Optionally link to a registered customer or record as a walk-in sale.
4. Add products with quantities and manual prices (prices are entered at time of sale, not from catalog).
5. Add optional cargo/shipping charges.
6. Select payment method (Cash, Online, Credit) and payment status (Paid, Unpaid, Partial).
7. Click "Create Sale".

Each sale gets an auto-generated sale number (OS-000001 format). You can generate invoices from office sales and view/delete past sales.

⚒ Production Log

Record daily production quantities for tracking and monitoring.

How to Use

• Go to Production Log in the sidebar.
• Select the date and product.
• Enter the quantity produced and any notes.
• Click "Log Production" to save the record.
• View production history filtered by date range and product.

Production data is shown on the monitoring dashboard and in company reports.

📦 Inventory Management

Track your stock levels across all products.

Features

• Current Stock — View current inventory levels for all products.
• Stock Adjustments — Record additions (from production, purchases) and deductions (for damage, loss).
• Auto Updates — Stock is automatically adjusted when deliveries are completed and production is logged.
• Stock History — View a log of all inventory changes with reasons.

🍺 Returnables (19L Bottles)

Track 19-liter returnable bottles issued to and returned by customers.

Features

• Customer Bottles List — See how many bottles each customer currently has outstanding.
• Record Returns — When a customer returns empty bottles, record the return to reduce their outstanding count.
• Bottle Defaulters — Identify customers with the most bottles outstanding (shown on the dashboard).
• Bottle History — View the complete transaction log of bottles issued and returned per customer.

🔄 Recurring Orders

View and manage customer recurring delivery schedules.

Features

• Schedule List — View all active and paused recurring schedules with customer name, products, frequency, and next order date.
• Pause/Resume — Temporarily pause a schedule or resume it.
• Cancel Schedule — Permanently cancel a recurring schedule.
• Auto-Generation — A background scheduler automatically creates orders based on the next_order_date. The scheduler runs periodically and processes all due schedules.

💵 Financial Management

Comprehensive financial tools to manage your water plant's finances.

Invoices

Generate and manage invoices for customers:

• Auto-generate invoices from orders or office sales.
• View all invoices with filters for status (Paid, Unpaid, Partial, Overdue), date range, and customer search.
• Mark invoices as paid and record payment details.
• Download/print invoice PDFs.

Payments

Record and track all customer payments:

• View all payments with receipt numbers, amounts, methods, and dates.
• Record manual payments (cash collection, bank transfers).
• Payments automatically reduce customer outstanding balance.

Deposit Approvals

Review and approve customer-submitted payment deposits:

• View pending deposits with proof images and reference numbers.
• Approve or reject deposits. Approved deposits create payment records.

Ledger

Complete general ledger showing all financial transactions:

• Filter by customer, date range, and transaction type.
• See running balance for each customer.
• Export ledger data as CSV.

Expenses

Track business expenses:

• Record expenses with category, amount, date, and description.
• Expense categories: Utilities, Rent, Salary, Fuel, Maintenance, Raw Materials, Other.
• View and filter expense history. Monthly totals shown on dashboard.

Aging Report

Analyze outstanding balances by age:

• Customers grouped by how long their balance has been outstanding (0-30, 31-60, 61-90, 90+ days).
• Identify long-overdue accounts for follow-up.
• Summary totals per aging bucket.

Advance Balances

View customers who have advance (prepaid) balances:

• List of all customers with negative outstanding (they've paid more than they owe).
• Total advance amount and customer count.
• Export as CSV.

Tax Certificates

Upload tax certificates for customers (for plants that charge tax):

• Upload PDF or image certificates per customer per fiscal year.
• Customers can download their certificates from their portal.
• View and manage all uploaded certificates.

Period Locks

Lock financial periods to prevent backdated modifications:

• Lock a month to prevent any new transactions from being recorded with dates in that period.
• Ensures financial data integrity for closed periods.

👷 Workers & Roles

Workers

Manage your team members who have access to the company panel:

• Add Worker — Create accounts for riders, monitors, or other staff. Assign a role to control what they can access.
• Worker Types — Rider (for delivery), Monitor (for live monitoring dashboard), Worker (general staff).
• Manage — Edit worker details, reset passwords, or deactivate accounts.

Roles & Permissions

Create custom roles with granular permissions:

• Create Role — Define a role name and select which permissions it has (e.g., orders.view, orders.create, payments.manage, etc.).
• Assign Roles — Assign roles to workers to control their access level.
• Default Roles — "rider" and "monitor" roles are created automatically with appropriate permissions.

📍 Zones

Define delivery zones to organize your service areas.

• Create Zones — Define named zones (e.g., "North City", "Industrial Area").
• Assign Customers — Assign customers to zones for organized delivery routing.
• Zone-Based Delivery — Use zones to plan delivery routes and assign riders to specific areas.

🚚 Cargo Charges

Set up slab-based cargo/delivery charges that are automatically applied to orders.

How It Works

• Create Slabs — Define charge slabs based on order quantity ranges (e.g., 1-5 bottles = Rs. 100, 6-10 = Rs. 200).
• Auto-Applied — When customers place orders, cargo charges are automatically calculated based on the total quantity and your defined slabs.
• Per-Product — Only products marked as "delivery chargeable" count toward cargo charge calculation.

🎨 White Label Branding

Customize the appearance of your customer portal with your own branding.

Branding Options

• Company Logo — Upload your logo to replace the default logo in the customer portal sidebar.
• Tagline — Set a custom tagline that appears below your company name.
• Theme Colors — Choose primary and secondary colors to match your brand identity.
• Footer Text — Add custom footer text (e.g., "Powered by Your Company").
• Favicon — Upload a custom favicon for the browser tab.
• Custom CSS — Add custom CSS rules for advanced styling (for technical users).

When a customer is connected to a whitelabel-enabled plant, the customer portal automatically applies that plant's branding.

📺 Monitoring Portal

A full-screen, TV-friendly dashboard for live monitoring of plant operations.

What It Shows

• Rider Map — Live Leaflet.js map showing rider locations with color-coded markers. Click markers for rider details.
• Stats Bar — Riders online, deliveries completed/in-progress/failed, production counts, sales, bottles outstanding.
• Financial Summary — Today's revenue, cash collected, outstanding amounts.
• Production by Product — Current day's production breakdown.
• Current Stock — Inventory levels for all products.
• Rider List — All active riders with their current status and last known location.
• Delivery Progress — Progress bar showing overall completion percentage for today.

Access

• Click "Live Monitor" card on the Company Dashboard to open in a new tab.
• Or access directly at /web/monitor/.
• Create Monitor users via the Workers page for dedicated monitoring accounts.
• Auto-refreshes every 30 seconds.

📊 Reports

Generate reports to analyze your business performance.

Available Reports

• Sales Report — Revenue, orders, and product breakdown by date range.
• Customer Report — Customer activity, outstanding balances, and engagement metrics.
• Delivery Report — Delivery success rates, rider performance, and route efficiency.
• Financial Summary — Revenue vs expenses, profit margins, and payment collection rates.
• Export — Download reports as CSV files for external analysis.

⭐ Subscription

Manage your platform subscription plan.

• Current Plan — View your active subscription plan, features, and expiry date.
• Upgrade — Upgrade to a higher plan for more features and higher limits.
• Plan Limits — Each plan has limits on number of customers, orders per month, riders, and available features.

🏃 Rider Dashboard

The Rider Dashboard provides an overview of today's delivery assignments.

What You See

• Location Toggle — Turn location sharing on/off. When active, your location is shared with the company for tracking on the monitoring dashboard.
• Status Cards — Count of deliveries by status: Assigned, Picked Up, In Transit, Delivered, Failed, and Total for today.
• Active Delivery — Your current active delivery with full details (order number, customer name, phone, address, amount, items, notes) and action buttons.

Rider Dashboard — the active delivery card shows everything the rider needs; three action buttons to advance the status

🚚 Rider Deliveries

View and manage all your delivery assignments.

Delivery Workflow

1. Assigned — A delivery appears when the company dispatches an order to you. Click "Pick Up" to confirm you've collected the order from the plant.
2. Picked Up — You have the order. Click "In Transit" to indicate you're on your way, or directly click "Deliver".
3. In Transit — You're traveling to the customer. Click "Deliver" when you arrive.
4. Deliver — When delivering, you'll be asked if payment was collected. Select "Cash Collected" and enter the amount, or "Unpaid / On Account" if the customer will pay later.
5. Failed — If delivery fails, click "Failed" and enter a reason (e.g., customer not available, wrong address). Failed deliveries can be rescheduled.

Features

• Filter deliveries by date and status.
• View delivery attempts for rescheduled orders.
• Call customers directly from the delivery card (phone link).

📍 Route Map

View today's deliveries as an ordered route list.

Features

• Route List — Deliveries shown in sequence order with numbered stops, customer names, addresses, and status indicators.
• Color Coding — Each stop is color-coded by status (blue = assigned, yellow = in transit, green = delivered, red = failed).
• Stats — Total stops, completed count, and remaining count.
• Completed deliveries appear faded to focus on remaining stops.

💳 Wallet & Collections

My Wallet

View your wallet summary showing total cash collected, total deposited, and current cash balance (amount you need to deposit back to the company).

Collections

Detailed log of all cash collections made during deliveries:

• Order number, customer, amount collected, date.
• Filter by date range.

Cash Balance

Shows your running cash balance — the difference between what you've collected from customers and what you've deposited to the company. This should be submitted regularly.

💵 Cash Deposits

Submit collected cash back to the company.

How to Submit a Deposit

1. Go to Submit Payment in the sidebar.
2. Enter the amount you're depositing.
3. Select the payment method (Cash handover, Bank transfer, etc.).
4. Enter a reference number if applicable.
5. Upload proof (photo of receipt or bank transfer confirmation).
6. Click "Submit Deposit".

Your deposit will be reviewed by the company admin. Once approved, it reduces your cash balance. View all your submitted deposits and their status under My Deposits.

🔎 Discovering Plants

The marketplace at /web/customer/discover.php is publicly accessible and allows anyone to browse available water plants.

Features

• City Filter — Filter plants by city to find options in your area.
• Search — Search by plant name or address.
• Plant Details — Each listing shows the plant name, city, address, star rating, review count, and product catalog with prices.
• Direct Order — Logged-in customers can order directly from the plant's detail page.

💰 Comparing Prices

Use the marketplace to compare prices across different water plants in your city:

• Each plant's product catalog with prices is visible on the discover page.
• Compare 19L bottle prices, smaller packs, and delivery charges between plants.
• Factor in ratings and reviews when making your choice.

⭐ Reading Reviews

Customer reviews help you choose the best water plant:

• View average star ratings (1-5) for each plant on the discover page.
• Click into a plant to read individual reviews from verified customers.
• Reviews include star rating, review text, customer name, and date.
• Only customers who have ordered from a plant can leave reviews, ensuring authenticity.

🔐 Super Admin — Platform Management

The Super Admin has full control over the entire Water is Life platform.

Capabilities

• Dashboard — Platform-wide statistics: total companies, customers, orders, revenue, and growth metrics.
• Announcements — Create and manage platform-wide announcements shown as ticker banners on landing page and dashboards. Support for bilingual content (English + Urdu).
• Client Management — View, edit, and delete any customer across all companies. Unrestricted access (no 6-month deletion rule).
• Company Oversight — View all registered companies, their subscription status, and operational metrics.
• Backup Management — Create and download database and file backups.

🏙 City Management

Manage the cities available on the platform:

• City List — 136+ cities across Pakistan are pre-seeded.
• Add City — Add new cities with name and province.
• Edit/Deactivate — Modify city details or deactivate cities no longer served.
• City Admins — Assign city admin users who can oversee operations within specific cities.

🏭 Company Management

Oversee all registered water plants:

• View all companies with their subscription plan, status, customer count, and order volume.
• Activate or suspend company accounts.
• Manage subscription plans and features per company.

⚙ System Settings

Configure platform-wide settings:

• Customer Management Lock — When enabled, companies cannot edit or delete existing customers (they can still add new ones). Useful for data integrity protection.
• Social Media Links — Configure platform social media links (Facebook, Instagram, WhatsApp, YouTube, etc.) that appear in the landing page footer.
• Contact Information — Set platform contact phone, WhatsApp, email, and website displayed on the landing page.
• Subscription Plans — Define available subscription plans with features, limits, and pricing.

🛡 Security Overview

The Super Admin has a dedicated Security Health Dashboard that gives a real-time snapshot of the platform's security posture. Access it via Security → Overview in the Super Admin panel.

What the Security Dashboard Shows

• SSL Certificate — Days remaining, issuer, domain, valid dates, and a "How to Renew" guide when expiry is within 30 days.
• HTTPS Enforced — Whether all HTTP traffic is force-redirected to HTTPS.
• HSTS Header — Whether Strict-Transport-Security is active (requires HTTPS).
• Content Security Policy — Blocks unauthorized scripts and resources.
• Rate Limiting — Current API request limit per minute per IP.
• IP Blocking — Number of currently active IP blocks.
• Account Lockout — Settings for brute-force protection (attempts before lock, lock duration).
• Active Sessions — Live count of valid login tokens across all users.
• Failed Logins (24h) — Failed login attempts in the last 24 hours with percentage of total attempts.
• Locked Accounts — Accounts currently locked due to repeated failed logins.
• Audit Logging — Number of admin events recorded in the last 24 hours.
• File Upload Security — MIME type validation status and maximum file size.
• Password Hashing — bcrypt cost 12 (industry standard).
• reCAPTCHA — Whether bot protection is enabled on login/registration forms.
• Token Expiry — Access token lifetime and refresh token lifetime.

Security Health Dashboard — green borders = healthy, yellow = needs attention, red = critical action required

Security Tabs

• Overview — The health check dashboard above.
• Login History — All login attempts (success and failure) with IP addresses, timestamps, and user agents.
• Audit Logs — Every admin action logged with who did it, what they did, when, and from which IP.
• Locked Accounts — Accounts currently locked due to failed login attempts. Unlock accounts from here.
• IP Blocks — View, add, and remove IP address blocks. Block suspicious IPs permanently or temporarily.

❓ FAQ for Beginners

New to the platform? Here are the most common questions and plain-language answers.