Skip to content

Merge/v1.12 into v2.0 - #563

Merged
kjlippold merged 152 commits into
release/v2.0.0from
merge/v1.12-into-v2.0
Oct 15, 2026
Merged

kjlippold merged 152 commits into
release/v2.0.0from
merge/v1.12-into-v2.0

Conversation

@kjlippold

@kjlippold kjlippold commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor
  1. Merges latest v1.12.0 QC app updates from main into release/v2.0.0
  2. Consolidates v2 data migrations and adds a v1 to v2 data migration guide to docs.
  3. Fixes issues with user signup and user/org types in the admin dashboard.

daniel-slaugh and others added 30 commits March 24, 2026 13:44
Mount app immediately then async load API data
Start editing opens a chooser of the source's managed datastreams and their
sessions: continue an in-progress session, start a new one over the selected
time range, or create and delete managed datastreams. Managed datastreams are
hidden from the catalog and reached through the chooser. Also adds inline
processing-level creation, the session description captured at commit time,
reuse of the source's loaded series as the working copy, clamping the session
window to the source extent, and session resume that replays saved operations.
Plot a QC session's state at any operation as a separate, frozen line so
it can be compared against the session being edited. Buttons sit on every
operation row and on the "Data loaded" row, which plots the state the
session started from.

Snapshots ride in plottedDatastreams under the synthetic id
snap:<sessionId>:<opIndex>, so legend rendering, colour assignment,
visibility and reorder work unchanged. isSnapshotId guards the paths that
would otherwise treat one as real: refreshGraphSeriesArray skips its
fetch, releaseManagedDatastream drops them when the editor closes, and
the share encoder keeps them out of ds in favour of its own snap key.

The base is always the session chain's own window, never the plot's time
range, because operations replay against array indices. Snapshots build
on a detached ObservationRecord since the observation store hands back
one shared instance per datastream and the replay mutates what it is
given.

Also fixes two pre-existing problems in the history panel that this work
surfaced:

- Reloading from a step restored the pre-replay entries wholesale, which
  put the old timings back over the ones the replay had just measured.
  Only the "Data loaded" row updated. The panel now keeps the replayed
  entries and appends only what the replay dropped.
- hasUnsavedChanges compared entries by identity, so a replay while
  viewing a committed session read as pending edits and prompted "You
  have unsaved edits". A committed session cannot be edited, so both it
  and unsavedEditCount now short-circuit on isReadOnly.
Covers the feature in the user guide, the id convention, guards and
detached-fetcher rule in the architecture doc, the axis behaviour in the
plotting doc, and the two new store actions in the API reference.
The Data loaded row is step -1, so a session's starting state is now
reachable the same way any operation is, and it carries the "Showing"
chip when it is the step on screen.

Its reload-from-server button moves to a cloud icon so the row no longer
shows two identical glyphs doing different things: one replays the
history to a step, the other refetches and drops the history.
Save, Commit and Close now sit in a footer below the history and stay
visible while it is collapsed. Also drops the author name from collapsed
rows, puts the comment icon beside the operation title, and retitles
reload-from-server to discard and reload, hidden on committed sessions.
…-endpoints

# Conflicts:
#	django/contracts/openapi/auth.openapi.json
#	django/contracts/openapi/data.openapi.json
#	django/hydroserver/__init__.py
#	packages/hydroserverpy/setup.cfg
Undo, redo, step reload, and removing an entry all rebuild each item from
its method and args, which dropped the operator's comment and the server's
attribution. Re-stamp both afterwards, paired positionally and only when
the method still matches. Execution timings are left to be re-measured.
@kjlippold kjlippold self-assigned this Oct 9, 2026
@kjlippold
kjlippold marked this pull request as ready for review October 12, 2026 17:16
@kjlippold

Copy link
Copy Markdown
Contributor Author

@Maurier Can you review the changes to the QC app to make sure the 2.0 merge doesn't break anything? These are mainly changes to the API contract for v2.0 that had to be reconciled with the v1.12 QC app and qc-utils.

In v2.0, the pattern for fetching nested collections of resources is different. With the way the QC API worked in v1.12, ported straight to v2.0, its not possible to fetch a history with all its sessions and operations in one request. The merge handles this by fetching operations for one session at a time for a given history.

I could also flatten all the history endpoints to allow more flexibility in fetching operations across multiple sessions or histories in a single request.

/quality-control/histories/items/{history_id}/sessions → /quality-control/sessions/items
/quality-control/histories/items/{history_id}/sessions/{session_id}/operations → /quality-control/operations/items

This would allow the QC app to fetch all operations for a given history using a historyId query parameter (instead of a path parameter), but its a bigger change to the API, so I wanted your thoughts on it before moving forward with that change.

@Maurier

Maurier commented Oct 12, 2026

Copy link
Copy Markdown
Contributor

Yes, I'll take a look at this .

@daniel-slaugh daniel-slaugh 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.

Looks to me like everything in v1.12 is working the same as before. I'd also support your proposed changes for flattened responses.

@kjlippold

Copy link
Copy Markdown
Contributor Author

@daniel-slaugh Sounds good, I'll plan to flatten those endpoints in a follow-up PR.

@kjlippold
kjlippold merged commit 5de974e into release/v2.0.0 Oct 15, 2026
12 checks passed
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.

3 participants