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 DRIVER DUTY AUDIT

Active Drivers & Logged-In Duty Time

Supabase-backed record of each Tirana LIVE driver session: who signed in, fitted bus/tablet, route confirmation, session duration and how the session ended.

PERIOD

LIVE DUTY OVERVIEW

Drivers signed in now

0 ACTIVE

Driver	Bus	Route	Tablet	Started	Logged in	Connection	Last seen	Action

PERIOD OVERVIEW

Logged-in hours by day

Load duty data.

DUTY HISTORY / AUDIT

Completed and active sessions

30 DAYS

Date	Driver	Employee	Bus	Route(s)	Start	End	Duration	End reason

TIRANA LIVE COMMUNICATIONS INTELLIGENCE

Communications Audit & Response Performance

Supabase-backed operational audit of driver/OCC calls and messages: answer performance, missed calls, call duration, message acknowledgement, route demand and controller workload. WebRTC audio is not recorded.

PERIOD

OPERATIONAL AUDITMeasures Tirana LIVE communications metadata and acknowledgement events. No call audio is recorded. Direct telephone fallback can be logged as initiated but cannot prove external PSTN answer/duration.WAITING

ACTIVITY TREND

Calls & messages by day

Load communications audit.

ROUTE DEMAND

Communications by route

Load communications audit.

OCC WORKLOAD

Controller communications activity

Load communications audit.

COMMUNICATIONS HISTORY

Calls and messages

30 DAYS

Date/time	Type	Direction	Route	Bus	Driver	Controller	Status	Response	Duration / message

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.

RING CHECKNOT CONNECTED

REALTIME PRESENCE

Active driver shifts

—ACTIVE DRIVERS

Refresh to load the active driver roster.

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

OCC RINGTONEVOLUME 80%

GOVERNED HISTORICAL AVL EVIDENCE

Historical Replay

Reconstruct a route minute by minute from the Supabase AVL archive. Replay uses captured evidence only; it never substitutes current vehicle positions into the past.

DATEROUTEDIRECTION

ARCHIVE AUTHORITYOne-minute AVL route snapshots captured by the Worker cron. Historical Replay is evidence reconstruction, not video and not interpolation between missing archive minutes.NOT LOADED

SPEED

CAPTURED—0 / 0

—No history loaded—

ROUTE POSITION RECONSTRUCTION

Select a route and date

NO FRAME

Load a historical route day to reconstruct vehicle positions.

CAPTURED VEHICLE EVIDENCE

Vehicles at selected minute

0 VEHICLES

Bus	Direction	Trip	Progress	Delay	Spacing	Next stop	GPS age	Evidence flags
No replay frame selected.

PLATFORM CONTROL

Platform Administration

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

ACTIVE CITYTirana

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.

DEVICE / BUS REGISTER

Register or update fitted tablet

ONE RECORD · ONE BUS

One setup only: register the physical tablet, the bus it is fitted to and its direct-call phone/SIM number together. Drivers still sign themselves in and out each shift — no daily Admin bus allocation.

DEVICE CODE BUS / VEHICLE ID DIRECT PHONE / SIMFallback DIRECT CALL number for this fitted bus/tablet. LABEL SERIAL / ASSET REF DEVICE STATUS

Use EDIT in the device list to change the bus number, phone, label, serial or status. DELETE removes the device from the active registry while preserving historical audit evidence.

DRIVER DIRECTORY

Employee-number driver accounts

NO EMAIL REQUIRED

Create each driver here using their employee/driver number, name and password. Tirana LIVE creates the internal authentication identity automatically — drivers never need an email address. The fitted bus/tablet is managed separately above.

EMPLOYEE / DRIVER NUMBER DRIVER NAME INITIAL / RESET PASSWORDRequired for a new driver; optional when editing unless resetting password. DRIVER ACCESS

Load the driver directory after the self-service driver SQL is installed.

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

Tirana AVL

Street map + vehicles + traffic

Trip Times / Operational Performance

All live trips on selected route

3-Route Monitor

OCC Alert Centre

Shared controller priority queue

Pinned OCC routes

Network Monitor

Live route health + on-demand road traffic

Route 360

Risk Intelligence

Current network signals

GTFS / Live Data Gateway Health

Transitime / standard GTFS-RT readiness

Driver Device Platform

Fit once. Driver signs in.

Drivers connected now

All Tirana LIVE tablets

Driver PWA

Active Drivers & Logged-In Duty Time

Drivers signed in now

Logged-in hours by day

Completed and active sessions

Communications Audit & Response Performance

Calls & messages by day

Communications by route

Controller communications activity

Calls and messages

Communications & Alerts

Active driver shifts

Recent / active calls

Recent driver communication

Independent monitoring window

Historical Replay

Select a route and date

Vehicles at selected minute

Platform Administration

Users, roles, views & routes

Platform access

Select a user

Cities & Data Sources

Configured networks

Select a city

GTFS & GTFS-Realtime

Operational Bus Schedule

On-Time / High-Frequency Service

Route Families

Display & AVL Configuration

Operational map

Corridor readability

Refresh & annotation

Operational label scale

Mobile, Communications & Device GPS

Device position mode

OCC ↔ driver

Register or update fitted tablet

Employee-number driver accounts

Operational readiness

GTFS-RT vs fitted device

AI OCC Copilot Lite

When AI may run

Application limits

Current month

Facts first, AI second

Branding