docs: update documentation to OKF v0.1 format

docs/architecture/frontend-structure.md

@@ -1,9 +1,9 @@
 ---
 type: architecture
 title: Frontend Structure
-description: Angular routes, components, services, guards, interceptors, and authenticated SSE transport.
-tags: [architecture, frontend, angular, shell, sse, challenges, scoreboard, notifications]
-timestamp: 2026-07-23T05:10:00Z
+description: Angular routes, components, services, guards, interceptors, authenticated SSE transport, and blog management and presentation wiring.
+tags: [architecture, frontend, angular, shell, sse, challenges, scoreboard, notifications, blog]
+timestamp: 2026-07-23T10:12:24Z
 ---
 
 # Routes
@@ -17,9 +17,10 @@ Routes live in `frontend/src/app/app.routes.ts`:
 | `/` | `HomeComponent` | `authGuard` | Authenticated shell and child outlet. |
 | `/challenges` | `ChallengesPage` | inherited | Full challenges board (category columns, modal, flag submit, live SSE). |
 | `/scoreboard` | `ScoreboardPage` | inherited | Live scoreboard page with 4 tabs (Ranking / Matrix / Event Log / Score Graph), live SSE `solve` updates. |
-| `/blog` | `BlogPage` | inherited | Placeholder blog page. |
-| `/admin` | `AdminUsersComponent` | `adminGuard` | Admin-only child route. |
+| `/blog` | `BlogPage` | inherited | Loads and renders published posts with loading, error, and empty states. |
+| `/admin` | `AdminShellComponent` | `adminGuard` | Admin-only layout; redirects to `/admin/general`. |
 | `/admin/challenges` | `AdminChallengesComponent` | inherited | Sortable/searchable admin Challenges list, Add/Edit modal, import/export. |
+| `/admin/blog` | `AdminBlogComponent` | inherited | Admin post table and create/edit/draft/publish/delete workflow. |
 
 # Components and services
 
@@ -45,6 +46,11 @@ Routes live in `frontend/src/app/app.routes.ts`:
 | `RankingComponent` / `MatrixComponent` / `EventLogComponent` / `ScoreGraphComponent` | `frontend/src/app/features/scoreboard/` | Presentational components for the 4 tabs; each binds a single `@Input()` from `ScoreboardStore` and uses `PLAYER_COLOR_PALETTE` + `stablePlayerColorIndex` to color each player consistently. |
 | `NotificationService` | `frontend/src/app/core/services/notification.service.ts` | Root-provided signal-backed store of `{ id, kind, message, ts }` records; `error()` / `info()` push, `dismiss(id)` / `clear()` remove. |
 | `errorNotificationInterceptor` | `frontend/src/app/core/interceptors/error-notification.interceptor.ts` | Functional HTTP interceptor that pushes a friendly message into `NotificationService` for every `HttpErrorResponse`; suppresses duplicate toasts for endpoints with their own error UI (login form, `/challenges/status` snapshot). |
+| `BlogApiService` | `frontend/src/app/core/services/blog.service.ts` | Promise-based HTTP client for the published list and admin CRUD routes. |
+| `BlogPage` | `frontend/src/app/features/blog/blog.page.ts` | Smart `/blog` page that loads published posts and derives loading, error, empty, and list states. |
+| `BlogPresenterComponent` | `frontend/src/app/features/blog/blog-presenter.component.ts` | Shared title/date/sanitized-Markdown renderer used by `/blog` and `/login`. |
+| `AdminBlogComponent` | `frontend/src/app/features/admin/blog/blog.component.ts` | Smart `/admin/blog` page coordinating list refresh and create/edit/delete modal state. |
+| `BlogFormModalComponent` / `BlogDeleteModalComponent` | `frontend/src/app/features/admin/blog/` | Admin Markdown editor with live preview and destructive-action confirmation. |
 
 # Authenticated SSE wiring
 
@@ -81,6 +87,9 @@ on destruction.
 | `frontend/src/app/core/services/event-status.pure.ts` | Defines the event payload and transport interface. |
 | `frontend/src/app/features/challenges/challenges.page.ts` | `/challenges` smart page; owns gate logic, modal lifecycle, SSE wiring, and the countdown-zero reload. |
 | `frontend/src/app/features/challenges/challenges.store.ts` | Signal store backing `/challenges`: board, event state, per-card solve listeners, SSE solve-frame mutation, submit response application, public `reset()`, and per-user `setMyUserId` flush. |
+| `frontend/src/app/core/services/blog.service.ts` | Calls public and admin blog endpoints with typed payloads. |
+| `frontend/src/app/features/blog/blog-presenter.component.ts` | Shared sanitized Markdown post rendering for authenticated and landing views. |
+| `frontend/src/app/features/admin/blog/blog.component.ts` | Coordinates administrator blog CRUD UI and table refreshes. |
 | `tests/frontend/authenticated-event-source.spec.ts` | Regression coverage for authenticated SSE transport behavior. |
 
 # Event-status pure helpers
@@ -129,4 +138,5 @@ for the full contract and tester matrix.
 - [Challenges Board](/guides/challenges-board.md)
 - [Scoreboard Page](/guides/scoreboard-page.md)
 - [Notifications](/guides/notifications.md)
+- [Blog Publishing and Reading](/guides/blog.md)
 - [System Overview](/architecture/overview.md)