📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados em Especialização em Flutter. Recomendado revisar antes de começar.

💙 Arquitetura Limpa & Gerenciamento BLoC em Flutter 3

v2.0 — Flutter 3, Dart, Clean Architecture, flutter_bloc, GetIt e Equatable

Trilha de Especialização Pedagógica — Projeto 2 de 4

• v1: App Financeiro · Flutter 3 · Provider · Material 3
• ➡️ v2 (este): Clean Architecture · BLoC Pattern (flutter_bloc) · GetIt · Dartz
• v3: App Offline-First com Banco NoSQL Hive & Sincronização
• v4: Super-App Omnichannel com Biometria & Push FCM

🎓 Nível Profissional Simulado: Desenvolvedor Flutter Pleno / Engenheiro Mobile. O padrão BLoC (Business Logic Component) com Clean Architecture é o padrão ouro adotado por bancos (Nubank, C6 Bank) e unicórnios de tecnologia para garantir separação estrita de responsabilidades e desacoplamento total da interface visual.

—`

🎯 Objetivo & Escopo do Projeto

Construir o módulo de Conta Digital e Transferências Pix em Flutter 3, aplicando a Clean Architecture em camadas (Domain, Data, Presentation), fluxo unidirecional de eventos e estados via flutter_bloc, injeção de dependências com get_it e estados imutáveis com Equatable.

—`

🧑‍💼 Fase 1 — Levantamento de Requisitos

O Briefing do Cliente (Tech Lead de Banco Digital)

“Precisamos refatorar nosso fluxo de transferência Pix. A lógica não pode ficar dentro dos widgets da tela. Exigimos o padrão BLoC com eventos explícitos (CarregarSaldoEvent, RealizarPixEvent), estados atômicos de tela (ContaLoading, ContaLoaded, ContaError) e injeção de dependências para podermos trocar a fonte de dados de Mock para API REST sem tocar na UI.”

Requisitos Funcionais (RF) e Não-Funcionais (RNF)

—`

📋 Fase 2 — Backlog & User Stories

—`

🌿 Fase 3 — Engenharia em Equipe (Git Flow & Setup)

# Branch da funcionalidade
git checkout -b feature/US01-flutter-clean-bloc

# Executar a aplicacao Flutter no emulador
flutter run

—`

🛠️ Fase 4 — Implementação Guiada do BLoC (conta_bloc.dart)

class ContaBloc extends Bloc<ContaEvent, ContaState> {
  double _saldoAtual = 5420.50;

  ContaBloc() : super(ContaInitial()) {
    on<CarregarSaldoEvent>((event, emit) async {
      emit(ContaLoading());
      await Future.delayed(const Duration(milliseconds: 600));
      emit(ContaLoaded(_saldoAtual));
    });

    on<RealizarPixEvent>((event, emit) async {
      emit(ContaLoading());
      if (event.valor > _saldoAtual) {
        emit(const ContaError('Saldo insuficiente para realizar o Pix.'));
      } else {
        _saldoAtual -= event.valor;
        emit(ContaLoaded(_saldoAtual));
      }
    });
  }
}

—`

🚀 Como Executar no Laboratório

1. Abra o terminal na pasta deste projeto

No seu editor/IDE, abra a pasta deste projeto (File > Open Folder) ou navegue via terminal:

cd mobile_flutter_02_bloc_cleanarch

2. Execute a aplicação e os testes

flutter pub get
flutter run
flutter test

[!TIP] Dica para execução a partir da raiz do repositório: Se você abriu o repositório completo no VS Code, basta navegar até a pasta antes de executar: cd proj_aplicacoes_full_stack/projetos/mobile_flutter_02_bloc_cleanarch`

🧭 Decisões de Arquitetura (ADRs)

• ADR 001: Adoção de Clean Architecture e flutter_bloc para isolamento total da regra de negócios.

—`

🧪 Testes de Validação & Asserções BLoC

// Teste unitário de BLoC com bloc_test
blocTest<ContaBloc, ContaState>(
  'emite [ContaLoading, ContaLoaded] ao carregar saldo com sucesso',
  build: () => ContaBloc(),
  act: (bloc) => bloc.add(CarregarSaldoEvent()),
  expect: () => [ContaLoading(), const ContaLoaded(5420.50)],
);

—`

✅ Checkpoint Final

1. Clean Architecture com BLoC implementada e testada.
2. BlocConsumer gerenciando renderização e SnackBars de erro.