Checklist do Tour pela Base de Código

Um checklist em níveis para onde residem as rotas, funcionalidades, configuração nativa e CI em um aplicativo Expo SDK 57 - use no segundo dia com um colega, não como uma caça ao tesouro solo.

Como Usar Este Checklist

• Complete o Nível 1 antes do seu primeiro PR; Nível 2 antes da funcionalidade principal; Níveis 3–4 na segunda semana.
• Substitua os caminhos de placeholder (features/orders/) pelos nomes reais do seu repositório - use grep se o README estiver desatualizado.
• Marque cada item como ✓ encontrado, ? incerto, ou ✗ ausente - escale ✗ para o líder da plataforma.
• Registre as respostas no seu PR de onboarding ou na wiki interna - o próximo contratado herdará suas anotações.
• Reexecute o Nível 4 ao ingressar em uma nova equipe ou após uma migração de arquitetura importante.

Nível 1 - Primeiro Dia (1–8)

Você consegue rodar o Metro e encontrar a tela inicial sem perguntar no Slack.

1. README de entrada do repositório - comando de clone, versão do Node, npm ci vs pnpm, link para canais do Slack.

   • Procure por: engines.node, canal #mobile ou #app, link para o projeto EAS
   • Pergunte se estiver ausente: "Onde está a documentação canônica de introdução?"

2. Scripts do package.json - como lint, typecheck, test e start são invocados.

   • Procure por: expo start, typecheck, lint, test - os mesmos scripts que a CI chama
   • Relacionado: Noções Básicas de Configuração de Projeto

3. Pinagem do SDK - versões de expo, react, react-native correspondem à matriz do SDK 57.

   • Procure por: "expo": "~57.0.4", "react": "19.2.3", "react-native": "0.86.0"
   • Verifique: npx expo-doctor passa em um clone limpo

4. Diretório app/ - rotas baseadas em arquivos (Expo Router).

   • Procure por: _layout.tsx, index.tsx, (tabs)/ ou grupos de rotas
   • Regra: Arquivos de rota devem ser finos - reexportar telas de funcionalidades
   • Relacionado: Noções Básicas do Expo Router

5. Layout raiz app/_layout.tsx - provedores, fontes, splash screen, navegador raiz.

   • Procure por: QueryClient, tema, portão de autenticação, Stack / Tabs de expo-router
   • Sinal: Todos os wrappers globais devem estar aqui ou em um arquivo de provedor importado

6. app.config.ts ou app.json - IDs de bundle, ícones, plugins, extra para ambiente.

   • Procure por: ios.bundleIdentifier, android.package, plugins: [], extra.eas.projectId
   • Relacionado: Noções Básicas de Configuração de Projeto

7. Template de ambiente - .env.example com variáveis EXPO_PUBLIC_* documentadas.

   • Procure por: URL da API de staging, chaves de flag de funcionalidade seguras para o bundle do cliente
   • Nunca: Segredos de API privados em EXPO_PUBLIC_

8. CONTRIBUTING.md - fluxo de branches, estilo de commit, template de PR, rótulo de build de preview.

   • Procure por: Regras de rótulo needs-preview, menção a CODEOWNERS, commits convencionais

Nível 2 - Primeiro PR (9–16)

Você consegue rastrear uma ação do usuário do toque à rede.

9. Convenção de pasta de funcionalidade - onde a lógica da tela vive fora de app/.

   • Procure por: features/<nome>/screens|hooks|api|components/
   • Padrões alternativos: src/modules/, FSD entities/ + features/
   • Relacionado: Estrutura de Pastas para Funcionalidades

10. Cliente de API compartilhado - wrapper HTTP único com cabeçalhos de autenticação e URL base.

    • Procure por: shared/api/client.ts, lib/api.ts, ou fábrica createApiClient()
    • Rastreie: Tela → hook → ordersApi.getById → client.get

11. Portão de autenticação/sessão - como usuários deslogados são redirecionados.

    • Procure por: Redirect em app/_layout.tsx, grupo de rotas (auth)/, ou guarda useAuth()
    • Pergunte: Onde o token de atualização é armazenado? (padrão expo-secure-store)

12. Estratégia de estado - o que vive em TanStack Query vs Zustand vs context.

    • Procure por: useQuery para dados do servidor; store apenas para estado de sessão da UI
    • Sinal de alerta: fetch dentro de ações Zustand duplicando o cache da query

13. Ponto de entrada do sistema de design - botões, tipografia, tokens de tema.

    • Procure por: shared/ui/, @/components, ou importação de pacote externo
    • Pergunte: URL do Storybook ou catálogo no dispositivo, se existir

14. Perfis de build eas.json - desenvolvimento, preview, produção.

    • Procure por: developmentClient, distribution: internal, channel por perfil
    • Relacionado: Noções Básicas de Build do EAS

15. Caminhos TypeScript - mapeamento de alias @/ em tsconfig.json.

    • Procure por: "paths": { "@/*": ["./*"] }" ou nomes de pacotes do monorepo
    • Verifique: A navegação "Ir para definição" da rota para a tela de funcionalidade funciona no IDE

16. Colocação de testes - política de *.test.tsx ao lado de componentes ou pasta __tests__.

    • Procure por: jest.config.js, jest.setup.ts, preset jest-expo
    • Execute: npm test -- --listTests | head

Nível 3 - Segunda Semana (17–24)

Você consegue raciocinar sobre o comportamento nativo e depurar builds com formato de produção.

17. Plugins de configuração - alterações nativas sem editar manualmente ios/ / android/.

    • Procure por: plugins: ["expo-router", "./plugins/withCustom"] na configuração do app
    • Pergunte: Quando foi o último npx expo prebuild e o CNG foi adotado?

18. Presença de ios/ e android/ - diretórios nativos gerenciados, bare ou gerados.

    • Gerenciado/CNG: pastas ignoradas pelo git - o EAS gera na build
    • Bare: pastas commitadas - pod install local é necessário
    • Relacionado: Noções Básicas de Prebuild

19. Configuração de deep linking - esquema, links universais, filtros de intenção.

    • Procure por: scheme na configuração do app, apple-app-site-association, filtros de intenção do Android
    • Relacionado: Noções Básicas de Deep Linking

20. Configuração de push notifications - registro de token e rota de inicialização a frio.

    • Procure por: Configuração de expo-notifications, listener de resposta de notificação em app/_layout.tsx
    • Pergunte: Qual ambiente envia push de teste?

21. Analytics e relatórios de erros - Sentry, Datadog, Amplitude, etc.

    • Procure por: inicialização no layout raiz ou AppProviders, padrão de uso de captureException
    • Pergunte: Regras de PII - o que é proibido em breadcrumbs?

22. Atualizações OTA - canais e política de runtimeVersion.

    • Procure por: Configuração de expo-updates, nomes de canal eas update na documentação
    • Relacionado: Noções Básicas de Atualizações OTA

23. Pasta Maestro / E2E - fluxos de smoke test e quando a CI os executa.

    • Procure por: .maestro/smoke.yml, appId correspondendo ao bundle identifier
    • Relacionado: Noções Básicas de Testes Mobile

24. Internacionalização - arquivos de locale e formatação de data/número.

    • Procure por: i18n/, locales/, uso de expo-localization
    • Sinal de alerta: Strings codificadas em telas de funcionalidades sem extração

Nível 4 - Alfabetização de Lançamento (25–30)

Você sabe como o código se torna um binário de loja e quem contatar quando ele quebra.

25. Localização do fluxo de CI - GitHub Actions, GitLab CI ou EAS Workflows.

    • Procure por: .github/workflows/pr-checks.yml, .eas/workflows/
    • Rastreie: PR aberto → quais jobs rodam → verificações necessárias para merge

26. Pipelines de PR vs. lançamento - gatilhos e segredos separados.

    • Procure por: pull_request para lint/tsc/test; tags: v* para eas build
    • Relacionado: Noções Básicas de CI/CD Mobile

27. Documentação de EXPO_TOKEN e segredos - onde as credenciais de robô vivem (não no repositório).

    • Procure por: Runbook de segredos da organização GitHub, nome do cofre 1Password
    • Nunca: Tokens em texto plano no YAML do workflow

28. Caminho de submissão para loja - quem executa eas submit e as trilhas do TestFlight / Play.

    • Procure por: Perfil submit em eas.json, links de documentação de teste interno
    • Relacionado: EAS Submit

29. Limites do Monorepo - se aplicável, qual workspace é o aplicativo móvel.

    • Procure por: apps/mobile/, packages/ui, filtros de pipeline turbo.json
    • Relacionado: Monorepo com Turborepo

30. CODEOWNERS e plantão - quem deve aprovar alterações em app/, nativas ou de lançamento.

    • Procure por: .github/CODEOWNERS, link para o cronograma PagerDuty / plantão
    • Pergunte: Processo de hotfix fora do horário comercial

Modelo de Sessão de Tour

Use esta agenda de 60 minutos com um colega:

## Tour pela base de código - <contratado> + <colega> - <data>
 
### Nível 1 (20m)
- [ ] Caminho de clone do README verificado
- [ ] app/_layout.tsx percorrido
- [ ] IDs de bundle de app.config.ts anotados
 
### Nível 2 (25m)
- [ ] Rastreado: <escolher uma funcionalidade> toque → API
- [ ] Perfis do eas.json explicados
- [ ] Comando de teste executado em conjunto
 
### Nível 3–4 (15m esboço)
- [ ] Verificações de PR de CI nomeadas
- [ ] Rótulo de build de preview demonstrado
- [ ] Perguntas abertas registradas abaixo
 
### Perguntas abertas → PRs de documentação
1.
2.

FAQs

Relacionados

• Noções Básicas de Onboarding - configuração da máquina antes do tour
• Caminho de Aprendizagem da Primeira Semana - arco da funcionalidade principal
• Noções Básicas de Configuração de Projeto - layout padrão do SDK 57
• Noções Básicas do Expo Router - roteamento app/
• Noções Básicas de Build do EAS - perfis de build
• Noções Básicas de CI/CD Mobile - pipelines de PR vs. lançamento

Versões da Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).