Wellmix
Portal Operacional de Importações da Wellmix: solicitação do cliente, RFQ com fornecedores na China, seleção, sinal, pedido, checklists, inspeção, embarque, desembaraço, transporte e entrega, com Control Tower para a equipe. O Sankhya continua sendo o ERP.
Stack: Next.js 16 (App Router, Server Actions, TypeScript, Tailwind 4) na Vercel, com Appwrite (Auth, TablesDB, Storage) em produção e um modo de dados em memória para desenvolvimento e testes.
Começando
nvm use # Node 22
npm ci
npm run dev # http://localhost:3000 (modo memória, dados em .data/)
Na primeira abertura de /login o sistema cria os dados de demonstração. Senha de todas as contas: wellmix123.
Para produção, preencha .env.example (Appwrite, SESSION_SECRET, CRON_SECRET) e publique o esquema: npm run appwrite:connect && npm run appwrite:push.
Scripts
| Script | O que faz |
|---|
npm run dev | Servidor de desenvolvimento |
npm run build | Build de produção (mesmo comando da Vercel) |
npm run lint | ESLint |
npm run typecheck | Tipos de rota + TypeScript |
npm test | Testes unitários (workflow completo, permissões, dicionários) |
npm run test:e2e | Playwright: solicitação → entrega no navegador (PW_CHROMIUM= opcional) |
npm run appwrite:connect | Conecta o CLI ao projeto a partir das variáveis de ambiente |
npm run appwrite:config | Regenera appwrite.config.json a partir de src/lib/db/schema.ts |
npm run appwrite:push | Publica tabelas e bucket no Appwrite |
Estrutura
src/
app/
login login (contas de demonstração no modo memória)
app/ área autenticada (layout com navegação por papel)
actions.ts Server Actions (toda escrita, com zod e checagem de papel)
requests, quotes, orders, tasks, notifications, account, penalties,
parties, products, lines, import, settings
api/auth/session login e logout
api/files/[id] download de documentos com controle de acesso
api/jobs/reminders cron de lembretes
api/admin/seed dados de demonstração (produção exige CRON_SECRET)
components/ kit de UI, formulários, Control Tower
i18n/ dicionários pt, en, zh
lib/
db/ schema.ts (fonte única), MemoryStore, AppwriteStore
auth/ sessão, senha, token, permissões por papel
workflow/ etapas, requisitos, engine de avanço
services/ solicitações, documentos, pendências, notificações,
auditoria, lembretes, importação, Control Tower
integrations/ Sankhya (mock) e pagamento (manual)
scripts/ conexão com o Appwrite e geração do config
tests/unit, tests/e2e vitest e Playwright
docs/ SCOPE, WORKFLOW, OPEN_DECISIONS, INTEGRATIONS, BACKLOG_FUTURO,
ARQUITETURA, APPWRITE, AMBIENTE
Documentação
