🐴 GoHorse Jobs

Plataforma de recrutamento com arquitetura separada por serviços:

• Frontend: Next.js (portal de vagas e dashboards).
• Backend: API em Go (regras de negócio, autenticação, dados).
• Backoffice: NestJS (administração, operações e integrações).
• Seeder API: utilitários para carga de dados de desenvolvimento.

---

✅ Estado atual da documentação

Este repositório tinha documentação duplicada e com partes desatualizadas. A partir desta revisão:

• a fonte canônica de documentação geral passa a ser a pasta docs/;
• arquivos antigos na raiz (ex.: ROADMAP.md, STATUS_REPORT.md) foram reduzidos para ponteiros;
• o roadmap foi simplificado para refletir prioridades reais do produto (sem backlog histórico de iniciativas fora de escopo atual).

---

📚 Onde encontrar cada assunto

Documentação central (canônica)

• docs/API.md — endpoints, contratos e exemplos.
• docs/API_SECURITY.md — autenticação, autorização e segurança.
• docs/DATABASE.md — estrutura e decisões de dados.
• docs/DEVOPS.md — execução local, deploy e operação.
• docs/ROADMAP.md — direção de produto e engenharia.
• docs/TASKS.md — tarefas e acompanhamento de execução.

Documentação por componente

• backend/BACKEND.md
• frontend/FRONTEND.md
• backoffice/BACKOFFICE.md
• seeder-api/SEEDER-API.md

---

🚀 Quick start

Pré-requisitos

• Go 1.24+
• Node.js 20+
• PostgreSQL 16+

Subindo localmente

# 1) clone
git clone https://github.com/rede5/gohorsejobs.git
cd gohorsejobs

# 2) variáveis de ambiente (ajuste os valores)
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

# 3) backend
cd backend
go run ./cmd/api

# 4) frontend (novo terminal)
cd ../frontend
npm install
npm run dev

# 5) seeder (opcional)
cd ../seeder-api
npm install
npm run seed

Script auxiliar

./start.sh

---

🧱 Estrutura resumida

gohorsejobs/
├── backend/
├── frontend/
├── backoffice/
├── seeder-api/
├── docs/
├── k8s/
└── start.sh

---

🤝 Contribuição

1. Crie uma branch de feature/fix.
2. Faça commits pequenos e objetivos.
3. Atualize documentação relevante em docs/ quando necessário.
4. Abra PR com contexto, impacto e evidências de teste.