Live Operations Map

Live map of vehicles on open schedules, filtered by hub or zone.

Live Operations Map

Vehicles on open runs — last known GPS by hub/zone.

Map

Open Runs

0
📊

On Road

0
🚐

At Stop

0
📍

Stale GPS

0
⏳

No GPS

0
📡
Loading live crew map…

Scheduled Runs

Define recurring ATM replenishment and field-service runs, attach ATMs to each route, and turn templates into daily executable runs.

Templates

0
📋

Route ATMs

0
🏧

Published

0
✅

Draft

0
📝

Upcoming Run Templates

R-204 · West Cairo Alternate-Day Replenishment
Every other day · 14 ATMs · 6 physical stops · Depot: October Cash Center
Draft
R-115 · Downtown Daily Mall Route
Daily · 9 ATMs · 3 mall stops · Mixed banks at each stop
Published
R-311 · Alexandria Coastal Service Loop
Mon/Wed/Fri · ATM cleaning, replenishment, and light service tasks
Needs Review

Denomination Overrides

Create daily or period-based denomination substitutions at hub, run, or ATM scope. Effective values follow ATM, then run, then hub, then ATM master.

Active Rules

Loading overrides...
Loading overrides...

Create Override Period

Use this when a denomination is temporarily unavailable and the ATM should behave as if a slot dispenses another denomination for a defined period.

Scope And Period

Choose whether the exception applies to one hub, one run template, or one ATM. Daily override means the start and end dates are the same.

Substitution Rule

Rules always evaluate against the ATM master cassette values. They do not cascade from one override into another.

Schedules

Schedules

0
📊

Prepped

0
📦

Loaded

0
🚐

In Progress

0
⏳

Stops Done

0 / 0
📍

Completed

0
✅
Loading schedules...
Page 1 of 1 · 0 total

Add Stop

Log phone requests for ATM replenishment or branch delivery. Search the site, confirm details, and notify vault.

Prep Dashboard

Schedules

0 / 0

Filled

0 / 0

Remaining

0 / 0

Branch boxes

0 / 0

Ready ATMs

0 / 0
Loading preparation board...
Loading preparation board...

Seal QR Registry

Head office registers vendor seal orders into the corporate pool, then divulges whole packs to hubs. Type is set on first field scan.

Total Seals

0
All registered seal QR rows.

Corporate Pool

0
Unallocated tags still at head office.

At Hubs

0
Divulged packs available for field scan.

Scanned

0
Single-use seals already claimed.

Procurement Divulge Planner

Run once per vendor shipment. Preview splits the batch by weekly burn. Apply records a system divulge (ownership move) for all hubs in the plan — it does not confirm physical delivery to hubs.

Select a procurement batch to build the divulge plan.
—

Next Seal Order Estimate

Advisory only for procurement. Uses on-hand stock, burn since the last batch, new ATMs, and unallocated corporate pool to suggest the next order size.

Set a planning horizon and calculate the suggested next order.

Divulge plan by hub

Select a batch to preview hub allocations.
Select a batch to preview hub allocations.
No pages

Register Vendor Order

Register the full purchased range into the corporate pool. The next starting code is suggested automatically from the last order.

Loading next start code…
Suggested seal counts by denomination
Denomination total: 0 seals

Correct Vendor Order

Void removes a wrong registration when no seals were scanned. Return to pool undoes a divulge plan when hubs have not scanned any seals yet.

Select a procurement batch to review void and return options.

Counting Vault

Receive returned ATM boxes and mint pickups. Confirm unloaded sealed boxes, then hand them to Vault. Head office can watch all hubs read-only.

Pending Returns

0

Select a hub to view pending returns.

Receive into Counting

Scan a returned box QR after crew unload. Possession moves from vehicle/crew to Counting for this hub.

Pending return boxes

Boxes still on vehicle/crew after ATM return — receive them into Counting from the Receive tab.

ATM installed / expected returns

Empty install list = first Wardeya replenishment (no return boxes to scan).

Mint pickups at hub

After field arrival: ATM type → start counting → Vault Register Bank Intake → confirm vault intaken. Delivery type → confirm sealed receive.

Hub Vault

Track bank cash intake, on-hand balances by denomination, and release cash to prep before box scanning starts.

On Hand

0 EGP

Reserved

0 EGP

Available

0 EGP

Pending Releases

0
1
2
3
Select a hub to view vault tally.

After schedules are built, release cash per stop (VOUT). Expand a bank, enter EGP per slot, then release each stop.

Live balances by bank plus intake, release, and adjustments for the selected period. Open the full statement here in Vault for printable movement detail.

On Hand

0 EGP

Period Intake

0 EGP

Period Released

0 EGP

Period Net

0 EGP

Register a bank mint collection instruction. This does not add cash to Vault yet — it creates a pickup request for Scheduling (1–2 trucks). After ATM replenishment cash is counted, use Register Bank Intake.

Banks usually give a total amount. Denominations are optional when known.

Expected total
0 EGP

Expected intake

Pickup requests for the selected hub and service date above. Open Schedules → Mint Pickups to attach 1–2 trucks.

Enter the EGP amount received in each note type — e.g. 1,000,000 or 1M in the 200 box means one million pounds in 200s. K/M shorthand works (100K, 20M). Tab out of the field to expand.

Transaction ID — Latest intake VIN code appears here after you record cash in.
Total intake
0 EGP

Today's Intakes

Intake VINs recorded today and since yesterday at this hub (each row shows date/time).

Physical cash handed to prep today. Enter EGP per denomination — prep can scan until this pool is used. Partial handovers are OK.

Prep required today

All banks at this hub — select a bank below to narrow.

Scheduled total 0 EGP
Still to fill 0 EGP
Still to hand 0 EGP
Denom Scheduled To fill Handed Available To hand
No scheduled prep work for this date yet.
Handed today 0 EGP
Prep used 0 EGP
Available for prep 0 EGP
Total handover
0 EGP

Today's Handovers

Intake, release, and handover for the selected service date at this hub. Use Transaction History for date ranges, bank filters, and full detail.

AI Analysis

Analyze a selected hub using current inner runs, ATM and branch distribution, upcoming schedule load, and Google driving distance to identify better dispatch and polygon choices.

Hub Analysis

Select a hub and click Analyze.

Hub Map

Hub Fence Inner Runs Saved ATMs Uncovered ATMs Cross-Hub Candidates Branches
Google Maps will load here when a valid API key is configured.

Inner Runs

0
Runs currently assigned to the selected hub.

ATMs

0
Saved ATM points inside the hub scope.

Branches

0
Branch density affecting lobby and replenishment demand.

Schedules

0
Upcoming schedule instances used for dispatch pressure.

Teams

0
Hub teams available to absorb schedule load.

Uncovered ATMs

0
ATMs not currently attached to any inner run.

Recommendations

No analysis yet

Run the hub analysis to see polygon, distance, and team utilization recommendations.

Run Insights

Waiting for analysis

Each analyzed inner run will appear here with drive distance, duration, utilization score, and suggested changes.

Uncovered ATMs

No issues

All ATMs are covered by active runs.

Users & Credentialing

Manage dispatchers, supervisors, auditors, and field operators with per-page visibility and explicit read-only access.

Total Users

0
All user accounts currently loaded from the database.

Active Users

0
Users who can sign in and operate according to their role.

Inactive Users

0
Users kept in the directory but currently disabled.

Suspended Users

0
Users blocked pending review or corrective action.

Users

Loading users...

Menu Management

Choose a user role, then set each menu item to Hidden (H), Read-only (R), or Full (F). Save Menu to apply.

Add User

Create a back-office or supervisory account in the main users table and assign its access role immediately.

This screen creates system users in the main users table. Team members who log in from the field app should be created from the Team Member screen instead.

Identity

Capture Arabic and English names so the user can be shown correctly in both interfaces.

Access & Assignment

Role is required. Hub and bank are optional and can scope the user operationally when needed.

Credentials

Username and password are created now so the user can sign in immediately after activation.

Teams

Review hubs first, then the teams and members operating under each one across the country.

Total Teams

0
All team records currently loaded from the database.

Total People

0
All people assigned under those teams.

Active People

0
People with active accounts and operational status.

In Shift

0
People who look currently logged in or recently tracked by the app.

Hubs And Teams

Loading hubs and teams...

Add Team Member

Create a field-app account under an operational team and store the person in the team_people table.

The selected team defines the member hub automatically. Vault clerks must be assigned to a Vault Team (run seed-vault-teams.php once per environment if none exists).

Assignment

Pick a team first — Vault Team auto-fills Vault Clerk; Prep Team auto-fills Preparer. Teams are grouped by type.

Identity

Store both Arabic and English names so the field app and dashboard stay aligned in either language.

Field App Credentials

These credentials are stored in team_people for mobile app login and team-level tracking.

Cleaning Teams

Manage ATM cleaning crews, territory coverage, shift availability, and recurring service bundles.

Team Coverage

Team Nile
Nasr City · Heliopolis · 28 ATMs on rolling weekly plan
Active

Reports

Operational reports built directly from live run, stop, and preparation data.

Hubs

Manage operational hubs, their center points, and the geofenced coverage areas used to assign branches, ATMs, and future runs.

Total Hubs

0
All hub records currently loaded from the database.

Active Hubs

0
Hubs available for branch, ATM, and run assignment.

Inactive Hubs

0
Hubs kept historically but excluded from current assignment.

Hub Directory

Loading hubs...

Add Hub

Create a hub record with bilingual identity, center point, and map-based geofence coverage.

Identity

Capture the hub code and bilingual names used across operational screens and assignment logic.

Location and Coverage

Use Google lookup, keep the Arabic operational address, and manage the hub center plus coverage on the same map.

Google Maps will load here when a valid API key is configured.
Map ModeCenter
Polygon Points0
CoverageNone

Notes

Keep optional Arabic and English notes separate from the location and coverage tools.

Banks

Manage the bank master directory used across branches, ATMs, user assignment, and operational reporting.

Total Banks

0
All bank records currently loaded from the database.

Active Banks

0
Banks available for new operational assignment and master-data linkage.

Inactive Banks

0
Banks kept historically but not currently active for assignment.

Bank Directory

Loading banks...

Add Bank

Create a bank master record with bilingual names and head-office details.

Identity

Store short code and bilingual names used across the platform.

Head Office

Keep address and location fields ready for future mapping and reporting use.

Add Branch

Create a bank branch with its bank, hub, address, and map coordinates.

Identity

Choose the bank and hub, then capture the branch name and unique branch code.

Location

Store branch address and coordinates so routing and ATM coverage can use the branch as an anchor point.

Start typing to search for the branch address. The system refreshes the bilingual address and suggests the hub that covers the branch.

The location map will load here when a valid API key is configured.
Coordinates-
Detected Hub-
Coverage State-
Address Arabic
No saved address yet.
Address English
No saved address yet.

Add Requestor

Authorize a bank Head Office or branch contact to request ATM replenishment or branch transfers. Add only after a bank official request.

Identity & scope

Choose Head Office (master) or a specific branch. Optional hub scope applies to Head Office requestors only.

Authorized services

Choose which job types this contact is allowed to request when they call. At least one must be selected.

Add Client

Create a parent commercial client with billing, contact, and default hub details.

Identity

Store the parent client code and bilingual names used across collection planning and billing.

Contacts

Keep the primary contact and default hub ready before creating child branches.

Billing

Store billing addresses and notes used by the commercial relationship.

Add Client Branch

Create a client branch or pickup site linked to its parent client and operational hub.

Identity

Link the branch to a parent client, then capture the branch code and bilingual names.

Contacts

Keep a branch contact ready for branch OTP and pickup coordination later.

Location

Pick the client branch location from Google search or directly from the map so the address is saved automatically.

Search and choose a Google address, or select a hub then click on the map to capture the exact location.

