Rhythm 2.0 Specifications

Appearance

JNY-PFM-INT-001Install an integration and recover a failed connection

Markdown

JNY-PFM-INT-001

Install an integration and recover a failed connection

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationPartially observed

Planning

Feature
FEAT-PFM-INT-01
Actor
ACT-PFM-017
Capabilities
CAP-PFM-INT-002, CAP-PFM-INT-003, CAP-PFM-INT-004, CAP-PFM-INT-005, CAP-PFM-INT-006
Rules in play
BR-CAP-PFM-INT-002-01, BR-CAP-PFM-INT-002-06, BR-CAP-PFM-INT-003-02, BR-CAP-PFM-INT-003-03, BR-CAP-PFM-INT-004-05, BR-CAP-PFM-INT-005-01, BR-CAP-PFM-INT-005-04, BR-CAP-PFM-INT-006-01, BR-CAP-PFM-INT-006-10

KindJourneyProduct areaPlatformModuleIntegration access, customer extensions and shared workflow configurationRevision1End-to-endRequired

Read atservices-platform ad3f6a65react-console baf6dae3

Install an integration and recover a failed connection ​

Story ​

An administrator reviews an offer and installs it with fewer permissions than requested. An invalid account key produces a visible failure. The administrator finds the account in the attention list and repairs credentials from its detail page. A colleague inspects the result with read permission. The browser recovery gap remains an examination finding; this story does not establish that the unfinished wizard supports the same repair.

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Goal
Choose an offered integration, restrict its access and verify a provider account while preserving read-only access for colleagues.
Screens
/console/{tenantId}/configuration/platform/integrations/catalog/console/{tenantId}/configuration/platform/integrations/catalog/{integrationKey}/console/{tenantId}/configuration/platform/integrations/{integrationKey}/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/new/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}/console/{tenantId}/configuration/platform/integrations/needs-attention
Intent sources
services-platform:docs/milestones/INTG-M1-find-install-connect.plan.md#INTG-M1-S03services-platform:docs/milestones/INTG-M1-find-install-connect.plan.md#INTG-M1-S05services-platform:docs/milestones/INTG-M1-find-install-connect.plan.md#INTG-M1-S06services-platform:docs/milestones/INTG-M1-find-install-connect.plan.md#INTG-M1-S08services-platform:docs/milestones/INTG-M1-find-install-connect.md#D4

Steps

#SurfaceActionCapabilityExpectedProvenance
1/console/{tenantId}/configuration/platform/integrations/catalogFind the dummy integration in the catalog and view its offer.CAP-PFM-INT-002The matching card opens an overview of the capabilities, requested access and available versions.test
react-console:acceptance/integrations/playwright/journeys/catalog/INT-ACC-0080.spec.ts#INT-ACC-0080
2/console/{tenantId}/configuration/platform/integrations/catalog/{integrationKey}Start installation, clear two access choices and enter the required settings.CAP-PFM-INT-003The saved installation displays the selected access and settings.test
react-console:acceptance/integrations/playwright/journeys/library/INT-ACC-0006.spec.ts#INT-ACC-0006
3/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/newAdd an account using a key that the provider rejects.CAP-PFM-INT-004The connection displays a red verification failure and the provider’s explanation.test
react-console:acceptance/integrations/playwright/journeys/catalog/INT-ACC-0130.spec.ts#INT-ACC-0130
4/console/{tenantId}/configuration/platform/integrations/needs-attentionView the Needs Attention list.CAP-PFM-INT-006The failed account appears with a recovery action and matching summary counts.test
react-console:acceptance/integrations/playwright/journeys/catalog/INT-ACC-0118.spec.ts#INT-ACC-0118
5/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}Open the connection details and supply an accepted key.CAP-PFM-INT-005The account becomes active, displays its verified features and reveals only the final four key characters.observed
react-console:components/integrations/connection-detail.tsx:1162
6/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}Visit the same pages with a colleague’s read-only account.CAP-PFM-INT-002The colleague can inspect the records but receives neither editing controls nor secret values.test
react-console:acceptance/integrations/playwright/journeys/library/INT-ACC-0049.spec.ts#INT-ACC-0049

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate3The administrator leaves account setup before verification finishesDiscard the incomplete account connectionThe connection becomes disconnected and ceases to prevent uninstallingtest
react-console:acceptance/integrations/playwright/journeys/library/INT-ACC-0013.spec.ts#INT-ACC-0013
failure2Requested acceptance includes access absent from the offerReject installation and identify the unsupported accessKeep the installation unchangedtest
services-platform:modules/integrations/tests/integration/services/installations/history-and-security-trail.integration.spec.js#is never widened beyond what the integration declares: refused, naming it, and nothing is written

Assertions

IdStatementProvenance
01Saved acceptance matches the administrator’s selections.test
react-console:acceptance/integrations/playwright/journeys/library/INT-ACC-0006.spec.ts#INT-ACC-0006
02An accepted key produces an active account with the verified features.test
react-console:acceptance/integrations/playwright/journeys/catalog/INT-ACC-0130.spec.ts#INT-ACC-0130
03The attention list retains the failed account until valid credentials pass verification.test
react-console:acceptance/integrations/playwright/journeys/catalog/INT-ACC-0118.spec.ts#INT-ACC-0118
04A colleague with read permission receives no editing controls.test
react-console:acceptance/integrations/playwright/journeys/library/INT-ACC-0049.spec.ts#INT-ACC-0049

End-to-end policy: required: A browser walk must connect access selection, account setup and reader controls. Recovery remains a recorded gap in the current browser evidence.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software