Tirana LIVE · Live Operations

AVL

Loading Tirana route control…Preparing official GTFS route topology.

LIVE ROUTE GEOGRAPHY

Street map + vehicles + traffic

OUT A→B IN B→A NORMAL SLOW JAMWAITING

LIVE PERFORMANCE · EXPECTED / ACTUAL

Trip Times / Operational Performance

Compare the authoritative expected timetable with observed AVL stop passage and live prediction. An active municipality/operator schedule overrides GTFS only when the live journey can be matched deterministically; official GTFS remains the safe fallback.

EXPECTED GTFSGPS WAITINGTRIP UPDATES WAITINGSERVICE ALERTS WAITINGTRAFFIC WAITING

ROUTE DIRECTION

CURRENT SERVICE

All live trips on selected route

0

Bus	Trip	Direction	Expected Source	Expected Start	Actual Start	Start Δ	Last Actual	Next Expected	Predicted	Terminal	Status

EXPECTED authority = active municipality/operator operational schedule when an exact deterministic journey match exists; otherwise official GTFS. ACTUAL = observed AVL stop passage evidence. PREDICTED = direct GTFS-RT operator prediction where available, otherwise live GPS + timetable + traffic. Performance standard is governed per route in Platform Admin: On-Time window or High-Frequency live EWT MPS.

MULTI-ROUTE OCC SUPERVISION

3-Route Monitor

Monitor three allocated Tirana routes simultaneously. Click any route board to open its full Live AVL; use MAP to open that route directly in the enlarged geographic view.

READY

MONITOR ROUTE 1 MONITOR ROUTE 2 MONITOR ROUTE 3

Choose up to three routes to start multi-route monitoring.

SHARED OCC PRIORITY MANAGEMENT

OCC Alert Centre

One shared controller queue across authorised users. Acknowledgement, assignment, monitoring, notes and resolution are persisted in Supabase with a full audit history. Alert detection remains deterministic from AVL, schedule, resource and manually-scanned traffic data.

ACTIVE OPERATIONAL ALERTS

Shared controller priority queue

SHARED OCC WAITINGTRAFFIC NOT SCANNED

Loading shared operational alerts…

SHARED ROUTE WATCHLIST

Pinned OCC routes

No routes pinned yet.

Up to 6 shared routes per city. All authorised controllers see the same watchlist and workflow state.

CITYWIDE SUPERVISION

Network Monitor

All routes ranked by operational risk, scheduled resource requirement and trip-match confidence. Run an on-demand road-traffic scan to add current congestion and predicted delay without continuously consuming Google traffic requests.

ALL ROUTES

Live route health + on-demand road traffic

TRAFFIC NOT SCANNED

Route	Live	Required	Direction live / req	Planned HW	Trip match	Traffic OUT/IN	Worst traffic section	Bunch / gap	Stale / off-route	Service delivery	Risk

ROUTE INTELLIGENCE

Route 360

Operational overview, geography and stop topology for one route.

OPERATIONAL RISK ENGINE

Risk Intelligence

Bunching, large gaps, stale GPS and route-adherence signals across the network.

LIVE RISK REGISTER

Current network signals

DATA CONFIDENCE

GTFS / Live Data Gateway Health

Provider endpoints remain server-side. This page shows source priority, freshness, trip-match quality and GTFS-RT entity coverage without exposing secrets.

REALTIME FEED INSPECTOR

Transitime / standard GTFS-RT readiness

Compatible with standard protobuf/JSON VehiclePositions and the documented Transitime VehiclePositions / TripUpdates outputs.

SERVER-SIDE FEED SECURITY

VP

VehiclePositionsRequired for live buses, route matching, AVL spacing and GPS health.

TU

TripUpdatesOperator-issued delay and stop predictions are matched to live vehicles by exact trip / vehicle identity and used ahead of inferred ETA when available.

SA

ServiceAlertsOfficial disruption context is filtered by active period and matched to route, trip, direction and stop selectors.

Configure live feeds in Platform Admin → Cities & Data, then probe the selected city.

TIRANA LIVE DRIVER

Driver Device Platform

The tablet is fitted to a vehicle once. Each driver simply signs in at the start of the shift; Platform Admin does not assign drivers to buses every day.

GPS OFF

DEVICE WORKFLOW

Fit once. Driver signs in.

1REGISTER TABLETGive each physical tablet a Tirana device code.

→

2FIT TO BUSAdmin links that device permanently to one vehicle.

→

3DRIVER LOGINAny authorised driver signs in and starts the shift automatically.

Route is read from the live AVL vehicle. No daily route, duty or driver-to-bus allocation is required in Tirana LIVE.

LIVE TABLETS

Drivers connected now

—ONLINE DRIVER DEVICES

Refresh to load active driver tablets.

REGISTERED DEVICE FLEET

All Tirana LIVE tablets

— REGISTERED

Registered devices remain visible here even when no driver is signed in. A fitted tablet is linked to its bus once; driver login is a separate shift action.

Authority Admin can load the registered device fleet here.

TEST FROM ANY BROWSER

Driver PWA

Open the device app in a new window to test the tablet UI. Device GPS remains completely disabled while Admin mode is OFF.

DAILY ADMIN ASSIGNMENTNOT REQUIRED

DEVICE → VEHICLEONE-TIME FITMENT

DRIVERSELF SIGN-IN / SIGN-OUT

TIRANA LIVE COMMUNICATIONS

Communications & Alerts

Keep driver calls, messages and OCC alerts visible here or open the same console as an independent resizable window on a second monitor.

NOT CONNECTED

REALTIME PRESENCE

Driver tablets online

—ONLINE DRIVERS

Open the console or refresh to load presence.

CALL MONITOR

Recent / active calls

AUDIO NOT RECORDED

No call data loaded.

MESSAGES

Recent driver communication

No messages loaded.

SECOND MONITOR MODE

Independent monitoring window

The standalone console keeps its own realtime connection and can remain open while the main AVL changes route, page or full-screen view.

IN-APP WEBRTCREADY

DIRECT TELEPHONEADMIN CONTROLLED

DEVICE GPSOFF

PLATFORM CONTROL

Platform Administration

Manage cities, network data, users, display behaviour and branding from one governed workspace.

ACTIVE CITYTirana

AUTHORISED USERS

Platform access

Loading users…

ACCESS PROFILE

Select a user

WAITING

Select a user or create a new oneAccess is enforced at the API and database layers.

CITY CATALOGUE

Configured networks

CITY PROFILE

Select a city

WAITING

Select a city or create a new oneEach city has independent GTFS, live feeds, display rules and access allocation.

DATA SOURCES

GTFS & GTFS-Realtime

NOT CONFIGURED

PROVIDER / SYSTEM

STATIC GTFS URLUse a URL, upload a ZIP, or both. The imported archive and runtime topology are stored in Supabase. GTFS ZIP VEHICLE POSITIONS · GTFS-RT TRIP UPDATES · GTFS-RT SERVICE ALERTS · GTFS-RT

EXPECTED SERVICE

Operational Bus Schedule

Expected timetable used later for actual-v-expected, early/on-time/late and scheduled headway intelligence.

NOT IMPORTED

SCHEDULE NAME FORMAT EFFECTIVE FROM EFFECTIVE TO SCHEDULE URLOptional. Store source URL or fetch a supported CSV directly. SCHEDULE FILEAVL Standard CSV is normalized immediately. XLSX/JSON/other source files are archived for the future format-conversion tool.

DOWNLOAD AVL SCHEDULE TEMPLATENo operational schedule imported.

FOUNDATION READYOperational schedule is separate from GTFS. On-Time performance now uses the route standard configured below; High-Frequency routes use live EWT against their route MPS. The same canonical expected-service layer remains available to later analytics and AI.

ROUTE PERFORMANCE STANDARD

On-Time / High-Frequency Service

Every route defaults to On-Time Service. Shared-trunk branched routes are configured once as one combined route. High-frequency routes use live EWT against the configured MPS.

DEFAULT ON-TIME

ROUTE SERVICE TYPE EARLY LIMIT · MIN LATE LIMIT · MIN EWT MPS · MIN

EARLY / TOO CLOSELF early · HF bunching ON TIME / ON TARGETLF on time · HF target spacing LATE / TOO FARLF late · HF large gap STALE / INACTIVENo reliable live criterion

These governed colours are used on Live AVL bus badges, combined routes, Vehicle Details and map vehicle markers. Defaults: Early/Too Close red · On Time/On Target yellow · Late/Too Far green · Stale grey.

All routes currently default to On-Time Service · −2m / +5m unless explicitly changed.

BRANCHED SERVICES

Route Families

