UNITED PETRO TECH • OPERATION GUIDE

Desktop

Station-side operation, monitoring and hardware control

Operator-facing documentation Screenshot-led walkthrough No implementation internals

How this guide is written

Every chapter explains why an option exists, what it does, how to use it, the expected result, and the exact screenshot required for the final manual. The guide intentionally documents the product from an operator/user perspective only.

Not included

Source code, internal architecture, database structure, credentials, secrets, implementation logic or sensitive engineering details.

SECTION 01

Desktop Overview

The Desktop application is the main station-side operational interface. It is used for station login, hardware availability, tank monitoring, alarm handling, nozzle operations and approved configuration actions.

Desktop main application / overview screen

WHY

Why this exists

WHAT

What it does

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 02

Login & Session

Login identifies the assigned station/manager session and opens the operational workspace. The guide will show successful login, incorrect credentials, session recovery and logout.

Desktop login screen

WHY

Why this exists

Login identifies the assigned station/manager session and opens the operational workspace. The guide will show successful login, incorrect credentials, session recovery and logout.

WHAT

What it does

Login identifies the assigned station/manager session and opens the operational workspace. The guide will show successful login, incorrect credentials, session recovery and logout.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 03

Dashboard

The Dashboard gives a quick operational summary of station status and the major areas that need attention before the operator opens individual modules.

Desktop dashboard after successful login

WHY

Why this exists

The Dashboard gives a quick operational summary of station status and the major areas that need attention before the operator opens individual modules.

WHAT

What it does

The Dashboard gives a quick operational summary of station status and the major areas that need attention before the operator opens individual modules.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 04

Tank Monitoring

Tank Monitoring displays the current tank state. Usable fuel, water, total measured liquid, product height, fill percentage, ullage and probe temperature are treated as separate operational values.

Desktop Tank Monitoring screen

WHY

Why this exists

To provide a complete operational picture of the selected tank without confusing usable fuel with water or total liquid.

WHAT

What it does

Tank Monitoring displays the current tank state. Usable fuel, water, total measured liquid, product height, fill percentage, ullage and probe temperature are treated as separate operational values.

HOW

How to use

Select the required tank. Review the tank visual, Live Usable Pure Fuel Stock, Product Height, Water Bottom, Ullage Space, Probe Temperature and active alarm state.

RESULT

Expected result

Fuel, water, total liquid and capacity-related values remain clearly separated and update from the station's current tank state.

Important: Do not treat Total Liquid as Usable Fuel. Water is displayed separately and may trigger an ingress warning.

SECTION 05

Water / Ingress Alarm

Water Bottom shows water level and volume. If the configured limit is exceeded, the visual water/ingress warning remains active until the physical condition clears.

Water Bottom normal state

Water / Ingress Alert active state

WHY

Why this exists

Water Bottom shows water level and volume. If the configured limit is exceeded, the visual water/ingress warning remains active until the physical condition clears.

WHAT

What it does

Water Bottom shows water level and volume. If the configured limit is exceeded, the visual water/ingress warning remains active until the physical condition clears.

HOW

How to use

Review the Water Bottom card. If an ingress alert is active, check the shown water level/volume and configured limit. Use the available Desktop alarm actions according to station procedure.

RESULT

Expected result

The visual warning remains active while the physical water condition remains active.

SECTION 06

Water Alarm Limit

The Desktop is the authorized surface for changing the water alarm limit. The guide explains why the limit exists, how to open the control, how to save it and how to verify the resulting warning state.

Tank Detail with Set Limit button visible

Set Water Alarm Limit modal/dialog

Saved limit visible after update

WHY

Why this exists

WHAT

What it does

HOW

How to use

Open Set Limit from the Desktop Water Bottom area, enter/select the approved threshold, save it and confirm the updated limit shown on screen.

RESULT

Expected result

The configured limit updates on Desktop and future water alarm evaluation uses the approved value.

Important: This configuration is Desktop-only. Manager Tablet must not expose Set/Increase Limit.

SECTION 07

Desktop Alarm Audio

The audible alarm attracts operator attention while the physical alarm remains visible. Silencing audio does not change the physical tank condition.

Desktop active Tank alarm / audible alarm state

WHY

Why this exists

The audible alarm attracts operator attention while the physical alarm remains visible. Silencing audio does not change the physical tank condition.

WHAT

What it does

The audible alarm attracts operator attention while the physical alarm remains visible. Silencing audio does not change the physical tank condition.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 08

