Hybrid developer suite — telemetry, fleet control & accounting.

Overview

Fleet health & live activity
15s

Live activity radar

auto 15s · heartbeats 60s

Kill switch

Freeze every terminal immediately (queued for offline machines until they sync).

Version fleet

Turnover & house-cut ledger

Fleet telemetry

Click a row for full history, update control, remote config and backup actions. Heartbeats every 60s; offline after 5 min of silence.

Minimum version policy

Machines reporting a version below the minimum are locked with an “Update Required” screen while online and auto-update via the ACTIVE release (offline shops keep playing until they reconnect). Ship the new release first — then raise the floor.

Publish app update (OTA)

Upload the zip from npm run package:update. Activating a release makes it the sole ACTIVE one and pushes it to all matching terminals on their next heartbeat (download → verify → silent restart). Exactly one ACTIVE release at all times.

Release history

Upload cartela bundle (CSV)

CSV in the app’s Card Sets export format (header card,b1..o5, 25 columns). Terminals re-validate every card with the engine parser and install the set at a safe moment only (idle registration, no sold cards) — never mid-round.

Push a card set to machines

Queues a signed DECK command per machine; terminals download, verify sha256 and apply on their next heartbeat when idle (redelivered until confirmed). Needs app v1.5.5+.

Bundle library

Earnings & network KPIs

Daily trend · turnover vs net earnings

Per shop · day

Shop statement & P&L export

Built from the detailed round reports pushed by each terminal (turnover, prizes, bonuses, per-cashier) plus approved top-ups. Print to PDF via the browser.

Issue offline action token

Tokens work without internet. They are recorded in the ledger below and flip to REDEEMED automatically when the terminal syncs.

Token ledger

Send remote command

Commands queue until the terminal's next heartbeat and are acknowledged on delivery.

Command history

Pending registrations

Self-serve sign-ups awaiting approval. Approve to activate and grant the opening trial / bonus credit.

Remote balance control

Direct +/−/set adjustments (NBP = ETB ×10). Each writes an audited ledger row (ref DEV-CMD-…). Verify Telebirr/CBE transfers, then credit.

Adjustment & grant history

Backup vault

Encrypted customer snapshots — content is unreadable without the customer's passphrase or the machine recovery key. Verify re-hashes the newest file on disk against the stored sha256.

Sales leads

Franchise / branch enquiries from the Telegram bot (TV banner → t.me/nile_bingo_bot). Call back promptly.

Support tickets

Bug / hardware reports with the terminal's latest heartbeat diagnostics attached.

Balance top-up requests

Terminal “Get Balance” → REQ code → Telegram. Verify the transfer, then approve — the TOP token is delivered to the customer's chat automatically and tracked in the token ledger.

Add operator account

Named logins for partners/staff. A top-up operator can only see the fleet radar and queue balance adjustments from the dev tool (/dev); a master operator has full access. Passwords are stored as scrypt hashes.

Accounts

Audit log

logins, balance adjustments & account changes (newest 100)
Machine