#4 Split EquipmentDataModel into focused stores

The god-class is gone. Each capability is now its own focused store: StatusVariableStore, DataVariableStore, EquipmentConstantStore (with EAC range validation), EventReportSubscriptions, AlarmRegistry, RecipeStore, Clock, HostCommandRegistry. Each is independently testable. EquipmentDataModel becomes a small composite that holds one of each store as a public member, plus three convenience methods (vid_value, vid_exists, compose_reports_for) that span SVIDs+DVIDs and inject the right callbacks into the EventReportSubscriptions. New under include/secsgem/gem/store/: status_variables.hpp StatusVariable, StatusVariableStore, DataVariable, DataVariableStore equipment_constants.hpp EquipmentConstant, EquipmentConstantStore, EquipmentAck. set_value() now validates numeric values against min_str/max_str and returns EAC=4 on out-of-range — closes the COMPLIANCE.md gap about EC range validation. event_reports.hpp CollectionEvent, Report, ReportData, EventReportSubscriptions + DefineReportAck, LinkEventAck, EnableEventAck. The store is pure data; VidLookup / VidExists callbacks are injected at define / emit time so the service doesn't back-reference the SVID store. alarms.hpp Alarm, AlarmAck, AlarmRegistry. Encapsulates the (enabled, active) sets and ALCD byte computation. recipes.hpp ProcessProgramAck, RecipeStore. clock.hpp TimeAck, Clock. set_time_string applies an offset so subsequent reads reflect the host time without mutating system clock. host_commands.hpp HostCmdAck, CommandParameter, HostCommandRegistry with Spec/Result types. include/secsgem/gem/data_model.hpp shrinks to a 50-line composite: struct EquipmentDataModel { StatusVariableStore svids; DataVariableStore dvids; EquipmentConstantStore ecids; EventReportSubscriptions events; AlarmRegistry alarms; RecipeStore recipes; Clock clock; HostCommandRegistry commands; /* + vid_value, vid_exists, compose_reports_for sugar */ }; src/gem/data_model.cpp is gone — every store is inline header-only. include/secsgem/gem/messages_helpers.hpp picks up EventReportAck and TerminalAck (S6F12 / S10F2-F4 ack enums that aren't tied to any one store). Call-site updates: apps/secs_server.cpp model->status_variable(id) -> model->svids.get(id), model->equipment_constant(id) -> model->ecids.get(id), model->alarm_set(id) -> model->alarms.set_active(id), model->dispatch_command(...) -> model->commands.dispatch(...), and similar across every handler. Plus model->current_time_string() -> model->clock.... src/config/loader.cpp model.add_status_variable(sv) -> model.svids.add(sv), and similar. HostCommandRegistry::Spec replaces EquipmentDataModel::CommandSpec. apps/secs_client.cpp std::vector<EquipmentDataModel::CommandParam> -> std::vector<CommandParameter>. tests/test_data_model.cpp Rewritten around the individual stores; each gets its own TEST_CASE block. Adds three new cases covering EC range validation (in range / out of range / non-numeric skipped). tests/test_loader.cpp m.has_event(100) -> m.events.has_event(100), etc. Verified: - Tests: 69 cases / 370 assertions pass (was 67 / 384; -14 stale composite-API assertions + 16 new store-level assertions covering EC range validation and the per-store add/get/list/delete paths). - Demo: byte-identical behaviour across the full 17-step flow. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-02 09:51:54 +02:00
parent 29db1caedb
commit 711ee1b40f
16 changed files with 877 additions and 770 deletions
@@ -0,0 +1,74 @@
+#pragma once
+
+#include <cstdint>
+#include <map>
+#include <optional>
+#include <set>
+#include <string>
+#include <utility>
+#include <vector>
+
+namespace secsgem::gem {
+
+struct Alarm {
+  uint32_t id;
+  std::string text;
+  // Lower 7 bits of ALCD: severity category (1=personal safety,
+  // 2=equipment safety, 4=parameter control error, ...).  Bit 7 marks
+  // set vs cleared and is applied at emit time.
+  uint8_t severity_category;
+};
+
+enum class AlarmAck : uint8_t {
+  Accept = 0,
+  Error = 1,
+};
+
+class AlarmRegistry {
+ public:
+  void add(Alarm a) { by_id_.insert_or_assign(a.id, std::move(a)); }
+  std::optional<Alarm> get(uint32_t id) const {
+    auto it = by_id_.find(id);
+    if (it == by_id_.end()) return std::nullopt;
+    return it->second;
+  }
+  std::vector<Alarm> all() const {
+    std::vector<Alarm> out;
+    out.reserve(by_id_.size());
+    for (const auto& [_, a] : by_id_) out.push_back(a);
+    return out;
+  }
+  bool has(uint32_t id) const { return by_id_.count(id) > 0; }
+
+  // S5F3 enable / disable.
+  AlarmAck set_enabled(uint32_t id, bool enable) {
+    if (!by_id_.count(id)) return AlarmAck::Error;
+    if (enable) enabled_.insert(id);
+    else enabled_.erase(id);
+    return AlarmAck::Accept;
+  }
+  bool enabled(uint32_t id) const { return enabled_.count(id) > 0; }
+
+  // Trigger set / clear; returns the ALCD byte to put on the wire (bit 7
+  // is the set flag, lower 7 carry the category). std::nullopt on unknown.
+  std::optional<uint8_t> set_active(uint32_t id) {
+    auto it = by_id_.find(id);
+    if (it == by_id_.end()) return std::nullopt;
+    active_.insert(id);
+    return static_cast<uint8_t>((it->second.severity_category & 0x7F) | 0x80);
+  }
+  std::optional<uint8_t> clear_active(uint32_t id) {
+    auto it = by_id_.find(id);
+    if (it == by_id_.end()) return std::nullopt;
+    active_.erase(id);
+    return static_cast<uint8_t>(it->second.severity_category & 0x7F);
+  }
+  bool active(uint32_t id) const { return active_.count(id) > 0; }
+
+ private:
+  std::map<uint32_t, Alarm> by_id_;
+  std::set<uint32_t> enabled_;
+  std::set<uint32_t> active_;
+};
+
+}  // namespace secsgem::gem