Diagrama de Classes: O Mapa do Mundo dos Códigos 🗺️

/*
 * ===================================================================
 *  CLASSE 1: O ARTESÃO DA IA (Simulação)
 *  Em um app real, esta classe chamaria a API do Google Gemini.
 * ===================================================================
 */
public class AiArtisanService {
    // Simula a IA criando uma imagem e retornando os "pixels" (bytes)
    public byte[] createImage(String prompt) {
        System.out.println("1. Pedido para IA: "" + prompt + """);
        // Bytes de um PNG 1x1 transparente (simulação para o exemplo)
        return Base64.getDecoder().decode("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=");
    }
}

/*
 * ===================================================================
 *  CLASSE 2: A FORJA DE ITENS MÁGICOS (Nosso Serviço Principal)
 *  Esta classe usa a IA para criar e salvar o item no Firebase.
 * ===================================================================
 */
public class MagicItemForgeService {

    private final AiArtisanService aiArtisan;
    private final Bucket storageBucket;

    // O serviço recebe as "ferramentas" que precisa para trabalhar (Injeção de Dependência)
    public MagicItemForgeService(AiArtisanService aiArtisan, Bucket storageBucket) {
        this.aiArtisan = aiArtisan;
        this.storageBucket = storageBucket;
    }

    public String forgeAndStoreItem(String prompt, String itemName) throws IOException {
        // 2. Chamar a IA para gerar os bytes da imagem
        byte[] imageBytes = aiArtisan.createImage(prompt);
        System.out.println("2. IA retornou " + imageBytes.length + " bytes de imagem.");

        // 3. Definir o caminho onde o item será salvo no Storage
        String filePath = "magic-items/" + itemName + ".png";

        // 4. Forjar! Fazer o upload dos bytes para o Firebase Storage
        storageBucket.create(filePath, imageBytes, "image/png");
        System.out.println("3. Forja concluída! Item salvo em: " + filePath);

        // 5. Gerar uma URL de acesso temporária para o item
        Blob blob = storageBucket.get(filePath);
        URL signedUrl = blob.signUrl(1, TimeUnit.HOURS);
        System.out.println("4. URL de acesso gerada!");

        return signedUrl.toString();
    }
}

/*
 * ===================================================================
 *  MÉTODO PRINCIPAL: Onde a mágica começa
 * ===================================================================
 */
public static void main(String[] args) throws IOException {
    // --- Configuração Inicial (em um app real, isso é feito uma vez) ---
    FirebaseApp.initializeApp(/*...*/);
    AiArtisanService ai = new AiArtisanService();
    Bucket bucket = StorageClient.getInstance().bucket();
    // ----------------------------------------------------------------

    // Criar nossa forja com as ferramentas necessárias
    MagicItemForgeService itemForge = new MagicItemForgeService(ai, bucket);

    // Usar a forja para criar um novo item!
    String prompt = "Uma espada mágica de cristal, brilhando com aura azul";
    String url = itemForge.forgeAndStoreItem(prompt, "crystal-sword");

    System.out.println("
Item Mágico disponível em: " + url);
}