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

.specify/features/006-client-area/contracts/me-favorites.md

@@ -0,0 +1,134 @@
+# Contract: GET /api/v1/me/favorites
+
+**Blueprint**: `client_bp`
+**Auth**: JWT Bearer — `require_auth` — ClientUser only
+
+---
+
+## Request
+
+```
+GET /api/v1/me/favorites
+Authorization: Bearer <jwt_token>
+```
+
+Sem parâmetros de query ou corpo.
+
+---
+
+## Response 200 OK
+
+```json
+[
+  {
+    "property": {
+      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
+      "title": "Apartamento 3 quartos Jardins",
+      "slug": "apartamento-3-quartos-jardins",
+      "price": "850000.00",
+      "condo_fee": "1200.00",
+      "type": "venda",
+      "subtype": { "id": 1, "name": "Apartamento" },
+      "bedrooms": 3,
+      "bathrooms": 2,
+      "parking_spots": 2,
+      "area_m2": 120,
+      "city": { "id": 1, "name": "São Paulo" },
+      "neighborhood": { "id": 5, "name": "Jardins" },
+      "is_featured": true,
+      "photos": [
+        { "url": "https://...", "alt_text": "", "display_order": 0 }
+      ],
+      "amenities": [{ "id": 1, "name": "Piscina" }],
+      "address": "Rua das Flores, 100",
+      "code": "AP001",
+      "description": "Apartamento espaçoso com varanda gourmet."
+    },
+    "created_at": "2026-04-13T10:00:00Z"
+  }
+]
+```
+
+Lista vazia `[]` quando o cliente não possui favoritos.
+
+---
+
+## Response 401 Unauthorized
+
+```json
+{ "error": "Token inválido ou ausente" }
+```
+
+---
+
+# Contract: POST /api/v1/me/favorites
+
+## Request
+
+```
+POST /api/v1/me/favorites
+Authorization: Bearer <jwt_token>
+Content-Type: application/json
+
+{ "property_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }
+```
+
+---
+
+## Response 201 Created
+
+```json
+{
+  "property": { /* PropertyDetailOut completo */ },
+  "created_at": "2026-04-13T10:00:00Z"
+}
+```
+
+---
+
+## Response 409 Conflict
+
+```json
+{ "error": "Imóvel já está nos favoritos" }
+```
+
+---
+
+## Response 404 Not Found
+
+```json
+{ "error": "Imóvel não encontrado" }
+```
+
+---
+
+## Response 422 Unprocessable Entity
+
+```json
+{ "error": "Dados inválidos", "details": ["property_id: field required"] }
+```
+
+---
+
+# Contract: DELETE /api/v1/me/favorites/<property_id>
+
+## Request
+
+```
+DELETE /api/v1/me/favorites/3fa85f64-5717-4562-b3fc-2c963f66afa6
+Authorization: Bearer <jwt_token>
+```
+
+---
+
+## Response 204 No Content
+
+Sem corpo.
+
+---
+
+## Response 404 Not Found
+
+```json
+{ "error": "Favorito não encontrado" }
+```