Hardware Setup

Hardware Setup is used to work with configured station hardware and visible communication status. The guide will explain operator-facing setup/status only.

Desktop Hardware Setup screen

WHY

Why this exists

Hardware Setup is used to work with configured station hardware and visible communication status. The guide will explain operator-facing setup/status only.

WHAT

What it does

Hardware Setup is used to work with configured station hardware and visible communication status. The guide will explain operator-facing setup/status only.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 09

Tank Probe Connection

The operator selects the configured probe connection for a tank and verifies that the visible communication state is healthy before relying on live readings.

Tank Probe configuration screen

Probe connected/responding status

WHY

Why this exists

The operator selects the configured probe connection for a tank and verifies that the visible communication state is healthy before relying on live readings.

WHAT

What it does

The operator selects the configured probe connection for a tank and verifies that the visible communication state is healthy before relying on live readings.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 10

Nozzle / Dispenser Monitoring

The Desktop shows configured nozzle/dispenser information and operational status for station use.

Nozzle / Dispenser monitoring screen

WHY

Why this exists

The Desktop shows configured nozzle/dispenser information and operational status for station use.

WHAT

What it does

The Desktop shows configured nozzle/dispenser information and operational status for station use.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 11

Nozzle Price Change

Where enabled, the Desktop can perform approved nozzle price changes. The guide will focus on prerequisites, visible confirmation and failure messages.

Nozzle price change form

Verified price change result / status

WHY

Why this exists

Where enabled, the Desktop can perform approved nozzle price changes. The guide will focus on prerequisites, visible confirmation and failure messages.

WHAT

What it does

Where enabled, the Desktop can perform approved nozzle price changes. The guide will focus on prerequisites, visible confirmation and failure messages.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 12

Manager Tablet Pairing

The Desktop receives Manager Tablet live-monitoring requests and allows the operator to accept or reject the request. After approval, the Tablet can receive the current tank state directly.

Incoming Manager Tablet live request

Tablet live request approved state

WHY

Why this exists

The Desktop receives Manager Tablet live-monitoring requests and allows the operator to accept or reject the request. After approval, the Tablet can receive the current tank state directly.

WHAT

What it does

The Desktop receives Manager Tablet live-monitoring requests and allows the operator to accept or reject the request. After approval, the Tablet can receive the current tank state directly.

HOW

How to use

When a Manager Tablet sends a live-monitoring request, review the request shown on Desktop and choose Allow or Reject.

RESULT

Expected result

Allow establishes the approved direct monitoring session; Reject leaves the Tablet without direct Desktop access.

SECTION 13

Desktop Online Presence

When the Desktop is logged in and its station presence is active, Manager Tablet can see the Desktop as ONLINE. Logout or loss of presence changes it to OFFLINE.

Desktop logged-in / active station session

WHY

Why this exists

When the Desktop is logged in and its station presence is active, Manager Tablet can see the Desktop as ONLINE. Logout or loss of presence changes it to OFFLINE.

WHAT

What it does

When the Desktop is logged in and its station presence is active, Manager Tablet can see the Desktop as ONLINE. Logout or loss of presence changes it to OFFLINE.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 14

Language & Theme

The guide will explain the available language/theme controls and what changes to expect on screen.

Desktop language option

Desktop theme option

WHY

Why this exists

The guide will explain the available language/theme controls and what changes to expect on screen.

WHAT

What it does

The guide will explain the available language/theme controls and what changes to expect on screen.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 15

Logout & Safe Exit

Logout ends the current Desktop session and also ends any active Manager Tablet direct monitoring session associated with that login.

Desktop logout confirmation / logout control

WHY

Why this exists

Logout ends the current Desktop session and also ends any active Manager Tablet direct monitoring session associated with that login.

WHAT

What it does

Logout ends the current Desktop session and also ends any active Manager Tablet direct monitoring session associated with that login.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 16

Operator Troubleshooting

Simple non-technical checks for missing readings, offline hardware, active alarms and connectivity status before escalation.

Representative Desktop operator warning/error state

WHY

Why this exists

Simple non-technical checks for missing readings, offline hardware, active alarms and connectivity status before escalation.

WHAT

What it does

Simple non-technical checks for missing readings, offline hardware, active alarms and connectivity status before escalation.

HOW

How to use

Follow the simple visible checks in order. If the issue remains after these checks, record the exact on-screen status/message and escalate it.

