Um ciclo para definir e produtizar capacidades de integração reutilizáveis sem assumir antecipadamente o estilo de implementação.
Orientar a concecao de capacidades de integracao reutilizaveis antes de escolher um estilo de implementacao API, evento, ficheiro, stream, produto de dados, integracao direta ou hibrido.
Sua rota no mapa
Navegar pelo método
Selecione uma estação, ciclo ou perspectiva para explorar o método.
A oportunidade de capacidade está identificada e documentada.
Critérios de saída
A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
Contratos de integração, esquemas, mapeamentos, evidências de teste, ambientes, permissões, credenciais, monitorização, suporte, replay, reconciliação, fallback, recuperação, riscos e ownership foram revistos para prontidão de lançamento.
A capacidade de integração está descobrível com ownership, estado de ciclo de vida, contratos, esquemas, expectativas de serviço, caminhos de acesso e onboarding, suporte, versionamento e canais de feedback publicados.
Comece pela jornada do cliente, pelo valor da capacidade e pela evidência de viabilidade; depois valide se a capacidade de integração reutilizável proposta deve avançar.
Muitas organizações pensam nas APIs como projetos tecnológicos e não como produtos. O resultado? Consumidores confusos, fraca adoção e esforço desperdiçado.
Esta estação ajuda-o a definir o objetivo da sua API, o público-alvo e os critérios de sucesso, para que as equipas possam fornecer APIs que resolvam problemas reais.
Acorde compromissos de fornecedor e consumidor para acesso, validação, serviço, tratamento de falhas, recuperação, compatibilidade e ciclo de vida.
As APIs excelentes não funcionam apenas - elas são intuitivas. Quer o consumidor seja um programador interno, um parceiro externo ou um agente de IA, a sua experiência determina a adoção.
Snum plano de experiência claro:
- Grandes APIs ficam sem uso
- As equipas perdem tempo a tentar adivinhar como utilizar a sua API
- Os ciclos de feedback estão quebrados ou ausentes.
Esta estação ajuda-o a ver a sua API através dos olhos dos seus consumidores.
Selecionar arquitetura de integração, estilo de implementação e capacidades de plataforma considerando restrições e governação.
Quando as APIs são escalonadas entre equipas, a sua plataforma deve permitir a governação e a reutilização sem bloquear a velocidade. Esta estação mostra como arquitetar APIs para longevidade, segurança e eficiência.
Desenhar a solução de integração, contratos, esquemas, estruturas de dados, mapeamentos e padrões de interação ou entrega para o estilo selecionado.
Conceber APIs não se resume apenas a nomear endpoints. Um bom projeto garante que as APIs sejam utilizáveis, consistentes e alinhadas com os objetivos de negócio e técnicos. Um projeto inadequado leva a um acoplamento rígido, baixa reutilização e retrabalho dispendioso entre as equipas.
Construir, testar, fazer deployment e operar a capacidade de integração usando o estilo selecionado e contrato validado.
Mesmo os melhores conceções de API falham se a entrega for inconsistente. Esta estação assegura que as suas APIs são construídas com qualidade, testadas exaustivamente e implementadas de forma fiável - permitindo iterações mais rápidas e maior confiança.
Garantir prontidão, governação, qualidade, segurança, compliance e evidências operacionais da integração antes do lançamento.
Uma decisão formal de prontidão impede que soluções de automação sejam lançadas sem evidências claras, riscos aceites, ações de remediação e ownership de negócio e operacional.
Publicar a capacidade de integração para que equipas possam descobri-la, avaliá-la, pedir acesso, completar onboarding, reutilizá-la e obter suporte.
Soluções de automação só criam valor após rollout quando as pessoas afetadas e sistemas consumidores entendem o que muda, como acesso e operação funcionam, onde obter suporte e quando o rollout deve pausar, expandir ou reverter.
Monitorizar fiabilidade, reutilização, incidentes, desempenho, resultados dos consumidores e necessidades de melhoria da integração.
Soluções lançadas precisam de evidências para mostrar se os resultados esperados estão a ser alcançados, onde ainda é necessária intervenção manual ou recuperação, e qual decisão de ciclo de vida deve ser tomada a seguir.
Publicar isto cycle
Export the page-specific template after reviewing the entity summary and supporting details above.
Exportação Confluence
Modelos de publicação
Use Markdown for repositories and static sites, or Confluence-wiki markup for compatible Confluence pages.
Markdown
# Ciclo de Produto de Integração question template
Um ciclo para definir e produtizar capacidades de integração reutilizáveis sem assumir antecipadamente o estilo de implementação.
Use this template to gather answers and evidence station by station. Canvas section prompts are listed first, followed by other related resources.
## 1. Estratégia da capacidade de integração
Comece pela jornada do cliente, pelo valor da capacidade e pela evidência de viabilidade; depois valide se a capacidade de integração reutilizável proposta deve avançar.
### Canvas questions
#### Canvas da Jornada do Cliente
Que jornada vive o cliente relevante mais externo e o que deve ser melhorado?
- **Persona do utilizador**: Quem é o cliente típico que passa por esta percurso?
- **O cliente descobre a necessidade**: Como o cliente reconhece sua necessidade ou problema?
- **Necessidade do cliente resolvida**: Como a necessidade do cliente é resolvida no final?
- **Etapas da percurso**: Quais são as etapas que o cliente percorre em sua percurso?
- **Dores**: Quais são os pontos fracos ou desafios do cliente?
- **Ganhos**: Quais são os ganhos ou benefícios do cliente?
- **Entradas e saídas**: Quais são as entradas e saídas em cada etapa?
- **Regras de interação e processamento**: Quais são as regras de interação e processamento em cada etapa?
- **Oportunidades de melhoria**: Que etapas da jornada indicam que uma capacidade ou processo subjacente deve ser criado, melhorado, automatizado ou removido?
#### Canvas da Proposta de Valor da Capacidade
Que capacidade reutilizável criaria valor para os utilizadores sem decidir ainda se deve ser disponibilizada como API, evento, ficheiro, stream, produto de dados ou outro estilo de implementação?
- **Tarefas e resultados dos utilizadores**: O que os utilizadores, parceiros, utilizadores, sistemas ou equipas estão a tentar alcançar?
- **Funcionalidades da capacidade que permitem ganhos**: Que funcionalidades da capacidade ajudariam os utilizadores a alcançar melhores resultados, rapidez, automação, conhecimento, alcance ou conformidade?
- **Funcionalidades da capacidade que aliviam dores**: Que funcionalidades da capacidade removeriam atrito, trabalho manual, erros, atrasos, risco ou incerteza para os utilizadores?
- **Capacidades reutilizáveis**: Que capacidades de negócio ou de dados reutilizáveis poderiam servir estas tarefas, ganhos e dores em mais do que um utilizador ou caso de utilização?
#### Canvas do Modelo de Negócio da Capacidade
Quão viável, reutilizável, financiada, atribuída, apoiada e detetável deve ser esta capacidade?
- **Proposta de valor da capacidade**: Que valor esta capacidade reutilizável oferece aos utilizadores e à organização ou ecossistema?
- **Segmentos de utilizadores da capacidade**: Quem são os utilizadores atuais e potenciais da capacidade, incluindo equipas, parceiros, sistemas, produtos ou utilizadores de dados?
- **Envolvimento dos utilizadores**: Como irão os utilizadores descobrir, avaliar, solicitar, integrar-se, obter apoio e dar feedback sobre a capacidade?
- **Canais**: Através de que catálogos, portais, marketplaces, sites de documentação, caminhos de apoio ou processos de governação os utilizadores irão interagir com a capacidade?
- **Recursos-chave**: Que sistemas, ativos de dados, plataformas, pessoas, normas, financiamento e capacidades operacionais são necessários?
- **Atividades-chave**: O que o responsável pela capacidade e os produtores devem fazer para conceber, entregar, governar, apoiar e melhorar a capacidade?
- **Parceiros-chave**: Que parceiros de negócio, tecnologia, dados, segurança, jurídico, plataforma ou externos são necessários para que a capacidade funcione?
- **Benefícios**: Que benefícios de negócio, operacionais, de ecossistema, reutilização, conformidade ou custo justificam a capacidade?
- **Custos**: Quais são os custos significativos de construir, operar, governar, apoiar e evoluir a capacidade?
#### Canvas de validação da capacidade de integração
Valide se uma capacidade de integração reutilizável proposta deve prosseguir.
- **Capacidade a validar**: Que capacidade de integração proposta e âmbito de reutilização estão a ser testados?
- **Evidências reutilizadas**: Que resultados de canvases anteriores suportam a proposta?
- **Pressupostos críticos**: O que poderia invalidar valor, reutilização, ownership, viabilidade ou adoção?
- **Passo de validação**: Qual é a menor validação útil e o limiar de sucesso?
- **Decisão**: Prosseguir, restringir, rever e voltar a testar ou parar?
### Before this station
- [ ] Os objetivos de negócio estão definidos.
- [ ] A oportunidade de capacidade está identificada e documentada.
### Ready to leave when
- [ ] Sinais de mercado relevantes, feedback ou conhecimento operacional estão disponíveis para orientar esta oportunidade de capacidade.
- [ ] Os objetivos de negócio estão definidos.
- [ ] A investigação de mercado identifica oportunidades de capacidade.
- [ ] As partes interessadas relevantes concordam que vale a pena explorar e priorizar esta oportunidade de capacidade.
## 2. Compromissos do consumidor e fornecedor de integração
Acorde compromissos de fornecedor e consumidor para acesso, validação, serviço, tratamento de falhas, recuperação, compatibilidade e ciclo de vida.
### Canvas questions
#### Canvas de compromissos do consumidor e fornecedor de integração
Acorde as responsabilidades necessárias para usar e fornecer uma capacidade de integração reutilizável.
- **Partes e casos de uso selecionados**: Que produtores, fornecedores, consumidores e casos de uso estão cobertos?
- **Compromissos do fornecedor**: O que os fornecedores irão entregar, manter, monitorizar e suportar?
- **Compromissos do consumidor**: O que os consumidores devem testar, proteger, operar e comunicar?
- **Acesso e validação**: Como serão tratados acesso, ambientes, credenciais e conformidade?
- **Falha e recuperação**: Quem trata falhas, replay, duplicados, reconciliação e recuperação?
- **Mudança e ciclo de vida**: Como funcionarão compatibilidade, migração, aviso, depreciação e retirada?
### Before this station
- [ ] Sinais de mercado relevantes, feedback ou conhecimento operacional estão disponíveis para orientar esta oportunidade de capacidade.
- [ ] Os objetivos de negócio estão definidos.
- [ ] A investigação de mercado identifica oportunidades de capacidade.
- [ ] As partes interessadas relevantes concordam que vale a pena explorar e priorizar esta oportunidade de capacidade.
### Ready to leave when
- [ ] A oportunidade de capacidade está identificada e documentada.
- [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
- [ ] Os segmentos de utilizadores estão identificados.
- [ ] Está definido um roadmap de implementação de alto nível.
### Other related resources
- **Guia de onboarding de consumidores de integração**: Guia de onboarding de consumidores de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Checklist de acesso e ambientes de integração**: Checklist de acesso e ambientes de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
## 3. Arquitetura de integracao e decisoes de plataforma
Selecionar arquitetura de integração, estilo de implementação e capacidades de plataforma considerando restrições e governação.
### Canvas questions
#### Canvas de Impacto no Negócio
Que valor, risco e impactos operacionais, financeiros, de clientes, colaboradores, conformidade e estratégicos são esperados ou estão em causa?
- **Benefícios esperados**: Que benefícios de negócio, cliente, colaborador, qualidade, velocidade, risco, conformidade ou estratégicos são esperados?
- **Impacto na eficiência operacional**: Como podem mudar o esforço de trabalho, o tempo de espera, o retrabalho, o débito, a fiabilidade, a carga de suporte ou o custo operacional?
- **Impacto em clientes e colaboradores**: Como irão clientes, colaboradores, parceiros, operadores ou equipas de suporte experienciar a mudança?
- **Impacto financeiro**: Que impacto em receitas, custos, investimento, poupanças, prevenção de perdas ou financiamento é esperado?
- **Impacto de conformidade e estratégico**: Que consequências regulamentares, contratuais, de políticas, reputação, mercado, ecossistema ou estratégicas são relevantes?
- **Impacto de não prosseguir**: O que acontece se a capacidade, automação, integração ou serviço não for melhorado ou entregue?
- **Riscos e criticidade**: Que riscos de disponibilidade, segurança, dados, segurança operacional, processo, adoção ou continuidade do negócio podem afetar o resultado?
- **Mitigações e impacto na decisão**: Que mitigações, restrições, compromissos ou riscos residuais devem influenciar decisões de priorização, arquitetura, rollout ou prontidão?
#### Canvas de Localização
Que fronteiras geopolíticas, regulamentares, de rede e de confiança afetam esta API?
- **Grupos de Localização / Confiança**: Quais são os grupos geopolíticos, regulamentares, de rede ou de confiança relevantes?
- **Características do grupo**: Quais são as características desses grupos, como residência, nível de confiança ou exposição de rede?
- **Locais / Zonas Relevantes**: Quais são os locais, zonas ou ambientes relevantes dentro de cada grupo?
- **Características de localização / zona**: Quais são as características dessas localizações ou zonas, tais como propriedade, região ou exposição?
- **Distâncias de Rede / Regulatórias**: Que distâncias de latência, confiança, regulatórias ou de conectividade existem entre os locais?
- **Características da Distância**: Quais são as características dessas distâncias, como sensibilidade à latência, restrições de residência ou limites de confiança?
- **Pontos de extremidade de conectividade**: Quais pontos de extremidade ou interfaces de conectividade estão associados aos locais?
- **Características de acesso aos pontos de extremidade**: Quais são as características desses pontos de extremidade, tais como exposição, protocolo, segurança ou restrições de acesso?
#### Canvas de Capacidade
Quanta procura, carga, temporização e capacidade de escala devem ser compreendidas para a capacidade, automação, integração ou serviço?
- **Volumes de negócio atuais**: Quais são os volumes de negócio e as taxas de transação atuais?
- **Tendências de consumo futuro**: Quais são as tendências de consumo futuro previstas?
- **Requisitos de pico de carga e disponibilidade**: Quais são os requisitos de pico de carga e disponibilidade?
- **Estratégias de cache**: Quais estratégias de cache podem ser usadas para otimizar o desempenho?
- **Estratégias de limitação de pedidos**: Que estratégias de limitação de pedidos podem ser usadas para gerir o consumo?
- **Estratégias de dimensionamento**: Que estratégias de dimensionamento podem ser usadas para acomodar o crescimento?
#### Canvas de decisão de arquitetura de integração
Escolha o estilo de integração e a plataforma usando evidências já recolhidas.
- **Entradas reutilizadas**: Que compromissos e decisões de capacidade, localização, impacto e domínio restringem a escolha?
- **Opções viáveis**: Que opções de API, evento, mensagens, ficheiro, stream, dados, conector, plataforma ou personalizadas permanecem viáveis?
- **Abordagem selecionada**: Que estilo de integração, plataforma ou híbrido é selecionado?
- **Justificação da decisão**: Porque é que a abordagem selecionada é a mais adequada?
- **Alternativas rejeitadas**: Que alternativas sérias foram rejeitadas e porquê?
- **Riscos em aberto**: O que ainda precisa de validação antes da entrega ou release?
### Before this station
- [ ] A oportunidade de capacidade está identificada e documentada.
- [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
- [ ] Os segmentos de utilizadores estão identificados.
- [ ] Está definido um roadmap de implementação de alto nível.
### Ready to leave when
- [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
- [ ] Os segmentos de utilizadores estão identificados.
- [ ] Está definido um roadmap de implementação de alto nível.
## 4. Conceção da solução de integração
Desenhar a solução de integração, contratos, esquemas, estruturas de dados, mapeamentos e padrões de interação ou entrega para o estilo selecionado.
### Canvas questions
#### Canvas de Domínio
Quais são as entidades principais e as regras de negócio relacionadas com a API?
- **Etapas selecionadas da percurso do cliente**: Quais etapas da percurso do cliente são relevantes para este domínio?
- **Entidades principais e significado de negócio**: Quais são as entidades principais e seu significado de negócio?
- **Atributos e importância de negócio**: Quais são os principais atributos de cada entidade e sua importância de negócio?
- **Relações entre entidades**: Quais são as relações entre as entidades?
- **Regras de negócio, conformidade e integridade**: Quais são as regras de negócio, conformidade e integridade relacionadas com as entidades?
- **Considerações sobre segurança e privacidade**: Quais são as considerações sobre segurança e privacidade relacionadas com as entidades?
#### Canvas de desenho da solução de integração
Refine a arquitetura selecionada num design de integração implementável.
- **Entradas selecionadas**: Que decisões de arquitetura, domínio, interação e compromisso são reutilizadas?
- **Contrato e modelo**: Que contrato, esquema, modelo de dados e versão definem a integração?
- **Mapeamento e entrega**: Que transformações, padrão de entrega e metadados são necessários?
- **Erros e recuperação**: Como são tratadas falhas, retries, replay, duplicados e reconciliação?
- **Segurança e confiança**: Que controlos de identidade, acesso, privacidade e confiança se aplicam?
- **Observabilidade e evolução**: Como a integração será monitorizada, alterada, migrada e depreciada?
#### Canvas de Interação
Que tipos de interações esta API deve suportar antes de escolher uma conceção específica para o protocolo?
- **Interações CRUD**: As interações do tipo CRUD (Criar, Ler, Atualizar, Eliminar) são necessárias aqui?
- **Modelos de entrada e saída CRUD**: Quais são os modelos de entrada e saída para as interações CRUD, caso esse estilo seja necessário?
- **Processamento e validação CRUD**: Quais são as regras de processamento e validação para as interações CRUD, caso esse estilo seja necessário?
- **Interações orientadas por consulta**: Quais interações de leitura ou consulta são necessárias para responder às perguntas dos utilizadores?
- **Modelos de entrada e saída orientados por consulta**: Quais são os modelos de entrada e saída para as interações orientadas por consulta?
- **Processamento e validação orientados por consulta**: Quais são as regras de processamento e validação para as interações orientadas por consulta?
- **Interações orientadas por comando**: Quais comandos de alteração de estado são necessários, se houver?
- **Modelos de entrada e saída orientados por comando**: Quais são os modelos de entrada e saída para as interações orientadas por comando, caso esse estilo seja necessário?
- **Processamento e validação orientados por comando**: Quais são as regras de processamento e validação para as interações orientadas por comando, caso esse estilo seja necessário?
- **Interações orientadas por eventos**: Quais eventos precisam /de ser publicados ou consumidos, se houver?
- **Modelos de entrada e saída orientados por eventos**: Quais são os modelos de entrada e saída para as interações orientadas a eventos, caso esse estilo seja necessário?
- **Processamento e validação orientados por eventos**: Quais são as regras de processamento e validação para as interações orientadas por eventos, caso esse estilo seja necessário?
### Before this station
- [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
- [ ] Os segmentos de utilizadores estão identificados.
- [ ] Está definido um roadmap de implementação de alto nível.
### Ready to leave when
- [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
- [ ] O desenho da interface segue os standards e convenções de desenho acordados.
### Other related resources
- **Desenho de Integração Contract-First**: Guidance for validating integration contracts before delivery, including OpenAPI, AsyncAPI, event schemas, message schemas, file schemas, data contracts, and interface specifications.
- **Guia de desenho por estilo de integração**: Guia de desenho por estilo de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
## 5. Entrega e operações da integração
Construir, testar, fazer deployment e operar a capacidade de integração usando o estilo selecionado e contrato validado.
### Canvas questions
#### Canvas de prontidão e operações de integração
Prepare as evidências operacionais mínimas necessárias antes da revisão de prontidão da integração.
- **Responsabilidade**: Quem é responsável por negócio, integração, produtor, consumidor, plataforma e incidentes?
- **Ambientes e acesso**: Ambientes, credenciais, conectividade, permissões e sequenciação estão prontos?
- **Evidências de teste**: O que comprova contrato, mapeamento, compatibilidade, qualidade, resiliência e recuperação?
- **Monitorização e suporte**: Como serão suportados produtores, consumidores, plataformas, incidentes e questões de serviço?
- **Falha e recuperação**: Como funcionarão retry, replay, duplicados, reconciliação, fallback e compensação?
- **Estado de prontidão**: Contratos, runbooks, dependências, riscos, condições e lacunas bloqueadoras estão claros?
### Before this station
- [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
- [ ] O desenho da interface segue os standards e convenções de desenho acordados.
### Ready to leave when
- [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
- [ ] O desenho da interface segue os standards e convenções de desenho acordados.
### Other related resources
- **Boas práticas de desenvolvimento de integração**: Boas práticas de desenvolvimento de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de testes de integração**: Guia de testes de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de CI/CD e deployment de integração**: Guia de CI/CD e deployment de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de segurança de integração**: Guia de segurança de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de recuperação e reconciliação de integração**: Guia de recuperação e reconciliação de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
## 6. Garantia de prontidão da integração
Garantir prontidão, governação, qualidade, segurança, compliance e evidências operacionais da integração antes do lançamento.
### Station questions
- Rever o desenho concluído, evidências de teste, modelo operacional, permissões, credenciais, monitorização, suporte, fallback e rollback.
- Verificar se riscos conhecidos, exceções, ações inseguras, supervisão humana, requisitos de conformidade e suposições não resolvidas foram tratados ou explicitamente aceites.
- Registar achados bloqueantes, riscos residuais aceites, condições de lançamento e ações de remediação necessárias.
- Decidir se o lançamento está pronto, pronto com condições, requer remediação ou não é aprovado.
- Registar o owner da decisão, a data da decisão e as evidências usadas.
- Confirmar que nada avança para lançamento sem ownership de negócio e operacional claro.
- Use a evidência de prontidão para tomar uma decisão explícita de avançar, avançar com condições ou não avançar antes do uso em produção.
- Uma decisão formal de prontidão impede que soluções de automação sejam lançadas sem evidências claras, riscos aceites, ações de remediação e ownership de negócio e operacional.
### Before this station
- [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
- [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
- [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
- [ ] O desenho da interface segue os standards e convenções de desenho acordados.
### Ready to leave when
- [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
- [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
- [ ] A interface e as suas capacidades estão documentadas de forma suficientemente clara para revisão, auditoria e onboarding.
- [ ] O desenho da interface segue os standards e convenções de desenho acordados.
- [ ] O contrato de interface foi validado e testado face aos requisitos funcionais e não funcionais.
### Other related resources
- **Checklist de prontidão da integração**: Checklist de prontidão da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de compliance e governação de dados da integração**: Guia de compliance e governação de dados da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
## 7. Publicacao e enablement da integracao
Publicar a capacidade de integração para que equipas possam descobri-la, avaliá-la, pedir acesso, completar onboarding, reutilizá-la e obter suporte.
### Station questions
- Pessoas afetadas e trabalho alterado: quem vai usar, operar, suportar, aprovar, consumir ou ser afetado pelo lançamento, e que responsabilidades, decisões, handoffs ou práticas de trabalho vão mudar?
- Ativação e abordagem de rollout: como serão geridos acesso, permissões, piloto, rollout faseado, grupos restritos, operação paralela e expansão?
- Enablement e suporte: que comunicação, formação, instruções operacionais e caminhos de suporte são necessários?
- Feedback e controlo: como serão monitorizados adoção, confiança, uso real, problemas e comportamento inesperado, e que condições acionam pausa, rollback ou retorno à operação manual?
- Planeie rollout, enablement, suporte, feedback e rollback para que as soluções lançadas possam ser adotadas com segurança.
- Soluções de automação só criam valor após rollout quando as pessoas afetadas e sistemas consumidores entendem o que muda, como acesso e operação funcionam, onde obter suporte e quando o rollout deve pausar, expandir ou reverter.
### Before this station
- [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
- [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
- [ ] A interface e as suas capacidades estão documentadas de forma suficientemente clara para revisão, auditoria e onboarding.
- [ ] O desenho da interface segue os standards e convenções de desenho acordados.
- [ ] O contrato de interface foi validado e testado face aos requisitos funcionais e não funcionais.
### Ready to leave when
- [ ] A solução passa as verificações de qualidade, segurança, conformidade e prontidão.
- [ ] As conclusões da auditoria e as decisões de correção são partilhadas com as partes interessadas relevantes.
- [ ] A capacidade está pronta para ser publicada ou disponibilizada através do mecanismo de entrega selecionado.
- [ ] A documentação orientada para os utilizadores e os materiais de onboarding estão prontos.
### Other related resources
- **Guia de publicação e descoberta da integração**: Guia de publicação e descoberta da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de onboarding de consumidores de integração**: Guia de onboarding de consumidores de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Modelo de acordo de serviço de integração**: Modelo de acordo de serviço de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de versionamento e depreciação da integração**: Guia de versionamento e depreciação da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
## 8. Monitorização e melhoria da integração
Monitorizar fiabilidade, reutilização, incidentes, desempenho, resultados dos consumidores e necessidades de melhoria da integração.
### Station questions
- Resultados e valor: os resultados esperados de processo, utilizador e negócio estão a ser alcançados?
- Desempenho operacional: o que mostram execuções bem-sucedidas, falhas, conclusões parciais, exceções, retries, timeouts, intervenções, tempo de processamento, tempo de espera e custo?
- Sinais de utilizador, risco e recuperação: que erros, correções, ações inseguras, contornos, desconfiança, necessidades de suporte, eventos de fallback ou falhas de recuperação ocorrem?
- Aprendizagem e decisão de ciclo de vida: que suposições da hipótese foram suportadas ou rejeitadas, e a solução deve ser melhorada, expandida, restringida, redesenhada, pausada ou retirada?
- Use evidência operacional, de utilizador, risco e valor para decidir o que melhorar, expandir, restringir, pausar ou retirar.
- Soluções lançadas precisam de evidências para mostrar se os resultados esperados estão a ser alcançados, onde ainda é necessária intervenção manual ou recuperação, e qual decisão de ciclo de vida deve ser tomada a seguir.
### Before this station
- [ ] A solução passa as verificações de qualidade, segurança, conformidade e prontidão.
- [ ] As conclusões da auditoria e as decisões de correção são partilhadas com as partes interessadas relevantes.
- [ ] A capacidade está pronta para ser publicada ou disponibilizada através do mecanismo de entrega selecionado.
- [ ] A documentação orientada para os utilizadores e os materiais de onboarding estão prontos.
### Ready to leave when
- [ ] A documentação orientada para os utilizadores e os materiais de onboarding estão prontos.
- [ ] Os processos de onboarding, suporte e comunicação para utilizadores estão prontos.
- [ ] Os requisitos legais, de privacidade e de conformidade para publicação ou disponibilização estão definidos e compreendidos.
### Other related resources
- **Monitorização e métricas de valor da integração**: Monitorização e métricas de valor da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de feedback de consumidores e adoção da integração**: Guia de feedback de consumidores e adoção da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Métricas de fiabilidade e qualidade dos dados da integração**: Métricas de fiabilidade e qualidade dos dados da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
- **Guia de gestão do ciclo de vida da integração**: Guia de gestão do ciclo de vida da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
Confluence-wiki
h1. Ciclo de Produto de Integração question template
Um ciclo para definir e produtizar capacidades de integração reutilizáveis sem assumir antecipadamente o estilo de implementação.
Use this template to gather answers and evidence station by station. Canvas section prompts are listed first, followed by other related resources.
h2. 1. Estratégia da capacidade de integração
Comece pela jornada do cliente, pelo valor da capacidade e pela evidência de viabilidade; depois valide se a capacidade de integração reutilizável proposta deve avançar.
h3. Canvas questions
h4. Canvas da Jornada do Cliente
Que jornada vive o cliente relevante mais externo e o que deve ser melhorado?
* *Persona do utilizador*: Quem é o cliente típico que passa por esta percurso?
* *O cliente descobre a necessidade*: Como o cliente reconhece sua necessidade ou problema?
* *Necessidade do cliente resolvida*: Como a necessidade do cliente é resolvida no final?
* *Etapas da percurso*: Quais são as etapas que o cliente percorre em sua percurso?
* *Dores*: Quais são os pontos fracos ou desafios do cliente?
* *Ganhos*: Quais são os ganhos ou benefícios do cliente?
* *Entradas e saídas*: Quais são as entradas e saídas em cada etapa?
* *Regras de interação e processamento*: Quais são as regras de interação e processamento em cada etapa?
* *Oportunidades de melhoria*: Que etapas da jornada indicam que uma capacidade ou processo subjacente deve ser criado, melhorado, automatizado ou removido?
h4. Canvas da Proposta de Valor da Capacidade
Que capacidade reutilizável criaria valor para os utilizadores sem decidir ainda se deve ser disponibilizada como API, evento, ficheiro, stream, produto de dados ou outro estilo de implementação?
* *Tarefas e resultados dos utilizadores*: O que os utilizadores, parceiros, utilizadores, sistemas ou equipas estão a tentar alcançar?
* *Funcionalidades da capacidade que permitem ganhos*: Que funcionalidades da capacidade ajudariam os utilizadores a alcançar melhores resultados, rapidez, automação, conhecimento, alcance ou conformidade?
* *Funcionalidades da capacidade que aliviam dores*: Que funcionalidades da capacidade removeriam atrito, trabalho manual, erros, atrasos, risco ou incerteza para os utilizadores?
* *Capacidades reutilizáveis*: Que capacidades de negócio ou de dados reutilizáveis poderiam servir estas tarefas, ganhos e dores em mais do que um utilizador ou caso de utilização?
h4. Canvas do Modelo de Negócio da Capacidade
Quão viável, reutilizável, financiada, atribuída, apoiada e detetável deve ser esta capacidade?
* *Proposta de valor da capacidade*: Que valor esta capacidade reutilizável oferece aos utilizadores e à organização ou ecossistema?
* *Segmentos de utilizadores da capacidade*: Quem são os utilizadores atuais e potenciais da capacidade, incluindo equipas, parceiros, sistemas, produtos ou utilizadores de dados?
* *Envolvimento dos utilizadores*: Como irão os utilizadores descobrir, avaliar, solicitar, integrar-se, obter apoio e dar feedback sobre a capacidade?
* *Canais*: Através de que catálogos, portais, marketplaces, sites de documentação, caminhos de apoio ou processos de governação os utilizadores irão interagir com a capacidade?
* *Recursos-chave*: Que sistemas, ativos de dados, plataformas, pessoas, normas, financiamento e capacidades operacionais são necessários?
* *Atividades-chave*: O que o responsável pela capacidade e os produtores devem fazer para conceber, entregar, governar, apoiar e melhorar a capacidade?
* *Parceiros-chave*: Que parceiros de negócio, tecnologia, dados, segurança, jurídico, plataforma ou externos são necessários para que a capacidade funcione?
* *Benefícios*: Que benefícios de negócio, operacionais, de ecossistema, reutilização, conformidade ou custo justificam a capacidade?
* *Custos*: Quais são os custos significativos de construir, operar, governar, apoiar e evoluir a capacidade?
h4. Canvas de validação da capacidade de integração
Valide se uma capacidade de integração reutilizável proposta deve prosseguir.
* *Capacidade a validar*: Que capacidade de integração proposta e âmbito de reutilização estão a ser testados?
* *Evidências reutilizadas*: Que resultados de canvases anteriores suportam a proposta?
* *Pressupostos críticos*: O que poderia invalidar valor, reutilização, ownership, viabilidade ou adoção?
* *Passo de validação*: Qual é a menor validação útil e o limiar de sucesso?
* *Decisão*: Prosseguir, restringir, rever e voltar a testar ou parar?
h3. Before this station
* [ ] Os objetivos de negócio estão definidos.
* [ ] A oportunidade de capacidade está identificada e documentada.
h3. Ready to leave when
* [ ] Sinais de mercado relevantes, feedback ou conhecimento operacional estão disponíveis para orientar esta oportunidade de capacidade.
* [ ] Os objetivos de negócio estão definidos.
* [ ] A investigação de mercado identifica oportunidades de capacidade.
* [ ] As partes interessadas relevantes concordam que vale a pena explorar e priorizar esta oportunidade de capacidade.
h2. 2. Compromissos do consumidor e fornecedor de integração
Acorde compromissos de fornecedor e consumidor para acesso, validação, serviço, tratamento de falhas, recuperação, compatibilidade e ciclo de vida.
h3. Canvas questions
h4. Canvas de compromissos do consumidor e fornecedor de integração
Acorde as responsabilidades necessárias para usar e fornecer uma capacidade de integração reutilizável.
* *Partes e casos de uso selecionados*: Que produtores, fornecedores, consumidores e casos de uso estão cobertos?
* *Compromissos do fornecedor*: O que os fornecedores irão entregar, manter, monitorizar e suportar?
* *Compromissos do consumidor*: O que os consumidores devem testar, proteger, operar e comunicar?
* *Acesso e validação*: Como serão tratados acesso, ambientes, credenciais e conformidade?
* *Falha e recuperação*: Quem trata falhas, replay, duplicados, reconciliação e recuperação?
* *Mudança e ciclo de vida*: Como funcionarão compatibilidade, migração, aviso, depreciação e retirada?
h3. Before this station
* [ ] Sinais de mercado relevantes, feedback ou conhecimento operacional estão disponíveis para orientar esta oportunidade de capacidade.
* [ ] Os objetivos de negócio estão definidos.
* [ ] A investigação de mercado identifica oportunidades de capacidade.
* [ ] As partes interessadas relevantes concordam que vale a pena explorar e priorizar esta oportunidade de capacidade.
h3. Ready to leave when
* [ ] A oportunidade de capacidade está identificada e documentada.
* [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
* [ ] Os segmentos de utilizadores estão identificados.
* [ ] Está definido um roadmap de implementação de alto nível.
h3. Other related resources
* *Guia de onboarding de consumidores de integração*: Guia de onboarding de consumidores de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Checklist de acesso e ambientes de integração*: Checklist de acesso e ambientes de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
h2. 3. Arquitetura de integracao e decisoes de plataforma
Selecionar arquitetura de integração, estilo de implementação e capacidades de plataforma considerando restrições e governação.
h3. Canvas questions
h4. Canvas de Impacto no Negócio
Que valor, risco e impactos operacionais, financeiros, de clientes, colaboradores, conformidade e estratégicos são esperados ou estão em causa?
* *Benefícios esperados*: Que benefícios de negócio, cliente, colaborador, qualidade, velocidade, risco, conformidade ou estratégicos são esperados?
* *Impacto na eficiência operacional*: Como podem mudar o esforço de trabalho, o tempo de espera, o retrabalho, o débito, a fiabilidade, a carga de suporte ou o custo operacional?
* *Impacto em clientes e colaboradores*: Como irão clientes, colaboradores, parceiros, operadores ou equipas de suporte experienciar a mudança?
* *Impacto financeiro*: Que impacto em receitas, custos, investimento, poupanças, prevenção de perdas ou financiamento é esperado?
* *Impacto de conformidade e estratégico*: Que consequências regulamentares, contratuais, de políticas, reputação, mercado, ecossistema ou estratégicas são relevantes?
* *Impacto de não prosseguir*: O que acontece se a capacidade, automação, integração ou serviço não for melhorado ou entregue?
* *Riscos e criticidade*: Que riscos de disponibilidade, segurança, dados, segurança operacional, processo, adoção ou continuidade do negócio podem afetar o resultado?
* *Mitigações e impacto na decisão*: Que mitigações, restrições, compromissos ou riscos residuais devem influenciar decisões de priorização, arquitetura, rollout ou prontidão?
h4. Canvas de Localização
Que fronteiras geopolíticas, regulamentares, de rede e de confiança afetam esta API?
* *Grupos de Localização / Confiança*: Quais são os grupos geopolíticos, regulamentares, de rede ou de confiança relevantes?
* *Características do grupo*: Quais são as características desses grupos, como residência, nível de confiança ou exposição de rede?
* *Locais / Zonas Relevantes*: Quais são os locais, zonas ou ambientes relevantes dentro de cada grupo?
* *Características de localização / zona*: Quais são as características dessas localizações ou zonas, tais como propriedade, região ou exposição?
* *Distâncias de Rede / Regulatórias*: Que distâncias de latência, confiança, regulatórias ou de conectividade existem entre os locais?
* *Características da Distância*: Quais são as características dessas distâncias, como sensibilidade à latência, restrições de residência ou limites de confiança?
* *Pontos de extremidade de conectividade*: Quais pontos de extremidade ou interfaces de conectividade estão associados aos locais?
* *Características de acesso aos pontos de extremidade*: Quais são as características desses pontos de extremidade, tais como exposição, protocolo, segurança ou restrições de acesso?
h4. Canvas de Capacidade
Quanta procura, carga, temporização e capacidade de escala devem ser compreendidas para a capacidade, automação, integração ou serviço?
* *Volumes de negócio atuais*: Quais são os volumes de negócio e as taxas de transação atuais?
* *Tendências de consumo futuro*: Quais são as tendências de consumo futuro previstas?
* *Requisitos de pico de carga e disponibilidade*: Quais são os requisitos de pico de carga e disponibilidade?
* *Estratégias de cache*: Quais estratégias de cache podem ser usadas para otimizar o desempenho?
* *Estratégias de limitação de pedidos*: Que estratégias de limitação de pedidos podem ser usadas para gerir o consumo?
* *Estratégias de dimensionamento*: Que estratégias de dimensionamento podem ser usadas para acomodar o crescimento?
h4. Canvas de decisão de arquitetura de integração
Escolha o estilo de integração e a plataforma usando evidências já recolhidas.
* *Entradas reutilizadas*: Que compromissos e decisões de capacidade, localização, impacto e domínio restringem a escolha?
* *Opções viáveis*: Que opções de API, evento, mensagens, ficheiro, stream, dados, conector, plataforma ou personalizadas permanecem viáveis?
* *Abordagem selecionada*: Que estilo de integração, plataforma ou híbrido é selecionado?
* *Justificação da decisão*: Porque é que a abordagem selecionada é a mais adequada?
* *Alternativas rejeitadas*: Que alternativas sérias foram rejeitadas e porquê?
* *Riscos em aberto*: O que ainda precisa de validação antes da entrega ou release?
h3. Before this station
* [ ] A oportunidade de capacidade está identificada e documentada.
* [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
* [ ] Os segmentos de utilizadores estão identificados.
* [ ] Está definido um roadmap de implementação de alto nível.
h3. Ready to leave when
* [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
* [ ] Os segmentos de utilizadores estão identificados.
* [ ] Está definido um roadmap de implementação de alto nível.
h2. 4. Conceção da solução de integração
Desenhar a solução de integração, contratos, esquemas, estruturas de dados, mapeamentos e padrões de interação ou entrega para o estilo selecionado.
h3. Canvas questions
h4. Canvas de Domínio
Quais são as entidades principais e as regras de negócio relacionadas com a API?
* *Etapas selecionadas da percurso do cliente*: Quais etapas da percurso do cliente são relevantes para este domínio?
* *Entidades principais e significado de negócio*: Quais são as entidades principais e seu significado de negócio?
* *Atributos e importância de negócio*: Quais são os principais atributos de cada entidade e sua importância de negócio?
* *Relações entre entidades*: Quais são as relações entre as entidades?
* *Regras de negócio, conformidade e integridade*: Quais são as regras de negócio, conformidade e integridade relacionadas com as entidades?
* *Considerações sobre segurança e privacidade*: Quais são as considerações sobre segurança e privacidade relacionadas com as entidades?
h4. Canvas de desenho da solução de integração
Refine a arquitetura selecionada num design de integração implementável.
* *Entradas selecionadas*: Que decisões de arquitetura, domínio, interação e compromisso são reutilizadas?
* *Contrato e modelo*: Que contrato, esquema, modelo de dados e versão definem a integração?
* *Mapeamento e entrega*: Que transformações, padrão de entrega e metadados são necessários?
* *Erros e recuperação*: Como são tratadas falhas, retries, replay, duplicados e reconciliação?
* *Segurança e confiança*: Que controlos de identidade, acesso, privacidade e confiança se aplicam?
* *Observabilidade e evolução*: Como a integração será monitorizada, alterada, migrada e depreciada?
h4. Canvas de Interação
Que tipos de interações esta API deve suportar antes de escolher uma conceção específica para o protocolo?
* *Interações CRUD*: As interações do tipo CRUD (Criar, Ler, Atualizar, Eliminar) são necessárias aqui?
* *Modelos de entrada e saída CRUD*: Quais são os modelos de entrada e saída para as interações CRUD, caso esse estilo seja necessário?
* *Processamento e validação CRUD*: Quais são as regras de processamento e validação para as interações CRUD, caso esse estilo seja necessário?
* *Interações orientadas por consulta*: Quais interações de leitura ou consulta são necessárias para responder às perguntas dos utilizadores?
* *Modelos de entrada e saída orientados por consulta*: Quais são os modelos de entrada e saída para as interações orientadas por consulta?
* *Processamento e validação orientados por consulta*: Quais são as regras de processamento e validação para as interações orientadas por consulta?
* *Interações orientadas por comando*: Quais comandos de alteração de estado são necessários, se houver?
* *Modelos de entrada e saída orientados por comando*: Quais são os modelos de entrada e saída para as interações orientadas por comando, caso esse estilo seja necessário?
* *Processamento e validação orientados por comando*: Quais são as regras de processamento e validação para as interações orientadas por comando, caso esse estilo seja necessário?
* *Interações orientadas por eventos*: Quais eventos precisam /de ser publicados ou consumidos, se houver?
* *Modelos de entrada e saída orientados por eventos*: Quais são os modelos de entrada e saída para as interações orientadas a eventos, caso esse estilo seja necessário?
* *Processamento e validação orientados por eventos*: Quais são as regras de processamento e validação para as interações orientadas por eventos, caso esse estilo seja necessário?
h3. Before this station
* [ ] A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
* [ ] Os segmentos de utilizadores estão identificados.
* [ ] Está definido um roadmap de implementação de alto nível.
h3. Ready to leave when
* [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
* [ ] O desenho da interface segue os standards e convenções de desenho acordados.
h3. Other related resources
* *Desenho de Integração Contract-First*: Guidance for validating integration contracts before delivery, including OpenAPI, AsyncAPI, event schemas, message schemas, file schemas, data contracts, and interface specifications.
* *Guia de desenho por estilo de integração*: Guia de desenho por estilo de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
h2. 5. Entrega e operações da integração
Construir, testar, fazer deployment e operar a capacidade de integração usando o estilo selecionado e contrato validado.
h3. Canvas questions
h4. Canvas de prontidão e operações de integração
Prepare as evidências operacionais mínimas necessárias antes da revisão de prontidão da integração.
* *Responsabilidade*: Quem é responsável por negócio, integração, produtor, consumidor, plataforma e incidentes?
* *Ambientes e acesso*: Ambientes, credenciais, conectividade, permissões e sequenciação estão prontos?
* *Evidências de teste*: O que comprova contrato, mapeamento, compatibilidade, qualidade, resiliência e recuperação?
* *Monitorização e suporte*: Como serão suportados produtores, consumidores, plataformas, incidentes e questões de serviço?
* *Falha e recuperação*: Como funcionarão retry, replay, duplicados, reconciliação, fallback e compensação?
* *Estado de prontidão*: Contratos, runbooks, dependências, riscos, condições e lacunas bloqueadoras estão claros?
h3. Before this station
* [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
* [ ] O desenho da interface segue os standards e convenções de desenho acordados.
h3. Ready to leave when
* [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
* [ ] O desenho da interface segue os standards e convenções de desenho acordados.
h3. Other related resources
* *Boas práticas de desenvolvimento de integração*: Boas práticas de desenvolvimento de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de testes de integração*: Guia de testes de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de CI/CD e deployment de integração*: Guia de CI/CD e deployment de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de segurança de integração*: Guia de segurança de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de recuperação e reconciliação de integração*: Guia de recuperação e reconciliação de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
h2. 6. Garantia de prontidão da integração
Garantir prontidão, governação, qualidade, segurança, compliance e evidências operacionais da integração antes do lançamento.
h3. Station questions
* Rever o desenho concluído, evidências de teste, modelo operacional, permissões, credenciais, monitorização, suporte, fallback e rollback.
* Verificar se riscos conhecidos, exceções, ações inseguras, supervisão humana, requisitos de conformidade e suposições não resolvidas foram tratados ou explicitamente aceites.
* Registar achados bloqueantes, riscos residuais aceites, condições de lançamento e ações de remediação necessárias.
* Decidir se o lançamento está pronto, pronto com condições, requer remediação ou não é aprovado.
* Registar o owner da decisão, a data da decisão e as evidências usadas.
* Confirmar que nada avança para lançamento sem ownership de negócio e operacional claro.
* Use a evidência de prontidão para tomar uma decisão explícita de avançar, avançar com condições ou não avançar antes do uso em produção.
* Uma decisão formal de prontidão impede que soluções de automação sejam lançadas sem evidências claras, riscos aceites, ações de remediação e ownership de negócio e operacional.
h3. Before this station
* [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
* [ ] A interface selecionada fornece uma abstração adequada aos utilizadores.
* [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
* [ ] O desenho da interface segue os standards e convenções de desenho acordados.
h3. Ready to leave when
* [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
* [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
* [ ] A interface e as suas capacidades estão documentadas de forma suficientemente clara para revisão, auditoria e onboarding.
* [ ] O desenho da interface segue os standards e convenções de desenho acordados.
* [ ] O contrato de interface foi validado e testado face aos requisitos funcionais e não funcionais.
h3. Other related resources
* *Checklist de prontidão da integração*: Checklist de prontidão da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de compliance e governação de dados da integração*: Guia de compliance e governação de dados da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
h2. 7. Publicacao e enablement da integracao
Publicar a capacidade de integração para que equipas possam descobri-la, avaliá-la, pedir acesso, completar onboarding, reutilizá-la e obter suporte.
h3. Station questions
* Pessoas afetadas e trabalho alterado: quem vai usar, operar, suportar, aprovar, consumir ou ser afetado pelo lançamento, e que responsabilidades, decisões, handoffs ou práticas de trabalho vão mudar?
* Ativação e abordagem de rollout: como serão geridos acesso, permissões, piloto, rollout faseado, grupos restritos, operação paralela e expansão?
* Enablement e suporte: que comunicação, formação, instruções operacionais e caminhos de suporte são necessários?
* Feedback e controlo: como serão monitorizados adoção, confiança, uso real, problemas e comportamento inesperado, e que condições acionam pausa, rollback ou retorno à operação manual?
* Planeie rollout, enablement, suporte, feedback e rollback para que as soluções lançadas possam ser adotadas com segurança.
* Soluções de automação só criam valor após rollout quando as pessoas afetadas e sistemas consumidores entendem o que muda, como acesso e operação funcionam, onde obter suporte e quando o rollout deve pausar, expandir ou reverter.
h3. Before this station
* [ ] A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
* [ ] O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
* [ ] A interface e as suas capacidades estão documentadas de forma suficientemente clara para revisão, auditoria e onboarding.
* [ ] O desenho da interface segue os standards e convenções de desenho acordados.
* [ ] O contrato de interface foi validado e testado face aos requisitos funcionais e não funcionais.
h3. Ready to leave when
* [ ] A solução passa as verificações de qualidade, segurança, conformidade e prontidão.
* [ ] As conclusões da auditoria e as decisões de correção são partilhadas com as partes interessadas relevantes.
* [ ] A capacidade está pronta para ser publicada ou disponibilizada através do mecanismo de entrega selecionado.
* [ ] A documentação orientada para os utilizadores e os materiais de onboarding estão prontos.
h3. Other related resources
* *Guia de publicação e descoberta da integração*: Guia de publicação e descoberta da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de onboarding de consumidores de integração*: Guia de onboarding de consumidores de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Modelo de acordo de serviço de integração*: Modelo de acordo de serviço de integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de versionamento e depreciação da integração*: Guia de versionamento e depreciação da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
h2. 8. Monitorização e melhoria da integração
Monitorizar fiabilidade, reutilização, incidentes, desempenho, resultados dos consumidores e necessidades de melhoria da integração.
h3. Station questions
* Resultados e valor: os resultados esperados de processo, utilizador e negócio estão a ser alcançados?
* Desempenho operacional: o que mostram execuções bem-sucedidas, falhas, conclusões parciais, exceções, retries, timeouts, intervenções, tempo de processamento, tempo de espera e custo?
* Sinais de utilizador, risco e recuperação: que erros, correções, ações inseguras, contornos, desconfiança, necessidades de suporte, eventos de fallback ou falhas de recuperação ocorrem?
* Aprendizagem e decisão de ciclo de vida: que suposições da hipótese foram suportadas ou rejeitadas, e a solução deve ser melhorada, expandida, restringida, redesenhada, pausada ou retirada?
* Use evidência operacional, de utilizador, risco e valor para decidir o que melhorar, expandir, restringir, pausar ou retirar.
* Soluções lançadas precisam de evidências para mostrar se os resultados esperados estão a ser alcançados, onde ainda é necessária intervenção manual ou recuperação, e qual decisão de ciclo de vida deve ser tomada a seguir.
h3. Before this station
* [ ] A solução passa as verificações de qualidade, segurança, conformidade e prontidão.
* [ ] As conclusões da auditoria e as decisões de correção são partilhadas com as partes interessadas relevantes.
* [ ] A capacidade está pronta para ser publicada ou disponibilizada através do mecanismo de entrega selecionado.
* [ ] A documentação orientada para os utilizadores e os materiais de onboarding estão prontos.
h3. Ready to leave when
* [ ] A documentação orientada para os utilizadores e os materiais de onboarding estão prontos.
* [ ] Os processos de onboarding, suporte e comunicação para utilizadores estão prontos.
* [ ] Os requisitos legais, de privacidade e de conformidade para publicação ou disponibilização estão definidos e compreendidos.
h3. Other related resources
* *Monitorização e métricas de valor da integração*: Monitorização e métricas de valor da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de feedback de consumidores e adoção da integração*: Guia de feedback de consumidores e adoção da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Métricas de fiabilidade e qualidade dos dados da integração*: Métricas de fiabilidade e qualidade dos dados da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.
* *Guia de gestão do ciclo de vida da integração*: Guia de gestão do ciclo de vida da integração apoia o planeamento, decisão, entrega, publicação ou melhoria de uma capacidade de integração reutilizável.