gohorsejobs/docs/GUIA_MIGRACAO_FORGEJO.md
NANDO9322 ddc2f5dd03 feat: atualiza fluxo de cadastro de candidatos com persistência completa de dados e máscara de telefone
Frontend:
- Implementar máscara de entrada de telefone para números BR ((XX) XXXXX-XXXX).
- Atualizar formulário de cadastro para enviar dados completos do perfil do candidato (endereço, formação, habilidades, etc.).
- Corrigir problemas de idioma misto na página de Detalhes da Vaga e adicionar traduções faltantes.

Backend:
- Atualizar modelo de Usuário, Entidade e DTOs para incluir campos de perfil (Data de Nascimento, Endereço, Formação, etc.).
- Atualizar UserRepository para persistir e recuperar os dados estendidos do usuário no PostgreSQL.
- Atualizar RegisterCandidateUseCase para mapear campos de entrada para a entidade Usuário.
2026-01-06 18:19:47 -03:00

97 lines
3.2 KiB
Markdown

# Guia de Migração: GitHub para Forgejo
Este guia documenta o processo padrão para migrar seus projetos existentes e novos para o repositório Forgejo da Rede5.
## 1. Autenticação (Passo Único)
Como o servidor é privado, a melhor forma de autenticar é gerando um **Access Token**.
1. Acesse o Forgejo: [https://forgejo-gru.rede5.com.br/](https://forgejo-gru.rede5.com.br/)
2. Clique no seu Avatar (topo direito) -> **Configurações**.
3. Vá em **Aplicações** (Applications).
4. Gere um novo token (ex: "migration-token") e **copie-o**.
> 💡 **Dica:** O token substitui sua senha nas operações de Git.
---
## 2. Migrando um Projeto Existente (GitHub -> Forgejo)
Se você já tem o projeto no computador (clonado do GitHub):
### Opção A: Manter os dois repositórios (GitHub e Forgejo)
Ideal para transição suave. Você mantém o `origin` (GitHub) e adiciona um novo (Forgejo).
```powershell
# 1. Entre na pasta do projeto
cd c:\caminho\do\projeto
# 2. Adicione o novo remote (usando o token para não pedir senha)
# Sintaxe: https://<SEU_TOKEN>@forgejo-gru.rede5.com.br/rede5/<NOME_DO_REPO>.git
git remote add forgero https://<TOKEN>@forgejo-gru.rede5.com.br/rede5/<NOME-DO-REPO>.git
# Exemplo real (substitua <TOKEN>):
# git remote add forgero https://<TOKEN>@forgejo-gru.rede5.com.br/rede5/gohorsejobs.git
# 3. Envie o código
git push forgero main
# (Ou 'master', dependendo de como está sua branch principal)
```
### Opção B: Mudar totalmente para o Forgejo
Se não vai mais usar o GitHub.
```powershell
# 1. Remova o vínculo com o GitHub (opcional, ou apenas renomeie)
git remote remove origin
# 2. Adicione o Forgejo como 'origin' (padrão)
git remote add origin https://<TOKEN>@forgejo-gru.rede5.com.br/rede5/<NOME-DO-REPO>.git
# 3. Envie o código e defina o upstream padrão
git push -u origin main
```
---
## 3. Comandos Padrão do Dia a Dia
Depois de configurado, o fluxo é o mesmo:
| Ação | Comando |
| :--- | :--- |
| **Baixar atualizações** | `git pull forgero main` |
| **Enviar alterações** | `git push forgero main` |
| **Verificar remotes** | `git remote -v` |
| **Criar nova branch** | `git checkout -b nova-feature` |
| **Enviar nova branch** | `git push forgero nova-feature` |
---
## 4. Solução de Problemas Comuns
### Erro: `fatal: Authentication failed`
* **Causa:** O Git não conseguiu logar.
* **Solução:** Verifique se o token no comando `git remote add` está correto ou se expirou.
* **Correção:** Atualize a URL com o token correto:
```powershell
git remote set-url forgero https://<NOVO_TOKEN>@forgejo-gru.rede5.com.br/rede5/<REPO>.git
```
### Erro: `remote origin already exists`
* **Causa:** Você tentou adicionar um remote (`origin`) que já existe.
* **Solução:** Use outro nome (ex: `forgero`) ou mude a URL do existente.
```powershell
# Adicionar com outro nome
git remote add forgero <URL>
# OU Alterar o existente
git remote set-url origin <URL>
```
### Erro: `refusing to merge unrelated histories`
* **Causa:** Você criou o repositório no Forgejo com README/Licença e tentou subir um projeto local que já tinha esses arquivos.
* **Solução:**
```powershell
git pull forgero main --allow-unrelated-histories
```