ui/_docs/02_document/tests/blackbox-tests.md

Blackbox Tests

Every test is observed at the SPA's public surface — DOM, ARIA, outbound network, EventSource state, browser storage, console — never via src/ imports beyond the typed wire-contract enums (P9). Each test trails an Expected result source: results_report.md row N line; the comparison method, tolerance, and reference file for the assertion come from that row. Profile (fast / e2e / static) decides which runner picks the test up — see environment.md.

Positive Scenarios

FT-P-01: Bootstrap refresh sends credentials:'include'

Summary: On <AuthContext> init, the bootstrap refresh call includes the HttpOnly refresh cookie. Traces to: AC-01 Category: Auth — bootstrap Profile: fast

Preconditions:

• Refresh cookie present in the browser jar (test stubs it on the test domain).
• No bearer in memory.

Input data: app mount in a fresh browser session — results_report.md row 02.

Steps:

Step	Consumer Action	Expected System Response
1	Mount <App> (test renderer or e2e navigation to /)	Outbound fetch to /api/admin/auth/refresh is observed
2	Inspect the RequestInit of that fetch	credentials === 'include'; cookie sent by the test runtime

Expected outcome: see row 02 (exact: credentials: 'include'). Max execution time: 5s. Expected result source: results_report.md row 02.

---

FT-P-02: 401-retry sequence — refresh and retry the original request

Summary: A 401 on an authenticated request triggers POST /api/admin/auth/refresh (cookie-bound) then a retry of the original request with the new bearer. Traces to: AC-01, AC-23 Profile: fast (with MSW) and e2e

Preconditions:

• Authenticated session active; bearer about to expire.

