From a8d7768fe54358c09e076c8ad8588be3e609dbe2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 22 Sep 2025 08:03:34 +0000
Subject: [PATCH 1/3] Initial plan
From 6b6b07a0b8536cd83f64c29c4a47efb2a90d41e9 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 22 Sep 2025 08:06:27 +0000
Subject: [PATCH 2/3] Initial exploration and project setup
Co-authored-by: Bulletdev <109600318+Bulletdev@users.noreply.github.com>
---
go.mod | 18 +++++++++++-------
go.sum | 15 +++++++++------
vendor/modules.txt | 4 ++++
3 files changed, 24 insertions(+), 13 deletions(-)
diff --git a/go.mod b/go.mod
index 5e88ca6..c022599 100644
--- a/go.mod
+++ b/go.mod
@@ -4,21 +4,25 @@ go 1.23.0
toolchain go1.24.1
-require github.com/gorilla/mux v1.8.1
+require (
+ github.com/golang-jwt/jwt/v5 v5.2.2
+ github.com/google/uuid v1.6.0
+ github.com/gorilla/mux v1.8.1
+ github.com/jackc/pgx/v5 v5.7.4
+ github.com/joho/godotenv v1.5.1
+ github.com/stretchr/testify v1.10.0
+ golang.org/x/crypto v0.37.0
+)
require (
github.com/davecgh/go-spew v1.1.1 // indirect
- github.com/golang-jwt/jwt/v5 v5.2.2 // indirect
- github.com/google/uuid v1.6.0 // indirect
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
- github.com/jackc/pgx/v5 v5.7.4 // indirect
github.com/jackc/puddle/v2 v2.2.2 // indirect
- github.com/joho/godotenv v1.5.1 // indirect
+ github.com/kr/text v0.2.0 // indirect
github.com/pmezard/go-difflib v1.0.0 // indirect
+ github.com/rogpeppe/go-internal v1.14.1 // indirect
github.com/stretchr/objx v0.5.2 // indirect
- github.com/stretchr/testify v1.10.0 // indirect
- golang.org/x/crypto v0.37.0 // indirect
golang.org/x/sync v0.13.0 // indirect
golang.org/x/text v0.24.0 // indirect
gopkg.in/yaml.v3 v3.0.1 // indirect
diff --git a/go.sum b/go.sum
index 68541b6..81d88b0 100644
--- a/go.sum
+++ b/go.sum
@@ -1,3 +1,4 @@
+github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E=
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
@@ -17,8 +18,14 @@ github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo
github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
+github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0=
+github.com/kr/pretty v0.3.0/go.mod h1:640gp4NfQd8pI5XOwp5fnNeVWj67G7CFk/SaSQn7NBk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
+github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
@@ -26,19 +33,15 @@ github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UV
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-golang.org/x/crypto v0.31.0 h1:ihbySMvVjLAeSH1IbfcRTkD/iNscyz8rGzjF/E5hV6U=
-golang.org/x/crypto v0.31.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk=
golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE=
golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc=
-golang.org/x/sync v0.10.0 h1:3NQrjDixjgGwUOCaF8w2+VYHv0Ve/vGYSbdkTa98gmQ=
-golang.org/x/sync v0.10.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
golang.org/x/sync v0.13.0 h1:AauUjRAJ9OSnvULf/ARrrVywoJDy0YS2AwQ98I37610=
golang.org/x/sync v0.13.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
-golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo=
-golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ=
golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0=
golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/vendor/modules.txt b/vendor/modules.txt
index 25da756..67350f2 100644
--- a/vendor/modules.txt
+++ b/vendor/modules.txt
@@ -36,9 +36,13 @@ github.com/jackc/puddle/v2/internal/genstack
# github.com/joho/godotenv v1.5.1
## explicit; go 1.12
github.com/joho/godotenv
+# github.com/kr/text v0.2.0
+## explicit
# github.com/pmezard/go-difflib v1.0.0
## explicit
github.com/pmezard/go-difflib/difflib
+# github.com/rogpeppe/go-internal v1.14.1
+## explicit; go 1.23
# github.com/stretchr/objx v0.5.2
## explicit; go 1.20
github.com/stretchr/objx
From abb57e7fb4eaaa1da585305aeeb2d36ba1a09343 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 22 Sep 2025 08:11:30 +0000
Subject: [PATCH 3/3] Create comprehensive architecture documentation with
Mermaid diagrams
Co-authored-by: Bulletdev <109600318+Bulletdev@users.noreply.github.com>
---
docs/README.md | 71 +++++++
docs/architecture.md | 426 ++++++++++++++++++++++++++++++++++++++++
docs/endpoints.md | 102 ++++++++++
docs/quick-reference.md | 66 +++++++
go-cart-api | Bin 0 -> 15606924 bytes
readme.md | 24 +++
6 files changed, 689 insertions(+)
create mode 100644 docs/README.md
create mode 100644 docs/architecture.md
create mode 100644 docs/endpoints.md
create mode 100644 docs/quick-reference.md
create mode 100755 go-cart-api
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..b2e74e2
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,71 @@
+# Documentação - Go Cart API
+
+Bem-vindo à documentação técnica do projeto Go Cart API. Este diretório contém toda a documentação arquitetural e técnica do sistema.
+
+## 📁 Arquivos de Documentação
+
+### 🏗️ [architecture.md](./architecture.md)
+Documentação completa da arquitetura do sistema, incluindo:
+
+- **Diagrama de Arquitetura Geral**: Visão macro do sistema com todas as camadas
+- **Fluxo de Autenticação**: Sequência detalhada dos processos de login/registro
+- **Modelo de Dados (ERD)**: Estrutura do banco de dados com relacionamentos
+- **Fluxo de Requests**: Como as requisições são processadas
+- **Estrutura de Pastas**: Organização do código e responsabilidades
+- **Tecnologias Utilizadas**: Stack tecnológico completo
+- **Padrões Arquiteturais**: Design patterns implementados
+
+## 🎯 Como Visualizar os Diagramas
+
+Os diagramas estão criados em formato **Mermaid**, que pode ser visualizado em:
+
+### GitHub
+Os diagramas são renderizados automaticamente quando você visualiza os arquivos `.md` diretamente no GitHub.
+
+### Editores Locais
+- **VS Code**: Instale a extensão "Mermaid Preview"
+- **IntelliJ/GoLand**: Suporte nativo para Mermaid
+- **Online**: [Mermaid Live Editor](https://mermaid.live/)
+
+### Documentação Online
+- GitBook, Notion, ou qualquer plataforma que suporte Mermaid
+
+## 🧩 Visão Geral da Arquitetura
+
+Este projeto segue os princípios de **Clean Architecture** com as seguintes características:
+
+- **Separação de Responsabilidades**: Cada camada tem função específica
+- **Inversão de Dependências**: Interfaces bem definidas entre camadas
+- **Testabilidade**: Estrutura preparada para testes unitários e integração
+- **Escalabilidade**: Arquitetura que facilita crescimento e manutenção
+
+## 🚀 Stack Tecnológico Principal
+
+- **Backend**: Go 1.23+ com Gorilla Mux
+- **Database**: PostgreSQL via Supabase
+- **Autenticação**: JWT + bcrypt
+- **Deploy**: Render/Heroku
+- **Testes**: Go testing + testify
+
+## 📚 Para Desenvolvedores
+
+Se você é novo no projeto, recomendamos a leitura na seguinte ordem:
+
+1. **README principal** do projeto para setup inicial
+2. **[architecture.md](./architecture.md)** para entender a estrutura
+3. **Código fonte** começando por `cmd/main.go`
+4. **Testes** em `internal/handlers/*_test.go`
+
+## 🔄 Manutenção da Documentação
+
+Esta documentação deve ser atualizada sempre que:
+- Novos componentes forem adicionados
+- A arquitetura for modificada
+- Novas dependências forem incluídas
+- Padrões de desenvolvimento mudarem
+
+## 📞 Suporte
+
+Para dúvidas sobre a arquitetura ou documentação:
+- Abra uma issue no repositório
+- Entre em contato com a equipe de desenvolvimento
\ No newline at end of file
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..8c9e36f
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1,426 @@
+# Diagrama de Arquitetura - Go Cart API
+
+Esta documentação apresenta os diagramas de arquitetura do sistema Go Cart API, uma API RESTful em Go para e-commerce.
+
+## 1. Arquitetura Geral do Sistema
+
+```mermaid
+graph TB
+ subgraph "Cliente"
+ Client[Cliente HTTP/API]
+ WebApp[Aplicação Web]
+ Mobile[App Mobile]
+ end
+
+ subgraph "Load Balancer/Reverse Proxy"
+ LB[Load Balancer
Nginx/Render]
+ end
+
+ subgraph "Go Cart API Application"
+ subgraph "HTTP Layer"
+ Router[Gorilla Mux Router
:4445+]
+ MW[Auth Middleware
JWT Validation]
+ end
+
+ subgraph "Handler Layer"
+ AuthH[Auth Handler
Login/Register]
+ UserH[User Handler
Profile/Addresses]
+ ProductH[Product Handler
CRUD Products]
+ CategoryH[Category Handler
CRUD Categories]
+ CartH[Cart Handler
Shopping Cart]
+ OrderH[Order Handler
Order Management]
+ HealthH[Health Handler
System Status]
+ end
+
+ subgraph "Business Logic Layer"
+ UserRepo[User Repository]
+ ProductRepo[Product Repository]
+ CategoryRepo[Category Repository]
+ AddressRepo[Address Repository]
+ CartRepo[Cart Repository]
+ OrderRepo[Order Repository]
+ end
+
+ subgraph "Security & Utils"
+ JWT[JWT Service
Token Generation]
+ BCrypt[BCrypt Hasher
Password Security]
+ WebUtils[Web Utils
JSON Helpers]
+ end
+
+ subgraph "Configuration"
+ Config[Config Loader
ENV Variables]
+ DB[Database Connection
pgxpool]
+ end
+ end
+
+ subgraph "External Services"
+ subgraph "Database"
+ PostgreSQL[(PostgreSQL
via Supabase)]
+ end
+
+ subgraph "Environment"
+ ENV[Environment Variables
DATABASE_URL
JWT_SECRET
PORT]
+ end
+ end
+
+ %% Connections
+ Client --> LB
+ WebApp --> LB
+ Mobile --> LB
+
+ LB --> Router
+
+ Router --> MW
+ MW --> AuthH
+ MW --> UserH
+ MW --> ProductH
+ MW --> CategoryH
+ MW --> CartH
+ MW --> OrderH
+ Router --> HealthH
+
+ AuthH --> UserRepo
+ AuthH --> JWT
+ AuthH --> BCrypt
+
+ UserH --> UserRepo
+ UserH --> AddressRepo
+
+ ProductH --> ProductRepo
+ CategoryH --> CategoryRepo
+ CartH --> CartRepo
+ CartH --> ProductRepo
+ OrderH --> OrderRepo
+ OrderH --> CartRepo
+ OrderH --> AddressRepo
+
+ UserRepo --> DB
+ ProductRepo --> DB
+ CategoryRepo --> DB
+ AddressRepo --> DB
+ CartRepo --> DB
+ OrderRepo --> DB
+
+ DB --> PostgreSQL
+ Config --> ENV
+
+ %% Styling
+ classDef handler fill:#e1f5fe
+ classDef repo fill:#f3e5f5
+ classDef security fill:#fff3e0
+ classDef database fill:#e8f5e8
+ classDef external fill:#fce4ec
+
+ class AuthH,UserH,ProductH,CategoryH,CartH,OrderH,HealthH handler
+ class UserRepo,ProductRepo,CategoryRepo,AddressRepo,CartRepo,OrderRepo repo
+ class JWT,BCrypt,MW security
+ class PostgreSQL,DB database
+ class ENV,LB external
+```
+
+## 2. Fluxo de Autenticação
+
+```mermaid
+sequenceDiagram
+ participant C as Cliente
+ participant R as Router
+ participant AH as Auth Handler
+ participant UR as User Repository
+ participant BC as BCrypt
+ participant JWT as JWT Service
+ participant DB as PostgreSQL
+
+ %% Registro
+ Note over C,DB: Fluxo de Registro
+ C->>+R: POST /api/auth/register
+ R->>+AH: Register()
+ AH->>+BC: HashPassword()
+ BC-->>-AH: hashedPassword
+ AH->>+UR: Create(name, email, hash)
+ UR->>+DB: INSERT INTO users
+ DB-->>-UR: user created
+ UR-->>-AH: User object
+ AH->>+JWT: GenerateToken(userID)
+ JWT-->>-AH: token
+ AH-->>-R: {user, token}
+ R-->>-C: 201 Created
+
+ %% Login
+ Note over C,DB: Fluxo de Login
+ C->>+R: POST /api/auth/login
+ R->>+AH: Login()
+ AH->>+UR: FindByEmail(email)
+ UR->>+DB: SELECT FROM users
+ DB-->>-UR: user data
+ UR-->>-AH: User object
+ AH->>+BC: ValidatePassword()
+ BC-->>-AH: valid/invalid
+ AH->>+JWT: GenerateToken(userID)
+ JWT-->>-AH: token
+ AH-->>-R: {user, token}
+ R-->>-C: 200 OK
+
+ %% Autenticação
+ Note over C,DB: Requests Autenticados
+ C->>+R: GET /api/users/me (Bearer token)
+ R->>+MW: Authenticate()
+ MW->>+JWT: ValidateToken()
+ JWT-->>-MW: claims
+ MW->>+UR: FindByID(userID)
+ UR-->>-MW: user exists
+ MW-->>-R: context with userID
+ R->>UH: GetMe()
+ UH-->>R: user data
+ R-->>-C: 200 OK
+```
+
+## 3. Modelo de Dados (ERD)
+
+```mermaid
+erDiagram
+ USERS {
+ uuid id PK
+ string name
+ string email UK
+ string password_hash
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ ADDRESSES {
+ uuid id PK
+ uuid user_id FK
+ string street
+ string city
+ string state
+ string zip_code
+ string country
+ boolean is_default
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ CATEGORIES {
+ uuid id PK
+ string name UK
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ PRODUCTS {
+ uuid id PK
+ string name
+ string description
+ decimal price
+ uuid category_id FK "nullable"
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ CARTS {
+ uuid id PK
+ uuid user_id FK
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ CART_ITEMS {
+ uuid id PK
+ uuid cart_id FK
+ uuid product_id FK
+ integer quantity
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ ORDERS {
+ uuid id PK
+ uuid user_id FK
+ uuid address_id FK
+ decimal total_amount
+ string status
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ ORDER_ITEMS {
+ uuid id PK
+ uuid order_id FK
+ uuid product_id FK
+ integer quantity
+ decimal price_at_time
+ timestamp created_at
+ timestamp updated_at
+ }
+
+ %% Relationships
+ USERS ||--o{ ADDRESSES : "has"
+ USERS ||--|| CARTS : "owns"
+ USERS ||--o{ ORDERS : "places"
+
+ CATEGORIES ||--o{ PRODUCTS : "contains"
+
+ CARTS ||--o{ CART_ITEMS : "contains"
+ PRODUCTS ||--o{ CART_ITEMS : "referenced_by"
+
+ ORDERS ||--o{ ORDER_ITEMS : "contains"
+ PRODUCTS ||--o{ ORDER_ITEMS : "referenced_by"
+ ADDRESSES ||--o{ ORDERS : "delivery_to"
+```
+
+## 4. Fluxo de API Requests
+
+```mermaid
+graph TD
+ A[Cliente HTTP Request] --> B{Rota Pública?}
+
+ B -->|Sim| C[Handler Direto]
+ B -->|Não| D[Auth Middleware]
+
+ D --> E{Token Válido?}
+ E -->|Não| F[401 Unauthorized]
+ E -->|Sim| G[Adicionar UserID ao Context]
+
+ G --> H[Handler Específico]
+ C --> H
+
+ H --> I[Validar Request]
+ I --> J{Dados Válidos?}
+ J -->|Não| K[400 Bad Request]
+ J -->|Sim| L[Repository Layer]
+
+ L --> M[Database Query]
+ M --> N{Query Sucesso?}
+ N -->|Não| O[500 Internal Error]
+ N -->|Sim| P[Processar Resultado]
+
+ P --> Q[JSON Response]
+ Q --> R[Cliente]
+
+ F --> R
+ K --> R
+ O --> R
+
+ %% Styling
+ classDef error fill:#ffcdd2
+ classDef success fill:#c8e6c9
+ classDef process fill:#e1f5fe
+
+ class F,K,O error
+ class Q,R success
+ class D,G,H,I,L,P process
+```
+
+## 5. Estrutura de Pastas e Responsabilidades
+
+```mermaid
+graph TD
+ subgraph "Projeto Go Cart API"
+ subgraph "cmd/"
+ MainGo[main.go
• Entry point
• Server setup
• Route configuration]
+ end
+
+ subgraph "internal/"
+ subgraph "handlers/"
+ Handlers[• HTTP request handling
• Input validation
• Response formatting
• Error handling]
+ end
+
+ subgraph "models/"
+ Models[• Data structures
• Business entities
• JSON tags
• Database mappings]
+ end
+
+ subgraph "repositories/"
+ Repos[users/
products/
categories/
addresses/
cart/
orders/
• Database operations
• Query implementation
• Error handling]
+ end
+
+ subgraph "auth/"
+ Auth[• JWT handling
• Password hashing
• Middleware
• Authentication logic]
+ end
+
+ subgraph "config/"
+ Config[• Environment variables
• Configuration loading
• Application settings]
+ end
+
+ subgraph "database/"
+ Database[• Connection management
• Pool configuration
• Migration handling]
+ end
+
+ subgraph "webutils/"
+ WebUtils[• JSON helpers
• HTTP utilities
• Common functions]
+ end
+ end
+
+ subgraph "docs/"
+ Docs[• API documentation
• Architecture diagrams
• Usage examples]
+ end
+ end
+
+ MainGo --> Handlers
+ MainGo --> Config
+ MainGo --> Database
+
+ Handlers --> Models
+ Handlers --> Repos
+ Handlers --> Auth
+ Handlers --> WebUtils
+
+ Repos --> Models
+ Repos --> Database
+
+ Auth --> Repos
+
+ %% Styling
+ classDef entry fill:#fff3e0
+ classDef business fill:#e8f5e8
+ classDef data fill:#e1f5fe
+ classDef security fill:#fce4ec
+ classDef config fill:#f3e5f5
+
+ class MainGo entry
+ class Handlers,Models business
+ class Repos,Database data
+ class Auth security
+ class Config,WebUtils,Docs config
+```
+
+## 6. Tecnologias e Dependências
+
+### Core Dependencies
+- **Go 1.23+**: Linguagem principal
+- **Gorilla Mux**: Roteamento HTTP
+- **pgx/v5**: Driver PostgreSQL
+- **UUID**: Identificadores únicos
+- **JWT**: Autenticação baseada em tokens
+- **bcrypt**: Hash de senhas
+
+### External Services
+- **PostgreSQL**: Banco de dados principal (via Supabase)
+- **Render/Heroku**: Hospedagem da aplicação
+
+### Environment Variables
+- `DATABASE_URL`: Connection string do PostgreSQL
+- `JWT_SECRET`: Chave secreta para tokens JWT
+- `PORT`: Porta do servidor (auto-detectada se não definida)
+
+## 7. Padrões Arquiteturais
+
+### Clean Architecture
+- **Separation of Concerns**: Cada camada tem responsabilidade específica
+- **Dependency Inversion**: Repositories como interfaces, implementações injetadas
+- **Independence**: Regras de negócio independentes de frameworks
+
+### Repository Pattern
+- Abstração do acesso a dados
+- Interfaces para testabilidade
+- Implementações específicas para PostgreSQL
+
+### Middleware Pattern
+- Autenticação centralizada
+- Interceptação de requests
+- Context enrichment
+
+### RESTful API Design
+- Recursos bem definidos
+- Métodos HTTP semânticos
+- Status codes apropriados
+- JSON como formato padrão
\ No newline at end of file
diff --git a/docs/endpoints.md b/docs/endpoints.md
new file mode 100644
index 0000000..2b0bcee
--- /dev/null
+++ b/docs/endpoints.md
@@ -0,0 +1,102 @@
+# API Endpoints Overview - Go Cart API
+
+## 🗺️ Mapa de Endpoints
+
+```mermaid
+graph LR
+ subgraph "Rotas Públicas"
+ A[GET /api/health]
+ B[POST /api/auth/register]
+ C[POST /api/auth/login]
+ D[GET /api/products]
+ E[GET /api/products/{id}]
+ F[GET /api/categories]
+ G[GET /api/categories/{id}]
+ end
+
+ subgraph "Rotas Protegidas 🔒"
+ subgraph "Users"
+ H[GET /api/users/me]
+ I[GET /api/users/{id}/addresses]
+ J[POST /api/users/{id}/addresses]
+ K[PUT /api/users/{id}/addresses/{aid}]
+ L[DELETE /api/users/{id}/addresses/{aid}]
+ M[PATCH /api/users/{id}/addresses/{aid}/default]
+ end
+
+ subgraph "Products Management"
+ N[POST /api/products]
+ O[PUT /api/products/{id}]
+ P[DELETE /api/products/{id}]
+ end
+
+ subgraph "Categories Management"
+ Q[POST /api/categories]
+ R[PUT /api/categories/{id}]
+ S[DELETE /api/categories/{id}]
+ end
+
+ subgraph "Shopping Cart"
+ T[GET /api/cart]
+ U[POST /api/cart/items]
+ V[PUT /api/cart/items/{pid}]
+ W[DELETE /api/cart/items/{pid}]
+ X[DELETE /api/cart]
+ end
+
+ subgraph "Orders"
+ Y[POST /api/orders]
+ Z[GET /api/orders]
+ AA[GET /api/orders/{id}]
+ BB[PATCH /api/orders/{id}/cancel]
+ end
+ end
+
+ %% Styling
+ classDef public fill:#c8e6c9
+ classDef protected fill:#ffcdd2
+ classDef management fill:#e1f5fe
+ classDef commerce fill:#fff3e0
+
+ class A,B,C,D,E,F,G public
+ class H,I,J,K,L,M,N,O,P,Q,R,S protected
+ class T,U,V,W,X,Y,Z,AA,BB commerce
+```
+
+## 🔄 Fluxo do E-commerce
+
+```mermaid
+graph TD
+ A[👤 Usuário acessa sistema] --> B{Já registrado?}
+ B -->|Não| C[📝 Registro - POST /api/auth/register]
+ B -->|Sim| D[🔑 Login - POST /api/auth/login]
+
+ C --> E[✅ Token JWT gerado]
+ D --> E
+
+ E --> F[🏪 Navegar produtos - GET /api/products]
+ F --> G[🛒 Adicionar ao carrinho - POST /api/cart/items]
+
+ G --> H{Continuar comprando?}
+ H -->|Sim| F
+ H -->|Não| I[📍 Verificar endereços - GET /api/users/me/addresses]
+
+ I --> J{Tem endereço?}
+ J -->|Não| K[➕ Adicionar endereço - POST /api/users/me/addresses]
+ J -->|Sim| L[📋 Revisar carrinho - GET /api/cart]
+
+ K --> L
+ L --> M[💳 Criar pedido - POST /api/orders]
+ M --> N[📦 Acompanhar pedidos - GET /api/orders]
+
+ %% Styling
+ classDef start fill:#c8e6c9
+ classDef auth fill:#e1f5fe
+ classDef shop fill:#fff3e0
+ classDef order fill:#f3e5f5
+
+ class A start
+ class B,C,D,E auth
+ class F,G,H shop
+ class I,J,K,L,M,N order
+```
\ No newline at end of file
diff --git a/docs/quick-reference.md b/docs/quick-reference.md
new file mode 100644
index 0000000..8589259
--- /dev/null
+++ b/docs/quick-reference.md
@@ -0,0 +1,66 @@
+# Quick Architecture Reference
+
+## 🏗️ High-Level Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ Go Cart API │
+├─────────────────────────────────────────────────────────────────┤
+│ │
+│ ┌─────────────┐ ┌──────────────┐ ┌─────────────────┐ │
+│ │ Client │───▶│ Router │───▶│ Middleware │ │
+│ │ (HTTP/JSON) │ │(Gorilla Mux) │ │ (JWT Auth) │ │
+│ └─────────────┘ └──────────────┘ └─────────────────┘ │
+│ │ │
+│ ▼ │
+│ ┌─────────────────────────────────────────────────────────┐ │
+│ │ Handlers │ │
+│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │ │
+│ │ │ Auth │ │ User │ │Product │ │ Cart & │ │ │
+│ │ │Handler │ │Handler │ │Handler │ │ Orders │ │ │
+│ │ └─────────┘ └─────────┘ └─────────┘ └─────────────┘ │ │
+│ └─────────────────────────────────────────────────────────┘ │
+│ │ │
+│ ▼ │
+│ ┌─────────────────────────────────────────────────────────┐ │
+│ │ Repositories │ │
+│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │ │
+│ │ │ User │ │Product │ │Category │ │ Cart/Order │ │ │
+│ │ │ Repo │ │ Repo │ │ Repo │ │ Repos │ │ │
+│ │ └─────────┘ └─────────┘ └─────────┘ └─────────────┘ │ │
+│ └─────────────────────────────────────────────────────────┘ │
+│ │ │
+│ ▼ │
+│ ┌─────────────────────────────────────────────────────────┐ │
+│ │ Database Layer │ │
+│ │ PostgreSQL │ │
+│ │ (via Supabase) │ │
+│ └─────────────────────────────────────────────────────────┘ │
+│ │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## 🔧 Key Components
+
+| Component | Technology | Purpose |
+|-----------|------------|---------|
+| **Router** | Gorilla Mux | HTTP routing and URL handling |
+| **Auth** | JWT + bcrypt | User authentication and security |
+| **Handlers** | Go stdlib | HTTP request/response processing |
+| **Repositories** | pgx/v5 | Database abstraction layer |
+| **Database** | PostgreSQL | Data persistence (via Supabase) |
+
+## 📊 Data Flow
+
+```
+Request → Router → Auth Middleware → Handler → Repository → Database
+ ↓
+Response ← JSON ← Processing ← Query Result ← PostgreSQL
+```
+
+## 🚀 Deployment
+
+- **Platform**: Render/Heroku
+- **Database**: Supabase (PostgreSQL)
+- **Port**: Auto-detected (4445+ range)
+- **Health Check**: `GET /api/health`
\ No newline at end of file
diff --git a/go-cart-api b/go-cart-api
new file mode 100755
index 0000000000000000000000000000000000000000..f92178541fede819a07ba577f07b065e8fb0b60e
GIT binary patch
literal 15606924
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