The location map will load here when a valid API key is configured.
Coordinates-
Detected Hub-
Coverage State-
Address Arabic
No saved address yet.
Address English
No saved address yet.

Add ATM

Create an ATM record with its bank, optional branch link, address, and map coordinates.

Identity

Capture the owning bank, hub, ATM identifier, and optional branch association.

Cassette Denominations

Choose the denomination for each ATM cassette. Four slots are required; add two more if the machine holds six cassettes.

Location

Store ATM address and coordinates for routing, coverage, and map visibility.

Start typing to search for the ATM address. The system refreshes the bilingual address, suggests the hub, and detects whether the ATM is close enough to a branch lobby.

The location map will load here when a valid API key is configured.
Coordinates-
Detected Hub-
Coverage State-
Nearby Branch-
Address Arabic
No saved address yet.
Address English
No saved address yet.

Services

Coordinate ATM replenishment, repair, and cleaning service definitions so operational work follows the correct workflow by type.

Replenishment

64%
Share of active scheduled work currently tied to cash handling runs.

Repair

11
Open technical service definitions awaiting route attachment.

Cleaning

37
Recurring non-cash service bundles across branches and malls.

Detailed Operator Help

Screen-by-screen training guide for registered users (Arabic / English). Use the index on the left inside the guide.

Settings

Control system defaults for routing, schedule generation, permissions, notifications, and integrations.

Operational Defaults

Run generation window
Generate tomorrow's run instances every day at 17:00.
Enabled
Permission fallback
Hidden menu items for denied pages, read-only view for scoped auditors.
Active
Maps integration
Browser Maps key active with live route preview in dashboard and panel.
Configured
Demo Route Rule
For mobile demo: enforce route order, or allow manual stop selection.
-
Schedule Mode
Demo toggle: Predefined Runs projects daily schedules from Runs. Add Run uses Dispatch Add Stop only, then assigns team and vehicle.
-
Vault Note Condition
System-wide: how many notes fit in one ATM cassette / delivery box. New = 2500, Used or Mixed = 2000. Used by bulk funds, vault planning, and branch packing.
-
Mint Pickup Edit/Cancel Approval
When required, Vault edit or cancel of a Register Pickup waits for admin / operations lead approval. Off = vault can apply changes immediately. Edit only while submitted; cancel also for scheduled (cancels linked trucks).
-
Demo Branding
For demo only: set a prospect logo URL to replace Wardeya logo in this browser.
Enabled

Portal build

Deploy version stamps for support. Hidden from day-to-day module screens.

Portal UI
—
Dispatch module
—
Vault module
—
Counting module
—
Seals module
—

Vehicles

Manage the hub fleet inventory, operational status, plates, and scan QR codes used for field vehicle confirmation.

Total Vehicles

0
All vehicles in the master fleet list.

Active

0
Vehicles available for schedule assignment.

Maintenance

0
Vehicles currently blocked for maintenance.

Inactive / Retired

0
Vehicles not available for dispatch.

Fleet Directory

Loading vehicles…

Add Vehicle

Register a fleet vehicle with plate, code, hub, and operational status.

Identity

Fleet code and plate are required. QR is used for field vehicle confirmation scans.

Hub & Status

Make / Model

Max sealed boxes this vehicle can carry (mint pickup / load planning).

Odometer

Set the starting KM when the vehicle joins the fleet. Current KM is updated automatically when a run ends.

Replenishment Boxes

Manage the master inventory of replenishment cash boxes, assign preferred banks, and track operational status.

Total Boxes

0
All box records in the master inventory.

Active

0
Boxes available for dispatch.

Out of Service

0
Boxes blocked from dispatch due to malfunction.

Under Repair

0
Boxes currently in the maintenance workflow.

Box Directory

Loading boxes…

Add Box

Register a new replenishment cash box with its QR code and optional bank assignment.

Identity

Enter the physical box serial number and the QR code payload that will be scanned in the field.

Assignment & Status

Assign a preferred bank, hub, and operational status for this box.

Notes

Wardeya CIT Operator Guide