Input data: any authenticated GET /api/admin/* issued via apiClient — results_report.md row 03.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger an authenticated call whose first response is 401 (stub)	The SPA issues POST /api/admin/auth/refresh with credentials:'include'
2	Refresh stub returns 200 with new bearer	The SPA retries the original request with the new bearer
3	Inspect the final response observed by the calling code	200 (success)

Expected outcome: sequence exactly per row 03; exactly one refresh call per refresh cycle (row 12). Max execution time: 5s. Expected result source: results_report.md rows 03, 12.

---

FT-P-03: Refresh transparency — <ProtectedRoute> does not unmount

Summary: Auth refresh occurring mid-session does not unmount the routed view. Traces to: AC-23 Profile: fast

Preconditions:

• User on /flights; bearer about to expire.

Input data: in-flight refresh while <FlightsPage> is mounted — results_report.md row 11.

Steps:

Step	Consumer Action	Expected System Response
1	Mount /flights; record render counter on <FlightsPage>	initial render = 1
2	Force a 401 → refresh → retry cycle	refresh handled
3	Inspect render counter post-refresh	delta ≤ 1 re-render

Expected outcome: row 11 — <ProtectedRoute> children stay mounted; ≤1 re-render delta. Max execution time: 5s. Expected result source: results_report.md row 11.

---

FT-P-04: AnnotationStatus enum on the wire

Summary: Outbound annotation save body's status is a number from the spec set {0,10,20,30,40}. Traces to: AC-04 Profile: fast (static + payload assertion)

Preconditions: _docs/00_problem/input_data/enum_spec_snapshot.json is up-to-date (Phase 3 gate).

Input data: POST /api/annotations/annotations body captured at save — results_report.md row 18; also static check of src/types/index.ts per row 14.

Steps:

Step	Consumer Action	Expected System Response
1	Static read AnnotationStatus from src/types/index.ts	{None:0, Created:10, Edited:20, Validated:30, Deleted:40}
2	Trigger an annotation save in <AnnotationsPage> (test mount)	POST /api/annotations/annotations issued
3	Inspect body	body.status ∈ {0,10,20,30,40}

Expected outcome: rows 14 (enum map) and 18 (wire payload). Max execution time: 3s. Expected result source: results_report.md rows 14, 18.

---

FT-P-05: MediaStatus / Affiliation / CombatReadiness enums match the spec

Summary: Each enum in src/types/index.ts matches the spec member set and numeric values pinned in enum_spec_snapshot.json. Traces to: AC-04 Profile: static

Preconditions: snapshot present (Phase 3 gate).

Input data: static read of src/types/index.ts against the snapshot — results_report.md rows 15, 16, 17.

Steps:

Step	Consumer Action	Expected System Response
1	Parse src/types/index.ts for enum MediaStatus, Affiliation, CombatReadiness	parsed without error
2	Compare member sets to snapshot	sets equal per row
3	Compare numeric values member-by-member	equal per row

Expected outcome: rows 15, 16, 17 (set_contains + exact). Max execution time: 1s. Expected result source: results_report.md rows 15, 16, 17.

---

FT-P-06: Detection wire payload — affiliation + combatReadiness in spec value sets

Summary: Every Detection element of an outbound annotation save has valid enum members. Traces to: AC-04 Profile: fast

Preconditions: snapshot present; an annotation with N detections about to be saved.

Input data: POST /api/annotations/annotations body — results_report.md row 19.

Steps:

Step	Consumer Action	Expected System Response
1	Save an annotation with N≥2 detections, mixed affiliations and readiness	request observed
2	Inspect every detections[i]	affiliation and combatReadiness are in spec value sets

Expected outcome: row 19. Max execution time: 3s. Expected result source: results_report.md row 19.

---

FT-P-07: Annotation save endpoint URL is doubly-prefixed

Summary: Save POSTs to /api/annotations/annotations, not the single-prefix path. Traces to: AC-05 Profile: fast and e2e

Preconditions: user is editing an annotation in <AnnotationsPage>.

Input data: click Save — results_report.md row 22.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger Save	exactly one POST observed
2	Inspect URL	matches ^/api/annotations/annotations$

Expected outcome: row 22. Max execution time: 3s. Expected result source: results_report.md row 22.

---

FT-P-08: Annotation save body contains all required fields

Summary: Save body has {Source, WaypointId, videoTime, mediaId, detections, status} and NOT the legacy time key. Traces to: AC-05 Profile: fast

Preconditions: an annotation with all spec-required fields present in the editor state.

Input data: click Save — results_report.md row 23.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger Save with Source=AI, a WaypointId, a videoTime	POST observed
2	Inspect body keys	{Source, WaypointId, videoTime, mediaId, detections, status} ⊆ keys; time absent

Expected outcome: row 23. Max execution time: 3s. Expected result source: results_report.md row 23.

---

FT-P-09: Annotation-status SSE opens on <AnnotationsPage> mount

Traces to: AC-09 Profile: fast (EventSource test double) and e2e

Input data: mount /annotations — results_report.md row 24.

Steps:

Step	Consumer Action	Expected System Response
1	Mount /annotations	exactly one EventSource constructed
2	Inspect URL	matches `^/api/annotations/annotations/events(?

Expected outcome: row 24. Max execution time: 3s. Expected result source: results_report.md row 24.

---

FT-P-10: Annotation-status SSE closes on unmount

Traces to: AC-09 Profile: fast

Preconditions: continuation of FT-P-09.

Input data: unmount /annotations — results_report.md row 25.

Steps:

Step	Consumer Action	Expected System Response
1	Unmount the route	EventSource.readyState → CLOSED (2) within 1 s

Expected outcome: row 25 (CLOSED within ≤ 1 000 ms). Max execution time: 3s. Expected result source: results_report.md row 25.

---

FT-P-11: Sync image detect endpoint

Traces to: AC-25 (sync path) Profile: fast and e2e

Input data: click Detect on a MediaType.Image — results_report.md row 26.

Steps:

Step	Consumer Action	Expected System Response
1	Open <AnnotationsSidebar> on an image; click Detect	exactly one POST observed
2	Inspect URL	matches ^/api/detect/[0-9]+$

Expected outcome: row 26. Max execution time: 30s (server-side detect time included). Expected result source: results_report.md row 26.

---

FT-P-12: Async video detect endpoint + SSE (target — Phase B)

Traces to: AC-25 (async path) Profile: fast (mocked) — quarantined until F7 lands Status: target — UI does not implement async video detect today (04_verification_log.md F7). Test is written so it activates the day the feature ships.

Input data: click Detect on a MediaType.Video (behind feature flag) — results_report.md row 27.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger detect on a video	one POST ^/api/detect/video/[0-9]+$
2	Inspect response	JSON {jobId: <int>}
3	Wait	EventSource opens to `^/api/detect/stream/[0-9]+(?

Expected outcome: row 27 (3 assertions). Max execution time: 10s. Expected result source: results_report.md row 27.

---

FT-P-13: Long-video detect carries X-Refresh-Token header

Traces to: AC-25 Profile: fast — quarantined until F7 lands (and the header is added per Step 4) Status: target.

Input data: long-video async detect — results_report.md row 28.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger long-video detect	request headers observed
2	Inspect headers	X-Refresh-Token present and non-empty

Expected outcome: row 28. Max execution time: 5s. Expected result source: results_report.md row 28.

---

FT-P-14: Overlay membership at the lower in-window edge

Summary: An annotation at videoTime = T - 30 ms (inside [-50, +150] window around T) renders. Traces to: AC-28 Profile: fast (component test on <CanvasEditor>)

Input data: currentTime = T, annotation at T - 30 ms — results_report.md row 29.

Steps:

Step	Consumer Action	Expected System Response
1	Render <CanvasEditor> with the annotation and set currentTime = T	overlay rect rendered

Expected outcome: row 29 (range check). Max execution time: 1s. Expected result source: results_report.md row 29.

---

FT-P-15: Overlay membership at the upper in-window edge

Summary: An annotation at videoTime = T + 120 ms renders. Traces to: AC-28 Profile: fast

Input data: currentTime = T, annotation at T + 120 ms — derived from results_report.md row 29.

Steps:

Step	Consumer Action	Expected System Response
1	Render <CanvasEditor> with the annotation and currentTime = T	overlay rendered

Expected outcome: present. Max execution time: 1s. Expected result source: results_report.md row 29.

---

FT-P-16: Flight selection persists via PUT /api/annotations/settings/user

Traces to: AC-06 Profile: fast

Input data: FlightContext.selectFlight(<id>) — results_report.md row 32.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger selectFlight for a known flight id	exactly one PUT observed
2	Inspect URL	matches ^/api/annotations/settings/user$
3	Inspect body	{selectedFlightId: <id>} (subset)
4	Code-search the test domain	NO call to /api/flights/select

Expected outcome: row 32. Max execution time: 3s. Expected result source: results_report.md row 32.

---

FT-P-17: Selected-flight rehydration on boot

Traces to: AC-06 Profile: e2e (and fast with stubbed UserSettings)

Preconditions: UserSettings.selectedFlightId known in seed.

Input data: full reload — results_report.md row 33.

Steps:

Step	Consumer Action	Expected System Response
1	Hard reload as the seeded user	app boots
2	Inspect FlightContext state via DOM (selected flight indicator)	matches UserSettings.selectedFlightId

Expected outcome: row 33. Max execution time: 10s. Expected result source: results_report.md row 33.

---

FT-P-18: Live-GPS SSE opens within 5 s of flight select

Traces to: AC-08 Profile: e2e (uses flights/ live-gps simulator)

Input data: select a flight — results_report.md row 34.

Steps:

Step	Consumer Action	Expected System Response
1	Select a flight in <Header>	EventSource opens
2	Inspect URL	matches `^/api/flights/[0-9]+/live-gps(?
3	Wait	readyState === OPEN (1) within ≤ 5 000 ms

Expected outcome: row 34. Max execution time: 10s. Expected result source: results_report.md row 34.

---

FT-P-19: Live-GPS SSE closes within 1 s of deselect

Traces to: AC-08 Profile: e2e

Input data: deselect — results_report.md row 35.

Steps:

Step	Consumer Action	Expected System Response
1	Deselect the flight	EventSource state transitions
2	Inspect	all ^/api/flights/[0-9]+/live-gps sources CLOSED (2) within ≤ 1 000 ms

Expected outcome: row 35. Max execution time: 5s. Expected result source: results_report.md row 35.

---

FT-P-20: Bulk-validate request URL and body

Traces to: AC-07 Profile: fast and e2e

Input data: select N items, click Validate — results_report.md row 36.

Steps:

Step	Consumer Action	Expected System Response
1	Select N items on <DatasetPage>	selection state observable
2	Click Validate	one POST observed
3	Inspect URL + body	/api/annotations/dataset/bulk-status; body {ids: <length-N>, targetStatus: 30}

Expected outcome: row 36 (targetStatus: 30 after AC-04 fix). Max execution time: 5s. Expected result source: results_report.md row 36.

---

FT-P-21: Bulk-validate UI reflects new status within 2 s

Traces to: AC-07 Profile: fast

Preconditions: continuation of FT-P-20.

Input data: server returns 200 — results_report.md row 37.

Steps:

Step	Consumer Action	Expected System Response
1	Stub a 200 response	UI updates
2	Inspect each selected row within ≤ 2 000 ms	status badge reads Validated

Expected outcome: row 37. Max execution time: 5s. Expected result source: results_report.md row 37.

---

FT-P-22: i18n key parity en ↔ ua

Traces to: AC-12 Profile: static

Input data: src/i18n/en.json, src/i18n/ua.json — results_report.md row 45.

Steps:

Step	Consumer Action	Expected System Response
1	Read both files	parsed
2	Compute deep, sorted key sets	set_equals

Expected outcome: row 45. Max execution time: 1s. Expected result source: results_report.md row 45.

---

FT-P-23: No raw user-visible strings outside t(...)

Traces to: AC-12 Profile: static (lint rule)

Input data: lint over src/**/*.tsx — results_report.md row 46.

