change_management_service.hpp

/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
 *
 * Copyright (C) 2025 Marco Craveiro <marco.craveiro@gmail.com>
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 3 of the License, or (at your option) any later
 * version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 51
 * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 */
#ifndef ORES_DQ_CORE_SERVICE_CHANGE_MANAGEMENT_SERVICE_HPP
#define ORES_DQ_CORE_SERVICE_CHANGE_MANAGEMENT_SERVICE_HPP
 
#include <string>
#include <vector>
#include <optional>
#include "ores.logging/make_logger.hpp"
#include "ores.database/domain/context.hpp"
#include "ores.dq.api/domain/change_reason_category.hpp"
#include "ores.dq.api/domain/change_reason.hpp"
#include "ores.dq.core/repository/change_reason_category_repository.hpp"
#include "ores.dq.core/repository/change_reason_repository.hpp"
 
namespace ores::dq::service {
 
class change_management_service {
private:
    inline static std::string_view logger_name =
        "ores.iam.service.change_management_service";
 
    [[nodiscard]] static auto& lg() {
        using namespace ores::logging;
        static auto instance = make_logger(logger_name);
        return instance;
    }
 
public:
    using context = ores::database::context;
 
    explicit change_management_service(context ctx);
 
    // ========================================================================
    // Category Management
    // ========================================================================
 
    std::vector<domain::change_reason_category> list_categories();
 
    std::vector<domain::change_reason_category>
    list_categories(std::uint32_t offset, std::uint32_t limit);
 
    std::uint32_t get_category_count();
 
    std::optional<domain::change_reason_category>
    find_category(const std::string& code);
 
    void save_category(const domain::change_reason_category& category);
 
    void save_categories(const std::vector<domain::change_reason_category>& categories);
 
    void remove_category(const std::string& code);
 
    void remove_categories(const std::vector<std::string>& codes);
 
    std::vector<domain::change_reason_category>
    get_category_history(const std::string& code);
 
    // ========================================================================
    // Reason Management
    // ========================================================================
 
    std::vector<domain::change_reason> list_reasons();
 
    std::vector<domain::change_reason>
    list_reasons(std::uint32_t offset, std::uint32_t limit);
 
    std::vector<domain::change_reason>
    list_reasons_by_category(const std::string& category_code);
 
    std::uint32_t get_reason_count();
 
    std::optional<domain::change_reason> find_reason(const std::string& code);
 
    void save_reason(const domain::change_reason& reason);
 
    void save_reasons(const std::vector<domain::change_reason>& reasons);
 
    void remove_reason(const std::string& code);
 
    void remove_reasons(const std::vector<std::string>& codes);
 
    std::vector<domain::change_reason> get_reason_history(const std::string& code);
 
    // ========================================================================
    // Validation
    // ========================================================================
 
    bool is_valid_reason_code(const std::string& code);
 
    bool is_valid_category_code(const std::string& code);
 
private:
    repository::change_reason_category_repository category_repo_;
    repository::change_reason_repository reason_repo_;
};
 
}
 
#endif