Files
Dreierpack-Manager/src/app/desktop_actions.hpp
T
ClaudeandClaude Sonnet 5.5 287b5a9251 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>
2026-11-06 09:15:23 +01:00

208 lines
11 KiB
C++

// SPDX-License-Identifier: GPL-3.0-only
// Application-boundary facades for desk-level windows: one small class per owner (desk
// settings, balance plan, other games, top scorers, opportunities, manager join, mailbox,
// menu layout, environment, reschedule, contracts, friendly matches). Each wraps a
// CareerSession reference; its apply() runs an action under a rollback transaction (see
// action_transaction.hpp), and open()/dispatch() take the UI request plus the shared
// revision counter and an optional "accept" callback that carries the front end's
// acknowledgement. Implemented in desktop_actions.cpp; window_actions.hpp holds the club windows.
#pragma once
#include "app/career_session.hpp"
namespace bmh::app {
class DesktopActions {
public:
static ui::DeskRequest menu(const ui::DeskState& observed, int kind);
};
class DeskSettingsActions {
public:
explicit DeskSettingsActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
using OpenAccept = std::function<void(CareerSession::DeskSettingsProjection&)>;
using Accept = std::function<void(CareerSession::DeskSettingsDispatch&)>;
std::optional<CareerSession::DeskSettingsProjection> open(const ui::DeskRequest&,
uint64_t& revision, std::string& error, const OpenAccept& = {});
std::optional<CareerSession::DeskSettingsDispatch> write(uint64_t owner_sequence,
const ui::SettingsWriteRequest&, uint64_t& revision, std::string& error, const Accept& = {});
std::optional<CareerSession::DeskSettingsDispatch> file(uint64_t owner_sequence,
const ui::SaveLoadRequest&, uint64_t& revision, std::string& error, const Accept& = {});
std::optional<CareerSession::DeskSettingsDispatch> close(uint64_t owner_sequence,
uint64_t owner_revision, const ui::DeskRequest& observed,
uint64_t& revision, std::string& error, const Accept& = {});
bool edit(const ui::SettingsState& observed, int row, int column, ui::SettingsEdit,
uint64_t& revision, std::string& error);
private:
std::optional<CareerSession::DeskSettingsDispatch> dispatch(const CareerSession::DeskSettingsAction&,
uint64_t& revision, std::string& error, const Accept&);
CareerSession& session_;
};
class BalanceActions {
public:
explicit BalanceActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
using OpenAccept = std::function<void(ui::BalanceState&)>;
using Accept = std::function<void(CareerSession::BalanceDispatch&)>;
std::optional<ui::BalanceState> open(const ui::DeskRequest&, uint64_t& revision,
const Image& underlay, std::string& error, const OpenAccept& = {});
std::optional<CareerSession::BalanceDispatch> dispatch(const ui::BalanceRequest&,
uint64_t& revision, std::string& error, const Accept& = {});
BalancePlanDraft open_draft(int manager) const;
void cycle_draft(BalancePlanDraft&) const;
void reset_draft(BalancePlanDraft&) const;
BalanceEditStatus edit_draft(BalancePlanDraft&, int row, int32_t value) const;
bool close_draft(const BalancePlanDraft&, uint64_t& revision);
private:
CareerSession& session_;
};
class OtherGamesActions {
public:
explicit OtherGamesActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
using OpenAccept = std::function<void(ui::OtherGamesState&)>;
using Accept = std::function<void(CareerSession::OtherGamesDispatch&)>;
std::optional<ui::OtherGamesState> open(const ui::DeskRequest&, uint64_t& revision,
const Image& underlay, std::string& error, const OpenAccept& = {});
std::optional<CareerSession::OtherGamesDispatch> dispatch(const ui::OtherGamesRequest&,
uint64_t& revision, std::string& error, const TransferOfferTeamInfoPresenter& = {}, const Accept& = {});
private:
CareerSession& session_;
};
class TopScorersActions {
public:
explicit TopScorersActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
using OpenAccept = std::function<void(ui::TopScorersState&)>;
using Accept = std::function<void(CareerSession::TopScorersDispatch&)>;
std::optional<ui::TopScorersState> open(const ui::DeskRequest&, uint64_t& revision,
const Image& underlay, std::string& error, const OpenAccept& = {});
std::optional<CareerSession::TopScorersDispatch> dispatch(const ui::TopScorersRequest&,
uint64_t& revision, std::string& error, const Accept& = {});
private:
CareerSession& session_;
};
class OpportunitiesActions {
public:
explicit OpportunitiesActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
using OpenAccept = std::function<void(ui::OpportunitiesState&)>;
using Accept = std::function<void(CareerSession::OpportunitiesDispatch&)>;
std::optional<ui::OpportunitiesState> open(const ui::DeskRequest&, uint64_t& revision,
const Image& underlay, std::string& error, bool national_source_case = false,
int stable_identity = -1, const OpenAccept& = {});
std::optional<CareerSession::OpportunitiesDispatch> dispatch(const ui::OpportunitiesRequest&,
uint64_t& revision, std::string& error, const Accept& = {});
bool preference(const ui::AnalyticsRequest&, uint64_t& revision, std::string& error,
const std::function<void()>& acknowledge = {});
static ui::OpportunitiesRequest close_request(const ui::OpportunitiesState& observed);
private:
CareerSession& session_;
};
class ManagerJoinActions {
public:
explicit ManagerJoinActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
bool commit(uint64_t& revision, std::string& error,
const std::function<void(ui::CareerInitializationResult&)>& acknowledge = {});
private:
CareerSession& session_;
};
class MailboxActions {
public:
explicit MailboxActions(CareerSession& session) : session_(session) {}
bool dispatch(const ui::MailboxActionRequest&, uint64_t& revision, std::string& error,
const std::function<void()>& acknowledge = {});
bool close(const ui::MailboxCloseRequest&, uint64_t& revision, std::string& error,
const std::function<void()>& acknowledge = {});
static ui::MailboxActionRequest request(int manager, uint64_t revision,
ui::MailboxActionKind, const ui::MailboxMessage& observed);
private:
CareerSession& session_;
};
class MenuLayoutActions {
public:
explicit MenuLayoutActions(CareerSession& session) : session_(session) {}
bool dispatch(const ui::SaveLoadRequest&, uint64_t& revision, std::string& error,
const std::function<void()>& acknowledge = {});
private:
CareerSession& session_;
};
class EnvironmentActions {
public:
explicit EnvironmentActions(CareerSession& session) : session_(session) {}
using Notice = std::function<bool(const GameState&, const std::string&)>;
std::optional<EnvironmentResult> set(const ui::EnvironmentRequest&, uint64_t& revision, std::string& error,
const Notice& = {}, const std::function<void(bool changed)>& acknowledge = {});
std::optional<EnvironmentResult> set_console(const ui::EnvironmentView&, int item, int level,
uint64_t& revision, std::string& error, const Notice& = {});
static ui::EnvironmentRequest request(const ui::EnvironmentView& observed, int item, int level);
private:
std::optional<EnvironmentResult> set_impl(const ui::EnvironmentRequest&, uint64_t&, std::string&,
const Notice&, const std::function<void(bool)>&, bool publish_console_result);
CareerSession& session_;
};
class RescheduleActions {
public:
explicit RescheduleActions(CareerSession& session) : session_(session) {}
bool apply(uint64_t& revision, const std::function<bool()>& action);
RescheduleStatus dispatch(const ui::RescheduleAction&, uint64_t& revision,
const std::function<void()>& acknowledge = {});
RescheduleStatus move(int manager, const LeagueMatchRef&, int day, uint64_t& revision);
void undo_console(int manager, int day, uint64_t& revision);
private:
static RescheduleStatus change(GameState&, int manager, const LeagueMatchRef&, int day, ui::RescheduleActionKind);
CareerSession& session_;
};
class ContractActions {
public:
explicit ContractActions(CareerSession& session) : session_(session) {}
bool dispatch(const ui::ContractRequest&, uint64_t& revision, ui::ContractActionResult&, std::string& error,
const std::function<void()>& acknowledge = {});
static ui::ContractRequest demands(const ui::ContractsState&, const ui::ContractPlayer&, uint64_t request_id);
static ui::ContractRequest team_bonus(const ui::ContractsState&, int index, uint8_t percent, uint64_t request_id);
static ui::ContractRequest insurance(const ui::ContractsState&, int row, int player, uint64_t quote,
uint8_t form, uint8_t months, uint64_t request_id);
static ui::ContractRequest offer(const ui::ContractsState&, int row, int player, uint64_t quote,
const std::array<uint8_t,7>& bonuses, int years, uint32_t salary,
const std::array<uint32_t,4>& demands, uint64_t request_id);
private:
static ui::ContractRequest bind(const ui::ContractsState&, ui::ContractActionKind, uint64_t request_id);
CareerSession& session_;
};
class FriendlyActions {
public:
explicit FriendlyActions(CareerSession& session) : session_(session) {}
struct Booking { FriendlyBookingResult result; bool applied = false, planner_mismatch = false; };
using Accept = std::function<void(const ui::FriendlyBookingAck&)>;
bool apply(uint64_t& revision, const std::function<bool()>& action);
Booking book_club(const ui::FriendlyMatchRequest&, uint64_t& revision, const Accept& = {});
Booking book_national(const ui::FriendlyMatchRequest&, uint64_t& revision, const Accept& = {});
FriendlyBookingResult book_console(const FriendlyBookingQuote&, uint16_t day, bool accept_opponent,
int consenting_manager, bool accept_cost, int approving_manager, uint64_t& revision);
FriendlyBookingQuote quote(int manager, int opponent, bool home) const;
NationalFriendlyQuote national_quote(const NationalFriendlyOwner&, int opponent, bool home);
FriendlyDateStatus date_status(const FriendlyBookingQuote&, uint16_t day) const;
FriendlyDateStatus national_date_status(const NationalFriendlyQuote&, const NationalFriendlyOwner&, uint16_t day) const;
static NationalFriendlyOwner national_owner(const ui::FriendlyMatchRequest&);
private:
Booking book(const ui::FriendlyMatchRequest&, uint64_t& revision, bool national, const Accept&);
static FriendlyBookingRequest booking_request(const ui::FriendlyMatchRequest&);
ui::FriendlyBookingAck acknowledgement(const ui::FriendlyMatchRequest&, const FriendlyBookingResult&, uint64_t revision) const;
CareerSession& session_;
};
} // namespace bmh::app