Files
Dreierpack-Manager/docs/new_ui/desktop/post-match/PROVIDER.md
T

4.9 KiB

Native post-match provider (by Codex)

The Modern UI can review its existing finite live recording through demo_post_match.hpp. This is a read-only presentation component, not a match engine, season driver or authoritative match report.

make_demo_post_match(fixture, completed_sequence) accepts only a validated openbmh-live-fixture@1 with source=ui-demo-fixture, its last sequence, a finished final phase and the recorded full duration. The explicit sequence acknowledges that the UI has reached the end of that recording. It cannot prove that an engine match finished. Existing nine-frame recordings, their outcomes, event IDs and owner IDs are unchanged.

The resulting openbmh-post-match@1 review retains fixture_id, source_revision, completed_sequence, world, date, role, surface, duration and the original owner views. Match rows retain their original identities, teams, owners and competition. Each adds:

  • final: the exact final recorded match snapshot, including score, chances, yellow/red cards, player counts and declared standings;
  • events: only that match's original events;
  • attendance: null, attendance_reason: "not_recorded".

Club/outdoor review tabs are results, report, eleven, overview, table. National/outdoor and club/indoor have only results, report, overview. Durations remain 90/40 and active-player counts remain 11/6. National owners retain the existing explicit POC club-roster basis; this does not create a national selection or caps history.

overview sums final goals, chances and cards over the unique recorded human matches, never once per human manager. Its scope=recorded_human_matches distinguishes it from a whole-league matchday. Additional league fixtures and crowds are not present in this native recording. tables deduplicates equal existing final standings snapshots and retains their rows unchanged. Wins, draws and losses are unknown; no season-ranking formula is introduced here. eleven={available:false,reason:"not_recorded",rows:[]} explicitly reports the missing nominations instead of deriving match ratings from catalogue strength.

For example, two recorded 2:1 matches shared by four human managers produce:

{
  "overview": {
    "games": 2, "goals": 6, "chances": 28, "yellow": 2, "red": 0,
    "attendance": null, "attendance_reason": "not_recorded",
    "scope": "recorded_human_matches"
  },
  "eleven": {"available": false, "reason": "not_recorded", "rows": []}
}

Report seeking

query_demo_post_match(fixture, request) takes that same retained live fixture, not the review DTO. A report request is:

{
  "kind": "report", "completed_sequence": 8,
  "fixture_id": "the-original-fixture-id", "revision": 1,
  "match_id": "the-original-match-id", "minute": 61
}

completed_sequence is required. Optional fixture_id and revision must match the recording. A report's match_id defaults to the first original match; minute defaults to full duration. Both are local presentation choices. The report returns home, away, match, final, final_score, cursor minute, recorded_minute, sequence, phase, score, chances, yellow, red, players, standings, past events and complete timeline.

Seeking picks the last existing frame at or before the cursor. In this recording a seek to minute 61 therefore shows the recorded 46-minute 1:0; minute 62 shows its recorded 1:1. No intermediate goal, assist, possession percentage or ball time is calculated. Future timeline markers remain available for the view to draw dimmed. Events retain their original fields; they do not contain a known player actor. Report-level actor, assists, ratings and playing_minutes are null.

kind="review" returns the complete review and rejects report-only fields. Malformed queries, incomplete sequences, stale revisions/fixture IDs, foreign match IDs and out-of-range minutes produce explicit ok:false,error values.

Source boundary and ownership

DataSource::read_post_match defaults to post_match_unavailable. A later authoritative adapter must independently confirm its actual completed state. DemoSource explicitly binds its read to the current fixture and requires both revision and fixture_id; a changed source rejects a stale read. The view can still review its retained immutable completed recording through the pure API, without rebinding old facts to another current team/person.

Reads never call apply, change revision/dirty state, create a match or save a review into a career checkpoint. View-local tab, selected manager, match, report minute and playback state must not modify the live recording cursor, owner selection, intervention drafts or career owner.

modern_post_match_ui_tests uses a synthetic catalogue to check unique matches, exact final values, seek boundaries, 5/3 tabs, missing facts, stale/invalid requests, retained identities and source/checkpoint immutability. Existing modern_live_ui_tests remains unchanged.