feat: impl lifecycle with tests

include/engine/core/engine.hpp

@@ -8,41 +8,43 @@
 #include <memory>
 #include <vector>
 
-/// Magic Srolls engine core
+/// Ядро движка Magic Srolls
 class MscEngine : public IMscEngineModuleAPI
 {
 private:
-  /// @brief Loaded modules list
+  /// @brief Загруженные модули
   std::vector<std::shared_ptr<MscEngineModule>> _modules;
 
-  /// @brief Common event bus
+  /// @brief Общая событийная шина движка
   MscEventBus _bus;
 
-  /// @brief Is engine running rn
+  /// @brief Флаг работы движка
   bool _isRunning = false;
 
-  /// @brief Last update time
+  /// @brief Время последнего тика
   clock::time_point _lastUpdate;
 
 public:
-  /// Actual version
+  /// @brief Номер ревизии
   static uint16_t REV;
 
   MscEngine(std::vector<std::shared_ptr<MscEngineModule>> modules);
+  ~MscEngine() = default;
 
-  /// @brief Start engine
+  /// @brief Запустить движок
   void start();
 
-  /// @brief Stop engine
+  /// @brief Остановить движок
   void stop();
 
   MscEventBus &getBus() override;
   std::unordered_map<std::string, std::uint16_t>
   getLoadedModules() const override;
-  MscEngineModule &getModule(const std::string &name) override;
+  std::shared_ptr<MscEngineModule> &getModule(const std::string &name) override;
   std::unique_ptr<MscEngineDBProvider> createDBProvider() override;
   std::unique_ptr<MscEngineDBProvider>
   createDBProvider(const std::string &filepath) override;
+  void requestStop() override;
 };
 
 #endif // __MCS_ENGINE_HPP__

include/engine/core/engine_module_api.hpp

@@ -10,6 +10,7 @@
 
 class MscEngineModule;
 
+/// @brief Публичный API движка для модулей
 class IMscEngineModuleAPI
 {
 public:
@@ -17,22 +18,26 @@ public:
 
   virtual ~IMscEngineModuleAPI() = default;
 
-  /// @brief Get access to engine event bus
+  /// @brief Получить доступ к событийной шине
   virtual MscEventBus &getBus() = 0;
 
-  /// @brief Get access to loaded module list
+  /// @brief Получить список загруженных модулей
   virtual std::unordered_map<std::string, std::uint16_t>
   getLoadedModules() const = 0;
 
-  /// @brief Access module by its name
-  virtual MscEngineModule &getModule(const std::string &name) = 0;
+  /// @brief Получить прямой доступ к модулю
+  virtual std::shared_ptr<MscEngineModule> &
+  getModule(const std::string &name) = 0;
 
-  /// @brief Create database provider with in-memory database
+  /// @brief Создать провайдер БД с хранением в памяти
   virtual std::unique_ptr<MscEngineDBProvider> createDBProvider() = 0;
 
-  /// @brief Create database provider with file database
+  /// @brief Создать провайдер БД с указанным файлом
   virtual std::unique_ptr<MscEngineDBProvider>
   createDBProvider(const std::string &filepath) = 0;
+
+  /// @brief Запросить остановку движка
+  virtual void requestStop() = 0;
 };
 
 #endif // __MSC_ENGINE_MODULE_API_HPP__