Teste de Cássius Queiroz Bessa

.env.example

@@ -0,0 +1,15 @@
+# Banco
+DB_HOST=db
+DB_PORT=5432
+DB_USER=user
+DB_PASSWORD=password
+DB_NAME=vbio
+DB_URL=postgresql://user:password@db:5432/vbio
+# Backend
+APP_PORT=8080
+JWT_SECRET=segredo
+BREVO_API_KEY=***
+REACT_APP_URL=http://localhost:3000
+# Frontend
+FRONTEND_PORT=3000
+NEXT_PUBLIC_API_URL=http://localhost:8080/api

.gitignore

@@ -0,0 +1 @@
+.env

README.md

@@ -1,47 +1,128 @@
-# **TESTE BACKEND**
+# 🛠️ Bvio Mono
 
-## SITUAÇÂO-PROBLEMA
-A ideia é construir uma página de competição muito simples que incentiva as pessoas a divulgarem notícias sobre compensações de carbono. Os usuários chegam à página e preenchem um formulário de inscrição. Após uma inscrição bem-sucedida, eles ganham um ponto para a competição. Neste momento, eles têm a opção de compartilhar o link de inscrição. Cada inscrição bem-sucedida feita através do link compartilhado dará pontos extras para o autor original do link. Não há limite para o número de pontos que uma pessoa pode obter. No final da competição, as 10 pessoas com mais pontos vencem.
+Monorepo da aplicação **Bvio**, uma plataforma com foco em competições, rankings e recompensas via sistema de indicações.
 
----------------------------------------------------------------------
+Este repositório contém tanto o **backend** (Go) quanto o **frontend** (Next.js), com orquestração via Docker e arquitetura orientada por **DDD (Domain-Driven Design)** no backend.
 
-## REQUISITOS OBRIGATÓRIOS
-- O formulário de inscrição consiste em nome, e-mail e números de telefone;
-- Quando o formulário é enviado, o usuário ganha um ponto e será direcionado para uma página com opção de compartilhar o link especial;
-- Quando as pessoas chegam à página da competição através do link especial, o autor original ganha um ponto extra;
-- Após o término da competição, gerar uma tabela dos vencedores;
-- Enviar notificação via e-mail para os ganhadores e para cada vez que alguém fizer um ponto a partir do link filiado.
-- Seja original, projetos suspeitos de serem copiados serão descartados
-- Queremos ver seu codigo, não o de outros.
-- Criar coleção no Postman (seu teste será testado por aqui).
-- Criar um frontend que consuma a API(React)
+---
 
----------------------------------------------------------------------
+## ✨ Funcionalidades
 
-## GIT
-- Faça um fork deste repositório.
-- Crie uma branch para codar as suas features.
-- Faça um pull-request quando o teste for finalizado.
+- Cadastro de usuários com código de convite único
+- Autenticação via JWT
+- Atribuição de pontos por convites
+- Ranking de usuários por pontuação
+- Finalização da competição:
+  - Envio de e-mails para os 10 primeiros colocados
+  - Reset da pontuação de todos os usuários
 
-##### **NOTA: Será avaliado também se o nome da branch, títulos de commit, push e comentários possuem boa legibilidade.**
+---
 
----------------------------------------------------------------------
+## 🧠 Arquitetura e DDD
 
-## FRAMEWORK
-- Servidor: Golang(Fiber ou Gin)
-- Banco de dados: MongoDB, DynamoDB, MySQL, Postgres...
+A arquitetura segue os princípios de Domain-Driven Design:
 
--------------------------------------------------------
+- **Domain Layer**: contém entidades e encapsulamento das regras das mesmas
+- **Application Layer**: orquestra os casos de uso
+- **Infrastructure Layer**: implementações concretas de repositórios (DB, e-mail)
+- **Interface Layer**: entrega da aplicação (ex: HTTP handlers com Gin)
 
-## REQUISITOS DIFERENCIAIS:
-- Seguir os princípios de SOLID.
-- Codar um código performático.
-- Utilizar inglês no projeto todo.
-- Utilizar Injeção de dependências.
-- Fazer deploy do mesmo (heroku, aws, google cloud ou outro da preferência).
+### Benefícios
 
