Documentation PreviewAPI reference

Operate & maintain / Operations & recovery

Keep the operation running

Prepare each shift, coordinate exceptions, and give IT a clear release and recovery routine.

Start and hand over a shift#

Confirm the selected facility, door occupants, waiting visits, active shuttle work, holds, and physical assets. Name the dispatch owner.

At handover, review open requests, active moves, ready doors, waiting drivers, failed or blocked checkouts, and unassigned assets. Reconcile physical counts and assign an owner to every unresolved issue.

Deployment essentials#

Deploy the server, browser app, desktop client, and database schema as a tested set. Use production mode, a strong unique server secret, explicit allowed origins, and separate database identities for runtime and migrations.

Public booking and phone QR flows need a reachable HTTPS origin serving the browser app and proxying /api. The marketing website is separate from this operational application.

  1. Verify a current backup and the tested release versions.
  2. Build the server, then apply its migrations using the migration identity.
  3. Start the matching API and check GET /api/health.
  4. Publish matching clients and verify desktop, browser, two-client updates, and both phone signs.

Server startup checks the schema but does not apply migrations. Validate the actual target environment before a live rollout.

Monitoring and backups#

Assign owners for API health, SQL failures, disk space, backup age, login failures, gate exceptions, and audit retry warnings. Test that alerts reach the responsible person.

Agree on maximum acceptable data loss and outage time. Verify off-site retrieval and perform a restore drill into a separate scratch environment. A scheduled backup job alone is not evidence of a usable backup.

During an outage#

  1. Switch to the agreed desk or radio procedure.

    Stop relying on stale board or map state for new instructions.

  2. Record manual events.

    Capture time and timezone, reference, tractor and trailer, origin and destination, event, actor, and notes.

  3. Restore and reconcile.

    IT diagnoses the failure. Read authoritative records before replaying work, match existing events, and confirm physical positions to prevent duplicates.

  4. Hand control back explicitly.

    The supervisor and transportation lead confirm that open exceptions and manual events have been reconciled.

ROME Operations ManagementDocumentation · September 2026
Let’s talk about your operation.Text (479) 370-5859sales@romeoperations.com