Rhythm 2.0 Specifications

Appearance

JNY-PFM-OPS-005Commercial contract changes update stored application coverage

Markdown

JNY-PFM-OPS-005

Commercial contract changes update stored application coverage

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationPartially observed

Planning

Feature
FEAT-PFM-OPS-03
Actor
ACT-PFM-043
Capabilities
CAP-PFM-OPS-012, CAP-PFM-OPS-014
Rules in play
BR-CAP-PFM-OPS-012-05, BR-CAP-PFM-OPS-012-06, BR-CAP-PFM-OPS-012-08, BR-CAP-PFM-OPS-012-12, BR-CAP-PFM-OPS-014-03

KindJourneyProduct areaPlatformModuleOperational RecordsRevision1End-to-endNone

Read atservices-platform ad3f6a65

Commercial contract changes update stored application coverage ​

Story ​

A verified commercial delivery requests a read of the known company’s terms. Complete synchronization replaces stored coverage and requests authorization invalidation when the result differs. Renewals, grace and known expiry remain time-based decisions even during an outage. The pinned operating record still requires real-provider activation, and new commercial coverage does not currently initialize missing application readiness.

The Formal Contract

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

Goal
Keep commercial coverage aligned with recognized contract terms and renewals.

Steps

#SurfaceActionCapabilityExpectedProvenance
1receiveHubspotWebhookReceive a HubSpot contract-change delivery.CAP-PFM-OPS-012Verified delivery resolves the known company and requests its synchronization.test
services-platform:modules/licensing/tests/e2e/hubspot-licensing.e2e.spec.js#accepts a correctly signed delivery and enqueues the company its contract belongs to
2jobProcess that company’s queued contract read.CAP-PFM-OPS-012A complete read stores the commercial copy, derived windows and success health together.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#writes the snapshot, the windows and the health row in one go
3jobRequest invalidation for changed coverage.CAP-PFM-OPS-012The stored commercial change requests a flush but still needs operational readiness for usable access.observed
services-platform:modules/licensing/services/sync/sync-company-licences.ts:syncCompanyLicences
4jobReconcile linked commercial companies overnight.CAP-PFM-OPS-012Resolved adjacent renewal terms extend continuous coverage.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#extends the licence to the end of the new term, as one window
5jobResolve availability after an unrenewed term.CAP-PFM-OPS-014Finite coverage passes through its grace before becoming expired.test
services-platform:modules/licensing/tests/unit/availability/application-availability.spec.ts#answers expired the day after the grace ends, which is when a licence really runs out

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate2A term is unreadable or a line has no recognized product mapping.Retain a resolution flag and omit the unsupported coverage.Other recognized commercial lines can still grant coverage.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#flags a SKU the product map does not know, and licenses everything the others do
failure1The delivered signature does not match the request.Reject verification without queue publication.A later nightly pass remains an independent opportunity to read linked companies.test
services-platform:modules/licensing/tests/e2e/hubspot-licensing.e2e.spec.js#refuses a delivery whose signature was made for another body
failure2The provider cannot finish reading the company.Record the failed read without replacing commercial data.Stored windows remain and their known expiry dates still apply.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#licenses the company again, unchanged, when the next read works
failure2Provider token configuration is absent.Record an unconfigured read outcome.Existing coverage remains and no provider-failure alarm is raised.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#records that there was nothing to read, and does not fail

Assertions

IdStatementProvenance
01Provider-read failure leaves stored windows intact while their existing term and grace still govern.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#changes no snapshot, no window and no last success
02Cancellation requests invalidation when it changes windows, using the same changed-window path as additional coverage.test
services-platform:modules/licensing/tests/integration/services/sync/sync-company-licences.integration.spec.js#asks for a flush when a licence is taken away, as fast as when one is given

End-to-end policy: none: This commercial integration has no browser flow, and existing provider evidence is stubbed; real source activation requires separate verification.

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