Referência de engenharia

AiValeu

Referência de engenharia do ecossistema AiValeu: aplicativos Flutter, domínio, dados e backend Firebase.

Flutter · Dart · Firebase · Node.js · Clean Architecture

Preparar o ambiente Entender a arquitetura

Escolha seu ponto de entrada

• Começando

  Prepare Flutter, Node, Melos e a suíte local do Firebase.

• Arquitetura

  Entenda os três aplicativos e as camadas compartilhadas.

• Referência

  Consulte variáveis, portas, segredos e precedência.

• Testes

  Execute suites Dart, Flutter, Jest e Firestore Emulator.

• Operação

  Opere schedulers, builds e deploys com limites explícitos.

• Desenvolvimento

  Localize os pontos de composição e extensão.

Arquitetura em alto nível

flowchart LR
    C[Cliente e parceiro: aivaleu_app] --> P[Packages Dart]
    W[Garçom: waiter_desktop] --> P
    A[Curadoria: super_admin_web] --> P
    P --> F[Firebase Auth, Firestore e Storage]
    P --> CF[Cloud Functions em southamerica-east1]
    CF --> F
    CF --> S[Stripe]

O domínio define entidades, decisões e interfaces; aivaleu_data implementa os contratos com Firebase; os apps compõem repositories, casos de uso e Cubits. Mutações privilegiadas e invariantes transacionais ficam nas Cloud Functions.

Escopo desta referência

Esta documentação descreve o código versionado no monorepo. Ela não comprova que uma versão esteja implantada, que integrações externas estejam configuradas ou que dados remotos tenham sido migrados. A fonte para operação local é a combinação de firebase.json, manifestos do workspace e entrypoints atuais.