How sabeurmohamedamin/guelma-history-nuxt works
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: index.ts Schema registry · ArticleContent.vue Article reading · index.vue Nuxt pages · mobile-auth-session.repository.ts Mobile sessions
Components 34
Web experience
- Nuxt pages
app/pages/index.vue - Search experience
app/composables/useArticleSearch.ts - Article reading
app/components/article/ArticleContent.vue - Account and roles
app/middleware/user-only.ts - Author workspace
app/pages/author/articles/index.vue - Admin workspace
app/pages/admin/articles/index.vue
Content and discovery
- Search endpoint
server/api/search/index.get.ts - Article endpoints
server/api/articles/index.get.ts - Article services
server/services/article.service.ts - Article queries
server/repositories/article.repository.ts - Article domain
server/db/schema/articles.ts - Author endpoints
server/api/authors/index.get.ts - Category endpoints
server/api/categories/index.get.ts
Community features
- Comment endpoints
server/api/comments/index.post.ts - Bookmark endpoints
server/api/bookmarks/index.get.ts - Newsletter
server/api/newsletter/subscribe.post.ts - Contact workflow
server/api/contact/submit.post.ts - Notifications
server/api/notifications/index.get.ts
Server and persistence
- Mobile admin auth
server/services/mobile-auth.service.ts - Mobile sessions
server/repositories/mobile-auth-session.repository.ts - Database client
server/db/index.ts - Schema registry
server/db/schema/index.ts - Article media
server/db/schema/article-media.ts - Bookmark data
server/db/schema/bookmarks.ts - Comment data
server/db/schema/comments.ts - Comment reports
server/db/schema/comment-flags.ts - Comment votes
server/db/schema/comment-votes.ts - Contact messages
server/db/schema/contact-messages.ts - Notification data
server/db/schema/notifications.ts - Notification mutes
server/db/schema/notification-mutes.ts - Subscriber data
server/db/schema/subscribers.ts - User accounts
server/db/schema/users.ts - OAuth accounts
server/db/schema/user-oauth-accounts.ts
Other components
- Reader
Connections 34
- Reader → Nuxt pages: browses
- Nuxt pages → Search experience: opens search
- Search experience → Search endpoint: fetches results
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
server/services/mobile-auth.service.ts - Mobile sessions → Database client: queries database
server/repositories/mobile-auth-session.repository.ts - Mobile sessions → Schema registry: uses session schema
server/repositories/mobile-auth-session.repository.ts - Mobile admin auth → Article domain: checks user accounts
server/services/mobile-auth.service.ts - Database client → Schema registry: loads schema
server/db/index.ts - Schema registry → Article domain: exports
server/db/schema/index.ts - Schema registry → Article media: exports
server/db/schema/index.ts - Schema registry → Bookmark data: exports
server/db/schema/index.ts - Schema registry → Comment data: exports
server/db/schema/index.ts - Schema registry → Comment reports: exports
server/db/schema/index.ts - Schema registry → Comment votes: exports
server/db/schema/index.ts - Schema registry → Contact messages: exports
server/db/schema/index.ts - Schema registry → Notification data: exports
server/db/schema/index.ts - Schema registry → Notification mutes: exports
server/db/schema/index.ts - Schema registry → Subscriber data: exports
server/db/schema/index.ts - Schema registry → User accounts: exports
server/db/schema/index.ts - Schema registry → OAuth accounts: exports
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