GRI-1885: write the MVP smoke-test checklist and script #117

Merged
vivy merged 2 commits from test/GRI-1885-mvp-smoke-test into dev 2026-11-10 18:35:15 +00:00
Member

Summary

Forge #115, GRI-1885: write the MVP smoke-test checklist and script now,
run it once #113 and #114 land (per the comment on the issue).

  • docs/mvp-smoke-test.md — the 5-step checklist from the forge issue, each
    step with the exact commands/API calls and what to confirm. Every payload
    shape is cross-checked against the current handler code, not guessed.
  • scripts/mvp-smoke-test.sh — automates everything in the checklist that
    does not need a human eye on a browser: builds and starts the packaged
    server (Docker Compose, the way packaging/server/README.md describes
    it), creates the first user and logs in by API, builds and runs the real
    grimoirix-signage-client (the gtk-renderer feature) under Xvfb,
    waits for it to go pending then accepted, generates one small real .mp4
    on the spot with gst-launch-1.0 (no network fetch, nothing checked into
    the repo) plus a test image, uploads both, builds and assigns a playlist,
    and confirms both playback and a live playlist change from the client's
    own log.

Found while writing this

  • This build host's agent accounts have no docker group membership —
    only vivy and fjrunner do. The script's preflight check catches this
    with a clear message instead of a confusing Docker error partway through.
  • Most of the system is already implemented on dev: the REST API
    (setup, session, devices, media, playlists) and the real client
    (enrolment, cache, playback, WebSocket sync) all exist today. Only
    #113 (panel still mocked) and #114 (server doesn't serve the panel) are
    missing, so steps 1, 3, 4 and 5 of the checklist do not depend on either
    and only step 2's browser half does.

Test plan

  • scripts/local-gates.sh passes on this branch (exit 0, full run).
  • Every jq/curl payload in the script matches the request structs
    in crates/server/src/{auth,devices,media,playlists}/handlers.rs.
  • The image (convert) and video (gst-launch-1.0) generation
    commands were run by hand on this host and produce a real PNG and a
    real playable .mp4.
  • Full end-to-end run of the script — blocked on #113/#114 landing and
    on docker access for an agent account (see above). Tracked as the
    next action on GRI-1885/forge #115, not fixed in this PR.
## Summary Forge #115, GRI-1885: write the MVP smoke-test checklist and script now, run it once #113 and #114 land (per the comment on the issue). - `docs/mvp-smoke-test.md` — the 5-step checklist from the forge issue, each step with the exact commands/API calls and what to confirm. Every payload shape is cross-checked against the current handler code, not guessed. - `scripts/mvp-smoke-test.sh` — automates everything in the checklist that does not need a human eye on a browser: builds and starts the packaged server (Docker Compose, the way `packaging/server/README.md` describes it), creates the first user and logs in by API, builds and runs the real `grimoirix-signage-client` (the `gtk-renderer` feature) under `Xvfb`, waits for it to go pending then accepted, generates one small real `.mp4` on the spot with `gst-launch-1.0` (no network fetch, nothing checked into the repo) plus a test image, uploads both, builds and assigns a playlist, and confirms both playback and a live playlist change from the client's own log. ## Found while writing this - This build host's agent accounts have no `docker` group membership — only `vivy` and `fjrunner` do. The script's preflight check catches this with a clear message instead of a confusing Docker error partway through. - Most of the system is already implemented on `dev`: the REST API (setup, session, devices, media, playlists) and the real client (enrolment, cache, playback, `WebSocket` sync) all exist today. Only #113 (panel still mocked) and #114 (server doesn't serve the panel) are missing, so steps 1, 3, 4 and 5 of the checklist do not depend on either and only step 2's browser half does. ## Test plan - [x] `scripts/local-gates.sh` passes on this branch (exit 0, full run). - [x] Every `jq`/`curl` payload in the script matches the request structs in `crates/server/src/{auth,devices,media,playlists}/handlers.rs`. - [x] The image (`convert`) and video (`gst-launch-1.0`) generation commands were run by hand on this host and produce a real PNG and a real playable `.mp4`. - [ ] Full end-to-end run of the script — blocked on #113/#114 landing and on `docker` access for an agent account (see above). Tracked as the next action on GRI-1885/forge #115, not fixed in this PR.
GRI-1885: write the MVP smoke-test checklist and automation script
Some checks failed
CI / the pre-push hook (pull_request) Successful in 6s
CI / cargo fmt (pull_request) Successful in 5s
CI / cargo clippy (pull_request) Successful in 10m25s
CI / cargo deny (pull_request) Failing after 3m0s
CI / repository boundary (pull_request) Successful in 7s
CI / cargo deny advisories (pull_request) Failing after 2m47s
CI / cargo test (pull_request) Successful in 11m42s
CI / frontend-web (pull_request) Successful in 9m49s
CI / CI (pull_request) Failing after 8s
CI / Notify gate failed (pull_request) Successful in 7s
f22b38e4a4
Forge #115. Writes the 5-step checklist (docs/mvp-smoke-test.md) and the
companion script (scripts/mvp-smoke-test.sh) that automates everything in
it that does not need a human eye on a browser: build and start the
packaged server, create the first user and log in by API, build and run
the real grimoirix-signage-client under Xvfb, approve it once pending,
generate one small real .mp4 with gst-launch-1.0 plus a test image, upload
both, build and assign a playlist, and confirm playback and a live
playlist change from the client's own log.

Not run end to end yet: the panel half of step 2 needs #113/#114, and this
build host's agent accounts have no docker group access to build or start
the container.
GRI-1885: retrigger CI (cargo deny / cargo deny advisories failed with no dependency change on this branch; dev's own tip is green)
Some checks failed
CI / the pre-push hook (pull_request) Successful in 8s
CI / cargo fmt (pull_request) Successful in 8s
CI / cargo deny (pull_request) Successful in 1m12s
CI / cargo deny advisories (pull_request) Failing after 4m34s
CI / repository boundary (pull_request) Successful in 19s
CI / frontend-web (pull_request) Successful in 9m55s
CI / cargo clippy (pull_request) Successful in 11m39s
CI / cargo test (pull_request) Successful in 11m42s
CI / CI (pull_request) Successful in 2s
CI / Notify gate failed (pull_request) Has been skipped
7685dfa10e
vivy merged commit 0d7a7eaf8d into dev 2026-11-10 18:35:15 +00:00
vivy deleted branch test/GRI-1885-mvp-smoke-test 2026-11-10 18:35:17 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Grimoirix/grimoire-of-digital-signage!117
No description provided.