Mobile Banker User Guide

Everything you need to run your route, in signal or out of it

TILL 14 · Covers both the Online App and the Offline Recorder

🌐 Open Online App → 📱 Open Offline Recorder →

These links open the real apps on this device — useful when reading the guide on your phone.

•Overview — Two Connected Apps

As a Mobile Banker you work with two related tools that hand off to each other:

Everything below lives at mobile_bankers/ and requires a working connection the whole time you're using it.

1Logging In

Sign in with your email, phone number, or Staff ID plus your password — any of the three identifiers work in the same box.

• 3-attempt lockout. After a wrong password you're told how many attempts remain. On the third miss your account is automatically disabled. There's no self-service undo — contact your Branch Manager, who can approve a reset (a 6-digit SMS code, valid 15 minutes) or reset your password directly.
• "Reset Password?" Step 1 asks for your phone number and a 6-digit code — that code isn't something you request yourself; it's issued once your Branch Manager approves a reset and it arrives by SMS. Step 2 lets you set a new password (minimum 6 characters, at least one uppercase letter and one number).

2Dashboard

Your home screen after logging in — a quick daily snapshot plus your profile.

• Today's Summary — three stat cards: Deposits (total cedis collected today), Commission (calculated live with the anti-Gaming formula, see Section 5), and Customers Served (distinct customers today).
• Deposits and Commission figures start blurred — tap the eye icon to reveal them. This is a privacy feature so the amount isn't visible at a glance to a customer or bystander.
• My Profile — your name, staff ID, branch, email, phone.
• Quick Actions — shortcuts to Record Deposit and Daily Collection.

3Record Deposit

The page you'll use most — recording an actual cash collection against a customer's account.

1. Find Customer. Enter the customer's full account number and tap Search Customer. A "✓ Verified" badge confirms the match and opens the deposit form.
2. Record Deposit. Enter the Deposit Amount and the Old Balance (typed in by you from the passbook — not pulled automatically, so double-check it). The New Balance is calculated live as Old Balance + Amount.
3. Validate Cash opens a confirmation summarizing everything. Tap Confirm & Submit.

On submit: a transaction reference is generated (e.g. TD-A1B2C3D4E5), the deposit is saved, and an SMS receipt goes out automatically. If the SMS fails, the deposit is still recorded — the SMS is a courtesy, not a condition.

• Negative amounts are rejected outright.
• You cannot record after the day's transactions have been formally closed.
• There is no delete or edit button anywhere. A genuine mistake must be reported to your Back Officer or Branch Manager for correction — nothing can quietly disappear from the ledger without oversight.

4Daily Collection / View Deposits

A live, read-only list of every deposit you've recorded today, reached from both the navbar ("View Deposits") and the bottom tab ("Daily Collection") — same page.

• Two summary cards: Customers (unique depositors today) and Total Amount collected today.
• A searchable list — filters live by name, account, reference, or phone.
• View-only, today only — no edit/delete, no date picker, and CSV export is currently switched off on this page.

5Commission

Shows exactly how your commission is calculated for a date range you choose (defaults to today).

6Pending Offline Deposits

Most deposits synced from the Offline Recorder (Part 2) become real automatically — nothing to do here. This page only fills up with the exceptions: a submission whose account number doesn't match any customer, or one that looks like a possible duplicate for that customer that day. Found in the ☰ sidebar menu — not the bottom tab bar — with a red badge showing how many are waiting.

7Account, Logout & Legacy Pages

Change Password only works once a Branch Manager has approved a reset flag on your account — otherwise it redirects you back to start a reset. Logout ends your online session only; the Offline Recorder keeps its own separate saved login, so logging out of one doesn't log you out of the other.

Not part of the live flow forgot_password.php / reset_pass.php / wait_for_admin.php in the mobile_bankers/ folder are an older self-service reset flow, bypassed by the current "Reset Password?" link. Ignore them if you ever land on one directly.

Everything below lives at offline/index.html. It's a single page that keeps working with the phone in airplane mode, once set up.

8One-Time Setup (Needs Internet)

