Skip to content

api: add gps device capture to records schema#75

Open
sjperaltas wants to merge 1 commit into
v2from
feature/FLCRM-20532-gps-device-capture-api-openapi
Open

api: add gps device capture to records schema#75
sjperaltas wants to merge 1 commit into
v2from
feature/FLCRM-20532-gps-device-capture-api-openapi

Conversation

@sjperaltas

@sjperaltas sjperaltas commented Jun 22, 2026

Copy link
Copy Markdown

What?

  • Add gps_device_capture to Records v2 response schemas
  • Add a reusable GpsDeviceCapture response schema with read-only geometry_matches_capture
  • Add a writable GpsDeviceCaptureRequest schema for record create/update requests

Why?

  • Documents the backend GPS device capture contract for FLCRM-20532
  • Prevents downstream schema validation failures caused by the new response shape
  • Keeps writable input separate from the server-computed geometry_matches_capture field

Related PRs:

Resolution

  • Updated Record and RecordHistoryItem to include gps_device_capture
  • Updated RecordRequest and RecordPatchRequest to accept gps_device_capture
  • Modeled geometry_matches_capture as a response-only boolean inside the response schema

Code Review

High quality code reviews are expected. You can utilize this PR review checklist to help you conduct one.

Testing

  • Validated reference/rest-api.json parses as valid JSON
  • Ran npx --yes rdme openapi validate rest-api.json successfully
  • Checked for RAW_BODY anti-patterns
  • Reviewed the diff to confirm only the Records-related schemas changed

Copilot AI review requested due to automatic review settings June 22, 2026 18:54
@sjperaltas sjperaltas requested review from a team as code owners June 22, 2026 18:54

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the OpenAPI specification (reference/rest-api.json) to document the new gps_device_capture shape on Records v2 responses and to accept corresponding input on record create/update requests, aligning the published schema with the backend contract for FLCRM-20532.

Changes:

  • Add gps_device_capture to the Record and RecordHistoryItem response schemas.
  • Introduce reusable GpsDeviceCapture (response) and GpsDeviceCaptureRequest (write) schemas, with geometry_matches_capture modeled as response-only (readOnly).
  • Extend RecordRequest and RecordPatchRequest to accept gps_device_capture via GpsDeviceCaptureRequest.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread reference/rest-api.json
Comment on lines +272 to +274
"gps_device_capture": {
"$ref": "#/components/schemas/GpsDeviceCapture"
},
Comment thread reference/rest-api.json
Comment on lines +464 to +466
"gps_device_capture": {
"$ref": "#/components/schemas/GpsDeviceCapture"
},
Comment thread reference/rest-api.json
Comment on lines +520 to +524
"GpsDeviceCapture": {
"type": "object",
"description": "Flexible GPS device metadata captured with a record.",
"additionalProperties": true,
"properties": {
Comment thread reference/rest-api.json
Comment on lines +520 to +526
"GpsDeviceCapture": {
"type": "object",
"description": "Flexible GPS device metadata captured with a record.",
"additionalProperties": true,
"properties": {
"device_name": {
"type": "string",
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants