# 🐴 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.

---

## 📚 Documentação

| Documento | Descrição |
|-----------|-----------|
| [docs/AGENTS.md](docs/AGENTS.md) | Contexto para assistentes de IA (Claude, Cursor, etc.) |
| [docs/API.md](docs/API.md) | Endpoints, contratos e exemplos |
| [docs/API_SECURITY.md](docs/API_SECURITY.md) | Autenticação, autorização e segurança |
| [docs/DATABASE.md](docs/DATABASE.md) | Estrutura e decisões de dados |
| [docs/DEVOPS.md](docs/DEVOPS.md) | Execução local, deploy e operação |
| [docs/WORKFLOWS.md](docs/WORKFLOWS.md) | Fluxos de deploy e operações |
| [docs/ROADMAP.md](docs/ROADMAP.md) | Direção de produto e engenharia |
| [docs/TASKS.md](docs/TASKS.md) | Tarefas e acompanhamento |

### Por componente

- [backend/BACKEND.md](backend/BACKEND.md) — API Go
- [frontend/FRONTEND.md](frontend/FRONTEND.md) — Next.js
- [backoffice/BACKOFFICE.md](backoffice/BACKOFFICE.md) — NestJS
- [seeder-api/SEEDER-API.md](seeder-api/SEEDER-API.md) — Seeder

---

## 🚀 Quick start

### Pré-requisitos

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

### Subindo localmente

```bash
# 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

```bash
./start.sh
```

---

## 🧱 Estrutura resumida

```text
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.