--- id: JNY-CMT-MTG-001 title: A secretary takes a board meeting from the calendar to circulated minutes feature: FEAT-CMT-MTG-01 product_area: committees module: meetings revision: 1 status: draft product_intent: proposed implementation_evidence: inconsistent supersedes: - react-console acceptance journeys CMT-ACC-0217, 0226, 0229, 0237, 0239, 0243 source_sha: services-committees: 36129c24daeaadcdb339218c38cdeaff9861359d react-console: baf6dae382d6f41dce976c7f848667ccc37e076f actor: ACT-CMT-002 goal: Hold the board’s monthly meeting with its agenda, packet and attendance, and circulate its minutes the same week. capabilities: - CAP-CMT-MTG-002 - CAP-CMT-MTG-004 - CAP-CMT-MTG-005 - CAP-CMT-MTG-003 - CAP-CMT-MTG-006 - CAP-CMT-MTG-001 - CAP-CMT-MTG-007 - CAP-CMT-MTG-009 screens: [] steps: - n: 1 surface: createMeetingSeries action: Set up the board’s second-Tuesday series capability: CAP-CMT-MTG-002 expected: Meetings exist for every second Tuesday of the window, each called provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#answers the series 201 with three meetings materialised - n: 2 surface: addAgendaItem action: Add the five agenda items of the November meeting capability: CAP-CMT-MTG-004 expected: The agenda lists them in order, positions 1 to 5 provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#adds the five agenda items in order, positions 1 to 5 - n: 3 surface: addMeetingMaterial action: Attach the treasurer’s report capability: CAP-CMT-MTG-005 expected: The file is stored as a permanent reference of the material provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#stores the material’s file through the asset pipeline, as a permanent reference - n: 4 surface: publishMeetingAgenda action: Publish the agenda capability: CAP-CMT-MTG-004 expected: The agenda is published and participants are told provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#publishes the agenda - n: 5 surface: publishMeetingPacket action: Publish the packet capability: CAP-CMT-MTG-005 expected: The papers are released and participants are told provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#publishes the packet - n: 6 surface: getMeetingCalendar action: Download the meeting’s calendar file for the chair capability: CAP-CMT-MTG-006 expected: A standard invitation identified by the meeting provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#answers the meeting’s calendar file, an invitation with the meeting as UID - n: 7 surface: recordMeetingAttendance action: Record who came, in one write capability: CAP-CMT-MTG-003 expected: Every participant’s attendance is recorded provenance: test source: services-committees:modules/meetings/tests/integration/services/meetings.integration.spec.ts#records attendance for every participant in one write - n: 8 surface: addMeetingItemNote action: Note each item as the meeting goes capability: CAP-CMT-MTG-007 expected: A note on each item with who and when provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#records a note on each item during the meeting - n: 9 surface: closeMeeting action: Close the meeting capability: CAP-CMT-MTG-001 expected: It is held, its agenda final and its minutes drafted provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#closes the meeting with its agenda final and its minutes drafted - n: 10 surface: assembleMeetingMinutes action: Assemble the draft from the notes capability: CAP-CMT-MTG-007 expected: One section per item in agenda order provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#assembles the draft from the notes, in the agenda’s order - n: 11 surface: circulateMeetingMinutes action: Circulate the minutes capability: CAP-CMT-MTG-007 expected: The minutes are circulated and participants told provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#circulates the minutes and tells Dana - n: 12 surface: acceptMeetingActionItem action: Accept one follow-up and dismiss another capability: CAP-CMT-MTG-009 expected: The accepted item has an empty task link; the other is dismissed provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#accepts one action item into a task link with no task, and dismisses the other alternates: - from_step: 7 condition: The meeting is already closed and a late arrival must be corrected path: The secretary reopens the attendance as a manager of meetings outcome: The correction is stored and audited provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#records attendance after the close when reopened by a manager failures: - from_step: 7 condition: Attendance is recorded after the close without reopening path: The write is refused because the meeting is closed outcome: Attendance is unchanged provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#refuses attendance after the close with 409, meeting_closed - from_step: 11 condition: The secretary edits the text after circulating it path: The save is refused until the minutes are reverted to a draft outcome: The circulated text stands provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#refuses a save of circulated minutes with 409, minutes_circulated rules_in_play: - BR-CAP-CMT-MTG-002-03 - BR-CAP-CMT-MTG-004-06 - BR-CAP-CMT-MTG-005-04 - BR-CAP-CMT-MTG-001-06 - BR-CAP-CMT-MTG-003-10 - BR-CAP-CMT-MTG-007-03 - BR-CAP-CMT-MTG-007-08 - BR-CAP-CMT-MTG-006-05 assertions: - id: AS-JNY-CMT-MTG-001-01 statement: Every participant was told once each that the meeting was called and that its agenda and packet were published. provenance: test source: services-committees:modules/meetings/tests/e2e/meetings.e2e.spec.ts#called every participant, told them of the agenda and of the packet, once each - id: AS-JNY-CMT-MTG-001-02 statement: The held meeting’s agenda is final and its attendance frozen. provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#refuses attendance after the close with 409, meeting_closed - id: AS-JNY-CMT-MTG-001-03 statement: A participant reads the circulated minutes in the portal with their fingerprint; a stranger cannot. provenance: test source: services-committees:modules/meetings/tests/e2e/minutes.e2e.spec.ts#shows Dana, a participant, the circulated minutes with their body and hash e2e_policy: required e2e_reason: It crosses eight capabilities and the portal, and the service end-to-end suites already drive it against the API; a browser test waits for staff meeting screens, which do not exist. --- # A secretary takes a board meeting from the calendar to circulated minutes ## Story The board’s secretary sets up the second-Tuesday series once. For November she adds the five agenda items, attaches the treasurer’s report and publishes first the agenda and then the packet; the directors are told each time. On the night she records who came in one go and notes each item as the meeting goes. She closes the meeting, which fixes the agenda and the attendance and opens the minutes. The next morning she assembles the draft from her notes, tidies it and circulates it to the directors, who can read it in the portal. She accepts the treasurer’s follow-up and dismisses one that was already done. Product decided that no meeting e-mails are sent in this milestone, so the notices in this story are what the product does today, not what it should do.