Skip to content

FAS-PFM-INT-01Integration offers and adoption acceptance

Markdown

FAS-PFM-INT-01

Integration offers and adoption acceptance

Markdown
  • DocumentProposed
  • Product intentProposed

Product areaPlatformModuleIntegration access, customer extensions and shared workflow configurationRevision2

Read atservices-platform ad3f6a65macroservice-libraries 54536a44react-console baf6dae3

Scenarios

5 scenarios proving FEAT-PFM-INT-01 as a whole.

01 Discover and adopt an eligible offer behaviour proposed
Exercises
CAP-PFM-INT-001 CAP-PFM-INT-002 CAP-PFM-INT-003
Relies on
ATS-PFM-INT-001-03 ATS-PFM-INT-002-01 ATS-PFM-INT-003-02
Preconditions
A validated provider can publish and a workspace administrator can adopt it.
Steps
Publish and offer the release, inspect provider detail, choose declared access and install.
Expected
The visible offer becomes one enabled installation with the selected access.
Data
Run-owned declarations, records and role fixtures in an isolated workspace.
Source
services-platform:modules/integrations/tests/integration/services/registration/register-integration-version.integration.spec.js#creates the definition by its key, internal until Rhythm offers it,services-platform:modules/integrations/tests/integration/services/catalog/catalog.integration.spec.js#shows a restricted integration only to the tenant granted it,services-platform:modules/integrations/tests/integration/services/installations/installation-lifecycle.integration.spec.js#refuses an acceptance wider than the manifest declares, naming it, and writes nothing
02 Audience changes preserve existing adoption interaction proposed
Exercises
CAP-PFM-INT-001 CAP-PFM-INT-002 CAP-PFM-INT-003
Relies on
ATS-PFM-INT-001-09 ATS-PFM-INT-002-04 ATS-PFM-INT-003-01
Preconditions
Two workspaces can see a public offer and one already adopts it.
Steps
Restrict the offer away from that workspace, read its saved installation and attempt adoption from an ungranted workspace.
Expected
The saved installation remains readable while new adoption is refused.
Data
Run-owned declarations, records and role fixtures in an isolated workspace.
Source
services-platform:modules/integrations/tests/integration/services/catalog/catalog.integration.spec.js#replaces the whole list of grants,services-platform:modules/integrations/tests/integration/services/installations/narrowed-availability.integration.spec.js#stays readable to the tenant that holds it: the installation, the connection and their lists answer, and the catalog entry stays hidden,services-platform:modules/integrations/tests/integration/services/installations/installation-lifecycle.integration.spec.js#refuses an integration installed already, and writes no second
03 Release governance and retained adoption lifecycle proposed
Exercises
CAP-PFM-INT-001 CAP-PFM-INT-002 CAP-PFM-INT-003
Relies on
ATS-PFM-INT-001-06 ATS-PFM-INT-003-07
Preconditions
The installation has no connected accounts and its release is published.
Steps
Uninstall, deprecate and retire the unused release, then read adoption history and the catalogue.
Expected
The installation history remains and the retired release is not offered for a new installation.
Data
Run-owned declarations, records and role fixtures in an isolated workspace.
Source
services-platform:modules/integrations/services/persistence/integration-versions.ts:VERSION_TRANSITIONS,services-platform:modules/integrations/tests/integration/services/connections/disconnect-discard-uninstall.integration.spec.js#is refused while a connection is not disconnected, naming each by id, name and status
04 Readers and staff have distinct acceptance boundaries permissionnegative proposed
Exercises
CAP-PFM-INT-001 CAP-PFM-INT-002 CAP-PFM-INT-003
Relies on
ATS-PFM-INT-001-10 ATS-PFM-INT-002-05 ATS-PFM-INT-003-11
Preconditions
A reader, manager, Rhythm operator and unrelated workspace administrator are available.
Steps
Inspect customer and staff catalogues and attempt installation changes with each appropriate and inappropriate identity.
Expected
Readers can inspect, managers can adopt, staff access remains separate and foreign workspace writes are refused.
Data
Run-owned declarations, records and role fixtures in an isolated workspace.
Source
services-platform:modules/integrations/tests/e2e/integrations.e2e.spec.js#is refused Rhythm HQ’s catalog (403),react-console:lib/integrations/access.test.ts#shows a reader every screen, with no change control and no secret,services-platform:modules/integrations/tests/e2e/reader-access.e2e.spec.js#is refused every tenant route of this tenant, by id as by list (403)
05 Install from reviewed provider detail regressionnegative proposed
Exercises
CAP-PFM-INT-002 CAP-PFM-INT-003
Relies on
ATS-PFM-INT-002-03 ATS-PFM-INT-003-02
Preconditions
An eligible Dummy offer is not installed in the run-owned workspace.
Steps
Open provider detail, clear two capability choices, enter valid settings and install through the console.
Expected
The saved adoption has exactly the chosen access and settings and allows account setup.
Data
Run-owned declarations, records and role fixtures in an isolated workspace.
Source
services-platform:modules/integrations/tests/integration/services/catalog/catalog.integration.spec.js#answers the contracts the version implements, with their schemas and feature meanings,services-platform:modules/integrations/tests/integration/services/installations/installation-lifecycle.integration.spec.js#refuses an acceptance wider than the manifest declares, naming it, and writes nothing

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.