Steps:

Step	Consumer Action	Expected System Response
1	Run the lint rule	reports 0 findings
2	Allow-list applies to proper-noun acronyms only	allow-list respected

Expected outcome: row 46. Max execution time: 30s. Expected result source: results_report.md row 46.

---

FT-P-24: i18n detector path used at first boot

Traces to: AC-13 Profile: fast — quarantined until the detector is added in Step 4

Input data: first boot in a clean profile — results_report.md row 47.

Steps:

Step	Consumer Action	Expected System Response
1	Mount the app with a profile providing Accept-Language: uk	i18next initialises
2	Inspect i18next.language	resolves from detector (not hardcoded 'en')
3	Static read src/i18n/i18n.ts	no lng: 'en' hardcoded init present

Expected outcome: row 47. Max execution time: 3s. Expected result source: results_report.md row 47.

---

FT-P-25: i18n persistence across reload

Traces to: AC-13 Profile: e2e — quarantined until the detector + persistence land

Input data: toggle language, reload — results_report.md row 48.

Steps:

Step	Consumer Action	Expected System Response
1	Click language toggle in <Header> to uk	UI re-renders in Ukrainian
2	Hard reload	app boots
3	Inspect i18next.language	equals uk

Expected outcome: row 48. Max execution time: 10s. Expected result source: results_report.md row 48.

