Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature: Modes - Delivery #787

Draft
wants to merge 26 commits into
base: dev
Choose a base branch
from

Conversation

tristan-charreton
Copy link
Contributor

@tristan-charreton tristan-charreton commented Sep 13, 2022

Explain pull request

Work on deliveries to incorporate into Modes

Is this a breaking change

  • Yes, breaking

Impacted Spec

Which spec(s) will this pull request impact?

  • agency
  • policy
  • provider

Additional Information

This draft is for all types of Delivery. For MDS 2.0 we chose to focus on sidewalk delivery robots and leave this broader scope of delivery for a future release.

@tristan-charreton tristan-charreton requested a review from a team as a code owner September 13, 2022 14:08
@tristan-charreton tristan-charreton changed the title Delivery Feature: Modes - Delivery Sep 13, 2022
@schnuerle schnuerle changed the base branch from feature-modes to dev September 13, 2022 14:16
@schnuerle schnuerle added Modes New modes that MDS can support (carshare, passenger services, delivery robots, etc) Delivery Robots Delivery Robots mode: sidewalk, autonomous, remote labels Sep 13, 2022
@schnuerle schnuerle added this to the 2.0.0 milestone Sep 13, 2022
@schnuerle schnuerle linked an issue Sep 13, 2022 that may be closed by this pull request
@schnuerle schnuerle marked this pull request as draft September 13, 2022 14:17
agency/README.md Outdated
@@ -373,6 +373,7 @@ The Trips endpoint serves two purposes:
|-------------------------------|--------------------------------|------------------------| ----------------- |
| trip_id | UUID | Required | UUID for the trip this payload pertains to |
| journey_id | UUID | Optional | A unique ID for associating collections of trips |
| trip_type | Enum | Optional | The type of the trip |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here a trip_type is added in order to precise what kind of segment a vehicle is on (picking up the delivery, delivering, roaming, ...).

| `unknown` | `reserved` | `reserved` | `comms_restored` | The vehicle has come back into comms while reserved by a customer |
| `unknown` | `stopped` | `stopped` | `comms_restored` | The vehicle has come back into comms while stopped |
| `on_trip` | `stopped` | `stopped` | `order_pick_up` | The vehicle has come to pick up the order at the restaurant |
| `on_trip` |`stopped` | N/A | `order_drop_off` | The vehicle is at the customer's place and is waiting for them |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here we add the possibility to give even more precision by tracking the waiting time (at the customer's place). Can be interesting but might not be necessary in the MDS 2.0. In any case, it remains optional.

@tristan-charreton
Copy link
Contributor Author

Here is an example of the different workflows that can be used by the operators.
workflows delivery vehicles.xlsx

- `off_hours`
- `on_hours`
- `driver_cancellation`
- `order_drop_off`
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 event_types have been added : order_pick_up and order_drop_off.
Also, there is also the possiblity of adding an 'obstacle' event which would switch to 'stopped' status.


In cases where there are multiple trips ongoing, please follow the trip state model pseudocode for determining what the vehicle state should be:
```
t = for the one vehicle, all on-going trips which are 'delivey' or undefined trips (we do not take into account 'roaming', 'return' or 'advertising' trips)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here a choice was made : even if we want to track all the movements as trips, we do not consider as a roaming robot as being 'on trip'. Can be debated

@@ -21,7 +23,7 @@ As with all MDS definitions, they should be described in a way that maximizes th
| `missing` | Missing |
| `off_hours` | Off hours - end of service |
| `on_hours` | On hours - start of service |
| `passenger_cancellation` | Passenger cancelled a trip |
| `customer_cancellation` | Customer cancelled a trip |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the notion of passenger does not fit the deliveries. Therefore, it has been replaced by the notion of customer

@schnuerle
Copy link
Member

Per our public working group meeting last week, we will be putting this PR about just Delivery on hold, in favor of the more narrow Delivery Robots mode which is in progress on this feature branch. The WGSC agreed with this today during their planning meeting.

We will be incorporating some of the ideas added here in to the new feature branch.

@CLAassistant
Copy link

CLAassistant commented Apr 11, 2024

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
0 out of 3 committers have signed the CLA.

❌ tristan-charreton
❌ JuanCarlos-TiqueRangel
❌ alesantiago98
You have signed the CLA already but the status is still pending? Let us recheck it.

@schnuerle
Copy link
Member

schnuerle commented May 31, 2024

@pierre-bouffort brought up in our steering committee meeting that MDS sidewalk robot delivery may be ready to be expanded into general delivery services, especially for food delivery.

Though if so and when ready, we will need to create a new pull request off of MDS 2.0, as this PR is out of date and not usable now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Delivery Robots Delivery Robots mode: sidewalk, autonomous, remote Modes New modes that MDS can support (carshare, passenger services, delivery robots, etc)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants