// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.

#pragma once

#include "CoreMinimal.h"
#include "Engine/DeveloperSettings.h"
#include "GIS_InventorySystemSettings.generated.h"

class UGIS_InventoryFactory;

/**
 * Structure representing a mapping of asset path prefix to item definition schema.
 * 表示资产路径前缀到道具定义模式的映射结构体。
 */
USTRUCT()
struct GENERICINVENTORYSYSTEM_API FGIS_ItemDefinitionSchemaEntry
{
	GENERATED_BODY()

	/**
	 * The path prefix for assets to apply this schema (e.g., "/Game/ActionRPG").
	 * 应用此模式的资产路径前缀（例如，"/Game/ActionRPG"）。
	 */
	UPROPERTY(config, EditAnywhere, Category="Settings", meta=(ContentDir))
	FString PathPrefix;

	/**
	 * The schema to apply for assets under this path prefix.
	 * 对此路径前缀下的资产应用的模式。
	 */
	UPROPERTY(config, EditAnywhere, Category="Settings", meta=(AllowedClasses="/Script/GenericInventorySystem.GIS_ItemDefinitionSchema"))
	FSoftObjectPath Schema;
};

/**
 * Settings for the Generic Inventory System.
 * 通用库存系统的设置。
 */
UCLASS(Config=Game, defaultconfig)
class GENERICINVENTORYSYSTEM_API UGIS_InventorySystemSettings : public UDeveloperSettings
{
	GENERATED_BODY()

public:
	/**
	 * Constructor for the inventory system settings.
	 * 库存系统设置的构造函数。
	 */
	UGIS_InventorySystemSettings();

	/**
	 * Gets the category name for these settings.
	 * 获取这些设置的类别名称。
	 * @return The category name. 类别名称。
	 */
	virtual FName GetCategoryName() const override;

	/**
	 * Gets the inventory system settings instance.
	 * 获取库存系统设置实例。
	 * @return The inventory system settings. 库存系统设置。
	 */
	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GIS|Settings", meta=(DisplayName="Get Inventory System Settings"))
	static const UGIS_InventorySystemSettings* Get();

	/**
	 * Gets the item definition schema for a given asset path.
	 * 获取给定资产路径的道具定义模式。
	 * @param AssetPath The path of the asset to find a schema for. 要查找模式的资产路径。
	 * @return The schema to use, or nullptr if none found. 要使用的模式，如果未找到则返回nullptr。
	 */
	const class UGIS_ItemDefinitionSchema* GetItemDefinitionSchemaForAsset(const FString& AssetPath) const;

	/**
	 * Inventory Factory class for managing low level operation in GIS.
	 * 库存工厂类用于管理GIS中的底层操作。
	 */
	UPROPERTY(config, Category="Settings", EditDefaultsOnly, NoClear)
	TSoftClassPtr<UGIS_InventoryFactory> InventoryFactoryClass;

	/**
	 * Array of path-to-schema mappings for item definition validation.
	 * 用于道具定义验证的路径到模式的映射数组。
	 * @details Assets under the specified path prefix will use the corresponding schema. If no match is found, the default schema is used.
	 * @细节 指定路径前缀下的资产将使用对应的模式。如果未找到匹配，则使用默认模式。
	 */
	UPROPERTY(config, EditAnywhere, Category="Settings")
	TArray<FGIS_ItemDefinitionSchemaEntry> ItemDefinitionSchemaMap;

	/**
	 * The default schema to enforce item definition layout consistency when no path-specific schema is found.
	 * 当未找到路径特定模式时，用于强制道具定义布局一致性的默认模式。
	 */
	UPROPERTY(config, EditAnywhere, Category="Settings", meta=(AllowedClasses="/Script/GenericInventorySystem.GIS_ItemDefinitionSchema"))
	FSoftObjectPath DefaultItemDefinitionSchema;
};