change_management_service Class Reference

Service for managing change reason categories and change reasons. More...

#include <change_management_service.hpp>

Collaboration diagram for change_management_service:

Public Types
using	context = ores::database::context

Public Member Functions
	change_management_service (context ctx)
	Constructs a change_management_service with required repositories.
std::vector< domain::change_reason_category >	list_categories ()
	Lists all change reason categories.
std::vector< domain::change_reason_category >	list_categories (std::uint32_t offset, std::uint32_t limit)
	Lists change reason categories with pagination.
std::uint32_t	get_category_count ()
	Gets the total count of active categories.
std::optional< domain::change_reason_category >	find_category (const std::string &code)
	Finds a category by its code.
void	save_category (const domain::change_reason_category &category)
	Saves a change reason category (creates or updates).
void	remove_category (const std::string &code)
	Removes a change reason category.
std::vector< domain::change_reason_category >	get_category_history (const std::string &code)
	Gets the version history for a category.
std::vector< domain::change_reason >	list_reasons ()
	Lists all change reasons.
std::vector< domain::change_reason >	list_reasons (std::uint32_t offset, std::uint32_t limit)
	Lists change reasons with pagination.
std::vector< domain::change_reason >	list_reasons_by_category (const std::string &category_code)
	Lists change reasons for a specific category.
std::uint32_t	get_reason_count ()
	Gets the total count of active reasons.
std::optional< domain::change_reason >	find_reason (const std::string &code)
	Finds a reason by its code.
void	save_reason (const domain::change_reason &reason)
	Saves a change reason (creates or updates).
void	remove_reason (const std::string &code)
	Removes a change reason.
std::vector< domain::change_reason >	get_reason_history (const std::string &code)
	Gets the version history for a reason.
bool	is_valid_reason_code (const std::string &code)
	Validates that a change reason code exists.
bool	is_valid_category_code (const std::string &code)
	Validates that a category code exists.

Detailed Description

Service for managing change reason categories and change reasons.

This service provides functionality for:

• Managing change reason categories (CRUD operations)
• Managing change reasons and their associated categories
• Validating change reason codes against the catalog

Constructor & Destructor Documentation

change_management_service()

change_management_service ( context  ctx )

explicit

Constructs a change_management_service with required repositories.

Parameters

ctx	The database context.

Member Function Documentation

save_category()

void save_category

(

const domain::change_reason_category &

category

)

Saves a change reason category (creates or updates).

Parameters

category

The category to save

remove_category()

void remove_category

(

const std::string &

code

)

Removes a change reason category.

Parameters

code	The code of the category to remove

get_category_history()

std::vector< domain::change_reason_category > get_category_history

(

const std::string &

code

)

Gets the version history for a category.

Parameters

code	The category code

Returns

Vector of all versions, newest first

save_reason()

void save_reason

(

const domain::change_reason &

reason

)

Saves a change reason (creates or updates).

Parameters

reason

The reason to save

remove_reason()

void remove_reason

(

const std::string &

code

)

Removes a change reason.

Parameters

code	The code of the reason to remove

get_reason_history()

std::vector< domain::change_reason > get_reason_history

(

const std::string &

code

)

Gets the version history for a reason.

Parameters

code	The reason code

Returns

Vector of all versions, newest first

is_valid_reason_code()

bool is_valid_reason_code

(

const std::string &

code

)

Validates that a change reason code exists.

Parameters

code	The change reason code to validate

Returns

true if the code is valid, false otherwise

is_valid_category_code()

bool is_valid_category_code

(

const std::string &

code

)

Validates that a category code exists.

Parameters

code	The category code to validate

Returns

true if the code is valid, false otherwise