Advertise a committee opening and see who is interested

Purpose

Staff advertise places on a committee, the right audience sees them, interested members say so, and the opening closes when its places are filled.

How It Works

Staff create an opening on a committee: for a particular seat, for a position, or for any seat, with how many places it offers, when it opens and closes for applications, and what it says. A draft is seen only by staff. Publishing it advertises it, tells the committee’s chair and staff liaison, and shows it outside the console as the committee’s directory listing allows: to anyone on the website, to signed-in portal users, or to nobody. A portal member can say they are interested, once, with a note they can replace. Staff close an opening by hand or cancel it; it closes itself as filled when enough seat-holders start on what it offers. Dissolving a committee cancels its openings. An edit saves only what it carries, and every change is made against the version read. Today an opening ignores its own window: it stays open past its deadline and fills before it opens, which Product should decide. Recruiting through Volunteers and applying through Submissions are only referenced so far.

Relationships

Relates to CAP-CMT-MTG-017 because the forecast drafts openings.
Relates to CAP-CMT-MTG-018 because nominations may name an opening.
Relates to CAP-CMT-MTG-019 because seat applications decided in Submissions belong to an opening.

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.

Outcomes: Vacancies advertised to the right audienceInterest recorded in one placeOpenings that close themselves when filled
Surfaces: apiportaljob
Preconditions: The committee exists and is not dissolved.
Intent sources: services-committees:docs/milestones/CMTE-M5-openings-and-nominations.md#Objectiveservices-committees:docs/milestones/CMTE-M1-committees-seats-and-rosters.md#D1services-committees:docs/milestones/CMTE-M1-committees-seats-and-rosters.md#D5

Controls

31 controls apply, from the corpus control catalogue.

TC-IAM-006 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-006 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-SEC-001 TC-SEC-004 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-DAT-004 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-AVL-004 TC-AVL-005 TC-MON-001 TC-MON-002 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005 TC-PRV-001 TC-PRV-002

Permissions

Key	Checked at	Scope
`committees.openings.read`	api	tenant
`committees.openings.manage`	api	tenant
`committees.rosters.read`	api	tenant
`committees.portal.participate`	api	record

Business Rules

13 rules, 12 to be proved before approval. A rule's product intent is derived from its origin: 0 confirmed by a product decision, the rest inheriting this capability's proposed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	An opening is made for a live committee, for one of its seats, a position or any seat, offering 1 to 100 places with an optional window whose end is not before its start; a seat’s position becomes the opening’s. no proof recorded yet	validation	api, service, database	test services-committees:modules/recruitment/tests/integration/services/openings.integration.spec.ts#refuses a seat of another committee
`02`must prove Proposed	An opening goes from draft to open by publishing, from open to closed by staff, from open to filled when its places are taken, and from draft or open to cancelled; it changes only while draft or open, and closed, filled and cancelled are final. no proof recorded yet	lifecycle	service	test services-committees:modules/recruitment/tests/unit/services/opening-lifecycle.spec.ts#answers the whole grid of statuses and actions as the table says
`03`must prove Proposed	Every change of an opening is made at the version read. no proof recorded yet	policy	api, service	test services-committees:modules/recruitment/tests/integration/services/openings.integration.spec.ts#refuses a replace against a stale version
`04`must prove Proposed	Publishing an opening tells the committee’s chair and staff liaison once each and records that it was published. no proof recorded yet	policy	service	test services-committees:modules/recruitment/tests/integration/services/openings.integration.spec.ts#tells the committee’s chair (its President) and its staff liaison, once each
`05`must prove Proposed	An open opening counts each seat-holder appointment that starts on what it offers once, and becomes filled when its places are taken; a pending offer, another seat, a staff liaison or a repeated report fills nothing. no proof recorded yet	calculation	service, job	test services-committees:modules/recruitment/tests/unit/services/fill-rule.spec.ts#counts the appointment and makes a one-place opening full
`06`must prove Proposed	Outside the console an opening is shown only while it is open and before its application deadline, as the committee’s directory listing allows: to anyone when public, to portal users when authenticated, and to nobody when none. no proof recorded yet	permission	service	test services-committees:modules/recruitment/tests/e2e/openings.e2e.spec.ts#shows anyone, through the public route, the public board’s opening alone
`07`must prove Proposed	A portal member says they are interested in an opening the portal shows them once, and saying it again replaces the note. no proof recorded yet	invariant	service, database	test services-committees:modules/recruitment/tests/e2e/openings.e2e.spec.ts#keeps one interest when it is said again, with the new note
`08`must prove Proposed	Today an open opening whose deadline has passed stays open, fillable and in the forecast, and an opening fills before its window opens. no proof recorded yet	policy	service	test react-console:acceptance/committees/playwright/journeys/recruitment/CMT-ACC-0399.spec.ts#CMT-ACC-0399
`09`must prove Proposed	Dissolving a committee cancels its draft and open openings and takes them off the website and the portal. origin: CMTE-M1 D5 (Andrew 2026-10-19 17:53 ET, services-committees:docs/milestones/CMTE-M1-committees-seats-and-rosters.md#Decisions) no proof recorded yet	lifecycle	service	test services-committees:modules/recruitment/tests/integration/services/dissolved-recruitment.integration.spec.ts#cancels the published and the draft opening
`10`must prove Proposed	An edit saves what it carries and keeps what it does not: a text-only edit keeps the seat, places and window, and a field sent empty is cleared. origin: CMTE-M1 D1 (Andrew 2026-10-19 17:45 ET, services-committees:docs/milestones/CMTE-M1-committees-seats-and-rosters.md#Decisions) no proof recorded yet	policy	service	test services-committees:modules/recruitment/tests/integration/services/edits.integration.spec.ts#keeps the seat, position, places, window and link the text-only edit did not carry
`11`must prove Proposed	Openings and interests of one association are invisible to another. no proof recorded yet	permission	database	test services-committees:modules/recruitment/tests/integration/services/openings.integration.spec.ts#answers it from another tenant as one that does not exist
`12`must prove Proposed	Opening permissions are checked across the whole association; a grant limited to one organizational unit does not reach them. origin: CMTE-M1 D11 (Andrew 2026-10-19 18:05 ET, services-committees:docs/milestones/CMTE-M1-committees-seats-and-rosters.md#Decisions) no proof recorded yet	permission	api	test react-console:acceptance/committees/playwright/journeys/recruitment/CMT-ACC-0404.spec.ts#CMT-ACC-0404
`13` Proposed	The links to a Volunteers opportunity and a Submissions process are only stored; nothing calls either service yet.	policy	service	observed services-committees:modules/recruitment/db/openings.table.ts

Scenarios

Id	Given	When	Then	Provenance
`01`	A two-place board opening published on the website	A member says they are interested and two directors are appointed	The opening reads filled and leaves the website	test react-console:acceptance/committees/playwright/journeys/recruitment/CMT-ACC-0391.spec.ts#CMT-ACC-0391

Planning

Advertise a committee opening and see who is interested ​

Purpose ​

How It Works ​

Relationships ​