RESULT

Expected result

The user can distinguish common operational conditions from issues requiring technical support.

UNITED PETRO TECH • OPERATION GUIDE

Client Application

Client/owner monitoring and approved remote operations

Operator-facing documentation Screenshot-led walkthrough No implementation internals

How this guide is written

Not included

Source code, internal architecture, database structure, credentials, secrets, implementation logic or sensitive engineering details.

SECTION 01

Application Overview

The Client Application gives the client/owner a mobile view of assigned pumps, tank information, alerts and approved account functions.

Client Application main overview

WHY

Why this exists

The Client Application gives the client/owner a mobile view of assigned pumps, tank information, alerts and approved account functions.

WHAT

What it does

The Client Application gives the client/owner a mobile view of assigned pumps, tank information, alerts and approved account functions.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 02

Splash & Intro

The opening experience introduces the application and prepares the user for login.

Client Application splash / intro

WHY

Why this exists

The opening experience introduces the application and prepares the user for login.

WHAT

What it does

The opening experience introduces the application and prepares the user for login.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 03

Login

The user signs in with the assigned account. The guide will show normal login, invalid credentials and recovery behavior.

Client Application login screen

WHY

Why this exists

The user signs in with the assigned account. The guide will show normal login, invalid credentials and recovery behavior.

WHAT

What it does

The user signs in with the assigned account. The guide will show normal login, invalid credentials and recovery behavior.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 04

App PIN

Where enabled, the user can use the application PIN for convenient access while periodic real-password verification remains mandatory according to configured policy.

App PIN entry screen

Periodic real-password verification screen

WHY

Why this exists

Where enabled, the user can use the application PIN for convenient access while periodic real-password verification remains mandatory according to configured policy.

WHAT

What it does

Where enabled, the user can use the application PIN for convenient access while periodic real-password verification remains mandatory according to configured policy.

HOW

How to use

Use the configured application PIN for normal convenient access when PIN login is available.

RESULT

Expected result

When real-password verification is due, the application requires the actual account password before continuing.

SECTION 05

Periodic Password Verification

At the configured interval, the application asks for the real account password again. This cannot be skipped when verification is due.

Mandatory password verification state

WHY

Why this exists

At the configured interval, the application asks for the real account password again. This cannot be skipped when verification is due.

WHAT

What it does

At the configured interval, the application asks for the real account password again. This cannot be skipped when verification is due.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 06

Forgot Password

Used when the account password is no longer known. The guide will explain the visible recovery flow only.

Forgot Password screen

WHY

Why this exists

Used when the account password is no longer known. The guide will explain the visible recovery flow only.

WHAT

What it does

Used when the account password is no longer known. The guide will explain the visible recovery flow only.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 07

Dashboard

Displays the client's operational overview and entry points to assigned pump information.

Client Dashboard

WHY

Why this exists

Displays the client's operational overview and entry points to assigned pump information.

WHAT

What it does

Displays the client's operational overview and entry points to assigned pump information.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 08

Pump Information

Shows the pumps assigned to the client and their visible operational information.

Assigned Pump information screen

WHY

Why this exists

Shows the pumps assigned to the client and their visible operational information.

WHAT

What it does

Shows the pumps assigned to the client and their visible operational information.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 09

Tank Monitoring

Shows tank readings and status available to the client, using clear separation between fuel and water information.

Client Tank Monitoring screen

WHY

Why this exists

Shows tank readings and status available to the client, using clear separation between fuel and water information.

WHAT

What it does

Shows tank readings and status available to the client, using clear separation between fuel and water information.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 10

Nozzle Information

Shows nozzle-related information available to the client.

Client Nozzle information screen

WHY

Why this exists

Shows nozzle-related information available to the client.

WHAT

What it does

Shows nozzle-related information available to the client.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 11

Remote Price Change

Where authorized, the client can request an approved nozzle price change. The guide explains prerequisites, confirmation states and failure reasons visible to the user.

Remote nozzle price change form

Remote price change result

WHY

Why this exists

Where authorized, the client can request an approved nozzle price change. The guide explains prerequisites, confirmation states and failure reasons visible to the user.

WHAT

What it does

Where authorized, the client can request an approved nozzle price change. The guide explains prerequisites, confirmation states and failure reasons visible to the user.

HOW

How to use

Open the approved nozzle price-change function, select the intended nozzle, enter the new valid price and submit. Follow the exact success/failure message shown.

RESULT

Expected result

The application reports confirmed success only when the station-side operation is actually verified; otherwise it shows the real reason for failure.

Important: A remote physical price change is not treated as successful merely because a request was submitted.

SECTION 12

Alerts & Notifications

Shows important operational notifications and warning states relevant to the client.

Client alerts / notifications screen

WHY

Why this exists

Shows important operational notifications and warning states relevant to the client.

WHAT

What it does

Shows important operational notifications and warning states relevant to the client.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 13

Settings

Includes supported language, theme and account-facing preferences.

Client settings screen

WHY

Why this exists

Includes supported language, theme and account-facing preferences.

WHAT

What it does

Includes supported language, theme and account-facing preferences.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 14

English / Urdu

Explains language switching and RTL presentation for Urdu.

Client Application English example

Client Application Urdu / RTL example

WHY

Why this exists

Explains language switching and RTL presentation for Urdu.

WHAT

What it does

Explains language switching and RTL presentation for Urdu.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 15

Logout

Ends the current client application session safely.

Client Application logout

WHY

Why this exists

Ends the current client application session safely.

WHAT

What it does

Ends the current client application session safely.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 16

User Troubleshooting

Simple checks for login, stale data, remote command failure and connectivity messages.

Representative Client Application warning/error state

WHY

Why this exists

Simple checks for login, stale data, remote command failure and connectivity messages.

WHAT

What it does

Simple checks for login, stale data, remote command failure and connectivity messages.

HOW

How to use

Follow the simple visible checks in order. If the issue remains after these checks, record the exact on-screen status/message and escalate it.

RESULT

Expected result

The user can distinguish common operational conditions from issues requiring technical support.

UNITED PETRO TECH • OPERATION GUIDE

Manager Tablet

Landscape monitoring interface for the assigned pump manager

Operator-facing documentation Screenshot-led walkthrough No implementation internals

How this guide is written

Not included

Source code, internal architecture, database structure, credentials, secrets, implementation logic or sensitive engineering details.

SECTION 01

Manager Tablet Overview

The Manager Tablet is a read-only monitoring surface for the assigned pump. It is designed for landscape use and shows current tank condition, alarms and Desktop availability.

Manager Tablet main overview

WHY

Why this exists

The Manager Tablet is a read-only monitoring surface for the assigned pump. It is designed for landscape use and shows current tank condition, alarms and Desktop availability.

WHAT

What it does

The Manager Tablet is a read-only monitoring surface for the assigned pump. It is designed for landscape use and shows current tank condition, alarms and Desktop availability.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 02

Manager Login

The Manager logs in and the assigned pump is resolved automatically; there is no manual pump selector in normal use.

Manager Tablet login screen

WHY

Why this exists

The Manager logs in and the assigned pump is resolved automatically; there is no manual pump selector in normal use.

WHAT

What it does

The Manager logs in and the assigned pump is resolved automatically; there is no manual pump selector in normal use.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 03

Desktop ONLINE / OFFLINE

The top status reflects the actual Desktop station presence. ONLINE means the assigned Desktop is currently present; OFFLINE means it is not.

Tablet showing Desktop ONLINE

Tablet showing Desktop OFFLINE

WHY

Why this exists

The top status reflects the actual Desktop station presence. ONLINE means the assigned Desktop is currently present; OFFLINE means it is not.

WHAT

What it does

The top status reflects the actual Desktop station presence. ONLINE means the assigned Desktop is currently present; OFFLINE means it is not.

HOW

How to use

Check the top Desktop status. No manual refresh should be required.

RESULT

Expected result

Desktop logged in/present → ONLINE. Desktop logged out/disconnected → OFFLINE.

Important: ONLINE is Desktop presence. It is different from LIVE FROM DESKTOP / Direct Monitoring Connected.

SECTION 04

Start Direct Live Monitoring

When the Desktop is ONLINE, the Manager can request direct live monitoring. The Desktop receives an approval prompt and decides whether to allow the session.

Start Live Monitoring control

Waiting for Desktop approval state

WHY

Why this exists

When the Desktop is ONLINE, the Manager can request direct live monitoring. The Desktop receives an approval prompt and decides whether to allow the session.

WHAT

What it does

When the Desktop is ONLINE, the Manager can request direct live monitoring. The Desktop receives an approval prompt and decides whether to allow the session.

HOW

How to use

