Skip to content

JNY-CMT-MTG-005Staff fill a coming vacancy from the forecast to an elected nominee

Markdown

JNY-CMT-MTG-005

Staff fill a coming vacancy from the forecast to an elected nominee

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

KindJourneyProduct areaCommitteesModuleMeetings, Decisions and RecruitmentRevision1End-to-endRequired

Read atservices-committees 36129c24react-console baf6dae3

The Formal Contract

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

Goal
Find the board seat falling vacant, advertise it, take nominations and have the board elect a nominee who takes the seat.

Steps

#SurfaceActionCapabilityExpectedProvenance
1getVacancyForecastRead the forecast for the coming yearCAP-CMT-MTG-017The director whose term ends in 60 days is listedtest
services-committees:modules/recruitment/tests/e2e/openings.e2e.spec.ts#forecasts Lee’s director appointment ending in 60 days
2createOpeningsFromForecastDraft an opening for that seat from the forecastCAP-CMT-MTG-017A draft opening for the seattest
services-committees:modules/recruitment/tests/e2e/openings.e2e.spec.ts#makes a draft opening for Lee’s seat from the forecast (201)
3publishCommitteeOpeningPublish the openingCAP-CMT-MTG-016It is open and advertised as the directory listing allowstest
4expressOpeningInterestA member says they are interestedCAP-CMT-MTG-016The interest is recorded with its notetest
5createCommitteeNominationRecord the nomination of a candidateCAP-CMT-MTG-018The nomination is submittedtest
6slateCommitteeNominationSlate the nominee into the board’s appointment decisionCAP-CMT-MTG-018A decision of kind appointment proposes the nomineetest
services-committees:modules/recruitment/tests/integration/services/nominations.integration.spec.ts#opens a decision of kind appointment proposing the nominee in the nomination’s position
7closeDecisionThe board carries the slate at its meetingCAP-CMT-MTG-012The nominee is appointed, naming the decisiontest
8getCommitteeNominationSee the nomination electedCAP-CMT-MTG-018It reads elected with its appointmenttest
9getCommitteeOpeningSee the opening filled when the appointment startsCAP-CMT-MTG-016The opening reads filled and leaves the websitetest

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate6The nominee is declined after slatingThe decision proposing only that nominee is withdrawnThe nominee is never appointedtest
failure2The seat already has an openingThe holder is skipped and namedNo second opening is madetest
services-committees:modules/recruitment/tests/integration/services/openings.integration.spec.ts#skips a holder whose seat already has an opening, making none twice
failure6The nominee is only a name and an e-mail addressSlating into a decision is refusedStaff link the nominee to a contact firsttest

Assertions

IdStatementProvenance
01The elected nomination links the appointment the board’s decision made.test
02The opening fills once, however often the appointment’s start is reported.test
services-committees:modules/recruitment/tests/integration/services/openings.integration.spec.ts#changes neither opening when the same start is delivered again (premise: the replay was delivered)
03A filled opening no longer shows on the website or in the portal.test

End-to-end policy: required: Recruitment crosses openings, nominations, decisions and the appointments roster of another module; the acceptance journeys already drive it end to end against the API.

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.