---

FT-P-26: Class-delete with confirmation — happy path

Traces to: AC-14, AC-30 Profile: fast

Input data: click Delete on a class entry in <AdminPage> and Confirm — results_report.md row 49.

Steps:

Step	Consumer Action	Expected System Response
1	Click Delete	<ConfirmDialog> mounts
2	Click Confirm	exactly one DELETE observed
3	Inspect URL	matches ^/api/admin/classes/[0-9]+$

Expected outcome: row 49 (confirm path). Max execution time: 5s. Expected result source: results_report.md row 49.

---

FT-P-27: Destructive policy — dialog before request for every destructive surface

Traces to: AC-14 Profile: fast

Input data: each destructive surface listed in _docs/ui_design/ (class delete, user deactivate, dataset bulk-overwrite, irreversible bulk) — results_report.md row 51.

Steps:

Step	Consumer Action	Expected System Response
1	For each surface, trigger the destructive action	<ConfirmDialog> opens BEFORE any HTTP fires
2	Inspect request log up to dialog open	empty for the destructive route

Expected outcome: row 51. Max execution time: 10s. Expected result source: results_report.md row 51.

---

FT-P-28: ConfirmDialog has dialog + modal a11y attributes

Traces to: AC-15 Profile: fast

Input data: render <ConfirmDialog open> — results_report.md row 52.

Steps:

Step	Consumer Action	Expected System Response
1	Open the dialog	root element rendered
2	Inspect root attributes	role="dialog" and aria-modal="true"

Expected outcome: row 52. Max execution time: 1s. Expected result source: results_report.md row 52.

---

FT-P-29: ConfirmDialog focus trap (Tab cycles inside)

Traces to: AC-15 Profile: fast

Input data: open dialog and Tab through — results_report.md row 53.

Steps:

Step	Consumer Action	Expected System Response
1	Open dialog; focus on first focusable element	initial focus inside dialog
2	Tab repeatedly	focus stays inside the dialog subtree; first ↔ last cycles

Expected outcome: row 53. Max execution time: 3s. Expected result source: results_report.md row 53.

---

FT-P-30: Header flight dropdown closed-state a11y

Traces to: AC-16 Profile: fast

Input data: render <Header> with dropdown closed — results_report.md row 55.

Steps:

Step	Consumer Action	Expected System Response
1	Mount Header	dropdown trigger rendered
2	Inspect attributes	role="combobox", aria-expanded="false", aria-haspopup="listbox"

Expected outcome: row 55. Max execution time: 1s. Expected result source: results_report.md row 55.

---

FT-P-31: Header flight dropdown open-state a11y

Traces to: AC-16 Profile: fast

Input data: open the dropdown — results_report.md row 56.

Steps:

Step	Consumer Action	Expected System Response
1	Click trigger	dropdown opens
2	Inspect	aria-expanded="true"; outside-click handler attached (was NOT attached while closed — observable via DOM event listener count or via behavior under a synthetic outside-click while closed: no-op)

Expected outcome: row 56. Max execution time: 3s. Expected result source: results_report.md row 56.

---

FT-P-32: ProtectedRoute spinner a11y

Traces to: AC-17 Profile: fast

Input data: render <ProtectedRoute> in loading state — results_report.md row 58.

Steps:

Step	Consumer Action	Expected System Response
1	Mount in loading state	spinner rendered
2	Inspect	role="status" + non-empty accessible label

Expected outcome: row 58. Max execution time: 1s. Expected result source: results_report.md row 58.

---

FT-P-33: ProtectedRoute timeout fallback after 10 s

Traces to: AC-17 Profile: fast (with fake timers)

Input data: loading exceeds the timeout — results_report.md row 59.

Steps:

Step	Consumer Action	Expected System Response
1	Mount loading; advance fake time to 10 s	timer fires
2	Inspect DOM	fallback (retry CTA or error message) present; spinner unmounted

Expected outcome: row 59. Max execution time: 3s. Expected result source: results_report.md row 59.

---

FT-P-34: Browser-support smoke (Chromium + Firefox)

Traces to: AC-18 Profile: e2e (manual smoke per AC — no enforcement today)

Input data: render /flights, /annotations, /dataset on each supported browser — results_report.md row 60.

Steps:

Step	Consumer Action	Expected System Response
1	Navigate to each route	page renders
2	Inspect console + DOM landmarks	no console errors; main landmark roles present

