Lista de verificação para entrada em produção

Use esta lista de verificação antes de ativar uma integração de parceiro para instalações em produção.

Configuração do Partner Console

Seu perfil de parceiro está completo.
A URL do seu logotipo, o site, a categoria e a descrição estão corretos.
Seu método de vinculação de dados está configurado: Direct Link ou Linking Identifier.
A vinculação de instalações foi testada com pelo menos uma instalação real.
O tipo de chave correto está sendo usado:
- Dryrun para testes de gravação não destrutivos.
- Read-only para consumo seguro de dados.
- Live somente quando você estiver pronto para afetar os dados de produção.

Autenticação e gerenciamento de chaves

As chaves secretas são armazenadas somente no servidor.
As chaves não estão incorporadas em aplicativos do lado do cliente, aplicativos móveis, repositórios públicos ou tickets de suporte.
A rotação e a revogação de chaves foram testadas.
Sua equipe sabe qual chave é usada em cada ambiente.

Validação de dados

Os campos obrigatórios estão presentes em todos os endpoints que você chama.
Os identificadores de instalação correspondem ao método de vinculação configurado.
Os IDs do seu sistema são estáveis e não mudam entre sincronizações.
As importações grandes são divididas em lotes dentro dos limites documentados.
Os itens de lote com falha podem ser identificados e reenviados.

Teste de endpoints

Antes do lançamento, teste todos os endpoints dos quais sua integração depende:

É possível ler organizações e instalações.
É possível salvar e atualizar membros.
Planos de associação, zonas de acesso e horários de acesso são sincronizados corretamente.
Os check-ins são aceitos e podem ser correlacionados com o seu sistema.
Os snapshots de relatórios usam o período de relatório e as métricas esperados.
Os fluxos do Door/Gate Controller são testados em hardware real, quando aplicável.

Preparação para Access Time Windows

Se a integração fornecer Access Time Windows:

Os exemplos absolutos e semanais passam na lista de verificação de certificação do produtor.
As épocas são segundos Unix inteiros sem aspas; os limites exatos [from, to) foram testados.
Os padrões em UTC, os fusos horários IANA personalizados da integração e as transições de horário de verão relevantes foram verificados.
Um único fluxo de revisões de membro/origem, durável e monotônico, coordena as atualizações incrementais, a reconciliação e as novas tentativas.
Os operadores entendem o comportamento de omissão, substituição completa, idempotência, conflito, dados desatualizados e [] explícito.
Cada scope_key, incluindo default, tem um mapeamento aprovado no Performance Hub; foi testado que chaves desconhecidas falham de forma fechada.
A cadência de atualização esperada da integração, a idade máxima dos dados de origem, o comportamento com origem desatualizada e os alertas estão configurados.
Foi comprovado que uma falha na consulta à origem não emite um snapshot vazio ou parcial.
A convergência do fluxo em staging, o cancelamento/revogação e os limites de início/fim na porta física atendem às metas acordadas.
As regras regulares e as concessões permanentes foram verificadas como caminhos alternativos, e as janelas não podem contornar a desativação de usuários, blockAllAccess, a manutenção ou a geocerca.

Preparação para o controle de acesso

Para integrações de controle de acesso:

Seu sistema toma a decisão de acesso antes de chamar o Performance Hub.
A integração trata device_offline, maintenance_mode_active e unlock_confirmation_timeout.
Os operadores entendem que um tempo limite significa que o destravamento não foi confirmado.
Seus logs armazenam o event_id e o command_id retornados.
Você tem um processo manual alternativo para a equipe da instalação.

Tratamento de erros e novas tentativas

As respostas 400, 401, 403, 404, 409 e 422 são apresentadas aos operadores ou às equipes de suporte, em vez de serem repetidas cegamente.
As respostas 429, 500, 502, 503 e 504 usam uma lógica de novas tentativas limitada, com recuo.
Falhas repetidas geram um alerta no seu sistema.
A integração nunca descarta registros com falha silenciosamente.

Observabilidade

Seus logs incluem endpoint, carimbo de data/hora, identificador da instalação, ID do registro de origem, resultado da solicitação e corpo da resposta.
Sua equipe de suporte pode pesquisar por ID de membro, ID de instalação, ID de check-in ou ID de evento de destravamento.
Você tem uma forma de repetir ou reconciliar sincronizações com falha.

Lançamento em produção

O Performance Hub confirmou seu acesso de produção.
Pelo menos uma instalação em produção ativou sua integração.
Sua chave de produção está ativa.
Seus contatos operacionais e técnicos estão atualizados.
Seu processo de suporte está documentado para os clientes.

Depois que essas verificações forem concluídas, sua integração configurada aparecerá no diretório de parceiros do Performance Hub, dentro da plataforma principal do Performance Hub.