Developer
070cd4d5a5
Add generated .pi-map.md and .pi-map.index.md files across the repository so the project navigation maps are shared and versioned. These artifacts are maintained by project_map_init/patch/validate and must be kept in sync with source edits. Note: .cache/ remains ignored (added in previous commit).
4.2 KiB
4.2 KiB
openspec/changes/notification-center
dir: openspec/changes/notification-center
index: openspec/changes/notification-center/.pi-map.index.md
role
Design and specification package for a full-stack Notification Center feature, containing architectural documents, implementation plans, and progress tracking across 4 stacked PRs.
files
- .openspec.yaml | Defines an OpenAPI specification metadata file for a notification center service
- apply-pr1.md | Documents the implementation, testing, and validation of a backend notification center system for a FastAPI/SQLAlchemy application. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, pytest, ruff, SQLite/PostgreSQL
- apply-pr2.md | This file is a completion report documenting the implementation of backend integration for a Notification Center (PR-2), covering wiring lifecycle hooks and health monitoring to a notification service, extending user configuration schemas, and validating through TDD with integration tests. | dep: notification_service, event_bus, lifecycle_hooks, health_monitor, user_config, Pydantic, pytest, unittest.mock, ruff, Alembic
- apply-pr3.md | Documents the implementation, testing, and validation of a frontend Notification Center feature (PR-3) including React components, hooks, state management, API client, and CSS styles. | dep: React, @phosphor-icons/react, vitest, testing-library, TypeScript, ESLint, CSS variables
- apply-pr4.md | Documents the implementation of toast notification coordination with user-configurable preferences for a notification center system. | dep: React, TypeScript, Vitest, UserConfig API, PATCH /user-config, tsc, eslint
- apply-progress.md | Documents the TDD-driven implementation progress of a full-stack Notification Center feature across 4 PRs, including backend API, frontend components, and toast coordination, with test evidence, file changes, and technical decisions. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, React, TypeScript, Vitest, pytest, ruff, ESLint, tsc, @phosphor-icons/react, unittest.mock
- design.md | Design document for a cross-cutting notification center system with backend FastAPI service, frontend React components, and event producer integration. | dep: FastAPI, SQLAlchemy/AsyncSession, Alembic, Pydantic, React/Context, SSE/event bus, Phosphor icons, lifecycle hooks, health monitor
- explore.md | Exploratory design document for adding a persistent, user-scoped Notification Center to an existing toast-only notification system, covering current state analysis, gaps, integration points, risks, and phased implementation roadmap. | dep: FastAPI, SQLAlchemy, Alembic, React, SSE/EventSource, Phosphor Icons, InstanceEventBus, HealthMonitor, LifecycleHooks, Toast System, Event Bridge
- proposal.md | This is a software design document (SDD) proposal for building a persistent, user-scoped notification center with REST API, database storage, and React frontend components, replacing ephemeral SSE-driven toasts. | dep: SQLAlchemy, Alembic, React, FastAPI/REST, PhosphorIcons, SSE (existing), UserConfig system, 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 category muting and toast suppression. | dep: FastAPI, SQLAlchemy, Alembic, PostgreSQL, React/frontend, 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, dependencies, and effort estimates. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, pytest, SQLite/PostgreSQL, AsyncSession, UUIDPrimaryKeyMixin, UserConfig, lifecycle_hooks, health_monitor, InstanceEventBus
arch
Document-driven development using phased TDD with stacked PRs (backend core → backend integration → frontend core → toast coordination), OpenAPI-first API design, FastAPI/SQLAlchemy backend with React frontend, and event-driven toast coordination with user-scoped persistent storage replacing ephemeral SSE notifications.
tags
notification, react, center, apply, fastapi, sqlalchemy, alembic, user