System Overview

Welcome back, Administrator
🔥 System Pulse · Last 7 Days
🏢 Branch Status
👥 Top Active Users
⚠️ System Alerts

Audit Log

Every data change is recorded here

User Management

Create, edit, and manage all system users

Roles & Access Control

Edit which permissions each role may use
🔐 Permission Matrix

Branch Network

Manage all branch locations

Geofencing Configuration

Set default radius and per-branch overrides
📍
0
Total Fences
📏
0m
Avg Radius
✅
0
Active
🌐
0km
Total Coverage
🌐 Default Geofence Radius
Default Radius (meters)
Applied when a branch has no specific radius set

Remote Workforce Monitor

Track who's working from home, the field, or the office — live presence + today's check-in
🔍 Filters

Live Location Map

Real-time positions of field staff during work hours · updated every 60 seconds
🔍 Filter Map Markers

Device Sessions

One-device-per-user enforcement — admins & managers exempt · force-clear stuck devices here
🔍 Filter Devices

Sales Center

All captured sales · filter, drill-down, export
🔍 Filter

Inventory Center

Stock ledger · current levels · low-stock alerts
🔍 Filter

Sales Catalog

Products · Brands · Categories · Dealers
Sub-section

Weekly Sales Reports

Builds the WEEKLY_SALES_REPORT structure — Raw, Analysis (WoW), Top-N — download or email
📅 Report period
📊 Week-over-week comparison
🏆 Top 5 Sellers
📦 Top 5 Models

Sales Config

Recipients, schedule, options for sales + inventory features
📧 Email reporting
⚙️ Capture options

KPI Groups

Configure weighted KPI groups assigned to staff

KPI Role Library

Every role definition used by the KPI Center is editable here. Tune weights, weekly rate, monthly rating, bonuses and penalty tiers.

KPI Targets & Parameters — Bulk Upload

Download a pre-filled CSV template, edit it in Excel/Sheets, then re-upload to apply targets, weights, bonuses and penalty tiers across many KPI groups at once. Safe: a preview is shown before anything is persisted.
⬇ Download templates
The downloaded files include your current KPI data so you can start editing right away. The blank template documents every column and expected data type.
⬆ Upload a CSV

📊 KPI Performance Reports

Organisation-wide metrics, drill-down by role, branch or KPI part
📈 Weekly trend · last 8 weeks
🎯 Role breakdown
🏢 Branch breakdown
🏆 Top 10 performers
⚠️ Bottom 10 (needs attention)
🔬 KPI part drill-down
Select a role above

Organisation Policies

Work hours, leave limits, expense caps, geofence
⏰ Work Hours
Shift Start
Expected daily clock-in time
Shift End
Expected daily clock-out time
Late Threshold (min)
Minutes after shift start considered late
Working Days / Week
Expected days per week
🌴 Leave Policy
Annual Leave (days)
Paid annual leave entitlement
Sick Leave (days)
Paid sick leave entitlement
Casual Leave (days)
Paid casual leave entitlement
Max Advance Days
How far ahead leave can be requested
💳 Expense Limits
Daily Cap (₦)
Max claim per day without approval
Monthly Cap (₦)
Max monthly expense per staff
Receipt Required Above (₦)
Amount requiring uploaded receipt
Approval Threshold (₦)
Above this amount auto-routes to CFO
📍 Geofence & Security
Default Radius (m)
Default fence radius for new branches
OTP Validity (min)
Minutes before OTP expires
Session Hours
Force re-auth after N hours
Require Biometric
Enforce biometric for clock-in
🕐 Auto Attendance
Office staff clock in/out automatically at their branch geofence — in the app, and (with the “Allow all the time” location grant) even while the app is closed.
🛡️ Geofence Enforcement
Require staff to be physically inside a valid location's geofence before they can perform the selected activities. When a user is off-site the action is blocked with a clear message. Admins & CFO stay exempt by default so you can never lock yourself out.
Activities to enforce
What counts as "on-site"
Exempt roles
Exempt work modes
Max GPS accuracy (m)

🧩 Custom Fields

