Admin Portal
Complete guide for platform administrators — vendors, approvals, subscriptions, vase orders, asset-recovery incidents, customers, orders and payments.
Authentication
Login Page
The Admin Portal login screen. Enter your platform administrator username and password then click Sign In. Use Forgot password? to reset.
Forgot Password
Password reset page. Enter your username or registered email address and a reset link will be sent. Accessible without logging in.
Dashboard
Dashboard Overview
The main dashboard summarises platform activity: vendor counts, vase statistics, recent orders and revenue. Use the top navigation bar to move between sections.
Vendor Management
All Vendors
Lists all registered vendors. Each card shows the vendor name, address, type badge and registered-vase count. Click View Details to open a profile.
Create New Vendor
Form to onboard a vendor manually. Admin-created vendors are pre-approved. (Vendors may also self-register from the Vendor Portal.)
Vendor Details
Full vendor profile: business information, location, statistics, platform subscription, vase inventory and account actions (see the new sections below).
Pending Installations
Lists vases registered but not yet confirmed as physically installed.
Smart Vase Management
All Smart Vases
Table of every registered IoT vase across all vendors with status and last-heartbeat columns.
Vase Details
Detailed view of a single vase: serial, location, current bouquet, sensor data and heartbeat history.
Register New Vase
Register a new ESP32 SmartVase: serial number, owning vendor and installation location.
Customer Management
All Customers
Searchable list of registered customers with status and registration date.
Customer Details
Full customer profile: personal info, order history, saved addresses and subscriptions.
Orders
All Orders
Platform-wide order list, filterable by status.
Payments
All Payments
Payment ledger of all Stripe transactions for reconciliation and dispute investigation.
Vendor Subscriptions NEW
All Subscriptions
The Subscriptions page lists every vendor SaaS platform subscription with plan, status badge (Trial / Active / PastDue / Suspended / Cancelled), trial-end and next-billing dates. Filter by status or by Trial expiring soon; rows expiring soon are highlighted. Click Vendor to open the vendor profile.
Vendor Approval & Profile NEW
Subscription & Vase Inventory
The vendor details page now includes a Platform Subscription card (plan, status, trial and billing period) and a Vase Inventory card with counters — Ordered, Delivered, Online, Offline, Offline > 7d — plus a per-vase table. Rows offline more than 7 days are highlighted red and link to the open incident.
Approve or Reject a Vendor
Self-registered vendors start as Pending approval and cannot list bouquets until approved. Use the Approve / Reject buttons in Quick Actions; a confirmation banner reports the result. Rejected or pending vendors are blocked from creating bouquets (HTTP 403).
Vase Order Fulfillment NEW
All Vase Orders
The Vase Orders page lists hardware orders from all vendors with order date, vendor, quantity, shipping city, status badge and tracking number. Filter by status. Click Details to fulfill an order.
Order Details & Confirm
The order detail page shows order info, shipping address and a four-step timeline (Ordered → Confirmed → Shipped → Delivered). Available actions depend on the current status; a Requested order can be Confirmed or Cancelled.
Mark Shipped with Tracking
Once confirmed, supply a courier tracking number (required) and click Mark Shipped. The vendor sees the tracking number on their My Vase Orders page. A final Mark Delivered step closes the order.
Vase Asset Recovery (Incidents) NEW
Incident Dashboard (Empty)
The Incidents page lists asset-recovery cases. Incidents are opened automatically when a vendor-assigned vase has been offline for 7+ days (the health monitor also notifies the vendor by email). When there are none, the dashboard shows an empty state.
Incident Dashboard (Active)
With active cases the table shows vase serial, vendor, offline-since date, days offline, status and the most recent action type. Filter by status or vendor; the list is sorted by days-offline descending so the most urgent cases surface first.
Incident Details & Action Log
The incident detail page shows the vase & vendor, status panel and a chronological action timeline. Record follow-ups (Email, Call, Visit, Return steps, Vendor responded, Admin note) via Add Action. Case Management buttons let you Request Return, Escalate, or Resolve. Recording a ReturnReceived action automatically unassigns the vase, marks it Under Maintenance and resolves the incident.
