Add header comments to the source files

Every source file in ui, app, game, formats, cli, audio and launch that had none
now starts with a short English comment: what it implements, what state it owns
and how it relates to its neighbours (request/acknowledge flow, pairs of files,
random generator use). Comment lines only; the full build and the runnable
tests are unchanged.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
ClaudeandClaude Sonnet 5.5 committed 2026-11-06 09:15:23 +01:00
1 parent aa6ec96305
commit 287b5a9251
324 files changed
+1186

No files matched your search

+12
View File
@@ -1,4 +1,16 @@
// SPDX-License-Identifier: GPL-3.0-only
// Implementation of CareerSession (career_session.hpp): the engine side of the career. It
// owns the GameState, the two random generators, the turn driver and every "owner" of an
// open modal window (transfer editor, league table, bank, contracts, ...), and it is the
// only code the UI flow reaches into for game logic, through the controller.
// Request/acknowledge model: the UI sends a typed request that carries the revision it
// observed; the session checks that revision, applies the change (or rejects it with an
// error text), bumps the revision only when something changed and returns a projection or
// dispatch result. The front end then acknowledges that result (controller.cpp and the
// *Actions facades roll the session back if the acknowledgement fails). Live match events and
// notices flow the other way: the session calls presenter hooks synchronously and waits.
// This file also contains the checkpoint/restore code used by those rollbacks, the career
// start (options, manager join), save/load through the .FBM container and autosave.
#include "formats/native_save_version.hpp"
#include "formats/badge_policy.hpp"
#include "game/calendar.hpp"