develop

.env.example

@@ -0,0 +1,106 @@
+# =============================================================================
+# TryCatch For Match — modelo de variáveis de ambiente
+# =============================================================================
+#
+# Copie este arquivo para .env e preencha os valores:
+#
+#     cp .env.example .env
+#
+# ⚠️ NUNCA coloque valores reais aqui. Este arquivo VAI para o repositório.
+#    O .env, com os valores de verdade, fica só na sua máquina.
+#
+# Para rodar o projeto localmente, o mínimo é: DATABASE_URL, NEXTAUTH_SECRET
+# e NEXTAUTH_URL. O resto habilita funcionalidades específicas.
+# =============================================================================
+
+
+# -----------------------------------------------------------------------------
+# BANCO DE DADOS
+# -----------------------------------------------------------------------------
+
+# OBRIGATÓRIA. Escolha UMA das três opções abaixo e deixe as outras comentadas.
+
+# 👉 Opção 1 — Banco compartilhado no Neon
+#    Peça a string de conexão no Discord. Não precisa instalar nada.
+# DATABASE_URL="postgresql://usuario:senha@host.neon.tech/neondb?sslmode=require"
+
+# 👉 Opção 2 — PostgreSQL via Docker (usa o docker-compose.yml do projeto)
+DATABASE_URL="postgresql://postgres:postgres@localhost:5555/trycatch_db"
+
+# 👉 Opção 3 — PostgreSQL instalado na sua máquina
+# DATABASE_URL="postgresql://postgres:postgres@localhost:5432/trycatch_db"
+
+
+# Usadas apenas pelo docker-compose (Opção 2). Se não usar Docker, ignore.
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=postgres
+POSTGRES_DB=trycatch_db
+POSTGRES_PORT=5555
+
+
+# -----------------------------------------------------------------------------
+# AUTENTICAÇÃO
+# -----------------------------------------------------------------------------
+
+# OBRIGATÓRIA. Assina os tokens de sessão do NextAuth.
+# Gere o SEU valor — nunca reaproveite o de outra pessoa nem de outro ambiente:
+#
+#     node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
+#
+NEXTAUTH_SECRET=gere-o-seu-com-o-comando-acima
+
+# OBRIGATÓRIA. URL onde a aplicação responde.
+# Em produção, precisa ser a URL real do deploy — o NextAuth usa este valor
+# para montar os redirecionamentos e os links de recuperação de senha.
+NEXTAUTH_URL=http://localhost:3000
+
+
+# -----------------------------------------------------------------------------
+# URL PÚBLICA DA APLICAÇÃO
+# -----------------------------------------------------------------------------
+
+# Usada para montar os links enviados nos e-mails de convite.
+# Em desenvolvimento, normalmente igual à NEXTAUTH_URL.
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+
+# -----------------------------------------------------------------------------
+# CLOUDINARY — upload de imagens (avatar e assets de UI)
+# -----------------------------------------------------------------------------
+
+# Necessárias para o upload de avatar funcionar.
+# Crie uma conta gratuita em https://cloudinary.com e copie os valores em
+# Dashboard → API Keys.
+CLOUDINARY_CLOUD_NAME=seu_cloud_name
+CLOUDINARY_API_KEY=sua_api_key
+CLOUDINARY_API_SECRET=sua_api_secret
+
+
+# -----------------------------------------------------------------------------
+# E-MAIL (Resend)
+# -----------------------------------------------------------------------------
+
+# Necessária para: formulário de contato, solicitação de convite e
+# recuperação de senha. Crie a chave em https://resend.com
+RESEND_API_KEY=re_sua_chave_aqui
+
+# Remetentes e destinatários usados pelos e-mails automáticos.
+# Precisam ser endereços de um domínio verificado no Resend.
+CONTACT_SENDER_EMAIL=contato@exemplo.com
+RESET_PASSWORD_EMAIL=nao-responda@exemplo.com
+INVITE_REQUEST_SENDER_EMAIL=convites@exemplo.com
+INVITE_REQUEST_RECEIVER_EMAIL=admin@exemplo.com
+
+
+# -----------------------------------------------------------------------------
+# OPCIONAIS
+# -----------------------------------------------------------------------------
+
+# Agente de code review (npm run review). Chave gratuita em:
+# https://aistudio.google.com/api-keys
+# Sem ela, o restante do projeto funciona normalmente.
+GEMINI_API_KEY=
+
+# Ativa os testes de integração, que precisam de banco real.
+# Deixe vazio para rodar apenas os testes unitários.
+INTEGRATION_TEST=

.github/workflows/docs-translate.yml

@@ -1,12 +1,18 @@
 name: Docs Auto Translate
 
+# Traduz automaticamente apenas o README.
+#
+# O CONTRIBUTING.md ficou de fora de propósito: ele é o documento operacional,
+# cheio de tabelas, âncoras de índice, comandos e nomes de arquivo. A tradução
+# automática quebra esse tipo de estrutura — traduz conteúdo dentro de blocos de
+# código e desalinha os links do índice. O CONTRIBUTING.en.md é mantido à mão,
+# junto com a versão em português, no mesmo pull request.
 on:
   push:
     branches:
       - main
     paths:
       - 'README.md'
-      - 'CONTRIBUTING.md'
 
 jobs:
   translate:
@@ -20,28 +26,20 @@ jobs:
       - name: Install translate-shell
         run: sudo apt-get update && sudo apt-get install -y translate-shell
 
-      - name: Translate files to English
+      - name: Translate README to English
         run: |
-          # Traduz o README para o novo padrão
           if [ -f README.md ]; then
             trans -b :en < README.md > README.en.md
             echo "README translated."
           fi
 
-          # Traduz o CONTRIBUTING para o novo padrão
-          if [ -f CONTRIBUTING.md ]; then
-            trans -b :en < CONTRIBUTING.md > CONTRIBUTING.en.md
-            echo "CONTRIBUTING translated."
-          fi
-
-      - name: Commit translated files
+      - name: Commit translated file
         run: |
           git config user.name "github-actions"
           git config user.email "actions@github.com"
 
-          # Adiciona os arquivos com a extensão correta
-          git add README.en.md CONTRIBUTING.en.md
+          # Apenas o README — o CONTRIBUTING.en.md e mantido a mao
+          git add README.en.md
 
-          # Commita as alterações
-          git commit -m "docs: auto-translate docs to English [skip ci]" || echo "No changes"
+          git commit -m "docs: auto-translate README to English [skip ci]" || echo "No changes"
           git push origin HEAD:main

.gitignore

@@ -30,6 +30,7 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel