# SeConectai Vendas — Frontend

Aplicação Next.js (App Router) que consome a API do backend NestJS deste
mesmo repositório. Arquitetura de referência:
[`Etapas/V2/10-frontend-schema-arquitetura.md`](../Etapas/V2/10-frontend-schema-arquitetura.md).
Estado de progresso das etapas de frontend:
[`Etapas/V2/20-controle-de-progresso-frontend.md`](../Etapas/V2/20-controle-de-progresso-frontend.md).

## Rodando localmente

1. Backend rodando (via `docker compose up -d` na raiz do repo, ou
   localmente) — necessário para `/diagnostico` e para qualquer chamada de
   API.
2. `cp .env.local.example .env.local` e ajuste `NEXT_PUBLIC_API_URL` se o
   backend não estiver em `http://localhost:3000`.
3. `npm install`
4. `npm run dev` — sobe em `http://localhost:3001` (porta 3000 é do
   backend; se estiver livre o Next também aceitaria 3000, mas o
   `CORS_ORIGINS` do backend já está configurado para 3001).

## Scripts

- `npm run dev` — servidor de desenvolvimento (Turbopack)
- `npm run build` — build de produção
- `npm run start` — serve o build de produção
- `npm run lint` — ESLint
- `npm run format` / `npm run format:check` — Prettier

## Stack

Next.js 15 (App Router) + React 19 + TypeScript, Tailwind CSS v4
(tokens definidos em [`styles/tokens.css`](./styles/tokens.css) via
`@theme inline`, não em `tailwind.config.ts` — ver decisão registrada no
controle de progresso da Etapa 11).

## Estrutura

```
app/(public)/    rotas públicas (login, recuperação de senha)
app/master/      painel master
app/app/         painel tenant
components/ui/   componentes base (Etapa 12)
components/layout/  sidebar/topbar/drawer (Etapa 14)
components/domain/  componentes específicos de domínio
lib/api/         cliente HTTP
lib/auth/        sessão/autenticação (Etapa 13)
lib/theme/       resolução de tema whitelabel (Etapa 13)
lib/validators/  schemas Zod
styles/tokens.css  tokens de design (CSS variables)
```