# Sample brief: Requests API with Postgres

A separate practice service, test data only. Hosted through Octo Cloud.
Before launch, confirm Postgres availability, resource terms and the access you need.

## Data

Request: ID, name, email, creation time. Name and a valid email are required.
Operations: create a request and read it back by ID.

Before implementation, define the endpoints, request and response formats, the authorization method and error handling.
Database connection settings and secrets must not end up in public code or example requests.

## Checking the first version

- Create a record: Test Participant / test@example.com.
- Save the returned ID and read the record with a separate request.
- Check an invalid email and a request without the required access.
- State which checks were actually run.

## Second deploy

Add an optional `comment` field and keep the existing records.
Before the change, define how to recover if it fails.
After the update, read the old record by its ID and create a new one with a comment.
Check that the new record returns the comment and that the old one is still available.