{
  "portfolio": {
    "id": "string",              // eindeutige Objekt-ID
    "name": "string",            // Bezeichnung
    "type": "Büro|Lager|Handel|Produktion|Parking|Bildung",
    "address": "string",
    "area_m2": "number",
    "built_year": "number",
    "tenants": "number",
    "sla_status": "ok|warn|crit",
    "kpis": {
      "occupancy_pct": "number", // Auslastung 0–100
      "budget_used_pct": "number",
      "budget_total_chf": "number",
      "energy_kwh": "number",    // aktueller Monat
      "tickets_open": "number"
    },
    "tickets": [{
      "id": "string",
      "priority": "crit|warn|ok",
      "title": "string",
      "due_date": "ISO8601",
      "status": "open|in_progress|done"
    }],
    "timeseries": {
      "budget": [{"month":"YYYY-MM","used_pct": number}],
      "energy": [{"month":"YYYY-MM","kwh": number}]
    }
  }
}

Alle Felder unter kpis und timeseries werden für die Dashboard-Visualisierung verwendet. Das Schema ist erweiterbar — zusätzliche Felder werden ignoriert und brechen nichts.

GET  /api/v1/portfolio              → Liste aller Objekte (ohne timeseries)
GET  /api/v1/portfolio/:id          → Einzelobjekt inkl. timeseries + tickets
GET  /api/v1/portfolio/:id/tickets  → Nur Tickets eines Objekts
GET  /api/v1/kpis/summary           → Aggregierte Portfolio-KPIs
GET  /api/v1/tasks?priority=crit    → Aufgaben gefiltert nach Priorität

// Query-Parameter
?type=Büro|Lager|...               → Filter nach Objekttyp
?sla=ok|warn|crit                  → Filter nach SLA-Status
?sort=occupancy_pct&order=desc     → Sortierung
?updated_since=ISO8601             → Delta-Sync für Polling

Empfohlener Polling-Intervall: 60s für KPIs, 300s für Timeseries. Auth via Bearer Token im Authorization-Header. Rate-Limit: 120 req/min.

{
  "id": "zh-west-01",
  "name": "Zürich West Tower",
  "type": "Büro",
  "address": "Hardstrasse 201, 8005 Zürich",
  "area_m2": 4200,
  "sla_status": "ok",
  "kpis": {
    "occupancy_pct": 94,
    "budget_used_pct": 71,
    "budget_total_chf": 280000,
    "energy_kwh": 26800,
    "tickets_open": 8
  },
  "timeseries": {
    "budget": [
      {"month":"2025-10","used_pct":12},
      {"month":"2025-11","used_pct":24},
      {"month":"2025-12","used_pct":38},
      {"month":"2026-01","used_pct":48},
      {"month":"2026-02","used_pct":59},
      {"month":"2026-03","used_pct":71}
    ],
    "energy": [
      {"month":"2025-10","kwh":24100},
      {"month":"2025-11","kwh":28300},
      {"month":"2025-12","kwh":31200},
      {"month":"2026-01","kwh":29800},
      {"month":"2026-02","kwh":27500},
      {"month":"2026-03","kwh":26800}
    ]
  }
}