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>
51 lines
1.9 KiB
Markdown
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)
|
|
```
|