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

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

OpenSSF Scorecard

Package	Version	Score	Details
gomod/github.com/kr/text	0.2.0	🟢 4	Details Check Score Reason Code-Review ⚠️ 2 Found 5/22 approved changesets -- score normalized to 2 Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Packaging ⚠️ -1 packaging workflow not detected Binary-Artifacts 🟢 10 no binaries found in the repo Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions Maintained ⚠️ 0 0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 Pinned-Dependencies ⚠️ 0 dependency not pinned by hash detected -- score normalized to 0 CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Security-Policy ⚠️ 0 security policy file not detected Fuzzing ⚠️ 0 project is not fuzzed License 🟢 10 license file detected Signed-Releases ⚠️ -1 no releases found Branch-Protection ⚠️ -1 internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md Vulnerabilities 🟢 10 0 existing vulnerabilities detected SAST ⚠️ 0 SAST tool is not run on all commits -- score normalized to 0
gomod/github.com/rogpeppe/go-internal	1.14.1	🟢 4.9	Details Check Score Reason Maintained ⚠️ 0 0 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 0 Code-Review 🟢 9 Found 24/25 approved changesets -- score normalized to 9 Dangerous-Workflow 🟢 10 no dangerous workflow patterns detected Packaging ⚠️ -1 packaging workflow not detected Token-Permissions ⚠️ 0 detected GitHub workflow tokens with excessive permissions CII-Best-Practices ⚠️ 0 no effort to earn an OpenSSF best practices badge detected Binary-Artifacts 🟢 10 no binaries found in the repo Pinned-Dependencies ⚠️ 0 dependency not pinned by hash detected -- score normalized to 0 Security-Policy ⚠️ 0 security policy file not detected Fuzzing 🟢 10 project is fuzzed License 🟢 10 license file detected Branch-Protection ⚠️ 0 branch protection not enabled on development/release branches Signed-Releases ⚠️ -1 no releases found Vulnerabilities 🟢 10 0 existing vulnerabilities detected SAST ⚠️ 0 SAST tool is not run on all commits -- score normalized to 0

Scanned Files

• go.mod