Tap Start Live Monitoring while the Desktop is ONLINE. Wait for delivery/approval status, then wait for the Desktop operator to Allow or Reject.

RESULT

Expected result

After approval, the Tablet connects to the Desktop live monitoring session and receives the full tank snapshot.

SECTION 05

LIVE FROM DESKTOP

When the direct connection is active, the Tablet uses the Desktop's current canonical tank state as the only live source.

Tablet LIVE FROM DESKTOP state

WHY

Why this exists

When the direct connection is active, the Tablet uses the Desktop's current canonical tank state as the only live source.

WHAT

What it does

When the direct connection is active, the Tablet uses the Desktop's current canonical tank state as the only live source.

HOW

How to use

When LIVE FROM DESKTOP is visible, use the Tablet readings as a read-only mirror of the Desktop's current tank state.

RESULT

Expected result

The same tank and same reading show matching fuel, water, fill percentage, ullage, temperature and alarm meanings on Desktop and Tablet.

Important: While Direct Live is active, Backend/DB tank snapshots must not overwrite the live Desktop values.

SECTION 06

Backend Fallback

If the direct Desktop connection is genuinely lost, the Tablet can fall back to the latest Backend snapshot and clearly indicate that it is no longer showing direct live data.

Tablet Backend Snapshot / fallback state

WHY

Why this exists

If the direct Desktop connection is genuinely lost, the Tablet can fall back to the latest Backend snapshot and clearly indicate that it is no longer showing direct live data.

WHAT

What it does

If the direct Desktop connection is genuinely lost, the Tablet can fall back to the latest Backend snapshot and clearly indicate that it is no longer showing direct live data.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 07

Tank List

Shows the tanks for the assigned pump with current monitoring values and alarm state.

Manager Tablet Tank List

WHY

Why this exists

Shows the tanks for the assigned pump with current monitoring values and alarm state.

WHAT

What it does

Shows the tanks for the assigned pump with current monitoring values and alarm state.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 08

Tank Detail

Tank Detail mirrors the Desktop's operational meanings: usable fuel stock, fill percentage, fuel level, product height, water bottom, water volume, total liquid, capacity, ullage, temperature and alarm state.

Manager Tablet Tank Detail matching Desktop semantics

WHY

Why this exists

WHAT

What it does

HOW

How to use

Open a tank. Review Usable Pure Fuel Stock, Fill %, Fuel Level, Product Height, Water Bottom, Water Volume, Total Liquid, Capacity, Ullage, Probe Temperature and alarm status.

RESULT

Expected result

The meanings and values match the Desktop view for the same reading.

SECTION 09

Read-only Tank Configuration

The Tablet can view the configured water alarm limit but cannot set/increase/decrease it. Alarm-limit configuration remains Desktop-only.

Read-only alarm limit on Tablet; no Set Limit button

WHY

Why this exists

The Tablet can view the configured water alarm limit but cannot set/increase/decrease it. Alarm-limit configuration remains Desktop-only.

WHAT

What it does

The Tablet can view the configured water alarm limit but cannot set/increase/decrease it. Alarm-limit configuration remains Desktop-only.

HOW

How to use

View the configured alarm limit as information only. Use Silence Alarm if audio needs to be muted temporarily.

RESULT

Expected result

No Set Limit / Increase Limit / threshold edit control appears on the Tablet.

Important: Alarm threshold changes are performed only from Desktop.

SECTION 10

Water / Ingress Alarm

Canonical physical alarm state comes from the current authoritative tank source. Visual warning remains visible while the condition is active.

Tablet Water / Ingress Alert active

WHY

Why this exists

Canonical physical alarm state comes from the current authoritative tank source. Visual warning remains visible while the condition is active.

WHAT

What it does

Canonical physical alarm state comes from the current authoritative tank source. Visual warning remains visible while the condition is active.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 11

Timed Per-Tank Silence

Silence Alarm opens a duration choice (5 Minutes, 1 Hour, 24 Hours). The selected tank stays audio-muted until the chosen expiry even when new socket snapshots arrive.

Silence Alarm action

5 Minutes / 1 Hour / 24 Hours modal

Silenced-until / remaining duration state

WHY

Why this exists

Silence Alarm opens a duration choice (5 Minutes, 1 Hour, 24 Hours). The selected tank stays audio-muted until the chosen expiry even when new socket snapshots arrive.

WHAT

What it does

