# openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center

index: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md

## role
Defines and documents a full-stack persistent notification center system replacing ephemeral toasts, with backend storage, REST API, React frontend, and user preference management.
## files
- .openspec.yaml | Defines an OpenAPI specification metadata file for a notification center service
- apply-pr1.md | Documents the implementation, testing, and validation of PR-1 backend core for a Notification Center system including database migrations, service layer, API endpoints, and comprehensive tests. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, SQLite, PostgreSQL, pytest, ruff
- apply-pr2.md | Documents the completion of PR-2 backend integration for a Notification Center, wiring lifecycle hooks and health monitoring to a notification service, extending user config schemas, and adding integration tests with TDD evidence. | dep: notification_service, event_bus, lifecycle_hooks, health_monitor, user_config, Pydantic, pytest, unittest.mock, ruff
- apply-pr3.md | Documents the implementation of a frontend notification center feature with bell icon, dropdown panel, polling, optimistic updates, and comprehensive tests. | dep: React, @phosphor-icons/react, vitest, testing-library, TypeScript, CSS variables
- apply-pr4.md | Documents the implementation of toast notification coordination for a notification center, including preference checks, category/severity mapping, settings UI, and comprehensive tests. | dep: React, UserConfig API, PATCH /user-config, vitest, TypeScript, ESLint
- apply-progress.md | Documents the TDD-driven implementation progress of a Notification Center feature across 4 PRs, covering backend CRUD/API, event producer integration, frontend React components/hooks, and toast coordination with user preferences. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, React, Vitest, pytest, ruff, eslint, TypeScript, unittest.mock, @phosphor-icons/react
- design.md | Design specification for a cross-cutting notification center system with backend persistence service, FastAPI endpoints, and React frontend components for user notifications. | dep: FastAPI, SQLAlchemy, AsyncSession, Alembic, Pydantic, React, Phosphor Icons, SSE/Event Bus, lifecycle_hooks, health_monitor, event-toast-bridge, UserConfig
- explore.md | Design document exploring the transition from an ephemeral toast-only notification system to a full persistent notification center with backend storage, user-scoped filtering, and a frontend UI component. | dep: FastAPI, SQLAlchemy, Alembic, React, SSE, Phosphor Icons, InstanceEventBus, HealthMonitor, LifecycleHooks, EventContext, Toast System, AppShell
- proposal.md | Proposes a system design for adding a persistent, per-user notification center with REST API, UI components, and toast coordination to replace ephemeral SSE-driven toasts. | dep: SQLAlchemy, Alembic, React, PhosphorIcons, FastAPI/REST, SSE, UserConfig, InstanceEventBus, HealthMonitor, lifecycle_hooks
- spec.md | Defines a full-stack notification center system with per-user persistent notifications, REST API, frontend UI, and user-scoped preferences for muting and toast suppression. | dep: SQLAlchemy, FastAPI, Alembic, PostgreSQL, React/frontend (implied), SSE/EventToastBridge, Phosphor icons, UserConfig, lifecycle_hooks, health_monitor
- tasks.md | Defines a detailed task breakdown for implementing a Notification Center feature across 4 stacked PRs, covering backend core, backend integration, frontend core, and toast coordination with specific acceptance criteria and dependencies. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, pytest, AsyncSession, UUIDPrimaryKeyMixin, UserConfig, InstanceEventBus, lifecycle_hooks, health_monitor
## arch
Specification-driven incremental development using 4 stacked PRs (backend core → backend integration → frontend core → toast coordination) with TDD, OpenAPI contracts, FastAPI service layer, React hooks/components, and event-driven lifecycle integration with health monitoring.
## tags
notification, center, react, apply, fastapi, user, backend, alembic
## symbols
-
## workflows
-
## dirty
-
