# sabeurmohamedamin/guelma-history-nuxt architecture

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

- Interactive diagram: https://gitdiagram.com/sabeurmohamedamin/guelma-history-nuxt
- Repository: https://github.com/sabeurmohamedamin/guelma-history-nuxt

## Overview

Guelma History is a bilingual Arabic/French history publication with public discovery and reading, community interactions, and administrative publishing. The main visitor journey is browsing or searching articles, opening a story, then optionally bookmarking or commenting; the sampled search composable explicitly fetches `/api/search`. The tree also documents author/admin workflows, newsletter and contact features, notifications, and a mobile-admin API. Several routes and service links are inferred only from the tree, so they are shown as unverified rather than asserted calls.

Main entry points: [`server/db/schema/index.ts`](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/index.ts) (Schema registry), [`app/components/article/ArticleContent.vue`](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/components/article/ArticleContent.vue) (Article reading), [`app/pages/index.vue`](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/index.vue) (Nuxt pages), [`server/repositories/mobile-auth-session.repository.ts`](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/repositories/mobile-auth-session.repository.ts) (Mobile sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_web["Nuxt pages<br/>[index.vue]"]
  node_search_ui["Search experience"]
  node_article_ui["Article reading<br/>[ArticleContent.vue]"]
  node_auth_ui["Account and roles<br/>[user-only.ts]"]
  node_author_ui["Author workspace<br/>[index.vue]"]
  node_admin_ui["Admin workspace<br/>[index.vue]"]
end

subgraph group_content["Content and discovery"]
  node_search_api["Search endpoint<br/>[index.get.ts]"]
  node_article_api["Article endpoints<br/>[index.get.ts]"]
  node_article_service["Article services<br/>[article.service.ts]"]
  node_article_repository["Article queries"]
  node_article_data["Article domain<br/>[articles.ts]"]
  node_author_api["Author endpoints<br/>[index.get.ts]"]
  node_category_api["Category endpoints<br/>[index.get.ts]"]
end

subgraph group_community["Community features"]
  node_comment_api["Comment endpoints<br/>[index.post.ts]"]
  node_bookmark_api["Bookmark endpoints<br/>[index.get.ts]"]
  node_newsletter["Newsletter<br/>[subscribe.post.ts]"]
  node_contact["Contact workflow<br/>[submit.post.ts]"]
  node_notification["Notifications<br/>[index.get.ts]"]
end

subgraph group_platform["Server and persistence"]
  node_mobile_auth["Mobile admin auth"]
  node_mobile_sessions["Mobile sessions"]
  node_db[("Database client<br/>[index.ts]")]
  node_schema_index["Schema registry<br/>[index.ts]"]
  node_media["Article media<br/>[article-media.ts]"]
  node_bookmarks_data["Bookmark data<br/>[bookmarks.ts]"]
  node_comments_data["Comment data<br/>[comments.ts]"]
  node_flags_data["Comment reports<br/>[comment-flags.ts]"]
  node_votes_data["Comment votes<br/>[comment-votes.ts]"]
  node_contact_data["Contact messages"]
  node_notifications_data["Notification data<br/>[notifications.ts]"]
  node_mutes_data["Notification mutes"]
  node_subscribers_data["Subscriber data<br/>[subscribers.ts]"]
  node_users_data["User accounts<br/>[users.ts]"]
  node_oauth_data["OAuth accounts"]
end

node_visitor(("Reader"))

node_visitor -.->|"browses"| node_web
node_web -.->|"opens search"| node_search_ui
node_search_ui -->|"fetches results"| node_search_api
node_visitor -.->|"reads stories"| node_article_ui
node_web -.->|"opens story"| node_article_ui
node_visitor -.->|"authors stories"| node_author_ui
node_visitor -.->|"administers site"| node_admin_ui
node_mobile_auth -->|"manages sessions"| node_mobile_sessions
node_mobile_sessions -->|"queries database"| node_db
node_mobile_sessions -->|"uses session schema"| node_schema_index
node_mobile_auth -->|"checks user accounts"| node_article_data
node_db -->|"loads schema"| node_schema_index
node_schema_index -->|"exports"| node_article_data
node_schema_index -->|"exports"| node_media
node_schema_index -->|"exports"| node_bookmarks_data
node_schema_index -->|"exports"| node_comments_data
node_schema_index -->|"exports"| node_flags_data
node_schema_index -->|"exports"| node_votes_data
node_schema_index -->|"exports"| node_contact_data
node_schema_index -->|"exports"| node_notifications_data
node_schema_index -->|"exports"| node_mutes_data
node_schema_index -->|"exports"| node_subscribers_data
node_schema_index -->|"exports"| node_users_data
node_schema_index -->|"exports"| node_oauth_data
node_article_ui -.->|"loads article"| node_article_api
node_article_api -.->|"delegates"| node_article_service
node_article_service -.->|"queries articles"| node_article_repository
node_article_repository -.->|"reads articles"| node_db
node_author_ui -.->|"manages content"| node_author_api
node_admin_ui -.->|"manages articles"| node_article_api
node_article_ui -.->|"submits comments"| node_comment_api
node_article_ui -.->|"saves bookmarks"| node_bookmark_api
node_visitor -.->|"subscribes"| node_newsletter
node_visitor -.->|"sends message"| node_contact

click node_web "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/index.vue"
click node_search_ui "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/composables/useArticleSearch.ts"
click node_article_ui "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/components/article/ArticleContent.vue"
click node_auth_ui "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/middleware/user-only.ts"
click node_author_ui "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/author/articles/index.vue"
click node_admin_ui "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/admin/articles/index.vue"
click node_search_api "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/search/index.get.ts"
click node_article_api "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/articles/index.get.ts"
click node_article_service "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/services/article.service.ts"
click node_article_repository "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/repositories/article.repository.ts"
click node_article_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/articles.ts"
click node_author_api "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/authors/index.get.ts"
click node_category_api "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/categories/index.get.ts"
click node_comment_api "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/comments/index.post.ts"
click node_bookmark_api "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/bookmarks/index.get.ts"
click node_newsletter "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/newsletter/subscribe.post.ts"
click node_contact "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/contact/submit.post.ts"
click node_notification "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/notifications/index.get.ts"
click node_mobile_auth "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/services/mobile-auth.service.ts"
click node_mobile_sessions "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/repositories/mobile-auth-session.repository.ts"
click node_db "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/index.ts"
click node_schema_index "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/index.ts"
click node_media "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/article-media.ts"
click node_bookmarks_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/bookmarks.ts"
click node_comments_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/comments.ts"
click node_flags_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/comment-flags.ts"
click node_votes_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/comment-votes.ts"
click node_contact_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/contact-messages.ts"
click node_notifications_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/notifications.ts"
click node_mutes_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/notification-mutes.ts"
click node_subscribers_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/subscribers.ts"
click node_users_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/users.ts"
click node_oauth_data "https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/user-oauth-accounts.ts"

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_web,node_search_ui,node_article_ui,node_auth_ui,node_author_ui,node_admin_ui toneBlue
class node_search_api,node_article_api,node_article_service,node_article_repository,node_article_data,node_author_api,node_category_api toneAmber
class node_comment_api,node_bookmark_api,node_newsletter,node_contact,node_notification toneMint
class node_mobile_auth,node_mobile_sessions,node_db,node_schema_index,node_media,node_bookmarks_data,node_comments_data,node_flags_data,node_votes_data,node_contact_data,node_notifications_data,node_mutes_data,node_subscribers_data,node_users_data,node_oauth_data toneRose
class node_visitor toneIndigo
```

## Components

### Web experience

- [Nuxt pages](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/index.vue): `app/pages/index.vue`
- [Search experience](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/composables/useArticleSearch.ts): `app/composables/useArticleSearch.ts`
- [Article reading](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/components/article/ArticleContent.vue): `app/components/article/ArticleContent.vue`
- [Account and roles](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/middleware/user-only.ts): `app/middleware/user-only.ts`
- [Author workspace](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/author/articles/index.vue): `app/pages/author/articles/index.vue`
- [Admin workspace](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/app/pages/admin/articles/index.vue): `app/pages/admin/articles/index.vue`

### Content and discovery

- [Search endpoint](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/search/index.get.ts): `server/api/search/index.get.ts`
- [Article endpoints](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/articles/index.get.ts): `server/api/articles/index.get.ts`
- [Article services](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/services/article.service.ts): `server/services/article.service.ts`
- [Article queries](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/repositories/article.repository.ts): `server/repositories/article.repository.ts`
- [Article domain](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/articles.ts): `server/db/schema/articles.ts`
- [Author endpoints](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/authors/index.get.ts): `server/api/authors/index.get.ts`
- [Category endpoints](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/categories/index.get.ts): `server/api/categories/index.get.ts`

### Community features

- [Comment endpoints](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/comments/index.post.ts): `server/api/comments/index.post.ts`
- [Bookmark endpoints](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/bookmarks/index.get.ts): `server/api/bookmarks/index.get.ts`
- [Newsletter](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/newsletter/subscribe.post.ts): `server/api/newsletter/subscribe.post.ts`
- [Contact workflow](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/contact/submit.post.ts): `server/api/contact/submit.post.ts`
- [Notifications](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/api/notifications/index.get.ts): `server/api/notifications/index.get.ts`

### Server and persistence

- [Mobile admin auth](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/services/mobile-auth.service.ts): `server/services/mobile-auth.service.ts`
- [Mobile sessions](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/repositories/mobile-auth-session.repository.ts): `server/repositories/mobile-auth-session.repository.ts`
- [Database client](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/index.ts): `server/db/index.ts`
- [Schema registry](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/index.ts): `server/db/schema/index.ts`
- [Article media](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/article-media.ts): `server/db/schema/article-media.ts`
- [Bookmark data](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/bookmarks.ts): `server/db/schema/bookmarks.ts`
- [Comment data](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/comments.ts): `server/db/schema/comments.ts`
- [Comment reports](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/comment-flags.ts): `server/db/schema/comment-flags.ts`
- [Comment votes](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/comment-votes.ts): `server/db/schema/comment-votes.ts`
- [Contact messages](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/contact-messages.ts): `server/db/schema/contact-messages.ts`
- [Notification data](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/notifications.ts): `server/db/schema/notifications.ts`
- [Notification mutes](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/notification-mutes.ts): `server/db/schema/notification-mutes.ts`
- [Subscriber data](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/subscribers.ts): `server/db/schema/subscribers.ts`
- [User accounts](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/users.ts): `server/db/schema/users.ts`
- [OAuth accounts](https://github.com/sabeurmohamedamin/guelma-history-nuxt/blob/main/server/db/schema/user-oauth-accounts.ts): `server/db/schema/user-oauth-accounts.ts`

### Other components

- **Reader**

## Connections

- Reader → Nuxt pages: browses
- Nuxt pages → Search experience: opens search
- Search experience → Search endpoint: fetches results (evidence: `app/composables/useArticleSearch.ts`)
- Reader → Article reading: reads stories
- Nuxt pages → Article reading: opens story
- Reader → Author workspace: authors stories
- Reader → Admin workspace: administers site
- Mobile admin auth → Mobile sessions: manages sessions (evidence: `server/services/mobile-auth.service.ts`)
- Mobile sessions → Database client: queries database (evidence: `server/repositories/mobile-auth-session.repository.ts`)
- Mobile sessions → Schema registry: uses session schema (evidence: `server/repositories/mobile-auth-session.repository.ts`)
- Mobile admin auth → Article domain: checks user accounts (evidence: `server/services/mobile-auth.service.ts`)
- Database client → Schema registry: loads schema (evidence: `server/db/index.ts`)
- Schema registry → Article domain: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Article media: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Bookmark data: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Comment data: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Comment reports: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Comment votes: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Contact messages: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Notification data: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Notification mutes: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → Subscriber data: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → User accounts: exports (evidence: `server/db/schema/index.ts`)
- Schema registry → OAuth accounts: exports (evidence: `server/db/schema/index.ts`)
- Article reading → Article endpoints: loads article
- Article endpoints → Article services: delegates
- Article services → Article queries: queries articles
- Article queries → Database client: reads articles
- Author workspace → Author endpoints: manages content
- Admin workspace → Article endpoints: manages articles
- Article reading → Comment endpoints: submits comments
- Article reading → Bookmark endpoints: saves bookmarks
- Reader → Newsletter: subscribes
- Reader → Contact workflow: sends message
