Building Solutions from 0 to 1

Logical translation of the modular transactional inventory system (`BPC_Inventory`) demonstrating decoupled struct arrays lookup, index checking, and stack updates.

// Transactional Stacking Algorithm - C++ Equivalent of Blueprint Logic
bool UBPC_Inventory::AdicionarItem(FName ItemId, int32 Quantidade, int32 Qualidade) {
    // 1. Verifica se o Item existe na Tabela de Itens (DataTable Factory)
    FS_Item* ItemData = DT_Itens->FindRow<FS_Item>(ItemId, "");
    if (!ItemData) {
        UE_LOG(LogTemp, Warning, TEXT("Item Inexistente no Banco de Dados!"));
        return false;
    }

    // 2. Varre o array de Itens do inventário buscando slots compatíveis
    for (FS_Item_Instance& Slot : Itens) {
        if (Slot.ItemID == ItemId && Slot.Qualidade == Qualidade && Slot.Quantidade < ItemData->MaxStack) {
            Slot.Quantidade += Quantidade; // Stack com sucesso
            return true;
        }
    }
    
    // 3. Se não achou slot compatível, valida espaço e adiciona no fim do array
    if (Itens.Num() < MaxSlots) {
        Itens.Add(FS_Item_Instance(ItemId, Quantidade, Qualidade, ItemData->MaxStack));
        return true;
    }
    
    UE_LOG(LogTemp, Error, TEXT("Inventário Cheio!"));
    return false;
}