> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wethehivers.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inscription d'un recruteur

> Parcours complet d'inscription et de validation d'un compte recruteur

# Inscription d'un recruteur

Un recruteur représente une entreprise sur THE HIVE. Son compte doit être **validé manuellement** par un administrateur avant de pouvoir publier des offres.

## Vue d'ensemble

```mermaid theme={null}
sequenceDiagram
    participant Recruteur
    participant API
    participant Admin
    participant Email

    Recruteur->>API: POST /auth/recruiter/register
    API->>Email: Email de vérification
    Recruteur->>API: Confirmer email
    API->>Admin: Notification nouveau recruteur en attente
    Admin->>API: Valider ou refuser
    API->>Email: Notification au recruteur
    Recruteur->>API: Login + publier une offre
```

## 1. Création du compte

```bash theme={null}
curl -X POST https://api.wethehivers.com/v1/api/auth/recruiter/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "rh@techcorp.cm",
    "password": "motdepasse-solide",
    "firstName": "Marie",
    "lastName": "Ngassa",
    "phoneNumber": "+237690123456",
    "entreprise": {
      "nom": "TechCorp SARL",
      "secteur": "SOFTWARE",
      "taille": "50-200",
      "rccm": "CM-DLA-2020-B-1234",
      "adresse": "Akwa, Douala",
      "ville": "Douala"
    }
  }'
```

À ce stade, le compte est créé avec le statut `PENDING_EMAIL_VERIFICATION`.

## 2. Vérification de l'email

Le recruteur reçoit un email avec un lien contenant un token. L'ouverture du lien déclenche :

```
GET /api/auth/verify-email?token=<token>
```

Le statut passe alors à `PENDING_ADMIN_APPROVAL`.

## 3. Validation par l'administration

L'admin consulte les recruteurs en attente :

```bash theme={null}
curl https://api.wethehivers.com/v1/api/admin/recruteurs/pending \
  -H "Authorization: Bearer <token-admin>"
```

Puis valide :

```bash theme={null}
curl -X POST https://api.wethehivers.com/v1/api/admin/recruteurs/42/approve \
  -H "Authorization: Bearer <token-admin>"
```

<Info>
  La validation admin vérifie principalement la légitimité de l'entreprise (RCCM, site web, réseaux sociaux) pour éviter les fausses offres.
</Info>

## 4. Connexion et publication

Une fois validé, le recruteur peut se connecter et publier des offres. Voir [Publication d'une offre](/guides/publication-offre).

## Statuts possibles

| Statut                       | Description                                    |
| ---------------------------- | ---------------------------------------------- |
| `PENDING_EMAIL_VERIFICATION` | Email non confirmé, aucune action possible     |
| `PENDING_ADMIN_APPROVAL`     | Email confirmé, en attente de validation admin |
| `ACTIVE`                     | Compte validé, peut publier des offres         |
| `REJECTED`                   | Rejeté par l'admin (avec motif)                |
| `SUSPENDED`                  | Suspendu par l'admin                           |

<Warning>
  Un recruteur rejeté reçoit un email avec le motif. Il peut contester en répondant à `support@wethehivers.com`.
</Warning>