Expected outcome: row 60. Max execution time: 30s per browser. Expected result source: results_report.md row 60.

---

FT-P-35: Mobile bottom-nav variant at 480 px

Traces to: AC-19 Profile: e2e

Input data: render at viewport 480×800 — results_report.md row 61.

Steps:

Step	Consumer Action	Expected System Response
1	Resize browser to 480×800	layout reflows
2	Inspect DOM	bottom-nav variant present; top-bar variant absent

Expected outcome: row 61. Max execution time: 5s. Expected result source: results_report.md row 61.

---

FT-P-36: Desktop top-bar variant at 1024 px

Traces to: AC-19 Profile: e2e

Input data: render at viewport 1024×768 — results_report.md row 62.

Steps:

Step	Consumer Action	Expected System Response
1	Resize to 1024×768	reflow
2	Inspect DOM	top-bar present; bottom-nav absent

Expected outcome: row 62. Max execution time: 5s. Expected result source: results_report.md row 62.

---

FT-P-37: Panel-width persistence — debounced PUT on resize end

Traces to: AC-21 Profile: fast — quarantined until useResizablePanel writes back (Step 4)

Input data: drag divider — results_report.md row 64.

Steps:

Step	Consumer Action	Expected System Response
1	Simulate drag-end on a useResizablePanel divider	PUT observed within 1 s (debounce-aware)
2	Inspect URL + body	matches /api/annotations/settings/user; body contains panelWidths key

Expected outcome: row 64. Max execution time: 5s. Expected result source: results_report.md row 64.

---

FT-P-38: Panel-width rehydration on reload

Traces to: AC-21 Profile: e2e — quarantined until Step 4

Input data: reload after resize — results_report.md row 65.

Steps:

Step	Consumer Action	Expected System Response
1	Resize panels; capture widths W	widths observable
2	Reload	app boots
3	Re-measure	widths equal W within ± 1 px

Expected outcome: row 65. Max execution time: 15s. Expected result source: results_report.md row 65.

---

FT-P-39: Manual bounding-box draw on <CanvasEditor>

Traces to: AC-35 Profile: fast (synthetic pointer events)

Input data: mousedown(x1,y1) → mousemove(x2,y2) → mouseup with selectedClassNum = C, photoMode = P — results_report.md row 73.

Steps:

Step	Consumer Action	Expected System Response
1	Fire pointer sequence on the canvas	one new local detection appended
2	Inspect detection	classNum == C + P; x,y,w,h normalised within ± 1 px of the drawn rect

Expected outcome: row 73. Max execution time: 1s. Expected result source: results_report.md row 73.

---

FT-P-40: 8-handle bbox resize

Traces to: AC-36 (a) Profile: fast

Input data: drag each of the 8 handles in turn — results_report.md row 74.

Steps:

Step	Consumer Action	Expected System Response
1	For h ∈ {NW,N,NE,W,E,SW,S,SE}: mousedown on h, drag (dx,dy), mouseup	bbox edges adjacent to h move; opposite edges unchanged
2	Force the drag past zero size	resulting bbox has w>0 and h>0 (clamped)

Expected outcome: row 74. Max execution time: 5s. Expected result source: results_report.md row 74.

---

FT-P-41: Ctrl+click multi-select on canvas

Traces to: AC-36 (b) Profile: fast

Input data: Ctrl+click an unselected bbox; second Ctrl+click on the same — results_report.md row 75.

Steps:

Step	Consumer Action	Expected System Response
1	Have one bbox already selected	initial selection = {A}
2	Ctrl+click bbox B	selection set = {A, B}; prior selection preserved
3	Ctrl+click bbox B again	selection set = {A} (toggle off)

Expected outcome: row 75. Max execution time: 1s. Expected result source: results_report.md row 75.

---

FT-P-42: Ctrl+wheel zoom-around-cursor

Traces to: AC-36 (c) Profile: fast

Input data: Ctrl+wheel at (cx, cy) — results_report.md row 76.

Steps:

Step	Consumer Action	Expected System Response
1	Record the world coordinate at (cx, cy) before zoom	W₀
2	Dispatch Ctrl+wheel	zoom level changes
3	Inverse-map (cx, cy) → world coordinate after zoom	equals W₀ within ± 1 viewport px

Expected outcome: row 76. Max execution time: 1s. Expected result source: results_report.md row 76.

---

FT-P-43: Ctrl+drag pan on empty canvas

Traces to: AC-36 (d) Profile: fast

Input data: Ctrl+drag on empty area — results_report.md row 77.

Steps:

Step	Consumer Action	Expected System Response
1	Ctrl+drag from (x1,y1) by (dx,dy)	viewport origin translates by (-dx,-dy) within ± 1 px
2	Inspect bbox state	no bbox created or modified

Expected outcome: row 77. Max execution time: 1s. Expected result source: results_report.md row 77.