Combine related services using official GTFS. One family per line: family id | label | route codes | type. Type is branch or loop.

GTFS DERIVED

GTFS audit includes branched families and clockwise/anticlockwise loop pairs.

MAP LABELS

Operational map

Permanent stop namesShow operational stop labels on the map. STOP NAME SIZE MAP NAME LENGTH22chShort operational labels; click a stop for its full name. VEHICLE LABEL SIZE ROUTE LINE WIDTH STOP MARKER SIZE

AVL BOARD

Corridor readability

STOP LABEL SIZE AVL NAME LENGTH12ch Compact operational namesAbbreviate long stop/road names on the AVL strip. Full names remain available on hover. BUS CARD SCALE AVL BOARD HEIGHT INBOUND BUS VERTICAL OFFSET0pxNegative moves INBOUND buses up; positive moves them down. GTFS position is unchanged. OUTBOUND BUS VERTICAL OFFSET0pxNegative moves OUTBOUND buses up; positive moves them down. GTFS position is unchanged. INTERFACE DENSITY

LIVE BEHAVIOUR

Refresh & annotation

LIVE REFRESH INTERVALVehicle layers refresh without moving the map. Show stop sequenceAdd stop order to operational labels. Direction labelsKeep OUTBOUND A→B / INBOUND B→A headings visible.

LIVE PREVIEW

Operational label scale

Central StationMunicipalityBUS 214
HW 7m

Settings apply per city and are loaded for every authorised user.

DEVICE GPS OFFNo device location is requested, accepted, stored or used. GTFS-RT remains authoritative until an administrator explicitly enables SHADOW or FUSED.

GPS CONTROL

Device position mode

OFF

DEVICE GPS MODE

CAPTURE INTERVAL · SECMAX DEVICE ACCURACY · MMAX POSITION AGE · SECMAX GTFS/DEVICE DIVERGENCE · M

OFF is a hard server + client gate. SHADOW records comparison evidence only. FUSED should be enabled only after Tirana field calibration.

COMMUNICATIONS

OCC ↔ driver

TURN NOT CHECKED

Enable Tirana LIVE in-app audio calls & messages Enable DIRECT CALL fallback OCC DIRECT TELEPHONEUsed only when a driver presses DIRECT CALL.

GPS is intentionally OFF until Tirana devices are fitted.

TABLET REGISTER

Register a driver device

DEVICE CODELABELSERIAL / ASSET REF

PHYSICAL FITMENT

Fit tablet to vehicle · one time

NO DAILY DRIVER ALLOCATION

Select the physical tablet and the bus it is installed in. This link stays in place across driver changes and route changes.

DEVICEVEHICLE ID

DRIVER DIRECTORY

Authorise driver once

Create the user in Users & Access once, then enable that person as a Driver here. After that, the driver can sign into any fitted bus tablet without OCC/Admin assigning them each day.

USEREMPLOYEE / DRIVER REFDIRECT PHONEDRIVER ACCESS

DEVICES · FITMENT · SHIFTS

Operational readiness

Load devices after the mobile foundation SQL is installed.

GPS CALIBRATION

GTFS-RT vs fitted device

GPS is OFF. Calibration will remain empty until Admin enables SHADOW or FUSED.

RUN MODE

When AI may run

KEY NOT CHECKED

AI MODE MODEL MAX OUTPUT TOKENSIncludes hidden reasoning plus the short structured result. 600 is the safe low-cost floor for GPT-5 nano. SMART MINIMUM RISK

COST GUARDS

Application limits

MAX CALLS / HOUR MAX CALLS / DAY MONTHLY APP GUARD · USDThis is enforced by Tirana AVL before an OpenAI request. Keep a separate OpenAI project spend limit too. SITUATION CACHE · MIN SMART COOLDOWN · MIN

DEV USAGE

Current month

CALLS—

EST. USD—

INPUT—

OUTPUT—

No API key is ever stored in browser settings.

OPERATING RULE

Facts first, AI second

GTFS, live GPS, traffic and Tirana AVL analytics remain the source of operational truth. OpenAI receives only a compact summary and returns explanation/recommendation.

No web search in runtime.
No GTFS files or map geometry sent.
No autonomous dispatch, hold or curtail commands.
Identical situations reuse cached advice without another model call.

PLATFORM IDENTITY

Branding

Control the identity shown on login and operational screens.

ADMIN