Files
tiagoandClaude Sonnet 5 323912748f Frontend completo (Etapas 11-18) e extensões de backend (Etapas 13 e 18)
Adiciona o frontend Next.js em frontend/ (setup, design system,
autenticação/tema, layout/navegação, área master, área tenant completa:
clientes, produtos, vendas, recebimentos, whatsapp, e-mail, alertas,
equipe e perfil). Estende o backend de forma aditiva e autorizada:
cookie httpOnly para refresh token (Etapa 13) e CRUD de equipe +
edição de perfil do tenant (Etapa 18, módulo src/modules/equipe/ novo
e PUT /tenant/perfil). Detalhes completos em Etapas/V2/*.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-16 09:41:13 -03:00

51 lines
1.9 KiB
Markdown

# 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)
```