# Loja, marketplace e checkout

Os outros arquivos valem inteiros aqui. Este diz o que muda quando a tela vende:
a pessoa decide com dinheiro dela, e 7 em cada 10 carrinhos são abandonados.
Os motivos que a tela controla são quase sempre os mesmos: custo que aparece
tarde, conta obrigatória, checkout comprido e cartão que não inspira confiança.

## Conteúdo

- O preço, escrito como a lei pede
- O frete e a entrega, antes do carrinho
- A listagem: carregar mais, e voltar ao mesmo ponto
- Filtros na mesa e no celular
- Avaliações que convencem
- O carrinho
- O checkout enxuto
- Pagar com cartão
- Pagar com Pix, do QR ao recibo

## O preço, escrito como a lei pede

O preço se informa pelo **total à vista**. Parcelado, a tela escreve também o
número de parcelas, o valor de cada uma, os juros e o **total a prazo**
(Decreto 5.903/2006, que vale para o comércio eletrônico). Desconto no Pix é
permitido, desde que as condições estejam à vista.

```tsx
<p className="font-display text-3xl tabular-nums">{currency(priceCents / 100)}</p>
<p className="text-fg-muted">
  {`ou ${installments}x de ${currency(installmentCents / 100)} sem juros`}
</p>
<p className="text-sm text-fg-subtle">
  {`No Pix, ${currency(pixCents / 100)} (5% de desconto)`}
</p>
```

Com juros, a frase muda: "ou 12x de R$ 129,90 com juros de 1,99% ao mês, total
R$ 1.558,80". **Nunca a parcela maior que o preço**, nem a parcela sozinha em
destaque. O `currency` recebe reais; o centavo inteiro do `CurrencyInput` e da
API se divide por 100 só na hora de escrever.

## O frete e a entrega, antes do carrinho

Dois terços das pessoas procuram o frete na página do produto, e o custo extra
é o primeiro motivo de abandono. A página do produto calcula o frete pelo CEP:

```tsx
const { mutate: quote, isPending: quoting } = useMutation({ mutationFn: quoteShipping })

<Field>
  <FieldLabel>CEP para calcular o frete</FieldLabel>
  <MaskedInput mask="cep" value={cep} onValueChange={setCep} className="sm:max-w-40" />
</Field>
<Button variant="secondary" loading={quoting} onClick={() => quote(cep)}>
  Calcular frete
</Button>
```

Quem já informou o CEP (logado, ou na visita anterior com `useLocalStorage`)
vê o frete sem pedir. **Diga a data, e não o prazo**: "Chega até quinta, 14
de novembro" decide a compra; "5 a 8 dias úteis" manda a pessoa contar no
calendário. Quem não sabe o valor exato mostra a faixa: "Frete de R$ 12 a
R$ 19, conforme o CEP".

## A listagem: carregar mais, e voltar ao mesmo ponto

Catálogo de produto usa o botão **"Carregar mais 24 produtos"** no fim da
lista: a lista cresce em vez de trocar, e dá para comparar o primeiro com o
quinquagésimo. A paginação é lenta para quem navega, e a rolagem infinita faz
passar o olho sem ler. `Pagination` fica para a listagem de operação
(`DataTable`), e `useInfiniteScroll` para feed e histórico.

- **Diga quantos há**: "128 produtos" acima da grade, e o botão diz quantos
  vêm a seguir.
- **Voltar do produto devolve a mesma posição e os mesmos itens já
  carregados.** Perder o lugar depois de três "Carregar mais" é recomeçar.
- **Imagem com proporção fixa** no `AspectRatio`, igual em todo cartão, para a
  grade não pular.

## Filtros na mesa e no celular

O padrão inteiro (o estado no endereço, os aplicados à vista no `FilterBar`, o
aplicar na hora na mesa, o vazio de filtro) está em
[filtros-e-busca.md](filtros-e-busca.md). Na loja, o que muda é o painel do
celular: um `Sheet` cujo rodapé diz quantos produtos vai mostrar.

```tsx
<Sheet open={filtersOpen} onOpenChange={setFiltersOpen}>
  <SheetContent>
    <ProductFilters value={draft} onChange={setDraft} />
    <SheetFooter>
      <Button className="w-full" onClick={() => setFiltersOpen(false)}>
        {`Ver ${preview.count} produtos`}
      </Button>
    </SheetFooter>
  </SheetContent>
</Sheet>
```

Filtro que zera a lista avisa antes: a opção que não traria nada mostra "(0)"
ou fica desligada.

## Avaliações que convencem

- **A média sempre com a contagem**: `Rating readOnly` com "4,6 (312
  avaliações)". Nota sem contagem não diz se são três pessoas ou três mil.
- **A distribuição por estrela vem antes do texto**, e cada barra filtra as
  avaliações daquela nota. Metade das pessoas procura as negativas.
- **Nunca esconda as negativas.** Elas aumentam a confiança na média; uma
  página só de cinco estrelas parece comprada.
- **Com cinco avaliações ou menos, sem resumo**: mostre as avaliações e o
  convite para avaliar.

```tsx
<div className="flex items-center gap-2">
  <Rating readOnly value={4.6} allowHalf />
  <span className="text-sm text-fg-muted tabular-nums">4,6 (312 avaliações)</span>
</div>
```

## O carrinho

- Quantidade editável no próprio item (`NumberField` com `min={1}`), com
  atualização otimista e volta no erro ([otimista.md](otimista.md)).
- Remover é na hora, com "Desfazer" no aviso, e sem `AlertDialog`.
- O subtotal, o frete pelo CEP já informado e o **total** ficam à vista antes
  do "Fechar pedido".

## O checkout enxuto

- **Compra sem conta.** A conta se oferece no `Result` do fim, quando os dados
  já foram digitados e só falta a senha. Na entrada, diga isso: "Você pode
  criar a conta no fim".
- **Cupom atrás de link**: um `Collapsible` "Tenho um cupom". O campo à vista
  manda a pessoa procurar cupom fora da loja, e ela não volta.

```tsx
const { mutate: applyCoupon, isPending: applying } = useMutation({ mutationFn: redeemCoupon })

<Collapsible>
  <CollapsibleTrigger>Tenho um cupom</CollapsibleTrigger>
  <CollapsiblePanel>
    <Field>
      <FieldLabel>Código do cupom</FieldLabel>
      <Input value={coupon} onValueChange={setCoupon} placeholder="Ex.: BEMVINDO10" />
    </Field>
    <Button variant="secondary" loading={applying} onClick={() => applyCoupon(coupon)}>
      Aplicar cupom
    </Button>
  </CollapsiblePanel>
</Collapsible>
```

- **Cobrança igual à entrega por padrão** ([forms.md](forms.md) e
  [wizard.md](wizard.md)).
- **Nome em um campo só, e o endereço que sai do CEP** ([forms.md](forms.md)).
- **Poucas opções, uma recomendada.** Frete em até três `RadioCard`, cada um
  com a data e o preço na `description`; parcelas num `Select` com cada opção
  escrevendo o total. Seis fretes quase iguais custam mais decisão do que
  economizam.
- **O botão final diz o efeito e o valor**: "Pagar R$ 1.284,90", com
  `loading`, e nunca "Finalizar".

## Pagar com cartão

Os campos do cartão ficam num bloco próprio, que nenhum outro bloco do checkout
usa: um `Fieldset` com borda e `bg-accent-subtle`, a legenda "Cartão de
crédito", o ícone `Lock` e uma frase verdadeira sobre quem processa. O olho
julga a segurança pela página; o bloco destacado é o que faz o cartão parecer
protegido.

```tsx
<Fieldset className="space-y-4 rounded-lg border border-border bg-accent-subtle p-4">
  <FieldsetLegend className="flex items-center gap-2">
    <Lock size={14} aria-hidden="true" />
    Cartão de crédito
  </FieldsetLegend>
  <p className="text-sm text-fg-muted">
    Pagamento processado pelo intermediador de pagamento. A loja não guarda o número do cartão.
  </p>
  <FormField name="cardNumber" label="Número do cartão">
    {(field) => <MaskedInput {...forValue(field)} mask="cartao" className="sm:max-w-72" />}
  </FormField>
</Fieldset>
```

- Número com `MaskedInput mask="cartao"`; nome como está no cartão; validade e
  CVV lado a lado, os dois com a largura de cinco caracteres.
- Selo só se for verdadeiro e do intermediador. Selo inventado é padrão
  enganoso ([padroes-enganosos.md](padroes-enganosos.md)).
- Recusa do cartão diz o que fazer ("O banco recusou. Tente outro cartão ou
  pague no Pix") e **mantém o endereço e o resto do pedido**.

## Pagar com Pix, do QR ao recibo

1. Valor e prazo à vista: `expiresAt` no `PixCode` mostra "Vence em 29:41"
   abaixo do valor e vence sozinho; não monte a contagem à mão.
2. No celular, o copia e cola é o caminho principal; o QR é para quem paga
   em outro aparelho.
3. A tela consulta a cobrança sozinha a cada poucos segundos e, paga, troca
   pelo `Result` com o pedido. Nunca dependa só de um "Já paguei".
4. Vencido, `expired` (ou o `expiresAt` que passou) com `onRenew`: gerar
   outro sem refazer o pedido.

```tsx
const { mutate: renew } = useMutation({ mutationFn: renewCharge })

<PixCode
  payload={charge.data?.pixCopiaECola ?? ''}
  loading={charge.isPending}
  expiresAt={charge.data?.expiresAt}
  onExpire={() => charge.refetch()}
  expired={charge.data?.status === 'expired'}
  onRenew={() => renew(order.id)}
/>
```