Do this once, while you have a good connection — ideally at the branch, on Wi-Fi, before you head out on your route.

1. Open the Offline Recorder. From the online app, tap the ☰ menu and choose "Offline Recording App." It opens in its own tab, or go straight to offline/index.html.
2. Sign in. Use the same Staff ID, email, or phone number and password as the main app. The same working-hours window and 3-attempt lockout rules apply here too.
3. Wait for the customer list to download. As soon as you sign in, the app automatically downloads the full customer directory (every customer's name, phone, and account number) onto your phone. A progress bar shows how far it's gotten — stay connected until it finishes.
4. (Optional) Add it to your home screen. Most phones will offer to install it as a home-screen icon, so it opens full-screen like a normal app.

9The App Screen — What You'll See

The whole app lives on one screen — everything below is on that same page, so there's nothing to "navigate to" except by scrolling or using the menu.

10Recording Deposits With No Signal

Once setup is done, you can close the app, turn on airplane mode, walk into a valley with zero bars — it doesn't matter. Opening the Offline Recorder again brings you straight to your recording screen, no login needed.

1. Find the customer. Type the customer's full account number and tap Search. This checks the copy of the customer list saved on your phone — it does not need the internet.
2. If found, the customer's name and account appear and the deposit form opens below.
3. If not found, you'll see "Customer account not found in the downloaded list." There's no way to type a name in manually — if this keeps happening for accounts that should exist, your customer list may be out of date (Refresh Customer List in the ☰ menu).
4. Enter the Deposit Amount and Old Balance (from the customer's passbook, same as the online app). The New Balance is calculated automatically as you type.
5. Tap "Save Deposit (Offline)." The deposit is saved on the phone immediately, with a local reference code, and appears under "Waiting to Sync."

11The Duplicate / "Gaming" Warning

If you try to record a second deposit for the same account on the same day, the app stops you with a warning — exactly like the online app does. It explicitly asks you not to split one deposit into multiple smaller entries ("Gaming"), because that would be used to dodge the commission threshold.

12Syncing When Signal Returns

You don't need to remember to do anything special — but it helps to understand what's happening:

• Automatic sync. The moment your phone regains a connection, the app notices and tries to send your queued deposits to the server on its own. It also quietly checks again every minute while you're online, in case anything was missed.
• Manual sync. You can also tap "Sync Now" in the app's header at any time you have signal.
• If your session has expired. If you've been offline for a long stretch, your login on the server may have timed out by the time you get signal back. When that happens, the app pauses and asks you to sign in again before it pushes your queue — your queued deposits are not affected either way, they just wait until you confirm.
• What happens after a successful sync. Synced items move from "Waiting to Sync" into "Recently Synced." Most are checked and turned into real deposits automatically, right there in the same sync — the table's Status column shows Confirmed for those. Only a possible duplicate or an unmatched account number shows Needs review — those are the only ones that need a trip to Pending Offline Deposits in the online app (Part 1, Section 6).

13A Typical Day, Start to Finish

7:55 AM — At the branch, on Wi-Fi, you log into the online app and open the Offline Recorder too, letting the customer list finish downloading before you head out.

8:30 AM — Signal is fine for the first stops, so you use the online app as usual: search, record, confirm, SMS receipt sent automatically.

9:45 AM — You walk into a dead zone. You open the Offline Recorder — it goes straight to your recording screen, no login needed. You search each account, record the amount and old balance, confirm. One customer gets a duplicate warning because you've genuinely visited her twice today; you confirm it's real and it saves.

12:30 PM — Signal returns. The app auto-syncs your morning's deposits in the background; most turn into real deposits with SMS receipts right away — you see them marked "Confirmed" in the "Recently Synced" table, and Today's Summary updates with your running total so far.

12:35 PM — Two items are marked "Needs review" instead. In the online app, you open Pending Offline Deposits — one flags as a possible duplicate, you check it, confirm it's genuine, and accept it. The other has a mistyped account number, so you reject it and make a note to re-collect that one properly.

6:45 PM — Back at the branch, you check your Daily Collection and Commission pages online to confirm the day's totals look right.

14Troubleshooting