Skip to content

JNY-MBR-STR-002Reorganize a branch and retain its earlier reporting context

Markdown

JNY-MBR-STR-002

Reorganize a branch and retain its earlier reporting context

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

KindJourneyProduct areaMembershipModuleOrganizational Structure, Membership Configuration and TermsRevision1End-to-endOptional

Read atservices-membership 5994c270react-console baf6dae3

The Formal Contract

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

Goal
Relocate Atlanta while keeping prior regional reporting and membership affiliations interpretable.

Steps

#SurfaceActionCapabilityExpectedProvenance
1listOrganizationalUnitDescendantsInspect Atlanta’s placement in the Eastern Region before restructuring.CAP-MBR-STR-005The earlier structural context includes Atlanta in Eastern.inferred
services-membership:tests/e2e/s09-restructuring.e2e.spec.ts#scenario 9: organizational restructuring › files Atlanta under the Eastern Region in September’s snapshot, taken before the move
2moveOrganizationalUnitRelocate Atlanta beneath Pacific and record the explanation.CAP-MBR-STR-002The unit’s current branch changes and the placement periods describe the transition.test
services-membership:tests/e2e/s09-restructuring.e2e.spec.ts#scenario 9: organizational restructuring › moves Atlanta under the Pacific Zone
3listOrganizationalUnitDescendantsInspect the new current regional context.CAP-MBR-STR-005Atlanta appears in Western’s current structure and related membership views follow that placement.inferred
services-membership:tests/e2e/s09-restructuring.e2e.spec.ts#scenario 9: organizational restructuring › shows Jo under the Western Region and the Pacific Zone today, and no longer under the Eastern Region
4listOrganizationalUnitDescendantsRequest Eastern’s structure for the earlier period-end date.CAP-MBR-STR-005That dated branch still includes Atlanta.test
services-membership:tests/e2e/s09-restructuring.e2e.spec.ts#scenario 9: organizational restructuring › still holds Atlanta among the Eastern Region’s descendants as of the period end
5listOrganizationalUnitParentHistoryInspect Atlanta’s retained parent periods.CAP-MBR-STR-002The periods distinguish Southeast before the change from Pacific afterward.test
services-membership:tests/acceptance/structure/MBR-ACC-0012.acceptance.ts#MBR-ACC-0012 scenario 9: Atlanta moves to the Pacific Zone

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate2Staff use an earlier effective date within the current period.The corrected period begins on that earlier date.A reader using earlier knowledge can still reproduce the preceding arrangement.test
services-membership:modules/structure/tests/integration/services/persistence/organizational-units.integration.spec.ts#organizational units in the database › the parent history and the as-of tree › answers nothing for a known_at before the moves were recorded, beyond the tree as it was then known
failure2Staff choose tomorrow as the effective day.The date check rejects the relocation.The previous arrangement remains intact.test
services-membership:modules/structure/tests/integration/services/persistence/organizational-units.integration.spec.ts#organizational units in the database › the parent history and the as-of tree › refuses a move dated after today

Assertions

IdStatementProvenance
01Jo’s affiliation retains its identity, version and unit after the relocation.test
services-membership:tests/e2e/s09-restructuring.e2e.spec.ts#scenario 9: organizational restructuring › rewrites no affiliation: Jo’s row is the same row, version and unit
02The earlier period-end view still includes Atlanta beneath Eastern.test
services-membership:tests/e2e/s09-restructuring.e2e.spec.ts#scenario 9: organizational restructuring › still files Atlanta under the Eastern Region in a September restated after the move: the period end’s tree

End-to-end policy: optional: The API restructuring case supplies existing evidence. The product should add browser proof when staff can perform this workflow through a structure screen.

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.