feat: track stand assignment source with colour-coded tag items

docs/TAG_ITEMS.md

@@ -32,3 +32,4 @@
 130 - Missed Approach Indicator
 131 - Relevant ECFMP Flow Measures
 132 - Glideslope Deviation
+133 - Stand Assignment Source

src/plugin/CMakeLists.txt

@@ -906,6 +906,9 @@ set(src__stands
     "stands/CompareStands.cpp"
     "stands/CompareStands.h"
     "stands/Stand.h"
+    "stands/StandAssignmentSource.h"
+    "stands/StandColourConfiguration.cpp"
+    "stands/StandColourConfiguration.h"
     "stands/StandEventHandler.cpp"
     "stands/StandEventHandler.h"
     "stands/StandModule.cpp"

src/plugin/stands/StandAssignmentSource.h

@@ -0,0 +1,66 @@
+#pragma once
+#include <string>
+#include <string_view>
+
+namespace UKControllerPlugin::Stands {
+    /*
+        Represents a stand assignment with its source (how it was assigned).
+    */
+    struct StandAssignment
+    {
+        enum class Source
+        {
+            Unknown,
+            User,
+            ReservationAllocator,
+            VaaAllocator,
+            SystemAuto,
+        };
+
+        int standId;
+
+        // The source of the assignment (user, reservation_allocator, vaa_allocator, system_auto)
+        Source source;
+
+        [[nodiscard]] static constexpr auto ToString(Source source) -> std::string_view
+        {
+            using enum Source;
+
+            switch (source) {
+            case Unknown:
+                return "unknown";
+            case User:
+                return "user";
+            case ReservationAllocator:
+                return "reservation_allocator";
+            case VaaAllocator:
+                return "vaa_allocator";
+            case SystemAuto:
+                return "system_auto";
+            default:
+                return "unknown";
+            }
+        }
+
+        [[nodiscard]] static constexpr auto FromString(std::string_view source) -> Source
+        {
+            using enum Source;
+
+            if (source == "user") {
+                return User;
+            }
+            if (source == "reservation_allocator") {
+                return ReservationAllocator;
+            }
+            if (source == "vaa_allocator") {
+                return VaaAllocator;
+            }
+
+            if (source == "system_auto") {
+                return SystemAuto;
+            }
+
+            return Unknown;
+        }
+    };
+} // namespace UKControllerPlugin::Stands

src/plugin/stands/StandColourConfiguration.cpp

@@ -0,0 +1,59 @@
+#include "StandColourConfiguration.h"
+#include "StandAssignmentSource.h"
+#include "euroscope/UserSetting.h"
+#include "helper/HelperFunctions.h"
+#include "log/LoggerFunctions.h"
+#include <array>
+
+namespace UKControllerPlugin::Stands {
+
+    StandColourConfiguration::StandColourConfiguration(UKControllerPlugin::Euroscope::UserSetting& setting)
+        : StandColourConfiguration(&setting)
+    {
+    }
+
+    StandColourConfiguration::StandColourConfiguration() : StandColourConfiguration(nullptr)
+    {
+    }
+
+    StandColourConfiguration::StandColourConfiguration(UKControllerPlugin::Euroscope::UserSetting* userSetting)
+        : userSetting(userSetting), sourceColours(
+                                        {{StandAssignment::Source::User, DEFAULT_USER_COLOUR},
+                                         {StandAssignment::Source::ReservationAllocator, DEFAULT_RESERVATION_COLOUR},
+                                         {StandAssignment::Source::VaaAllocator, DEFAULT_VAA_COLOUR},
+                                         {StandAssignment::Source::SystemAuto, DEFAULT_SYSTEM_COLOUR}})
+    {
+        LoadFromUserSettings();
+    }
+
+    auto StandColourConfiguration::GetColourForSource(StandAssignment::Source source) const -> COLORREF
+    {
+        if (auto it = sourceColours.find(source); it != sourceColours.cend()) {
+            return it->second;
+        }
+
+        return DEFAULT_COLOUR;
+    }
+
+    void StandColourConfiguration::LoadFromUserSettings()
+    {
+        if (!this->userSetting) {
+            return;
+        }
+
+        using enum UKControllerPlugin::Stands::StandAssignment::Source;
+
+        constexpr std::array<StandAssignment::Source, 5> sourceColourDefaults = {
+            {Unknown, User, ReservationAllocator, VaaAllocator, SystemAuto}};
+
+        for (const auto source : sourceColourDefaults) {
+            const std::string key = std::string(SETTING_PREFIX) + std::string(StandAssignment::ToString(source));
+            if (this->userSetting->HasEntry(key)) {
+                this->sourceColours[source] = this->userSetting->GetColourEntry(key);
+            }
+        }
+
+        LogInfo("Loaded stand assignment source colours from UserSettings");
+    }
+
+} // namespace UKControllerPlugin::Stands

src/plugin/stands/StandColourConfiguration.h

@@ -0,0 +1,55 @@
+#pragma once
+#include "StandAssignmentSource.h"
+#include <map>
+#include <string>
+#include <string_view>
+#include <Windows.h>
+
+namespace UKControllerPlugin::Euroscope {
+    class UserSetting;
+}
+
+namespace UKControllerPlugin::Stands {
+    /*
+        Manages colour configuration for stand assignments based on their source.
+        Colours are persisted to EuroScope UserSettings and can be customized without recompilation.
+    */
+    class StandColourConfiguration
+    {
+        public:
+        explicit StandColourConfiguration(UKControllerPlugin::Euroscope::UserSetting& userSetting);
+        explicit StandColourConfiguration();
+
+        /*
+            Get the colour for a given assignment source.
+            Returns a default grey if source is not found or not set.
+        */
+        [[nodiscard]] auto GetColourForSource(StandAssignment::Source source) const -> COLORREF;
+
+        /*
+            Load colours from UserSettings, with fallback to defaults.
+        */
+        void LoadFromUserSettings();
+
+        private:
+        explicit StandColourConfiguration(UKControllerPlugin::Euroscope::UserSetting* userSetting);
+
+        // Reference to user settings for persistence (null if not available)
+        UKControllerPlugin::Euroscope::UserSetting* userSetting;
+
+        // Map of source to RGB colour
+        std::map<StandAssignment::Source, COLORREF> sourceColours;
+
+        // Default colour (grey) for unknown sources
+        static constexpr COLORREF DEFAULT_COLOUR = RGB(204, 204, 204);
+
+        // Default colours if not configured
+        static constexpr COLORREF DEFAULT_USER_COLOUR = RGB(255, 149, 41);       // orange
+        static constexpr COLORREF DEFAULT_RESERVATION_COLOUR = RGB(255, 216, 0); // yellow
+        static constexpr COLORREF DEFAULT_VAA_COLOUR = RGB(255, 216, 0);         // yellow
+        static constexpr COLORREF DEFAULT_SYSTEM_COLOUR = RGB(255, 255, 255);    // white
+
+        // UserSetting key prefix for colours
+        static constexpr std::string_view SETTING_PREFIX = "stand_colour_";
+    };
+} // namespace UKControllerPlugin::Stands