102 lines
4.9 KiB
Markdown
102 lines
4.9 KiB
Markdown
# 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:
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
|
|
```json
|
|
{
|
|
"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.
|