Tailor every record type to your industry — add, edit, duplicate, reorder & define field types
Record type:

🤖 AI Assistant & Fraud Watch

Configure the personal AI coach and review flagged activity
🤖 Assistant settings
The built-in engine always works offline — analysing each user's own data, gated by their hierarchy & location. Claude only handles free-form questions (or every message when Deep chat is on), via your relay. There's no free Claude API, but Haiku is near-free and the relay runs on a free tier — see ai-relay/README.md in the repo for a 5-minute setup.
🚨 Fraud & anomaly alerts

🗂️ Organogram Intelligence

Visualise & manage your management and reporting-line structure
    Tip: click anyone to reassign their manager, add a direct report, or detach them. Drag-free — pick from the list.

    Product Catalog

    Products stocked across branches

    eSurveys

    Create, publish and analyse field surveys

    Company Notices

    Announcements pinned to dashboards

    Gamification Badges

    Awards earned by staff for achievements

    Training Library

    Learning modules and certifications

    Support Tickets

    Inbound issues raised by staff — triage, assign, resolve
    📥
    0
    Open
    🔧
    0
    In progress
    ✅
    0
    Resolved
    📦
    0
    Total

    🧭 Workflow Intelligence

    Reporting lines, regions, approvers — the backbone of every approval, notification, report, and escalation.
    🗺️
    0
    Regions
    🏢
    0
    Branches
    👔
    0
    Managers
    🧑‍💼
    0
    Staff
    ⚠️
    0
    Issues
    Company Reporting Tree
    💡 Drag any person card onto another to make them report to that person. Drop on the "↥ top level" row to un-assign a manager.

    Messaging Channels

    Broadcast groups and regional channels

    Push Notifications

    Send instant notices to any group of staff
    📣 New Broadcast
    📝 Recent Broadcasts

    Email Gateway

    SMTP configuration and transactional email log
    🚀 Delivery Mode
    Choose how outbound email actually leaves the browser. Simulation only logs into the email table below; the real modes issue a live HTTPS request.
    Loading…
    ⚙️ SMTP Server
    Legacy SMTP coordinates. Real delivery is selected above.
    📨 From Identity
    Last Test
    Never tested
    Pending
    📬 Notice Delivery Policy
    Which in-app notifications also dispatch an email. Recipients resolve automatically via Workflow Intelligence.
    📜 Email Log

    Reports & Business Intelligence

    Configure recipients and scheduling for automated daily, weekly and monthly performance reports
    🕑 Schedule
    All times 24-hour, server local time
    📬 Recipients
    Automatically includes CEO/MD, CFO, COO, managers
    Use Name <email@host> format for friendly names.
    📡 Delivery transport
    Scheduled delivery is handled by the sync server — it calls back into SMTP to send.
    How delivery works:
    1️⃣ Sync server fires cron jobs at the schedule above (daily 01:00, weekly Sunday 01:00, monthly 1st @ 01:00).
    2️⃣ Server pulls the latest state snapshot and runs the report engine to produce an executive HTML document.
    3️⃣ Server posts the HTML via SMTP to every recipient on the list.
    4️⃣ A copy is saved into the portal's Reports Center so anyone can download the PDF / CSV anytime.
    📑 Latest saved reports

    Features & Access

    Enable, disable, and assign features to roles, branches, user groups, or specific users
    🔍 Filter

    User Groups

    Create named groups to assign features to many users at once

    Salary Deductions

    Accumulated late-arrival penalties — review, mark as applied to payroll, or export
    🔍 Filter

    Connectors

    Connect your Gmail / Outlook / Zoho inbox, WhatsApp Business number, and production database. Credentials are stored on the sync server; secrets never leave it.
    🔑 Sync Server Admin Token
    checking…
    The sync server gates connector configuration behind an admin token (the ADMIN_TOKEN env var on the Render service). Without it, every Connect / Save / Disconnect button on this page returns 401. Paste the value here; stored in this browser only.
    📧 Two-way Email Inbox
    Loading…
    Polls your inbox every 5 minutes and lands new mail in Spectrum. Reply from the same place.
    Click a provider to start the OAuth sign-in flow.
    ▸ First-time Gmail OAuth setup (one-time)
    1. Open Google Cloud → APIs & Services → Credentials (signed in as aibuedefe@korevra.com)
    2. Click + Create Credentials → OAuth client ID → Web application
    3. Authorized redirect URI: (loading…)
    4. Copy Client ID + Secret into Render env vars as GMAIL_OAUTH_CLIENT_ID + GMAIL_OAUTH_CLIENT_SECRET
    5. Return here, click Gmail (recommended) above, sign in
    Advanced — paste credentials manually
    💬 WhatsApp Business (Cloud API)
    Loading…
    Send + receive WhatsApp messages via Meta's Cloud API. Click-to-chat works without any setup; full two-way messaging needs four values from your Meta dashboard.
    Get these four values from developers.facebook.com → your app → WhatsApp → API Setup.
    🗄️ Production Database
    Loading…
    Mirror every write to a real database. Firebase Firestore is the recommended default — drop in a Service Account JSON and Spectrum starts persisting in real-time. Postgres / Mongo / SQLite are available if you bring your own connection string.
    Active driver
    —
    Drivers installed
    —
    JSONL fallback path
    —

    Integrations Portal

    ERP connectors, webhooks, and manual stock uploads
    🔌 Installed Integrations
    🧩 Available Connectors
    Click to install
    📝 Sync Log

    System Settings

    Brand, language, data and security
    🎨 Brand
    Organisation Name
    Shown in app header and emails
    Currency
    Default currency for financial fields
    Time Zone
    Reporting time zone
    🔔 Notification Providers
    Browser Push
    Google FCM (Chrome) · Mozilla autopush (Firefox) · Apple WebPush (Safari)
    Enabled
    Active push provider mix
    Click refresh to query the relay
    VAPID Public Key
    Required to dispatch Web Push from server
    Push Relay URL
    HTTPS endpoint that delivers via web-push library
    Save push config
    Persists VAPID key + relay URL into policies
    SMS Gateway
    Africa's Talking / Twilio
    Not Configured
    Email SMTP
    Transactional email
    Not Configured
    WhatsApp Business
    Cloud API
    Not Configured
    🛰 Realtime Sync
    Multi-device collaboration via WebSocket relay
    Point every device at the same sync server URL to keep expenses, stock movements, tickets, KPI scores and all other CRUD operations in sync within ~100 ms. Configure your server URL below — the value persists across reloads and is shared with the mobile APK via the same seed.
    Sync Server URL
    Use ws:// on LAN, wss:// when TLS is available
    Connection Status
    Green = live · Amber = connecting · Red = error · Grey = offline
    —
    Client ID
    Stable per-browser identifier (survives reloads)
    —
    Queue Depth
    Mutations waiting for reconnection (flushed automatically)
    0

    Branding

    Customize this tenant's icon, favicon, logo, banner, colors and tagline. Changes apply across every portal on this tenant.
    Tenant
    Tagline preview
    🎨 Brand colors
    🪪 Identity
    🖼 Logos, icons & banners — paste a URL or upload a file (≤ 500 KB)

    Backup & Restore

    Export the entire database to JSON or re-seed from file
    📊
    0
    Total Records
    🕒
    —
    Last Backup
    💾
    0 KB
    Database Size
    🔖
    v3.0
    Schema Version
    ⬇ Export Database
    Download a JSON snapshot of all tables. Keep this file secure — it contains user data.
    ⬆ Import / Restore
    Replace the current database with a saved snapshot. This action cannot be undone.

    About SpectrumField

    Build information and license
    S
    SpectrumField
    Field-force management platform
    Version
    3.0.0
    Build
    —
    Licensed To
    Spectrum Industries · Korevra
    Modules Enabled
    14 / 14
    Technical Stack
    HTML5 · Vanilla JS · PWA
    Storage Engine
    LocalStorage (Client)
    🔑 Demo & test accounts
    Sign-in IDs + PINs for demos and QA. Type the ID and PIN on the login screen. These are the seeded accounts that ship with every tenant — change or remove them in Users before going live.