the-biergarten-app/pipeline/includes/data_generation/data_generator.h

#ifndef BIERGARTEN_PIPELINE_DATA_GENERATION_DATA_GENERATOR_H_
#define BIERGARTEN_PIPELINE_DATA_GENERATION_DATA_GENERATOR_H_

/**
 * @file data_generation/data_generator.h
 * @brief Shared generator interfaces and result models.
 */

#include <string>
#include <string_view>

/**
 * @brief Non-owning brewery location input.
 */
struct BreweryLocation {
   /// @brief City name.
   std::string_view city_name;

   /// @brief Country name.
   std::string_view country_name;
};

/**
 * @brief Generated brewery payload.
 */
struct BreweryResult {
   /// @brief Brewery display name.
   std::string name;

   /// @brief Brewery description text.
   std::string description;
};

/**
 * @brief Generated user profile payload.
 */
struct UserResult {
   /// @brief Username handle.
   std::string username;

   /// @brief Short user biography.
   std::string bio;
};

/**
 * @brief Interface for data generator implementations.
 */
class DataGenerator {
  public:
   /// @brief Virtual destructor for polymorphic cleanup.
   virtual ~DataGenerator() = default;

   /**
    * @brief Generates brewery data for a location.
    *
    * @param location City and country names.
    * @param region_context Additional regional context text.
    * @return Brewery generation result.
    */
   virtual BreweryResult GenerateBrewery(const BreweryLocation& location,
                                         const std::string& region_context) = 0;

   /**
    * @brief Generates a user profile for a locale.
    *
    * @param locale Locale hint used by generator.
    * @return User generation result.
    */
   virtual UserResult GenerateUser(const std::string& locale) = 0;
};

#endif  // BIERGARTEN_PIPELINE_DATA_GENERATION_DATA_GENERATOR_H_