gohorsejobs/README.md

127 lines
3.3 KiB
Markdown

# 🐴 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.
---
## 🔑 Usuários para Teste (Seeder & Dev)
Estes são os usuários padrões imutáveis criados para fins de teste no ambiente local e dev.
**(Importante:** A senha base é verificada usando a constante `PASSWORD_PEPPER`. Garanta ter ela configurada nos seus `.env`s).
### Super Admin (Main)
- **Login**: `lol` / **Email:** `lol@gohorsejobs.com`
- **Senha**: `Admin@2025!`
- **Role**: `superadmin` (Acesso total infra)
### Admins de Empresa
| Login | Senha | Empresa | Role |
|-------|-------|---------|------|
| `takeshi_yamamoto` | `Takeshi@2025` | TechCorp | `admin` |
| `kenji@appmakers.mobile` | `Takeshi@2025` | AppMakers | `admin` |
| `wile_e_coyote` | `MeepMeep@123` | ACME Corporation | `admin` |
### Recrutadores
| Login | Senha | Empresa | Role |
|-------|-------|---------|------|
| `maria_santos` | `User@2025` | DesignHub | `recruiter` |
### Candidatos
| Login | Senha | Role |
|-------|-------|------|
| `paulo_santos` | `User@2025` | `candidate` |
| `maria@email.com` | `User@2025` | `candidate` |
| *e outros...* | `User@2025` | `candidate` |