Skip to content

Knowledge

Purpose

Internal knowledge articles (markdown), tags, publication workflow, and links to incidents/changes.

Key components

Layer	Path
Backend	`Backend/internal/domain/knowledge/`
Diagrams	`Backend/internal/domain/diagrams/`
Frontend	Knowledge module routes

Flow: publish article

sequenceDiagram
    participant User as Author
    participant SPA as Cloud SPA
    participant API as Cloud Backend
    participant DB as Azure SQL

    User->>SPA: Create/edit article
    SPA->>API: POST/PATCH knowledge article
    API->>DB: Store markdown + metadata
    User->>SPA: Publish
    SPA->>API: PATCH status=published

Debug scenarios

Issue	Check
Article not visible	Publication status; RBAC read permission
Diagram render fail	`diagrams` domain validation

Domain structure