Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,71 @@
|
||||
# EXT-18 · BauHow Test-Workspace + OAuth-/API-Vertrag klären
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Typ** | Setup (External) |
|
||||
| **Owner** | Raffael |
|
||||
| **Plane** | `HIV-217` |
|
||||
| **Cycle/Fenster** | ungeplant · vor dem Bau von `R-BAUHOW` |
|
||||
| **Status** | In Progress · **1/6 DoD = ~17 % done** · Mail an Nick geschrieben, Rückmeldung offen |
|
||||
|
||||
## Was zu tun ist
|
||||
|
||||
Mit Nick von BauHow den belastbaren Zugangs- und Integrationsvertrag für einen HiveGrid-Connector klären. Es
|
||||
werden bewusst **keine unbestätigten BauHow-Funktionen vorausgesetzt**. Bekannt ist nur, dass Raffael die API
|
||||
bereits über Noah gesehen hat; daraus folgt noch kein freigegebener Testzugang oder OAuth-Vertrag.
|
||||
|
||||
Der in der Mail beschriebene vorläufige HiveGrid-Scope ist:
|
||||
|
||||
- einen BauHow-Account mit HiveGrid verbinden,
|
||||
- Kunden-, Projekt- und Gebäudedaten im vereinbarten Minimalumfang übertragen,
|
||||
- das zugehörige BauHow-Projekt aus HiveGrid öffnen,
|
||||
- Status, Ergebnisse und Dokumente synchronisieren, soweit die BauHow-API diese Vorgänge tatsächlich trägt.
|
||||
|
||||
## Angefragter Partner-Input
|
||||
|
||||
1. **Test-Workspace:** separater Testzugang mit API-Zugriff und realistischen, nicht produktiven Testdaten.
|
||||
2. **OAuth-App:** Kann HiveGrid selbst eine OAuth-App anlegen und verwalten oder legt BauHow sie für uns an?
|
||||
3. **OAuth-Vertrag:** Client-ID/-Secret, Authorization-/Token-Endpunkte, Scopes, Refresh-/Revocation-Verhalten
|
||||
und Bindung der Autorisierung an Nutzer beziehungsweise Organisation/Workspace.
|
||||
4. **Redirect-URIs:** Unterstützung fester Callback-URLs für lokal, Staging und Produktion. Nach dem
|
||||
HiveGrid-Routenvertrag wären dies, sofern BauHow sie akzeptiert:
|
||||
- `http://localhost:3000/integrations/bauhow/oauth/callback`
|
||||
- `https://staging-app.hivegrid.de/integrations/bauhow/oauth/callback`
|
||||
- `https://app.hivegrid.de/integrations/bauhow/oauth/callback`
|
||||
5. **Direkter Projekteinstieg:** Unterstützter SSO-, Deep-Link- oder vergleichbarer Mechanismus, mit dem ein
|
||||
autorisierter Nutzer das verknüpfte Projekt ohne erneute Anmeldung öffnen kann.
|
||||
6. **API-Unterlagen:** aktuelle Dokumentation und Setup-Schritte sowie die tatsächlich unterstützten
|
||||
Ressourcen für Kunden, Projekte, Gebäude, Status, Ergebnisse und Dokumente; außerdem Webhooks oder die
|
||||
empfohlene Alternative für den Rückkanal.
|
||||
|
||||
## Abhängigkeiten
|
||||
|
||||
- **blocked-by:** Rückmeldung und Bereitstellung durch Nick/BauHow (extern)
|
||||
- **blocks:** `R-BAUHOW`
|
||||
- **Auswirkung auf den Abhängigen:** `R-BAUHOW` bleibt bis zur dokumentierten Antwort auf **Blocked / On Hold**.
|
||||
Insbesondere werden OAuth, API-Token, SSO/Deep-Link, Scopes und Sync-Richtung nicht vorab erfunden.
|
||||
|
||||
## Definition of Done
|
||||
|
||||
- [x] Initiale Mail an Nick mit kurzem HiveGrid-Scope sowie Fragen zu Test-Workspace, OAuth-App, Callback-URLs,
|
||||
direktem Projekteinstieg und API-Unterlagen geschrieben
|
||||
- [ ] Separater Test-Workspace mit nutzbarem API-Zugang und Testdaten ist bereitgestellt
|
||||
- [ ] OAuth-App-Modell ist geklärt: Self-Service oder Provisionierung durch BauHow, inklusive Client-Credentials
|
||||
- [ ] OAuth-Vertrag ist dokumentiert: Endpunkte, Redirect-URIs, Scopes, Token-Lifecycle und Nutzer-/Org-Bindung
|
||||
- [ ] Unterstützter Vertrag für den direkten Projekteinstieg ohne zweite Anmeldung ist dokumentiert
|
||||
- [ ] Aktuelle API-Unterlagen und der bestätigte Daten-/Sync-Umfang liegen vor
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
- **2026-08-01 · 1/6 DoD = ~17 % done:** Raffael hat die initiale Mail an Nick geschrieben. Sie nennt nur den
|
||||
geplanten HiveGrid-Integrationsscope und fragt nach Test-Workspace, OAuth-App beziehungsweise eigener
|
||||
App-Erstellung, Callback-URLs, Client-Credentials, OAuth-Endpunkten/Scopes, Token-Lifecycle, direktem
|
||||
Projekteinstieg und aktueller API-Dokumentation. Offen: fünf Punkte; davon fünf durch BauHow-Input blockiert,
|
||||
sobald die Anfrage bei Nick liegt. Es wird ausdrücklich noch nicht behauptet, dass BauHow OAuth/OIDC,
|
||||
SSO/Deep-Links oder alle genannten Sync-Ressourcen anbietet.
|
||||
|
||||
## Quellen
|
||||
|
||||
- Anfrage und Mail-Stand von Raffael, 2026-08-01
|
||||
- `docs/INTEGRATION-CONTRACTS.md` §3 (kanonischer Connector-Callback)
|
||||
- `.planning/ticket-docs/R-P5.md` (bestehende Apps-Engine und `DataConnection`-Vertrag)
|
||||
Reference in new issue
Block a user