headquarter/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md

archive/2026-06-12-completed-changes-archive/container-monitoring-notifications

dir: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications

index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md

role

Archive of completed design, specification, and implementation documentation for a real-time container monitoring and notification system that replaced polling with Server-Sent Events.

files

• .openspec.yaml | Defines an OpenSpec project specification for a container monitoring and notification system
• apply-pr1.md | Documents the implementation of a backend core for container monitoring and notifications, including database migrations, SQLAlchemy models, event bus, health monitoring, SSE endpoint, lifecycle hooks, structured logging, and unit tests. | dep: SQLAlchemy, Alembic, FastAPI, asyncio, uvicorn, pytest, ruff, Docker, JSON
• apply-pr2.md | Documents the implementation of a frontend UI for container monitoring and notifications using Server-Sent Events, custom toast system, and real-time status updates. | dep: React, EventSource, TypeScript, Vitest, CSS, AbortController, fetch API
• apply-pr3.md | Documents the completion status and implementation details of PR-3 for container monitoring and notifications integration, including tests, API endpoints, documentation updates, and quality gate results.
• apply-progress.md | Documents the implementation progress of two pull requests for a container monitoring and notifications system, covering backend core services (EventBus, HealthMonitor, SSE endpoints) and frontend UI components (SSE hooks, custom toast system, real-time status updates). | dep: pytest, vitest, SQLAlchemy, Alembic, FastAPI/SSE, React, TypeScript, EventSource, ruff, eslint, asyncio, inspect, collections.abc
• design.md | Design document for a container monitoring and notification system using in-memory pub/sub, background health polling, SSE streaming, and frontend toast notifications | dep: FastAPI, SQLAlchemy, Alembic, asyncio, Docker, SSE/EventSource, sonner, TypeScript, Python
• explore.md | Exploratory analysis document identifying gaps and recommending architecture for container monitoring, health checks, logging, and notifications in a Docker-based tool instance management system. | dep: FastAPI, Docker CLI, SQLAlchemy, cloudflared, asyncio, SSE, React/frontend stack
• proposal.md | Proposes a container monitoring and real-time notification system using SSE to push lifecycle events and health status from a FastAPI backend to a frontend toast component, replacing 30-second polling with instant visibility into container failures, tunnel health, and audit trails. | dep: FastAPI, SSE/StreamingResponse, asyncio, Docker CLI, PostgreSQL, JSONB, UUID, WebSocket (existing terminal), sonner/toast library
• spec.md | Specifies a container monitoring and notification system using an in-memory event bus, background health monitor, SSE streaming, and frontend toast notifications with persistent audit logging. | dep: asyncio, PostgreSQL, Docker CLI, HTTP/tunnel, SSE/Server-Sent Events, JWT/cookie auth, JSON logging
• tasks.md | Defines a detailed software development plan for building a container monitoring and notification system across backend and frontend, broken into chained PRs with specific tasks, acceptance criteria, and dependencies. | dep: FastAPI, SQLAlchemy, Alembic, Docker, asyncio, SSE/EventSource, React, sonner, pytest

arch

Event-driven architecture using in-memory pub/sub EventBus, background health polling with SQLAlchemy persistence, SSE streaming from FastAPI backend, and frontend toast notifications; implemented via 3 chained PRs with structured logging, audit trails, and comprehensive test coverage.

tags

sse, container, monitoring, system, apply, notifications, fastapi, asyncio

symbols

workflows

dirty