JNY-CMT-MTG-004A member weighs a conflict and votes on an e-mail motion from the portal

JNY-CMT-MTG-004

A member weighs a conflict and votes on an e-mail motion from the portal

Markdown

DocumentDraft
Product intentProposed
ImplementationPartially observed

Planning

Feature: FEAT-CMT-MTG-04
Actor: ACT-CMT-005
Capabilities: CAP-CMT-MTG-014, CAP-CMT-MTG-015, CAP-CMT-MTG-010, CAP-CMT-MTG-020, CAP-CMT-MTG-011
Rules in play: BR-CAP-CMT-MTG-014-01, BR-CAP-CMT-MTG-014-05, BR-CAP-CMT-MTG-015-02, BR-CAP-CMT-MTG-015-04, BR-CAP-CMT-MTG-015-05, BR-CAP-CMT-MTG-020-09, BR-CAP-CMT-MTG-010-12, BR-CAP-CMT-MTG-011-08

KindJourneyProduct areaCommitteesModuleMeetings, Decisions and RecruitmentRevision1End-to-endOptional

Read atservices-committees 36129c24react-console baf6dae3

A member weighs a conflict and votes on an e-mail motion from the portal

Story

In January the association’s annual disclosures open, and a director sees in the portal that hers is due by the end of the month. She declares that she owns a share of a catering firm, and the review in Submissions accepts it. In March the board puts a catering contract with that firm to an e-mail vote. Staff reading the decision see her suggested for recusal, with the firm named; she recuses herself in the portal, and the product no longer lets her vote. Her colleagues vote in the portal, the motion closes itself on the hour after its closing time, and every member reads the result and its arithmetic. The portal is the last milestone to be built, so this story describes what the back end already supports.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

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

Goal: Vote on the board’s e-mail motion about a supplier contract, standing aside where a disclosed interest makes that right.

Steps

#	Surface	Action	Capability	Expected	Provenance
1	`runDecisionsDaily`	The year’s disclosure is opened and the member told it is due	`CAP-CMT-MTG-014`	One disclosure per voting member for the year	test services-committees:modules/decisions/tests/integration/services/disclosures.integration.spec.ts#opens one obligation per voting appointment
2	`listMyDisclosures`	The member sees the disclosure due and by when	`CAP-CMT-MTG-014`	The disclosure shows its due date	test services-committees:modules/decisions/tests/integration/services/disclosures.integration.spec.ts#shows the member their disclosure due, and by when, in the portal
3	`committees_submission_decisions`	Submissions accepts the member’s disclosure naming their firm	`CAP-CMT-MTG-014`	The disclosure is accepted with the firm among its interests	test services-committees:modules/recruitment/tests/integration/services/submission-decisions.integration.spec.ts#accepts the disclosure with the summary its decision’s basis carried
4	`listDecisionRecusals`	Staff see the member suggested for recusal on the contract vote	`CAP-CMT-MTG-015`	The suggestion names the firm	test services-committees:modules/decisions/tests/integration/services/disclosures.integration.spec.ts#suggests the voter whose accepted disclosure names the decision’s linked organization, and why
5	`recordPortalRecusal`	The member recuses from the contract vote in the portal	`CAP-CMT-MTG-015`	The recusal is recorded and the member can no longer vote on it	test react-console:acceptance/committees/playwright/journeys/decisions/CMT-ACC-0350.spec.ts#CMT-ACC-0350
6	`castPortalVote`	A colleague votes on the e-mail motion in the portal	`CAP-CMT-MTG-020`	The vote is recorded once	test services-committees:modules/decisions/tests/e2e/decisions.e2e.spec.ts#records the voter’s own vote through the portal
7	`runDecisionsHourly`	The motion closes itself after its closing time	`CAP-CMT-MTG-010`	It is closed with its result, the job as recorder	test services-committees:modules/decisions/tests/integration/services/consequences.integration.spec.ts#closes the decision past its closing time, carried 2 to 0
8	`getPortalDecision`	The members read the result and its arithmetic	`CAP-CMT-MTG-020`	The tally and explanation are shown	test services-committees:modules/decisions/tests/e2e/decisions.e2e.spec.ts#shows the tally and its explanation after the close

Alternate and Failure Paths

Path	From step	Condition	Path taken	Outcome	Provenance
alternate	4	The member’s disclosure is not yet accepted	No suggestion is made	The member may still recuse on their own	test services-committees:modules/decisions/tests/integration/services/disclosures.integration.spec.ts#suggests nobody for a disclosure naming it that is not yet accepted
failure	6	The colleague votes a second time	The second vote is refused	One vote stands	test services-committees:modules/decisions/tests/e2e/decisions.e2e.spec.ts#refuses the voter a second vote with 409, already_voted
failure	1	Submissions cannot be reached when staff start the disclosure form	The request is refused saying so	The disclosure stays owed	test services-committees:modules/decisions/tests/integration/services/disclosures.integration.spec.ts#refuses while the engine cannot be reached, saying so

Assertions

Id	Statement	Provenance
`01`	A recused member’s vote is refused.	test services-committees:modules/decisions/tests/integration/services/decisions.integration.spec.ts#refuses a recused member’s vote, 409 recused
`02`	Only staff holding the disclosures permission see the suggestion.	test services-committees:modules/decisions/tests/integration/api/recusal-confidentiality.integration.spec.ts#shows the bookkeeper an open decision’s recusals without suggestions
`03`	The hourly sweep closes the motion once and reminds nothing more on its next run.	test services-committees:modules/decisions/tests/integration/services/consequences.integration.spec.ts#closes and reminds nothing more on a second sweep

End-to-end policy: optional: The portal is not built and the Submissions intake is a stand-in, so a full browser journey cannot run; the service suites prove each hop against the API.

Planning

A member weighs a conflict and votes on an e-mail motion from the portal ​

Story ​

Steps

Alternate and Failure Paths

Assertions

A member weighs a conflict and votes on an e-mail motion from the portal

Story