1. Bike/Scooter Sharing Platform
  2. Data model
Reference

The tables behind Bike/Scooter Sharing Platform

Bike/Scooter Sharing Platform ships with 11 tables, grouped here by the feature that uses them. Every record your team works with lives in one of them, and you can add fields and tables in Proto.

Tables
11
Features
6, plus shared settings
Change it
Add fields and tables in Proto

How the model is organised

Fleet readiness

Organizations supplies operating scope. Resources identifies bikes, e-bikes, scooters and docks with Active, resource type, Availability, maintenance status, battery percent and current dock location. Team members links operating staff to Users.

Reservations and capacity

Bookings holds the Organization, Owner and Resource references, scheduled starts at and ends at, Status and Revision. Booking resources links each reservation line through Parent and Resource with Capacity, reserved units, setup minutes and cleanup minutes.

Ride sessions

Ride sessions connects the actual Vehicle and Organization to its Bookings parent. Started at, ended at, distance miles and fare USD describe actual service, supported by provider device receipt references and times.

Independent review

Review decisions identifies the source revision, Reviewer, Decision, Reason and operation key for the booking's submitted work.

Payment evidence

Payment evidence retains provider event ID, provider reference, Type, amount USD and Verified alongside the booking reference.

Activity and reconciliation

Operation receipts stores Action, expected revision, result state and effect references. Record attachments keeps evidence files, Visibility and uploaded by against the same booking.

Every table, by feature

Fleet readiness

4 tablesAbout this feature
  • Resources

    Bikes, scooters and docks available for sharing operations.

    Linked to Organizations
  • Organizations

    Sharing operator organizations with time zone and currency scope.

  • Team members

    Operator staff linked to an organization and authenticated platform identity.

    Linked to Organizations, Users
  • Record attachments

    Unlock, lock and ride evidence files attached to bookings.

    Linked to Bookings, Team members

Reservations and capacity

7 tablesAbout this feature
  • Bookings

    Ride bookings with lifecycle, quoted amount and counterparty resource.

    Linked to Organizations, Team members, Resources
  • Booking resources

    Reserved resource lines attached to a booking.

    Linked to Bookings, Resources
  • Resources

    Bikes, scooters and docks available for sharing operations.

    Linked to Organizations
  • Organizations

    Sharing operator organizations with time zone and currency scope.

  • Team members

    Operator staff linked to an organization and authenticated platform identity.

    Linked to Organizations, Users
  • Payment evidence

    Provider payment authorization, capture, refund and void evidence.

    Linked to Bookings
  • Operation receipts

    Stable operation keys and result state for every guarded action.

    Linked to Bookings

Ride sessions

6 tablesAbout this feature
  • Ride sessions

    Provider-confirmed ride sessions with vehicle, distance and evidence.

    Linked to Bookings, Organizations, Resources
  • Bookings

    Ride bookings with lifecycle, quoted amount and counterparty resource.

    Linked to Organizations, Team members, Resources
  • Resources

    Bikes, scooters and docks available for sharing operations.

    Linked to Organizations
  • Record attachments

    Unlock, lock and ride evidence files attached to bookings.

    Linked to Bookings, Team members
  • Review decisions

    Independent reviewer decisions on submitted revisions.

    Linked to Bookings, Team members
  • Operation receipts

    Stable operation keys and result state for every guarded action.

    Linked to Bookings

Independent review

6 tablesAbout this feature
  • Review decisions

    Independent reviewer decisions on submitted revisions.

    Linked to Bookings, Team members
  • Ride sessions

    Provider-confirmed ride sessions with vehicle, distance and evidence.

    Linked to Bookings, Organizations, Resources
  • Bookings

    Ride bookings with lifecycle, quoted amount and counterparty resource.

    Linked to Organizations, Team members, Resources
  • Team members

    Operator staff linked to an organization and authenticated platform identity.

    Linked to Organizations, Users
  • Record attachments

    Unlock, lock and ride evidence files attached to bookings.

    Linked to Bookings, Team members
  • Operation receipts

    Stable operation keys and result state for every guarded action.

    Linked to Bookings

Payment evidence

4 tablesAbout this feature
  • Payment evidence

    Provider payment authorization, capture, refund and void evidence.

    Linked to Bookings
  • Bookings

    Ride bookings with lifecycle, quoted amount and counterparty resource.

    Linked to Organizations, Team members, Resources
  • Ride sessions

    Provider-confirmed ride sessions with vehicle, distance and evidence.

    Linked to Bookings, Organizations, Resources
  • Operation receipts

    Stable operation keys and result state for every guarded action.

    Linked to Bookings

Activity and reconciliation

7 tablesAbout this feature
  • Operation receipts

    Stable operation keys and result state for every guarded action.

    Linked to Bookings
  • Record attachments

    Unlock, lock and ride evidence files attached to bookings.

    Linked to Bookings, Team members
  • Bookings

    Ride bookings with lifecycle, quoted amount and counterparty resource.

    Linked to Organizations, Team members, Resources
  • Booking resources

    Reserved resource lines attached to a booking.

    Linked to Bookings, Resources
  • Review decisions

    Independent reviewer decisions on submitted revisions.

    Linked to Bookings, Team members
  • Ride sessions

    Provider-confirmed ride sessions with vehicle, distance and evidence.

    Linked to Bookings, Organizations, Resources
  • Payment evidence

    Provider payment authorization, capture, refund and void evidence.

    Linked to Bookings

Shared and settings

1 table
  • Users

    Users

    Linked to Users

Keys and references

The model contains 11 tables. Follow reference fields when joining records; a vehicle name or customer name is descriptive text. Bookings.Owner references team members, and team members.User connects that membership to Users. Resolve the authenticated user through that relationship for assigned work.

Child Parent references lead to Bookings. Review decisions.source revision identifies the revision being decided, while operation receipts.expected revision identifies the revision expected by an action. Preserve operation keys and provider event identities through retries and migration.

Migration order

  1. Establish identity. Resolve Users through the platform identity process, then create Organizations and team members with their correct references.
  2. Load resources. Import Resources with stable codes, organization ownership and current operating condition.
  3. Load reservations. Import Bookings and then booking resources, preserving their parent and resource links.
  4. Attach actual service. Import ride sessions with the matching booking, organization and selected vehicle. Preserve historical vehicle wording separately.
  5. Retain evidence. Import record attachments, review decisions, payment evidence and operation receipts with their original references and revision meaning intact.

Set up Bike/Scooter Sharing Platform your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started