---

FT-P-44: DetectionClasses loads from /api/annotations/classes

Traces to: AC-37 (load path) Profile: fast

Input data: mount with a successful response of N classes — results_report.md row 78.

Steps:

Step	Consumer Action	Expected System Response
1	Mount <DetectionClasses>	GET observed
2	Inspect rendered entries	N entries; active-mode filter applied; no fallback indicator

Expected outcome: row 78. Max execution time: 3s. Expected result source: results_report.md row 78.

---

FT-P-45: Class hotkey 1–9 selects classes[(key-1) + P]

Traces to: AC-37 (hotkey path) Profile: fast (synthetic keydown on window)

Input data: keys '1'..'9', photoMode = P, classes mode-ordered — results_report.md row 79.

Steps:

Step	Consumer Action	Expected System Response
1	For each key k ∈ {1..9}: dispatch keydown	onSelect fires once
2	Inspect arg	class.id == classes[(k-1) + P].id
3	Inspect rendered list element	label index i+1 equals k

Expected outcome: row 79. Max execution time: 3s. Expected result source: results_report.md row 79.

---

FT-P-46: Class click path

Traces to: AC-37 (click path) Profile: fast

Input data: click a class entry — results_report.md row 80.

Steps:

Step	Consumer Action	Expected System Response
1	Click entry for class C	onSelect fires once with C.id

Expected outcome: row 80. Max execution time: 1s. Expected result source: results_report.md row 80.

---

FT-P-47: Fallback class list on API empty/5xx

Traces to: AC-37 (fallback) Profile: fast

Input data: GET /api/annotations/classes returns [] (or 5xx) — results_report.md row 81.

Steps:

Step	Consumer Action	Expected System Response
1	Stub empty response	fallback list rendered
2	Inspect rendered IDs	FALLBACK_CLASS_NAMES × 3 PhotoMode offsets (set equals [0..N-1, 20..20+N-1, 40..40+N-1])

Expected outcome: row 81. Max execution time: 3s. Expected result source: results_report.md row 81.

---

FT-P-48: PhotoMode switch — mode set + filter

Traces to: AC-38 (mode set + filter) Profile: fast

Input data: click Winter while photoMode = 0 — results_report.md row 82.

Steps:

Step	Consumer Action	Expected System Response
1	Click Winter	onPhotoModeChange(20) fires once
2	Inspect rendered class list	filtered to entries with photoMode == 20

Expected outcome: row 82. Max execution time: 1s. Expected result source: results_report.md row 82.

---

FT-P-49: PhotoMode auto-select when prior class no longer valid

Traces to: AC-38 (auto-select) Profile: fast

Input data: switch mode where previously selected class is not in the new filtered set — results_report.md row 83.

Steps:

Step	Consumer Action	Expected System Response
1	Pre-select a Regular class	initial state
2	Switch to Night (photoMode = 40)	onSelect fires once with modeClasses[0].id

Expected outcome: row 83. Max execution time: 1s. Expected result source: results_report.md row 83.

---

FT-P-50: yoloId on the wire — classNum == classId + photoModeOffset

Traces to: AC-38 (wire) Profile: fast

Input data: save annotation after drawing with C, P — results_report.md row 84.

Steps:

Step	Consumer Action	Expected System Response
1	Draw a bbox with selectedClassNum = C, photoMode = P	local detection appended
2	Save	POST observed
3	Inspect new detection in body	classNum == C + P

Expected outcome: row 84. Max execution time: 3s. Expected result source: results_report.md row 84.

---

FT-P-51: Tile-split endpoint contract

Traces to: AC-39 (endpoint) Profile: fast — quarantined until the split action surfaces on the dataset page

Input data: click Split tile on a dataset item — results_report.md row 85.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger Split tile	one POST observed
2	Inspect URL + status	^/api/annotations/dataset/[0-9]+/split$; 200 JSON

Expected outcome: row 85. Max execution time: 5s. Expected result source: results_report.md row 85.

---

FT-P-52: YOLO label parser — happy path

Traces to: AC-39 (parser happy) Profile: fast

Input data: isSplit: true, splitTile: "3 0.5 0.5 0.2 0.2" — results_report.md row 86.

Steps:

Step	Consumer Action	Expected System Response
1	Pass the item through the parser/render path	no exception
2	Inspect parsed result	{classNum:3, cx:0.5, cy:0.5, w:0.2, h:0.2}

Expected outcome: row 86. Max execution time: 1s. Expected result source: results_report.md row 86.

---

FT-P-53: DatasetItem.isSplit is honored on the dataset list path

Traces to: AC-39 (dataset list) Profile: fast

Input data: GET /api/annotations/dataset response contains isSplit: true — results_report.md row 88.

Steps:

Step	Consumer Action	Expected System Response
1	Stub the response	render no crash
2	Inspect that the field is read into the item state (DOM marker present for split items)	field present

