Skip to content

Add MDS Audit Draft#326

Closed
whereissean wants to merge 4 commits intodevfrom
unknown repository
Closed

Add MDS Audit Draft#326
whereissean wants to merge 4 commits intodevfrom
unknown repository

Conversation

@whereissean
Copy link
Copy Markdown
Contributor

Explain pull request

Add new Audit API and associated schema for the evaluation of the technical compliance of providers.

Is this a breaking change

A breaking change would require consumers or implementors of the API to modify their code for it to continue to function (ex: renaming of a required field or the change in data type of an existing field). A non-breaking change would allow existing code to continue to function (ex: addition of an optional field or the creation of a new optional endpoint).

  • Yes, breaking
  • No, not breaking
  • I'm not sure

Provider or agency

Which API(s) will this pull request impact:

  • provider
  • agency
  • both
  • neither

Additional context

MDS enables cities or municipal operators to receive information directly from regulated / permitted entities ("providers") relating to the behavior of vehicles and devices in the public right of way. During initial onboarding of providers and thereafter for maintenance purposes, it may be necessary for the city or its agents to attempt to audit or otherwise ensure that this information is correct.

This question of auditable compliance relates both to the correct formatting of data (e.g., no malformed inputs), its accuracy, and its timeliness. These three factors together are important contributors to the evaluation of the technical compliance of a provider. This is to say, the compliance of regulated / permitted vehicles or devices with the specific requirements laid out both by MDS as a system of interfaces, and by the specific program terms or requirements (e.g. an event telemetry submission latency window, a telemetry temporal resolution requirement, and for the evaluation of the precision of such submissions consistent with GPS accuracy requirements or other program terms that may vary from city to city or within the scope of permitted and regulated program operations.

This specification defines an API which facilitates in-field data collection and evaluation of the technical compliance of providers. It is not intended as a substitute for other evaluative, cooperative, or corrective measures in the implementation or ongoing operations of MDS.

Document a common set of data definitions between MDS components.
@whereissean whereissean requested review from a team, hunterowens and thekaveman as code owners May 31, 2019 22:00
mdurling added 3 commits June 12, 2019 11:10
* Simplified/standardized audit details response

* Fix formatting

* Fixing lat type

* Fix some data types
* Allow adjustment of the provider event window.

* Fix headings

* Clarify event viewport definition and default
@hunterowens hunterowens added this to the 0.4.0 milestone Jun 28, 2019
Copy link
Copy Markdown
Collaborator

@marie-x marie-x left a comment

Choose a reason for hiding this comment

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

No comments, must not be too controversial. :) Approved.

@hunterowens hunterowens modified the milestones: 0.4.0 , Future Oct 11, 2019
@hunterowens
Copy link
Copy Markdown
Collaborator

changing milestone for now.

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Nov 6, 2019

CLA assistant check
All committers have signed the CLA.

@sarob sarob added the enhancement New feature or request label Dec 19, 2019
@jfh01
Copy link
Copy Markdown
Contributor

jfh01 commented Apr 9, 2020

Should we consider for the 1.0.0 release?

@jfh01 jfh01 modified the milestones: Future, 1.0.0 Apr 9, 2020
@Retzoh Retzoh mentioned this pull request May 27, 2020
@schnuerle
Copy link
Copy Markdown
Member

schnuerle commented Jun 5, 2020

HI @drtyh2o can make sure to sign the CLA for your contribution?

@schnuerle
Copy link
Copy Markdown
Member

This PR will be closed per our call today in favor of #483.

@schnuerle schnuerle closed this Jun 11, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants