Padrões de Revisão de Código para RN

## Checklist de revisão mobile
 
### Evidência (mudanças de UI / gesto / a11y)
- [ ] Captura de tela ou gravação do iOS anexada
- [ ] Captura de tela ou gravação do Android anexada
- [ ] Verificação rápida VoiceOver OU TalkBack anotada (qual fluxo)
 
### Performance
- [ ] Listas usam FlashList/FlatList - não ScrollView para feeds longos
- [ ] `renderItem` / `keyExtractor` estáveis (useCallback ou escopo do módulo)
- [ ] Sem novas importações pesadas em `app/_layout.tsx` sem rota lazy
 
### Acessibilidade
- [ ] `accessibilityLabel` em controles apenas com ícone
- [ ] `accessibilityRole` corresponde ao comportamento (botão vs link)
- [ ] Tipo dinâmico: layout sobrevive a fontes grandes (ou `maxFontSizeMultiplier` justificado)
 
### Limite nativo
- [ ] Novas dependências adicionadas via `npx expo install <pkg>`
- [ ] Mudanças em `app.config.ts` / plugin de configuração mencionadas na descrição
- [ ] Classificado: Apenas JS (OTA OK) vs requer `eas build`
- [ ] `npx expo-doctor` verde (link do CI)
 
### Arquitetura
- [ ] Arquivo de rota fino - lógica em `features/`
- [ ] Sem importações profundas entre limites de features
- [ ] Estado do servidor em TanStack Query - não duplicado em Zustand
 
### Release (se tocar em eas.json, runtimeVersion, channels)
- [ ] Passos de rollback no ticket / comentário do PR
- [ ] Bump de runtimeVersion justificado

// ❌ Revisor bloqueia - map ScrollView de 200 pedidos
export function OrdersScreenBad() {
  const { data } = useOrders();
  return (
    <ScrollView>
      {data?.map((o) => <OrderRow key={o.id} order={o} />)}
    </ScrollView>
  );
}

// ✅ Caminho de aprovação - lista virtualizada + renderItem estável
import { FlashList } from "@shopify/flash-list";
import { useCallback } from "react";
 
export function OrdersScreen() {
  const { data } = useOrders();
  const renderItem = useCallback(
    ({ item }: { item: Order }) => <OrderRow order={item} />,
    []
  );
 
  return (
    <FlashList
      data={data ?? []}
      renderItem={renderItem}
      keyExtractor={(o) => o.id}
      estimatedItemSize={72}
    />
  );
}

// ❌ Bloqueio - apenas ícone, sem nome, função errada
<Pressable onPress={onSave}>
  <Icon name="check" />
</Pressable>

// ✅ Aprovação - nome, função, estado
<Pressable
  onPress={onSave}
  accessibilityRole="button"
  accessibilityLabel="Salvar alterações"
  accessibilityState={{ disabled: !dirty, busy: saving }}
>
  <Icon name="check" accessible={false} />
</Pressable>

// package.json - revisor verifica expo install, não npm major cru
+ "expo-camera": "~17.0.10"

// app.config.ts - stanza de plugin presente
plugins: [
  [
    "expo-camera",
    {
      cameraPermission: "Permitir que $(PRODUCT_NAME) escaneie códigos de barras do armazém.",
    },
  ],
],

// ❌ Bloqueio - fetch + ramificação na rota app/
// app/(tabs)/orders.tsx
export default function OrdersRoute() {
  const [filter, setFilter] = useState("open");
  const { data } = useQuery({ queryKey: ["orders", filter], queryFn: () => fetchOrders(filter) });
  return <FlatList data={data} ... />;
}

// ✅ Aprovação - rota fina
// app/(tabs)/orders.tsx
export { OrdersScreen as default } from "@/features/orders/screens/OrdersScreen";