Guia do Desenvolvedor

Bem-vindo ao Guia do Desenvolvedor do sistema Trevo. Esta seção fornece documentação técnica completa para desenvolvedores que trabalham com o código.

Visão Geral

O Guia do Desenvolvedor cobre:

Arquitetura

• Estrutura geral do sistema
• Frontend (Nuxt.js)
• Backend (Node.js/Express/TypeScript)
• Banco de dados (MongoDB)
• Armazenamento de arquivos (AWS S3)

Setup Local

• Configuração do ambiente de desenvolvimento
• Setup do frontend
• Setup do backend
• Variáveis de ambiente

Deployment

• Deploy do frontend na Vercel
• Deploy do backend na Render
• Configuração de ambientes
• Troubleshooting

API

• Documentação da API REST
• Autenticação JWT
• Endpoints disponíveis
• Tratamento de erros

Manutenção

• Monitoramento
• Logs
• Backup do banco de dados
• Segurança

Código

• Estrutura do projeto
• Gerenciamento de estado
• Serviços
• Componentes
• Tipos TypeScript

Tecnologias Principais

Frontend

• Framework: Nuxt.js 3.17.2
• Linguagem: Vue 3.5.13 + TypeScript
• State Management: Pinia 3.0.2
• UI: PrimeVue 4.3.4 + Tailwind CSS 4.1.6
• HTTP Client: Axios 1.9.0

Backend

• Runtime: Node.js 20
• Framework: Express com TypeScript
• Database: MongoDB Atlas (Mongoose)
• File Storage: AWS S3
• Email: Mailgun

Próximos Passos

• Arquitetura - Entender a arquitetura do sistema
• Setup Local - Configurar ambiente de desenvolvimento
• Deployment - Fazer deploy da aplicação
• API - Documentação da API