feat(guide): markdown-driven backend API, retire DB/CRUD (Phase 1) #2

2026-06-30T23:52:48-04:00

hiveiq commented

2026-06-30 23:52:48 -04:00

Phase 1 of the guide rebuild (DESIGN.md).

What changed

MarkdownGuideService scans content/**/*.md (frontmatter: module/title/tab/order/audience), no DB.
GET /api/v1/guide/nav + GET /api/v1/guide/modules/{module}; internal-audience tabs gated to MSP_ADMIN/BCOS_ADMIN.
Removed JPA/Flyway/Postgres, the Guide entity/repo/service, admin CRUD, and seed migrations.
Seed content: devices.sw-deploy (Overview / The Data / Technical-internal), fleet.tasks.

Verified locally: boots with no DB, loads 4 docs; nav returns the tree; customer sees 2 tabs, MSP_ADMIN sees 3 (Technical internal); no-token → 401.

Refs #1

Phase 1 of the guide rebuild (DESIGN.md). **What changed** - `MarkdownGuideService` scans `content/**/*.md` (frontmatter: module/title/tab/order/audience), no DB. - `GET /api/v1/guide/nav` + `GET /api/v1/guide/modules/{module}`; internal-audience tabs gated to MSP_ADMIN/BCOS_ADMIN. - Removed JPA/Flyway/Postgres, the Guide entity/repo/service, admin CRUD, and seed migrations. - Seed content: `devices.sw-deploy` (Overview / The Data / Technical-internal), `fleet.tasks`. **Verified locally:** boots with no DB, loads 4 docs; nav returns the tree; customer sees 2 tabs, MSP_ADMIN sees 3 (Technical internal); no-token → 401. Refs #1

hiveiq added 2 commits 2026-06-30 23:52:48 -04:00

docs: hiveops-guide redesign plan (markdown + API + tabbed slide-out) 9c91c56672

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

feat(guide): markdown-driven backend API, retire DB/CRUD (Refs #1 ) 4b7f50ec6a

Phase 1 of the guide rebuild (DESIGN.md):
- MarkdownGuideService scans content/**/*.md (frontmatter: module/title/tab/order/audience)
- GET /api/v1/guide/nav + /api/v1/guide/modules/{module}; audience gated by role
  (internal tabs only for MSP_ADMIN/BCOS_ADMIN)
- Removed JPA/Flyway/Postgres, Guide entity/repo/service, admin CRUD, seed migrations
- Seed content: devices.sw-deploy (Overview/Data/Technical-internal), fleet.tasks
- Verified: boots with no DB, loads 4 docs, nav + audience filtering + 401 all correct

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

hiveiq merged commit e17e3feca6 into develop

2026-06-30 23:54:10 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hiveiq-src/hiveops-guide#2