# Bloco: Fechamento do caixa

O caixa do mês de uma loja: o mês num MonthPicker, o resumo das vendas nos quatro finais, o bloqueio que diz o porquê e o Result no fim do fluxo.

Uma tela inteira, montada só com peças do @rivocode/ui e as regras da skill. Copie o arquivo, troque os dados de exemplo pelos da sua consulta e mantenha os quatro finais: dados, carregando, erro e vazio. Ele importa só de `@rivocode/ui` e `react`.

Peças: [MonthPicker](https://ds.rivocode.com.br/componentes/month-picker.md), [QueryBoundary](https://ds.rivocode.com.br/componentes/query-boundary.md), [DescriptionList](https://ds.rivocode.com.br/componentes/description-list.md), [Alert](https://ds.rivocode.com.br/componentes/alert.md), [Result](https://ds.rivocode.com.br/componentes/result.md), [PageHeader](https://ds.rivocode.com.br/componentes/page-header.md).

Padrões de UX que ele aplica: [Somente leitura, desabilitado e sem permissão](https://ds.rivocode.com.br/padroes/estados-de-acesso.md), [O que fazer quando dá errado](https://ds.rivocode.com.br/padroes/erros.md).

Ao vivo, no desktop e no celular: https://ds.rivocode.com.br/blocos#fechamento-do-caixa

## Código

```tsx
import {
  Alert,
  AlertDescription,
  AlertTitle,
  Button,
  Card,
  CardContent,
  CardFooter,
  CardHeader,
  CardTitle,
  DescriptionItem,
  DescriptionList,
  Field,
  FieldDescription,
  FieldLabel,
  MonthPicker,
  PageHeader,
  QueryBoundary,
  Result,
  currencyShort,
} from '@rivocode/ui'
import { useEffect, useState } from 'react'

type Summary = { month: string; sales: number; revenue: number; fees: number; pending: number }

const SUMMARIES: Record<string, Summary> = {
  '2026-08': { month: 'agosto de 2026', sales: 1_284, revenue: 96_420, fees: 2_892, pending: 0 },
  '2026-07': { month: 'julho de 2026', sales: 1_107, revenue: 83_150, fees: 2_494, pending: 0 },
  '2026-09': { month: 'setembro de 2026', sales: 1_196, revenue: 89_730, fees: 2_691, pending: 2 },
}

/** A consulta de mentira: julho falha na primeira vez, para a tela mostrar o erro. */
function useSummary(month: string | null) {
  const [state, setState] = useState<{ month: string | null; data?: Summary | null; failed?: boolean }>({ month })
  const [attempt, setAttempt] = useState(0)

  useEffect(() => {
    if (!month) return
    setState({ month })
    const timer = setTimeout(() => {
      if (month === '2026-07' && attempt === 0) setState({ month, failed: true })
      else setState({ month, data: SUMMARIES[month] ?? null })
    }, 600)
    return () => clearTimeout(timer)
  }, [month, attempt])

  const current = state.month === month
  return {
    data: current ? state.data : undefined,
    isLoading: Boolean(month) && (!current || (state.data === undefined && !state.failed)),
    isError: current && Boolean(state.failed),
    refetch: () => setAttempt((count) => count + 1),
  }
}

export default function MonthClosePage() {
  const [month, setMonth] = useState<string | null>('2026-09')
  const [closing, setClosing] = useState(false)
  const [closed, setClosed] = useState<Summary | null>(null)
  const summary = useSummary(month)

  if (closed) {
    return (
      <div className="flex w-full justify-center bg-bg px-4 py-12 sm:py-16">
        <Result
          tone="success"
          titleAs="h1"
          title={`Caixa de ${closed.month} fechado`}
          description={`As ${closed.sales} vendas foram para a contabilidade, com ${currencyShort(closed.fees)} de taxa das maquininhas. O mês não aceita lançamento novo.`}
          actions={
            <>
              <Button onClick={() => setClosed(null)}>Fechar outro mês</Button>
              <Button variant="secondary" render={<a href="/vendas" />}>
                Ver as vendas
              </Button>
            </>
          }
        />
      </div>
    )
  }

  const blocked = Boolean(summary.data && summary.data.pending > 0)

  return (
    <div className="w-full space-y-6 bg-bg p-4 sm:p-6">
      <PageHeader
        title="Fechamento do caixa"
        description="Confira as vendas do mês na loja e envie o fechamento para a contabilidade."
      />

      <div className="max-w-xl space-y-6">
        <Field className="w-56">
          <FieldLabel>Mês</FieldLabel>
          <MonthPicker value={month} onValueChange={setMonth} min="2026-01" max="2026-09" />
          <FieldDescription>
            Só meses que já terminaram. Setembro ainda tem venda no cartão sem conciliar.
          </FieldDescription>
        </Field>

        {month && (
          <QueryBoundary
            data={summary.data}
            isLoading={summary.isLoading}
            isError={summary.isError}
            onRetry={summary.refetch}
            isEmpty={summary.data === null}
            errorTitle="Não foi possível carregar o resumo do mês"
            errorMessage="O servidor do caixa não respondeu. Tente de novo em alguns minutos."
            empty={{
              title: 'Nenhuma venda neste mês',
              description: 'Mês sem venda não precisa de fechamento. Escolha outro.',
            }}
            skeletonRows={4}
          >
            {(data) => (
              <Card>
                <CardHeader>
                  <CardTitle render={<h2 />}>Resumo de {data.month}</CardTitle>
                </CardHeader>
                <CardContent className="space-y-4">
                  <DescriptionList>
                    <DescriptionItem label="Vendas">
                      <span className="tabular-nums">{data.sales}</span>
                    </DescriptionItem>
                    <DescriptionItem label="Total vendido">
                      <span className="tabular-nums">{currencyShort(data.revenue)}</span>
                    </DescriptionItem>
                    <DescriptionItem label="Taxa das maquininhas">
                      <span className="tabular-nums">{currencyShort(data.fees)}</span>
                    </DescriptionItem>
                  </DescriptionList>
                  {blocked && (
                    <Alert tone="warning">
                      <AlertTitle>{data.pending} vendas no cartão ainda sem conciliar</AlertTitle>
                      <AlertDescription>
                        O mês fecha quando o extrato da operadora bater com cada uma delas.
                      </AlertDescription>
                    </Alert>
                  )}
                </CardContent>
                <CardFooter>
                  <Button
                    loading={closing}
                    disabled={blocked}
                    onClick={() => {
                      setClosing(true)
                      setTimeout(() => {
                        setClosing(false)
                        setClosed(data)
                      }, 900)
                    }}
                  >
                    Fechar {data.month}
                  </Button>
                </CardFooter>
              </Card>
            )}
          </QueryBoundary>
        )}
      </div>
    </div>
  )
}
```