Expected outcome: row 88. Max execution time: 3s. Expected result source: results_report.md row 88.

---

FT-P-54: Tile auto-zoom viewport matches tile rect

Traces to: AC-40 (viewport) Profile: fast — quarantined (UX missing today)

Input data: open a splitTile-bearing annotation — results_report.md row 89.

Steps:

Step	Consumer Action	Expected System Response
1	Double-click the annotation in <AnnotationsSidebar>	<CanvasEditor> opens to that annotation
2	Inspect viewport rect	equals tile rect within ± 1 px per edge

Expected outcome: row 89. Max execution time: 5s. Expected result source: results_report.md row 89.

---

FT-P-55: Tile-zoom indicator visible while active

Traces to: AC-40 (indicator) Profile: fast — quarantined

Input data: tile zoom active → cleared — results_report.md row 90.

Steps:

Step	Consumer Action	Expected System Response
1	Activate tile zoom	indicator icon/badge present in canvas chrome
2	Clear tile zoom	indicator removed

Expected outcome: row 90. Max execution time: 3s. Expected result source: results_report.md row 90.

---

Negative Scenarios

FT-N-01: Overlay annotation below the lower bound is NOT rendered

Summary: At currentTime = T, an annotation at T - 60 ms (outside [-50, +150] ms) is excluded. Traces to: AC-28 Profile: fast

Input data: currentTime = T, annotation at T - 60 ms — results_report.md row 30.

Steps:

Step	Consumer Action	Expected System Response
1	Render with the off-window annotation	overlay NOT rendered

Expected outcome: row 30 (absent). Max execution time: 1s. Expected result source: results_report.md row 30.

---

FT-N-02: Overlay annotation above the upper bound is NOT rendered

Traces to: AC-28 Profile: fast

Input data: currentTime = T, annotation at T + 160 ms — results_report.md row 31.

Steps:

Step	Consumer Action	Expected System Response
1	Render	overlay NOT rendered

Expected outcome: row 31. Max execution time: 1s. Expected result source: results_report.md row 31.

---

FT-N-03: Authenticated non-admin navigating to /admin is redirected to /flights

Traces to: AC-22 Profile: e2e — quarantined until role-gate is added (Step 4 / Step 8)

Input data: log in as op_alice (Operator) → navigate /admin — results_report.md row 08.

Steps:

Step	Consumer Action	Expected System Response
1	Authenticate as Operator	session active
2	Navigate to /admin	redirect
3	Inspect final URL + tree	URL is /flights; <AdminPage> NOT mounted

Expected outcome: row 08. Max execution time: 10s. Expected result source: results_report.md row 08.

---

FT-N-04: Unauthenticated user navigating to /admin is redirected to /login

Traces to: AC-22 Profile: e2e

Input data: no session → navigate /admin — results_report.md row 09.

Steps:

Step	Consumer Action	Expected System Response
1	Clear cookies and bearer	unauthenticated
2	Navigate to /admin	redirect
3	Inspect final URL	/login

Expected outcome: row 09. Max execution time: 10s. Expected result source: results_report.md row 09.

---

FT-N-05: Authenticated user without SETTINGS permission navigating to /settings

Traces to: AC-22 Profile: e2e — quarantined

Input data: op_bob (no SETTINGS) → /settings — results_report.md row 10.

Steps:

Step	Consumer Action	Expected System Response
1	Authenticate as op_bob	session active
2	Navigate to /settings	redirect
3	Inspect final URL + tree	/flights; <SettingsPage> NOT mounted

Expected outcome: row 10. Max execution time: 10s. Expected result source: results_report.md row 10.

---

FT-N-06: Upload of 501 MB file surfaces a user-visible 413 error

Traces to: AC-10 Profile: e2e

Input data: 501 MB synthetic file via dropzone — results_report.md row 39.

Steps:

Step	Consumer Action	Expected System Response
1	Drop 501 MB onto <MediaList>	upload request issued
2	nginx returns 413	rejected upstream
3	Inspect UI	user-visible error containing the i18n "file too large" string; NO alert()

Expected outcome: row 39. Max execution time: 30s. Expected result source: results_report.md row 39.

---

FT-N-07: Class-delete Cancel path — NO DELETE request issued

Traces to: AC-14, AC-30 Profile: fast

Input data: click Delete → click Cancel — derived from results_report.md row 49.

Steps:

Step	Consumer Action	Expected System Response
1	Click Delete	<ConfirmDialog> mounts
2	Click Cancel	dialog unmounts
3	Inspect network log	zero DELETE requests fired

Expected outcome: cancel branch of row 49. Max execution time: 3s. Expected result source: results_report.md row 49.

---

FT-N-08: Escape on <ConfirmDialog> cancels — no destructive request

Traces to: AC-15 Profile: fast

Input data: open dialog → press Escape — results_report.md row 54.

Steps:

