# saraeyad/msdaq- architecture

> Architecture diagram of the GitHub repository saraeyad/msdaq-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saraeyad/msdaq-
- Repository: https://github.com/saraeyad/msdaq-

## Overview

صبارة بوست is an Arabic-first newsroom product: staff authenticate, manage and prepare articles through a gated seven-step publishing flow, while readers browse a public read-only site. Separate newsroom capabilities include editorial tools, a shared file library, a calendar, and trust feedback; administrators manage analytics, users, roles, and categories. The React client routes these workspaces to feature pages and API services backed by a Laravel API. The graph follows documented capabilities and sampled route wiring; unsampled page-to-service calls are not inferred.

Main entry points: [`src/router/AppRoutes.tsx`](https://github.com/saraeyad/msdaq-/blob/main/src/router/AppRoutes.tsx) (Route composition), [`src/layouts/PublicLayout.tsx`](https://github.com/saraeyad/msdaq-/blob/main/src/layouts/PublicLayout.tsx) (Public layout), [`src/features/publishing-flow/PublishingFlow.tsx`](https://github.com/saraeyad/msdaq-/blob/main/src/features/publishing-flow/PublishingFlow.tsx) (Seven-step publishing), [`src/features/tools/StandaloneToolPage.tsx`](https://github.com/saraeyad/msdaq-/blob/main/src/features/tools/StandaloneToolPage.tsx) (Standalone tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_public_pages["Public pages"]
  node_public_layout["Public layout<br/>[PublicLayout.tsx]"]
end

subgraph group_newsroom["Newsroom workflow"]
  node_newsroom_articles["Article workspace"]
  node_publishing["Seven-step publishing<br/>[PublishingFlow.tsx]"]
  node_publishing_rules["Publish gates<br/>[publish-gate.ts]"]
  node_calendar["Editorial calendar<br/>[CalendarPage.tsx]"]
  node_library["File library<br/>[LibraryPage.tsx]"]
end

subgraph group_editorial["Editorial tools"]
  node_tools["Standalone tools"]
  node_smart_editor["Editorial review"]
  node_trust["Trust index"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Dashboard and analytics"]
  node_admin_team["Team and roles"]
  node_admin_categories["Category management"]
end

subgraph group_platform["Application platform"]
  node_locale["Locale context<br/>[locale.tsx]"]
  node_auth["Authentication<br/>[provider.tsx]"]
  node_routes["Route composition<br/>[AppRoutes.tsx]"]
  node_api_services["Backend API clients"]
end

node_reader(("Reader"))
node_staff(("Newsroom staff"))
node_administrator(("Administrator"))
node_backend[("Laravel backend")]

node_reader -->|"opens pages"| node_routes
node_routes -->|"routes public"| node_public_layout
node_public_layout -->|"hosts pages"| node_public_pages
node_staff -->|"opens workspace"| node_routes
node_administrator -->|"opens admin"| node_routes
node_routes -->|"routes articles"| node_newsroom_articles
node_routes -->|"routes publishing"| node_publishing
node_publishing -->|"checks gates"| node_publishing_rules
node_publishing -.->|"submits content"| node_api_services
node_routes -->|"routes calendar"| node_calendar
node_routes -->|"routes library"| node_library
node_routes -->|"routes tools"| node_tools
node_tools -.->|"renders review"| node_smart_editor
node_routes -->|"routes trust index"| node_trust
node_routes -->|"routes dashboard"| node_admin_dashboard
node_routes -->|"routes team"| node_admin_team
node_routes -->|"routes categories"| node_admin_categories
node_staff -->|"authenticates"| node_auth
node_routes -->|"guards workspace"| node_auth
node_public_layout -->|"reads locale"| node_locale
node_api_services -->|"sends API requests"| node_backend

click node_public_pages "https://github.com/saraeyad/msdaq-/tree/main/src/features/public-site"
click node_public_layout "https://github.com/saraeyad/msdaq-/blob/main/src/layouts/PublicLayout.tsx"
click node_locale "https://github.com/saraeyad/msdaq-/blob/main/src/context/locale.tsx"
click node_auth "https://github.com/saraeyad/msdaq-/blob/main/src/context/auth/provider.tsx"
click node_routes "https://github.com/saraeyad/msdaq-/blob/main/src/router/AppRoutes.tsx"
click node_newsroom_articles "https://github.com/saraeyad/msdaq-/blob/main/src/features/newsroom/articles/NewsroomArticlesPage.tsx"
click node_publishing "https://github.com/saraeyad/msdaq-/blob/main/src/features/publishing-flow/PublishingFlow.tsx"
click node_publishing_rules "https://github.com/saraeyad/msdaq-/blob/main/src/lib/publishing/publish-gate.ts"
click node_calendar "https://github.com/saraeyad/msdaq-/blob/main/src/features/calendar/CalendarPage.tsx"
click node_library "https://github.com/saraeyad/msdaq-/blob/main/src/features/newsroom/library/LibraryPage.tsx"
click node_tools "https://github.com/saraeyad/msdaq-/blob/main/src/features/tools/StandaloneToolPage.tsx"
click node_smart_editor "https://github.com/saraeyad/msdaq-/blob/main/src/features/tools/smart-editor/EditorialReviewPanel.tsx"
click node_trust "https://github.com/saraeyad/msdaq-/blob/main/src/features/trust-index/pages/TrustIndexPlatformPage.tsx"
click node_admin_dashboard "https://github.com/saraeyad/msdaq-/blob/main/src/features/admin/dashboard/AdminDashboardPage.tsx"
click node_admin_team "https://github.com/saraeyad/msdaq-/blob/main/src/features/admin/team/TeamManagementPage.tsx"
click node_admin_categories "https://github.com/saraeyad/msdaq-/blob/main/src/features/admin/categories/CategoriesManagementPage.tsx"
click node_api_services "https://github.com/saraeyad/msdaq-/tree/main/src/services/api"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_pages,node_public_layout toneBlue
class node_newsroom_articles,node_publishing,node_publishing_rules,node_calendar,node_library,node_backend toneAmber
class node_tools,node_smart_editor,node_trust toneMint
class node_admin_dashboard,node_admin_team,node_admin_categories toneRose
class node_locale,node_auth,node_routes,node_api_services,node_reader,node_staff,node_administrator toneIndigo
```

## Components

### Public site

- [Public pages](https://github.com/saraeyad/msdaq-/tree/main/src/features/public-site): `src/features/public-site`
- [Public layout](https://github.com/saraeyad/msdaq-/blob/main/src/layouts/PublicLayout.tsx): `src/layouts/PublicLayout.tsx`

### Newsroom workflow

- [Article workspace](https://github.com/saraeyad/msdaq-/blob/main/src/features/newsroom/articles/NewsroomArticlesPage.tsx): `src/features/newsroom/articles/NewsroomArticlesPage.tsx`
- [Seven-step publishing](https://github.com/saraeyad/msdaq-/blob/main/src/features/publishing-flow/PublishingFlow.tsx): `src/features/publishing-flow/PublishingFlow.tsx`
- [Publish gates](https://github.com/saraeyad/msdaq-/blob/main/src/lib/publishing/publish-gate.ts): `src/lib/publishing/publish-gate.ts`
- [Editorial calendar](https://github.com/saraeyad/msdaq-/blob/main/src/features/calendar/CalendarPage.tsx): `src/features/calendar/CalendarPage.tsx`
- [File library](https://github.com/saraeyad/msdaq-/blob/main/src/features/newsroom/library/LibraryPage.tsx): `src/features/newsroom/library/LibraryPage.tsx`

### Editorial tools

- [Standalone tools](https://github.com/saraeyad/msdaq-/blob/main/src/features/tools/StandaloneToolPage.tsx): `src/features/tools/StandaloneToolPage.tsx`
- [Editorial review](https://github.com/saraeyad/msdaq-/blob/main/src/features/tools/smart-editor/EditorialReviewPanel.tsx): `src/features/tools/smart-editor/EditorialReviewPanel.tsx`
- [Trust index](https://github.com/saraeyad/msdaq-/blob/main/src/features/trust-index/pages/TrustIndexPlatformPage.tsx): `src/features/trust-index/pages/TrustIndexPlatformPage.tsx`

### Administration

- [Dashboard and analytics](https://github.com/saraeyad/msdaq-/blob/main/src/features/admin/dashboard/AdminDashboardPage.tsx): `src/features/admin/dashboard/AdminDashboardPage.tsx`
- [Team and roles](https://github.com/saraeyad/msdaq-/blob/main/src/features/admin/team/TeamManagementPage.tsx): `src/features/admin/team/TeamManagementPage.tsx`
- [Category management](https://github.com/saraeyad/msdaq-/blob/main/src/features/admin/categories/CategoriesManagementPage.tsx): `src/features/admin/categories/CategoriesManagementPage.tsx`

### Application platform

- [Locale context](https://github.com/saraeyad/msdaq-/blob/main/src/context/locale.tsx): `src/context/locale.tsx`
- [Authentication](https://github.com/saraeyad/msdaq-/blob/main/src/context/auth/provider.tsx): `src/context/auth/provider.tsx`
- [Route composition](https://github.com/saraeyad/msdaq-/blob/main/src/router/AppRoutes.tsx): `src/router/AppRoutes.tsx`
- [Backend API clients](https://github.com/saraeyad/msdaq-/tree/main/src/services/api): `src/services/api`

### Other components

- **Reader**
- **Newsroom staff**
- **Administrator**
- **Laravel backend**

## Connections

- Reader → Route composition: opens pages (evidence: `README.md`)
- Route composition → Public layout: routes public (evidence: `src/router/AppRoutes.tsx`)
- Public layout → Public pages: hosts pages (evidence: `src/layouts/PublicLayout.tsx`)
- Newsroom staff → Route composition: opens workspace (evidence: `README.md`)
- Administrator → Route composition: opens admin (evidence: `README.md`)
- Route composition → Article workspace: routes articles (evidence: `src/router/AppRoutes.tsx`)
- Route composition → Seven-step publishing: routes publishing (evidence: `src/router/AppRoutes.tsx`)
- Seven-step publishing → Publish gates: checks gates (evidence: `README.md`)
- Seven-step publishing → Backend API clients: submits content
- Route composition → Editorial calendar: routes calendar (evidence: `src/router/AppRoutes.tsx`)
- Route composition → File library: routes library (evidence: `src/router/AppRoutes.tsx`)
- Route composition → Standalone tools: routes tools (evidence: `src/router/AppRoutes.tsx`)
- Standalone tools → Editorial review: renders review
- Route composition → Trust index: routes trust index (evidence: `src/router/AppRoutes.tsx`)
- Route composition → Dashboard and analytics: routes dashboard (evidence: `src/router/AppRoutes.tsx`)
- Route composition → Team and roles: routes team (evidence: `src/router/AppRoutes.tsx`)
- Route composition → Category management: routes categories (evidence: `src/router/AppRoutes.tsx`)
- Newsroom staff → Authentication: authenticates (evidence: `README.md`)
- Route composition → Authentication: guards workspace (evidence: `src/router/AppRoutes.tsx`)
- Public layout → Locale context: reads locale (evidence: `src/layouts/PublicLayout.tsx`)
- Backend API clients → Laravel backend: sends API requests (evidence: `README.md`)
