AI Implementation feature(869): Admin Area Blog and Blog Page (#58)

2026-07-23 10:17:55 +00:00
parent d468cca766
commit 294873240b
32 changed files with 1798 additions and 117 deletions
@@ -1,9 +1,9 @@
 ---
 type: guide
 title: Admin Shell & Side Navigation
-description: How an authenticated admin navigates the post-login admin area, the side-nav layout, and how the General and Categories pages are reached.
+description: How an authenticated admin navigates the post-login admin area, including General, Challenges, Players, Categories, and Blog management pages.
 tags: [guide, admin, shell, navigation, tester]
-timestamp: 2026-07-22T12:00:00Z
+timestamp: 2026-07-23T10:12:24Z
 ---

 # When this view is available
@@ -47,9 +47,9 @@ The side-nav is defined as a static `ENTRIES` array in
 |-------------|-----------------------|---------|----------------------------------------------------------------------------------------------|
 | General     | `/admin/general`      | yes     | [Admin — General Settings](/guides/admin-general-settings.md) (default — `/admin` redirects here). |
 | Challenges  | `/admin/challenges`   | yes     | [Admin — Challenges](/guides/admin-challenges.md) — sortable list, search, Add/Edit modal, file staging, import/export. |
-| Players     | `/admin/players`      | no      | Greyed-out placeholder. No route registered.                                                |
-| Blog        | `/admin/blog`         | no      | Greyed-out placeholder. No route registered.                                                |
-| System      | `/admin/system`       | no      | Greyed-out placeholder. No route registered.                                                |
+| Players     | `/admin/players`      | yes     | User management page. |
+| Blog        | `/admin/blog`         | yes     | [Blog Publishing and Reading](/guides/blog.md) — post list with draft/publish, edit, preview, and delete workflows. |
+| System      | `/admin/system`       | no      | Greyed-out placeholder. No route registered. |

 Each `<li>` carries `data-testid="admin-nav-{id}"`. Disabled entries
 have `cursor: not-allowed` and `opacity: 0.45`. Clicking a disabled
@@ -95,17 +95,18 @@ current URL starts with the entry's path. General is the default child
 | 4    | `frontend/src/app/features/admin/admin-shell.component.ts`  | Renders the aside + body; `ENTRIES` is the static side-nav list.                                   |
 | 5    | `frontend/src/app/features/admin/general.component.ts`       | `AdminGeneralComponent` (default `/admin/general`); embeds `AdminCategoriesComponent`.             |
 | 6    | `frontend/src/app/features/admin/categories/categories.component.ts` | `AdminCategoriesComponent` (`/admin/categories`); also rendered inside the General page.    |
-| 7    | `frontend/src/app/features/home/home.shell.ts`               | `shouldShowAdminNav({isAuthenticated, role})` predicate (exported and unit-tested).                 |
-| 8    | `frontend/src/app/features/home/home.component.ts`           | Shell template renders header, conditional nav (`*ngIf="showAdminNav()"`), and `<router-outlet>`.   |
-| 9    | `frontend/src/app/core/services/admin.service.ts`           | Typed wrappers for `/api/v1/admin/users`, `/admin/general/*`, `/admin/categories/*`, `/uploads/{logo,category-icon}`. |
-| 10   | `backend/src/modules/admin/admin.module.ts`                 | Registers `AdminController`, `AdminGeneralController`, `AdminCategoriesController` + their services. Imports `AuthModule`, `UsersModule`, `SettingsModule`, `CommonModule`, and `TypeOrmModule.forFeature([UserEntity, CategoryEntity, ChallengeEntity])`. |
+| 7    | `frontend/src/app/features/admin/blog/blog.component.ts` | `AdminBlogComponent` (`/admin/blog`); coordinates post listing, editing, publication, and deletion. |
+| 8    | `frontend/src/app/features/home/home.shell.ts`               | `shouldShowAdminNav({isAuthenticated, role})` predicate (exported and unit-tested).                 |
+| 9    | `frontend/src/app/features/home/home.component.ts`           | Shell template renders header, conditional nav (`*ngIf="showAdminNav()"`), and `<router-outlet>`.   |
+| 10   | `frontend/src/app/core/services/blog.service.ts` | Typed wrappers for public blog listing and `/api/v1/admin/blog/posts` CRUD. |
+| 11   | `backend/src/modules/blog/blog.module.ts` | Registers public and admin blog controllers/services with the blog repository. |

 # Notes

 * The shell deliberately keeps `AdminShellComponent` as a thin layout
-  owner — child routes (`general`, `categories`) render into its
-  `<router-outlet>`. New admin sub-pages can be added by enabling
-  entries in `ENTRIES` and registering a child route in `app.routes.ts`.
+  owner — enabled child routes render into its `<router-outlet>`. New admin
+  sub-pages require both an enabled `ENTRIES` item and a child route in
+  `app.routes.ts`.
 * The guard decision function (`decideAdminGuard`) is a pure module so
  it is straightforward to unit-test without Angular DI. See
  `tests/frontend/admin-shell.spec.ts` and
@@ -124,5 +125,6 @@ current URL starts with the entry's path. General is the default child
 - [Change Password](/guides/change-password.md)
 - [Admin — General Settings](/guides/admin-general-settings.md)
 - [Admin — Categories](/guides/admin-categories.md)
+- [Blog Publishing and Reading](/guides/blog.md)
 - [REST API Overview](/api/rest-overview.md)
 - [Admin Endpoints](/api/admin.md)