From 47b9e4feaf1e9e91d82c197e08bc28e1355e0bd1 Mon Sep 17 00:00:00 2001
From: Tiago Yamamoto <japa@rede5.com.br>
Date: Sun, 14 Dec 2025 17:26:39 -0300
Subject: [PATCH] Add example for hiring application status update

---
 backend/README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/backend/README.md b/backend/README.md
index 7003850..47360aa 100755
--- a/backend/README.md
+++ b/backend/README.md
@@ -73,6 +73,28 @@ O servidor valida no boot que `JWT_SECRET` tenha pelo menos 32 caracteres. Em pr
 
 ---
 
+### Exemplo: atualizar candidatura para "Contratado"
+
+Use este fluxo para marcar uma candidatura como aprovada (status `hired`).
+
+1. **Endpoint**: `PUT /applications/{id}/status`
+   - Substitua `{id}` pelo identificador numérico da candidatura. Exemplo: `/applications/1234/status`.
+2. **Payload (`application/json`)**:
+
+```json
+{
+  "status": "hired",
+  "notes": "Candidato APROVADO após a entrevista final. Salário de R$ 5.500,00 acordado. Início em 01/02/2026."
+}
+```
+
+- O campo `status` é obrigatório e deve ser `"hired"` para confirmar a contratação.
+- O campo `notes` é opcional e pode registrar observações do recrutador.
+
+3. **Próximo passo recomendado**: Após o `200 OK`, crie a conta de usuário interno do contratado com `POST /api/v1/users`.
+
+---
+
 ## 🚀 Desenvolvimento
 
 ### Executar