Voltar ao início

Documentação

Última atualização:

Boas-vindas à documentação da SM Supports. Este guia completo ajuda você a entender nosso processo de desenvolvimento, nossa stack técnica, as integrações de API e as boas práticas para trabalhar com nossos serviços.

Primeiros passos

Siga estes passos para começar a trabalhar com os serviços e projetos da SM Supports.

  1. Consultoria inicial

    Agende uma chamada de consultoria gratuita para conversar sobre os requisitos, os objetivos e o prazo do seu projeto.

    Agendar uma chamada

  2. Planejamento do projeto

    Criaremos um plano de projeto detalhado, com escopo, etapas, entregáveis e cronograma. Você receberá uma proposta completa que descreve todos os aspectos do projeto.

  3. Desenvolvimento e colaboração

    Nossa equipe inicia o desenvolvimento com reuniões de acompanhamento e atualizações regulares. Você terá acesso a ambientes de homologação (staging) para revisar o progresso e dar feedback durante todo o processo.

  4. Lançamento e suporte

    Depois de testes completos e da sua aprovação, colocamos seu projeto no ar. Oferecemos suporte contínuo, manutenção e documentação para garantir o sucesso a longo prazo.

Stack de tecnologia

Usamos tecnologias modernas e líderes do setor para criar aplicações escaláveis e de alto desempenho.

Desenvolvimento frontend

  • Next.js 15 - Framework React com App Router
  • React 18 - Biblioteca de UI baseada em componentes
  • TypeScript - JavaScript com tipagem segura
  • Tailwind CSS - Framework CSS utility-first
  • Framer Motion - Biblioteca de animações

Backend e APIs

  • Node.js - Runtime JavaScript
  • Next.js API Routes - Funções serverless
  • APIs REST - Arquitetura RESTful
  • Cloudflare Workers - Computação na borda (edge)
  • Resend - Serviço de envio de e-mails

Banco de dados e armazenamento

  • Cloudflare D1 - SQLite serverless
  • PostgreSQL - Banco de dados relacional
  • MongoDB - Banco de dados NoSQL
  • Redis - Cache em memória

Plataformas e ferramentas

  • Wix - Plataforma de criação de sites
  • Velo (Wix Code) - Funcionalidades personalizadas
  • Git e GitHub - Controle de versão
  • Vercel - Plataforma de deploy

Referência da API

Documentação dos nossos endpoints de API e serviços de integração.

POST /api/contact

Enviar uma mensagem pelo formulário de contato

POST

Corpo da requisição:

{
  "name": "string",
  "email": "string",
  "subject": "string",
  "message": "string"
}

Resposta (200):

{
  "success": true,
  "message": "Message sent successfully"
}

POST /api/schedule

Agendar uma reunião de consultoria

POST

Corpo da requisição:

{
  "name": "string",
  "email": "string",
  "company": "string",
  "date": "string",
  "time": "string",
  "timezone": "string",
  "projectType": "string",
  "description": "string"
}

GET /api/timeslots

Obter os horários disponíveis para agendamento

GET

Parâmetros de consulta:

?date=2025-10-02&timezone=America/New_York

Resposta (200):

{
  "availableSlots": ["09:00", "10:00", "14:00"],
  "bookedSlots": ["11:00", "15:00"]
}

Deploy e hospedagem

Fazemos o deploy das aplicações em plataformas líderes do setor, para obter desempenho e confiabilidade ideais.

Vercel (plataforma principal)

Nossa principal plataforma de deploy para aplicações Next.js, com CI/CD automático, edge functions e CDN global.

  • Deploys automáticos a partir do Git
  • Deploys de prévia para pull requests
  • Rede edge com mais de 100 locais
  • Análises e monitoramento integrados

Cloudflare Pages e Workers

Plataforma de computação na borda (edge) para funções serverless, banco de dados D1 e hospedagem de sites estáticos.

  • Banco de dados SQLite D1 serverless
  • Workers para computação na borda
  • Armazenamento de objetos R2
  • Proteção contra DDoS e segurança

Soluções de hospedagem sob medida

Também trabalhamos com diversos provedores de hospedagem, de acordo com os requisitos de cada projeto.

  • AWS (EC2, S3, CloudFront, Lambda)
  • DigitalOcean (Droplets, App Platform)
  • Netlify (sites estáticos, edge functions)
  • Heroku (deploy de contêineres)

Boas práticas

Diretrizes e recomendações para trabalhar com os projetos da SM Supports.

Qualidade do código

  • Use TypeScript para ter segurança de tipos e uma experiência de desenvolvimento melhor
  • Siga as configurações do ESLint e do Prettier para manter um estilo de código consistente
  • Escreva mensagens de commit claras, seguindo o padrão Conventional Commits
  • Mantenha os componentes pequenos, focados e reutilizáveis
  • Documente lógicas complexas e interfaces de API

Otimização de desempenho

  • Otimize imagens com o componente Image do Next.js
  • Implemente o carregamento lento (lazy loading) para o conteúdo abaixo da dobra
  • Use React Server Components sempre que possível
  • Reduza o tamanho do bundle com code splitting e tree shaking
  • Faça cache adequado das respostas de API e dos arquivos estáticos

Segurança

  • Nunca faça commit de dados sensíveis ou chaves de API no controle de versão
  • Use variáveis de ambiente para as configurações
  • Implemente validação e sanitização adequadas das entradas
  • Use HTTPS em todos os deploys de produção
  • Mantenha as dependências atualizadas para corrigir vulnerabilidades de segurança

Acessibilidade (A11y)

  • Use elementos HTML semânticos (nav, main, article etc.)
  • Forneça texto alternativo (alt) para todas as imagens
  • Garanta uma relação de contraste de cores adequada
  • Torne os elementos interativos acessíveis pelo teclado
  • Teste com leitores de tela e ferramentas de acessibilidade

Solução de problemas

Problemas comuns e como resolvê-los.

Erros de build

Problema: o build falha com erros de TypeScript ou ESLint

Solução:

  • Execute npm run lint para identificar os problemas
  • Verifique se há dependências faltando no package.json
  • Confira se todas as importações estão tipadas corretamente
  • Apague a pasta .next e faça o build novamente

Problemas de conexão com a API

Problema: endpoints de API retornam erros ou excedem o tempo limite

Solução:

  • Verifique se as variáveis de ambiente estão configuradas corretamente
  • Confira os limites de requisições e as cotas da API
  • Revise as configurações de CORS para requisições entre origens
  • Acompanhe a aba Rede (Network) no DevTools do navegador

Problemas de desempenho

Problema: páginas carregam devagar ou têm pontuações baixas no Lighthouse

Solução:

  • Otimize as imagens (use o formato WebP e dimensões adequadas)
  • Ative o lazy loading para imagens e componentes
  • Reduza o tamanho do bundle JavaScript
  • Use cache na borda (edge) para as respostas de API
  • Implemente estados de carregamento adequados

Precisa de mais ajuda?

Não encontrou o que procurava? Nossa equipe está pronta para ajudar você com qualquer dúvida ou com suporte técnico.

E-mail:
[email protected]
Telefone:
(+880) 13013-60818
Horário de atendimento:
Seg. a sex., das 9h às 18h (horário de Bangladesh, BST)
Falar com o suporteAgendar uma chamada