-## ENTREGA
+- Alta testabilidade
+- Baixo acoplamento
+- Clareza na separação de responsabilidades
+- Facilita manutenção e extensão de funcionalidades
+
+---
+
+## 🐳 Docker
+
+A aplicação é inteiramente dockerizada. Para subir o ambiente localmente:
+
+```bash
+docker-compose up --build
+```
+
+Serviços disponíveis:
+
+- `backend`: aplicação Go na porta `${APP_PORT}`
+- `frontend`: aplicação Next.js na porta `${FRONTEND_PORT}`
+- `db`: banco PostgreSQL na porta `5432`
+
+---
+
+## 🔐 Autenticação
+
+- Feita via **JWT**
+- Após login, o token é retornado no corpo da resposta
+- Rotas privadas requerem o cabeçalho:
+
+```
+Authorization: <token>
+```
+
+---
+
+## 🥪 Testes
+
+Os testes unitários são escritos com `testify` e `testify/mock`.
+
+### Estrutura dos testes:
+
+1. Setup de mocks
+2. Execução do caso de uso
+3. Verificações com `assert` e `AssertExpectations`
+
+```bash
+cd backend
+go test ./...
+```
+
+---
+
+## 🌐 Variáveis de Ambiente
+
+As variáveis estão centralizadas em um único arquivo `.env`:
+
+```env
+# Backend
+APP_PORT=8080
+
+# Frontend
+FRONTEND_PORT=3000
+NEXT_PUBLIC_API_URL=http://localhost:8080
+
+# Banco de dados
+DB_NAME=bvio
+DB_USER=postgres
+DB_PASSWORD=secret
+```
+
+O Docker Compose injeta esse `.env` automaticamente nos serviços.
+
+---
+
+## 🚀 Deploy
+
+### Backend
+
+- Hospedado na [Render](https://render.com)
+
+---
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Sinta-se à vontade para abrir:
+
+- Issues com dúvidas, bugs ou sugestões
+- Pull Requests com melhorias ou novas funcionalidades
+
+---
+
+## 📬 Contato
+
+Feito com 💙 por Cássius Queiroz Bessa.
+
+Se tiver dúvidas ou quiser trocar ideias, abra uma issue ou entre em contato!
 
-- Faça um pull request e nomeie-o como no ex.: Teste de (Seu nome aqui).
-- Envie um email para morelli@gss.eco com o link do pull request, do deploy (tanto do front quanto do back se feito), e anexe a coleção do postman.
-- Assim que avaliarmos seu teste, enviaremos uma devolutiva de sucesso ou falha, e caso seja aprovado, um link para agendar sua entrevista técnica.

backend/.gitignore

@@ -0,0 +1 @@
+.env

backend/Dockerfile

@@ -0,0 +1,20 @@
+FROM golang:1.24.1 AS builder
+
+WORKDIR /app
+
+COPY go.mod go.sum ./
+RUN go mod download
+
+COPY . .
+
+RUN go build -o backend-test ./cmd/main.go
+
+FROM gcr.io/distroless/base-debian12
+
+WORKDIR /app
+
+COPY --from=builder /app/backend-test .
+
+EXPOSE 8080
+
+CMD ["./backend-test"]

backend/cmd/main.go

@@ -0,0 +1,53 @@
+package main
+
+import (
+	"log"
+	"os"
+	"time"
+
+	"github.com/cassiusbessa/backend-test/internal/infra/db"
+	"github.com/cassiusbessa/backend-test/internal/interfaces/http/routes"
+	"github.com/gin-contrib/cors"
+	"github.com/gin-gonic/gin"
+	"github.com/joho/godotenv"
+)
+
+func main() {
+	if err := godotenv.Load(); err != nil {
+		log.Println("No .env file found")
+	}
+
+	db.Connect()
+
+	port := os.Getenv("APP_PORT")
+	if port == "" {
+		port = "8080"
+	}
+
+	r := gin.Default()
+
+	r.Use(cors.New(cors.Config{
+		AllowOrigins:     []string{"*"},
+		AllowMethods:     []string{"GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"},
+		AllowHeaders:     []string{"Origin", "Authorization", "Content-Type"},
+		ExposeHeaders:    []string{"Content-Length"},
+		AllowCredentials: true,
+		MaxAge:           12 * time.Hour,
+	}))
+
+	r.GET("/health", func(c *gin.Context) {
+		c.JSON(200, gin.H{"status": "ok"})
+	})
+
+	api := r.Group("/api")
+	routes.WithCreateUser(api)
+	routes.WithLogin(api)
+	routes.WithLoadUserByToken(api)
+	routes.WithUsersRanking(api)
+	routes.WithFinishCompetition(api)
+
+	log.Printf("Server running on port %s 🚀", port)
+	if err := r.Run(":" + port); err != nil {
+		log.Fatal(err)
+	}
+}

backend/go.mod

@@ -0,0 +1,60 @@
+module github.com/cassiusbessa/backend-test
+
+go 1.24.1
+
+require (
+	github.com/gin-contrib/cors v1.7.5
+	github.com/gin-gonic/gin v1.10.0
+	github.com/golang-jwt/jwt/v5 v5.2.2
+	github.com/google/uuid v1.6.0
+	github.com/joho/godotenv v1.5.1
+	github.com/stretchr/testify v1.10.0
+	golang.org/x/crypto v0.36.0
+	gorm.io/driver/postgres v1.5.11
+	gorm.io/gorm v1.25.12
+)
+
+require (
+	github.com/antihax/optional v1.0.0 // indirect
+	golang.org/x/oauth2 v0.21.0 // indirect
+)
+
+require (
+	github.com/bytedance/sonic v1.13.2 // indirect
+	github.com/bytedance/sonic/loader v0.2.4 // indirect
+	github.com/cloudwego/base64x v0.1.5 // indirect
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.8 // indirect
+	github.com/getbrevo/brevo-go v1.1.3
+	github.com/gin-contrib/sse v1.0.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator/v10 v10.26.0 // indirect
+	github.com/goccy/go-json v0.10.5 // indirect
+	github.com/jackc/pgpassfile v1.0.0 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a // indirect
+	github.com/jackc/pgx/v5 v5.5.5 // indirect
+	github.com/jackc/puddle/v2 v2.2.1 // indirect
+	github.com/jinzhu/inflection v1.0.0 // indirect
+	github.com/jinzhu/now v1.1.5 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/kr/text v0.2.0 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.3 // 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/twitchyliquid64/golang-asm v0.15.1 // indirect
+	github.com/ugorji/go/codec v1.2.12 // indirect
+	golang.org/x/arch v0.15.0 // indirect
+	golang.org/x/net v0.38.0 // indirect
+	golang.org/x/sync v0.12.0 // indirect
+	golang.org/x/sys v0.31.0 // indirect
+	golang.org/x/text v0.23.0 // indirect
+	google.golang.org/protobuf v1.36.6 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)