chore: archive observability-service-registry, track pi-map artifacts
- Archive the completed observability-service-registry SDD change into openspec/changes/archive/ (delivered across 5 slices; only jellyfin-service-registry remains active). - Stop ignoring .pi-map.md / .pi-map.index.md so the navigation maps are versioned alongside the code, and add the regenerated map pairs repo-wide.
This commit is contained in:
Developer
@@ -0,0 +1,24 @@
|
||||
# docs (index)
|
||||
dir: docs
|
||||
|
||||
## role
|
||||
Documentation package containing architectural plans, requirements, and operational guides for the "Manage" media library application and its observability stack.
|
||||
## parent
|
||||
index: ./.pi-map.index.md
|
||||
map: ./.pi-map.md
|
||||
## children
|
||||
- docs/superpowers
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
map: docs/superpowers/.pi-map.md
|
||||
## files
|
||||
- MIGRATION_PLAN.md
|
||||
- REQUIREMENTS.md
|
||||
- monitoring-logging-design.md
|
||||
- observability-runbooks.md
|
||||
## links
|
||||
index: docs/.pi-map.index.md
|
||||
map: docs/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,22 @@
|
||||
# docs
|
||||
dir: docs
|
||||
|
||||
index: docs/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Documentation package containing architectural plans, requirements, and operational guides for the "Manage" media library application and its observability stack.
|
||||
## files
|
||||
- MIGRATION_PLAN.md | This file documents the architecture, API design, and step-by-step migration plan for transitioning an application from a Streamlit monolith to a FastAPI and React SPA. | dep: FastAPI, React, Vite, TypeScript, pydantic-settings, @tanstack/react-query, ag-grid-react, recharts, tailwindcss
|
||||
- REQUIREMENTS.md | Living requirements and decision log document for "Manage," a web application for browsing Jellyfin media libraries and inspecting corresponding media files on disk over SSH. | dep: React, TypeScript, shadcn/ui, Tailwind CSS, lucide-react, TanStack Table, Vitest, Jellyfin API, SQLite, Prometheus, Grafana, Alertmanager, OIDC
|
||||
- monitoring-logging-design.md | Design document detailing a self-hosted observability architecture (metrics, logs, dashboards, alerting) for integration with a platform called Manage. | dep: Prometheus, Grafana, Node Exporter, Grafana Loki, Grafana Alloy, Alertmanager, Authentik, Traefik
|
||||
- observability-runbooks.md | Provides operational runbooks, configuration, and maintenance procedures for deploying and managing a standalone observability stack. | dep: Prometheus, Grafana, Loki, Alloy, Alertmanager, Node Exporter, Docker Compose, Traefik
|
||||
## arch
|
||||
Static markdown documentation organized as living specs, design docs, and runbooks without code structure or dependencies.
|
||||
## tags
|
||||
react, design, observability, migration, plan, requirements, prometheus, grafana
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,23 @@
|
||||
# docs/superpowers (index)
|
||||
dir: docs/superpowers
|
||||
|
||||
## role
|
||||
Documentation directory for advanced features, capabilities, or customization guides within the project.
|
||||
## parent
|
||||
index: docs/.pi-map.index.md
|
||||
map: docs/.pi-map.md
|
||||
## children
|
||||
- docs/superpowers/plans
|
||||
index: docs/superpowers/plans/.pi-map.index.md
|
||||
map: docs/superpowers/plans/.pi-map.md
|
||||
- docs/superpowers/specs
|
||||
index: docs/superpowers/specs/.pi-map.index.md
|
||||
map: docs/superpowers/specs/.pi-map.md
|
||||
## files
|
||||
## links
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
map: docs/superpowers/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,18 @@
|
||||
# docs/superpowers
|
||||
dir: docs/superpowers
|
||||
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Documentation directory for advanced features, capabilities, or customization guides within the project.
|
||||
## files
|
||||
## arch
|
||||
Flat-file documentation structure (currently empty of content files), serving as a namespace for specialized or extended documentation topics.
|
||||
## tags
|
||||
-
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# docs/superpowers/plans (index)
|
||||
dir: docs/superpowers/plans
|
||||
|
||||
## role
|
||||
Documentation directory containing detailed implementation plans for specific project features or standalone systems.
|
||||
## parent
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
map: docs/superpowers/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- 2026-05-11-backup-monitoring.md
|
||||
## links
|
||||
index: docs/superpowers/plans/.pi-map.index.md
|
||||
map: docs/superpowers/plans/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# docs/superpowers/plans
|
||||
dir: docs/superpowers/plans
|
||||
|
||||
index: docs/superpowers/plans/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Documentation directory containing detailed implementation plans for specific project features or standalone systems.
|
||||
## files
|
||||
- 2026-05-11-backup-monitoring.md | Implementation plan for building a standalone backup monitoring system with FastAPI backend, SQLite storage, and React frontend that receives HTTP reports, tracks jobs/runs/alerts, and provides dashboards with validation and alerting. | dep: FastAPI, SQLite, Pydantic, React, TypeScript, TanStack Query, D3, MUI, Python uuid/time/json modules
|
||||
## arch
|
||||
Flat-file markdown documentation following a date-prefixed naming convention (`YYYY-MM-DD-feature.md`) to organize chronological planning artifacts.
|
||||
## tags
|
||||
backup, monitoring, fastapi, sqlite, react, 2026, 05, 11
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,20 @@
|
||||
# docs/superpowers/specs (index)
|
||||
dir: docs/superpowers/specs
|
||||
|
||||
## role
|
||||
Specification documents defining approved architectural designs for major features of the media library viewer project.
|
||||
## parent
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
map: docs/superpowers/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- 2026-05-08-obsidian-documentation-design.md
|
||||
- 2026-05-11-backup-monitoring-design.md
|
||||
## links
|
||||
index: docs/superpowers/specs/.pi-map.index.md
|
||||
map: docs/superpowers/specs/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,20 @@
|
||||
# docs/superpowers/specs
|
||||
dir: docs/superpowers/specs
|
||||
|
||||
index: docs/superpowers/specs/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Specification documents defining approved architectural designs for major features of the media library viewer project.
|
||||
## files
|
||||
- 2026-05-08-obsidian-documentation-design.md | Defines the approved documentation structure for an Obsidian-based knowledge vault for the Manage media library viewer project, targeting developers, contributors, operators, and deployers. | dep: Obsidian, FastAPI, React, TypeScript, Vite, MUI, D3, AG Grid, Docker, Traefik, Authentik, Paramiko, PyJWT, SQLite
|
||||
- 2026-05-11-backup-monitoring-design.md | Design document for a standalone backup monitoring module with HTTP API ingestion, SQLite storage, automated alerting, and React frontend for a media library viewer application. | dep: FastAPI, React, SQLite, OIDC/JWT, D3, existing MonitoringPoller
|
||||
## arch
|
||||
Dated Markdown design documents following a specification pattern, each capturing requirements, architecture decisions, and implementation plans for distinct system components.
|
||||
## tags
|
||||
design, obsidian, 2026, 05, documentation, react, sqlite, backup
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
Reference in New Issue
Block a user