Adiciona documentação de arquitetura completa com diagramas Mermaid

[Copilot]

📋 Resumo

Criada documentação arquitetural abrangente para o projeto Go Cart API, incluindo diagramas detalhados em formato Mermaid que ilustram a estrutura, fluxos e relacionamentos do sistema.

🎯 Motivação

O projeto não possuía documentação visual da sua arquitetura, dificultando:

• Onboarding de novos desenvolvedores
• Compreensão da estrutura do sistema
• Manutenção e evolução do código
• Comunicação técnica entre stakeholders

🏗️ Arquitetura Documentada

O sistema segue Clean Architecture com separação clara de responsabilidades:

Cliente → Router → Auth Middleware → Handler → Repository → Database

Stack Principal:

• Backend: Go 1.23+ com Gorilla Mux
• Database: PostgreSQL via Supabase
• Auth: JWT + bcrypt
• Deploy: Render/Heroku

📁 Arquivos Adicionados

docs/architecture.md - Documentação Principal

Contém 7 diagramas Mermaid detalhados:

1. Arquitetura Geral: Sistema completo com todas as camadas (handlers, repositories, database)
2. Fluxo de Autenticação: Sequence diagram mostrando registro, login e validação JWT
3. Modelo de Dados (ERD): Relacionamentos entre users, products, cart, orders, etc.
4. Fluxo de Requests: Como requisições HTTP são processadas através das camadas
5. Estrutura de Pastas: Organização do código e responsabilidades de cada módulo
6. Tecnologias: Stack completo e dependências
7. Padrões Arquiteturais: Clean Architecture, Repository Pattern, Middleware Pattern

docs/endpoints.md - Mapa Visual da API

• Diagrama com todas as rotas públicas e protegidas
• Fluxo da jornada do usuário no e-commerce
• Organização por funcionalidade (auth, users, products, cart, orders)

docs/quick-reference.md - Referência Rápida

• Arquitetura em ASCII art
• Tabela de componentes e tecnologias
• Fluxo de dados simplificado

docs/README.md - Índice da Documentação

• Guia de navegação pela documentação
• Instruções para visualizar diagramas
• Ordem recomendada de leitura

🔄 Melhorias no README Principal

Adicionada seção de arquitetura com:

• Link para documentação completa
• Resumo arquitetural visual
• Referência aos padrões utilizados

🎨 Visualização

Os diagramas Mermaid são renderizados automaticamente no GitHub e podem ser visualizados em:

• GitHub (nativo)
• VS Code (com extensão Mermaid Preview)
• Mermaid Live Editor
• Qualquer plataforma que suporte Mermaid

✅ Verificação

• ✅ Projeto continua buildando corretamente
• ✅ Nenhuma funcionalidade alterada
• ✅ Documentação acessível e bem organizada
• ✅ Diagramas renderizam corretamente
• ✅ Links funcionais entre documentos

Esta documentação facilitará significativamente o entendimento e manutenção do sistema, servindo como referência técnica para a equipe de desenvolvimento.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Bulletdev]

Reviewed and approved