Elenco di controllo per il go-live

Usa questo elenco di controllo prima di attivare un'integrazione partner per le strutture in produzione.

Configurazione della Partner Console

Il tuo profilo partner è completo.
URL del logo, sito web, categoria e descrizione sono corretti.
Il metodo di collegamento dei dati è configurato: Direct Link o Linking Identifier.
Il collegamento delle strutture è stato testato con almeno una struttura reale.
Viene usato il tipo di chiave corretto:
- Dryrun per testare le scritture senza effetti distruttivi.
- Read-only per un consumo sicuro dei dati.
- Live solo quando sei pronto a modificare i dati di produzione.

Autenticazione e gestione delle chiavi

Le chiavi segrete sono conservate solo lato server.
Le chiavi non sono incorporate in applicazioni lato client, app mobili, repository pubblici o ticket di assistenza.
La rotazione e la revoca delle chiavi sono state testate.
Il tuo team sa quale chiave viene usata in ciascun ambiente.

Convalida dei dati

I campi obbligatori sono presenti per ogni endpoint che chiami.
Gli identificatori delle strutture corrispondono al metodo di collegamento configurato.
Gli ID del tuo sistema sono stabili e non cambiano tra una sincronizzazione e l'altra.
Le importazioni di grandi dimensioni sono suddivise in batch entro i limiti documentati.
Gli elementi dei batch non riusciti possono essere identificati e inviati di nuovo.

Test degli endpoint

Prima del lancio, testa ogni endpoint da cui dipende la tua integrazione:

Le organizzazioni e le strutture possono essere lette.
I membri possono essere salvati e aggiornati.
Piani di abbonamento, zone di accesso e orari di accesso si sincronizzano correttamente.
I check-in vengono accettati e possono essere ricondotti al tuo sistema.
Le istantanee dei report usano il periodo di riferimento e le metriche previsti.
I flussi dei Door/Gate Controller sono testati su hardware reale, ove applicabile.

Preparazione per le Access Time Windows

Se l'integrazione fornisce Access Time Windows:

Gli esempi assoluti e settimanali superano l'elenco di controllo per la certificazione dei produttori.
Gli epoch sono secondi Unix interi senza virgolette; i limiti esatti [from, to) sono stati testati.
Sono stati verificati i valori predefiniti UTC, i fusi orari IANA personalizzati dell'integrazione e i relativi passaggi all'ora legale.
Un unico flusso di revisioni per membro/fonte, persistente e monotono, coordina aggiornamenti incrementali, riconciliazione e nuovi tentativi.
Gli operatori comprendono il comportamento nei casi di campo omesso, sostituzione completa, idempotenza, conflitto, dati obsoleti e [] esplicito.
Ogni scope_key, compreso default, ha una mappatura approvata nel Performance Hub; è stato verificato che le chiavi sconosciute neghino l'accesso per impostazione predefinita.
La frequenza di aggiornamento prevista dall'integrazione, l'età massima dei dati di origine, il comportamento con dati di origine obsoleti e gli avvisi sono configurati.
È stato dimostrato che un errore di recupero a monte non genera un'istantanea vuota o parziale.
La convergenza del flusso in staging, l'annullamento/la revoca e i limiti di inizio e fine sulle porte fisiche rispettano gli obiettivi concordati.
Le regole ordinarie e le concessioni permanenti sono state verificate come percorsi di riserva, e le finestre non possono aggirare la disattivazione dell'utente, blockAllAccess, la manutenzione o il geofencing.

Preparazione per il controllo degli accessi

Per le integrazioni di controllo degli accessi:

Il tuo sistema prende la decisione sull'accesso prima di chiamare il Performance Hub.
L'integrazione gestisce device_offline, maintenance_mode_active e unlock_confirmation_timeout.
Gli operatori sanno che un timeout significa che lo sblocco non è stato confermato.
I tuoi log memorizzano l'event_id e il command_id restituiti.
Hai una procedura di riserva manuale per il personale della struttura.

Gestione degli errori e nuovi tentativi

Le risposte 400, 401, 403, 404, 409 e 422 vengono segnalate agli operatori o ai team di assistenza invece di essere ripetute alla cieca.
Le risposte 429, 500, 502, 503 e 504 usano una logica di nuovi tentativi limitata, con backoff.
Gli errori ripetuti generano un avviso nel tuo sistema.
L'integrazione non scarta mai in modo silenzioso i record non riusciti.

Osservabilità

I tuoi log includono endpoint, timestamp, identificatore della struttura, ID del record di origine, esito della richiesta e corpo della risposta.
Il tuo team di assistenza può cercare per ID del membro, ID della struttura, ID del check-in o ID dell'evento di sblocco.
Hai un modo per ripetere o riconciliare le sincronizzazioni non riuscite.

Lancio in produzione

Il Performance Hub ha confermato il tuo accesso alla produzione.
Almeno una struttura in produzione ha attivato la tua integrazione.
La tua chiave di produzione è attiva.
I tuoi referenti operativi e tecnici sono aggiornati.
La tua procedura di assistenza è documentata per i clienti.

Una volta completate queste verifiche, la tua integrazione configurata comparirà nella directory dei partner del Performance Hub, all'interno della piattaforma principale del Performance Hub.