Silence Alarm opens a duration choice (5 Minutes, 1 Hour, 24 Hours). The selected tank stays audio-muted until the chosen expiry even when new socket snapshots arrive.

HOW

How to use

Tap Silence Alarm, select 5 Minutes, 1 Hour or 24 Hours, and confirm. The physical alarm remains visible while only this tank's Tablet audio is muted.

RESULT

Expected result

Repeated socket snapshots do not restart the sound before the selected expiry. If the alarm is still active when silence expires, sound becomes eligible again.

SECTION 12

Alarm Tone Settings

The Manager can choose a bundled alarm tone and preview it. A strong professional tone is selected by default and works offline.

Alarm Tone Settings

Alarm tone preview / Test Alarm state

WHY

Why this exists

The Manager can choose a bundled alarm tone and preview it. A strong professional tone is selected by default and works offline.

WHAT

What it does

The Manager can choose a bundled alarm tone and preview it. A strong professional tone is selected by default and works offline.

HOW

How to use

Open Settings → Alarm & Alerts → Alarm Tone. Preview available tones and select the preferred professional warning tone.

RESULT

Expected result

The selected tone is remembered locally and works without Internet.

SECTION 13

Multiple Tank Alarms

Each tank has its own timed silence state while the application uses one central alarm audio loop. Any active unmuted tank can keep the audible alert running.

Multiple Tank alarms example

WHY

Why this exists

Each tank has its own timed silence state while the application uses one central alarm audio loop. Any active unmuted tank can keep the audible alert running.

WHAT

What it does

Each tank has its own timed silence state while the application uses one central alarm audio loop. Any active unmuted tank can keep the audible alert running.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 14

History / Stored Data

Historical data remains a Backend function and is kept separate from direct current Desktop readings.

Manager Tablet History / stored data screen

WHY

Why this exists

Historical data remains a Backend function and is kept separate from direct current Desktop readings.

WHAT

What it does

Historical data remains a Backend function and is kept separate from direct current Desktop readings.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 15

English / Urdu Typography

English and Urdu are supported with proper RTL behavior. The approved Urdu typography is applied consistently in the Tablet UI.

Manager Tablet English screen

Manager Tablet Urdu / RTL screen

WHY

Why this exists

English and Urdu are supported with proper RTL behavior. The approved Urdu typography is applied consistently in the Tablet UI.

WHAT

What it does

English and Urdu are supported with proper RTL behavior. The approved Urdu typography is applied consistently in the Tablet UI.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 16

Light / Dark / System Theme

Explains visual theme choices without changing monitoring behavior.

Manager Tablet Light theme

Manager Tablet Dark theme

WHY

Why this exists

Explains visual theme choices without changing monitoring behavior.

WHAT

What it does

Explains visual theme choices without changing monitoring behavior.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 17

Connection Loss & Reconnect

Explains how the Tablet identifies a lost direct session, shows stale/fallback status and returns to direct live state after a valid reconnect.

Direct connection lost / stale state

Direct monitoring reconnected

WHY

Why this exists

Explains how the Tablet identifies a lost direct session, shows stale/fallback status and returns to direct live state after a valid reconnect.

WHAT

What it does

Explains how the Tablet identifies a lost direct session, shows stale/fallback status and returns to direct live state after a valid reconnect.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 18

Logout

Ends the Manager Tablet session and clears the current authenticated monitoring context.

Manager Tablet logout

WHY

Why this exists

Ends the Manager Tablet session and clears the current authenticated monitoring context.

WHAT

What it does

Ends the Manager Tablet session and clears the current authenticated monitoring context.

HOW

How to use

Open this area from the application navigation, review the visible status/information, and use only the controls presented for your role.

RESULT

Expected result

The screen should clearly show the current user-facing state and any action result or warning.

SECTION 19

Manager Troubleshooting

Simple checks for Desktop OFFLINE, live request not delivered, direct connection loss, stale readings and alarm-audio behavior.

Representative Tablet warning/error state

WHY

Why this exists

Simple checks for Desktop OFFLINE, live request not delivered, direct connection loss, stale readings and alarm-audio behavior.

WHAT

What it does

Simple checks for Desktop OFFLINE, live request not delivered, direct connection loss, stale readings and alarm-audio behavior.

HOW

How to use

Follow the simple visible checks in order. If the issue remains after these checks, record the exact on-screen status/message and escalate it.

RESULT

Expected result

The user can distinguish common operational conditions from issues requiring technical support.