feat: add full project - backend, frontend, docker, specs and configs

.specify/features/007-admin-panel/contracts/clientes.md

@@ -0,0 +1,77 @@
+# Contract: Admin Clientes Endpoints
+
+**Prefix:** `/api/v1/admin/client-users`
+**Auth:** JWT Bearer (admin)
+
+---
+
+## GET /api/v1/admin/client-users
+Lista todos os clientes.
+
+### Response 200
+```json
+[
+  {
+    "id": "uuid",
+    "name": "João",
+    "email": "joao@email.com",
+    "role": "client"
+  }
+]
+```
+
+---
+
+## POST /api/v1/admin/client-users
+Cria um novo cliente.
+
+### Request
+```json
+{
+  "name": "João",
+  "email": "joao@email.com",
+  "password": "senha123",
+  "role": "client"
+}
+```
+
+### Response 201
+```json
+{
+  "id": "uuid",
+  "name": "João",
+  "email": "joao@email.com",
+  "role": "client"
+}
+```
+
+---
+
+## PUT /api/v1/admin/client-users/:id
+Atualiza um cliente existente.
+
+### Request
+```json
+{
+  "name": "João",
+  "email": "joao@email.com",
+  "role": "client"
+}
+```
+
+### Response 200
+```json
+{
+  "id": "uuid",
+  "name": "João",
+  "email": "joao@email.com",
+  "role": "client"
+}
+```
+
+---
+
+## DELETE /api/v1/admin/client-users/:id
+Remove um cliente.
+
+### Response 204