Manage a personal notification inbox

Purpose

Staff can review, open and organize their own notices without accessing another person's inbox.

How It Works

A signed-in console user opens the personal Notifications page. Permission checking establishes access and the server derives the recipient identity. The page fetches notices and unread totals for that person. Filters and paging organize active and archived items. Opening or changing an item updates only its personal read and archive state. Bulk reading reports how many eligible items changed. A personal test exercises the publication pipeline without selecting another recipient. The combined header bell remains intended behavior with a recorded implementation gap.

The rule rows define this outcome; the acceptance set identifies existing proof and proposed checks. Implementation evidence alone does not approve the observed details.

Relationships

Recipient rendering supplies the content and destinations displayed to staff.

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: Staff browse, read and archive their own notices.The inbox presents the implemented summary and navigation behavior.
Surfaces: consoleapi
Intent sources: services-platform:docs/milestones/PLAT-M23-notifications-core-and-in-app.md#D2services-platform:docs/proposals/notifications/23-decisions.md#D-06services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#3. How it works for the userservices-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S01services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S02services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S03services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S13

Controls

29 controls apply, from the corpus control catalogue.

TC-AVL-005 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-CRY-001 TC-CRY-002 TC-CRY-003 TC-CRY-004 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

Key	Checked at	Scope
`platform.notifications.use`	api	record
`platform.notifications.use`	console	tenant

Business Rules

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

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	Built-in console roles include personal notification permission; every personal notification route rejects callers lacking it. origin: services-platform:docs/milestones/PLAT-M23-notifications-core-and-in-app.md#D2 no proof recorded yet	permission	api, console	test services-platform:modules/notifications/tests/unit/permissions.spec.js#puts use at tier read, so every built-in console role carries it, and open to customers
`02`must prove Proposed	Personal routes derive identity from the signed-in user rather than accepting a user selector; Another person's item is not found and cannot change; portal accounts are excluded. origin: services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S04 no proof recorded yet	permission	api, service	test services-platform:modules/notifications/tests/e2e/notifications.e2e.spec.js#finds nothing of another person’s notification, whoever asks
`03`must prove Proposed	The inbox returns newest-first notices, normally omitting archived items; Unread, category and since filters apply; pages default to fifty and cap at one hundred; invalid filters, cursors and sizes identify the offending parameter. no proof recorded yet	validation	api, service	test services-platform:modules/notifications/tests/e2e/notifications.e2e.spec.js#refuses a bad filter, cursor or page size with a 400 naming the parameter
`04`must prove Proposed	Unread totals and category totals include only unread, unarchived, applicable notices; the unread list follows the same exclusions. origin: services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S03 no proof recorded yet	calculation	service	test services-platform:modules/notifications/tests/integration/services/centre/notification-centre.integration.spec.js#leaves out a notification that no longer applies
`05`must prove Proposed	Opening marks an item read; repeated reading preserves the original read time; unread, archive and restore operations affect only the caller's item and return its updated state. no proof recorded yet	lifecycle	service, console	test services-platform:modules/notifications/tests/e2e/notifications.e2e.spec.js#marks one read and unread, archives and unarchives it, answering it each time
`06`must prove Proposed	Mark-all-read updates the caller's unread, unarchived items, optionally restricted by category or creation cutoff; it returns the changed count and is idempotent. no proof recorded yet	lifecycle	service	test services-platform:modules/notifications/tests/integration/services/persistence/instances.integration.spec.js#marks every unread instance read, but neither an archived instance nor another person’s
`07`must prove Proposed	A personal test request targets only the caller through the complete pipeline, supplying default wording when the message is omitted. origin: services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#PLAT-M23-S13 no proof recorded yet	policy	api, service, console	test services-platform:modules/notifications/tests/e2e/notifications.e2e.spec.js#puts a test notification in the caller’s own list, through the whole pipeline, and nobody else’s
`08` Proposed	The inbox groups rows under Today, Yesterday and dated headings, provides Unread, All and Archived views, highlights unread titles and labels superseded notices in muted styling.	policy	console	test react-console:lib/notifications/__tests__/model.test.ts#groups under Today, Yesterday, then dates, keeping the order given
`09`must prove Confirmed	The intended bell combines unread required-attention items and notifications in one count and presents notifications alongside Needs Your Attention. origin: services-platform:docs/proposals/notifications/23-decisions.md#D-06 no proof recorded yet	calculation	console	documented services-platform:docs/milestones/plans/PLAT-M23-plan.humanized.md#3. How it works for the user
`10` Proposed	Navigation exposes the Notifications page only when the user has personal notification permission.	permission	console	observed react-console:app/(console)/console/[tenantId]/notifications/page.tsx:permissions.platform.notifications.use

Scenarios

Id	Given	When	Then	Provenance
`01`	A nonadministrative clerk account for Jane receives a Batch posting assignment.	Jane opens Notifications and follows the assignment item.	The item becomes read, its unread total decreases by one and My Responsibilities opens.	test react-console:acceptance/notifications/playwright/journeys/inbox/NT-ACC-0001.spec.ts#NT-ACC-0001
`02`	Jane has moved an item out of her normal inbox.	She selects Archived.	The item is listed there and restoration returns it to the normal inbox.	test react-console:acceptance/notifications/playwright/journeys/inbox/NT-ACC-0003.spec.ts#NT-ACC-0003

Planning

Manage a personal notification inbox ​

Purpose ​

How It Works ​

Relationships ​