Step	Consumer Action	Expected System Response
1	Open dialog	mounted
2	Dispatch keydown Escape	dialog unmounts; cancel callback fires exactly once
3	Inspect network log	no destructive HTTP fired

Expected outcome: row 54. Max execution time: 1s. Expected result source: results_report.md row 54.

---

FT-N-09: Header dropdown Escape — close + handler detached

Traces to: AC-16 Profile: fast

Input data: open dropdown → press Escape — results_report.md row 57.

Steps:

Step	Consumer Action	Expected System Response
1	Open dropdown	open
2	Dispatch Escape	dropdown closes
3	Inspect attributes	aria-expanded="false"; outside-click handler detached

Expected outcome: row 57. Max execution time: 1s. Expected result source: results_report.md row 57.

---

FT-N-10: Malformed YOLO label surfaces a user-visible error (no silent swallow, no NaN render)

Traces to: AC-39 Profile: fast

Input data: isSplit: true, splitTile: "garbage" — results_report.md row 87.

Steps:

Step	Consumer Action	Expected System Response
1	Stub the item; render	parse attempted
2	Inspect UI	error toast / inline error present
3	Inspect rendered overlay	no NaN values, no tile region rendered

Expected outcome: row 87. Max execution time: 3s. Expected result source: results_report.md row 87.

---

FT-N-11: Numeric field with empty input — no silent zero

Traces to: AC-26 Profile: fast — quarantined until form hygiene fix (Step 4)

Input data: clear a 09_settings numeric input and submit — results_report.md row 66.

Steps:

Step	Consumer Action	Expected System Response
1	Clear the field	form state observed
2	Click Save	form blocks save
3	Inspect network log	no PUT fires
4	Inspect DOM	submit disabled OR explicit validation error rendered

Expected outcome: row 66. Max execution time: 3s. Expected result source: results_report.md row 66.

---

FT-N-12: Numeric field with non-numeric input — rejected

Traces to: AC-26 Profile: fast — quarantined

Input data: type "abc" and submit — results_report.md row 67.

Steps:

Step	Consumer Action	Expected System Response
1	Type non-numeric value	state updates
2	Click Save	rejected
3	Inspect	validation error rendered; no PUT

Expected outcome: row 67. Max execution time: 3s. Expected result source: results_report.md row 67.

---

FT-N-13: Settings save with 500 response — saving flag reset; error surfaced

Traces to: AC-27 Profile: fast — quarantined until try/finally fix (Step 4)

Input data: upstream PUT returns 500 — results_report.md row 68.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger save	request issued
2	Stub responds 500 within 2 s	failure handled
3	Inspect within ≤ 2 000 ms	toast / inline error present; saving === false; no navigation away

Expected outcome: row 68. Max execution time: 5s. Expected result source: results_report.md row 68.

---

FT-N-14: Settings save with network failure — try/finally state reset

Traces to: AC-27 Profile: fast — quarantined

Input data: PUT throws (network drop) — results_report.md row 69.

Steps:

Step	Consumer Action	Expected System Response
1	Trigger save	request issued
2	Stub throws	rejection handled
3	Inspect	saving === false; user-visible error present

Expected outcome: row 69. Max execution time: 5s. Expected result source: results_report.md row 69.

---

FT-N-15: MediaType magic-literal / magic-string hygiene

Traces to: AC-29 Profile: static

Input data: regex sweep of src/ for mediaType\s*[!=]==?\s*[0-9] and mediaType\s*[!=]==?\s*['"] — results_report.md rows 20, 21.

Steps:

Step	Consumer Action	Expected System Response
1	Run the two regexes	results captured
2	Inspect	match_count == 0 for both

Expected outcome: rows 20, 21. Max execution time: 5s. Expected result source: results_report.md rows 20, 21.

---

Notes carried into Phase 3

• All tests tagged quarantined correspond to features either pending a Step 4 fix (e.g., AC-13 i18n detector, AC-21 panel persistence, AC-22 role-gate, AC-26/27 form hygiene, AC-39 split surface, AC-40 tile zoom) or pending Phase B implementation (AC-11 bundle gate, AC-24 SSE refresh, AC-25 async video, AC-40 tile zoom). The test is written so it activates the day the implementation lands; Phase 3 will surface them for downgrade or accept.
• FT-P-13 / FT-P-14 / FT-P-37 / FT-P-38 / FT-P-51 / FT-P-54 / FT-P-55 / FT-N-03 / FT-N-05 / FT-N-11 / FT-N-12 / FT-N-13 / FT-N-14 are all on the quarantine list above.
• Tests that depend on the enum-spec numeric snapshot (AC-04 rows 15-17) are blocked on populating enum_spec_snapshot.json from the suite spec — Phase 3 surfaces this as the blocking input.
• AC-37 row 79 depends on backend ordering returning [0..N-1, 20..20+N-1, 40..40+N-1]. If the seed reveals otherwise, this test fails — fix can land either side per data_parameters.md.