# bazuga02/stories-app-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/bazuga02/stories-app-frontend
- Repository: https://github.com/bazuga02/stories-app-frontend

## Overview

This is a Next.js frontend for a story-publishing community, backed by an API. Readers browse published stories and Aesop fables, open story details, interact through bookmarks/comments, and optionally listen to narration. Authors register or sign in, then create, save, and publish stories; personal dashboard and admin tools support management. The graph preserves these distinct product areas. Connections are limited to relationships visible in excerpts or the SOURCE INDEX; several routes and integrations are unsampled.

Main entry points: [`src/services/api.ts`](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/api.ts) (API client), [`src/services/stories.service.ts`](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/stories.service.ts) (Story operations), [`src/app/(site)/story/[id]/StoryPageClient.tsx`](https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(site)/story/%5Bid%5D/StoryPageClient.tsx) (Story detail route), [`src/features/feed/HomeFeed.tsx`](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/feed/HomeFeed.tsx) (Published story feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity"]
  node_login["Sign in and register"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_auth_state[("Session state<br/>[authStore.ts]")]
end

subgraph group_reading["Reading"]
  node_home["Editorial home<br/>[EditorialHome.tsx]"]
  node_feed["Published story feed<br/>[HomeFeed.tsx]"]
  node_fables["Aesop fables"]
  node_story_detail["Story detail route"]
  node_story_views["Story views"]
  node_fable_view["Fable view<br/>[AesopStoryView.tsx]"]
  node_narration["Audio narration"]
end

subgraph group_authoring["Story authoring"]
  node_editor["Story editor"]
  node_markdown["Markdown editor"]
end

subgraph group_management["Management"]
  node_personal["Personal dashboard<br/>[page.tsx]"]
  node_admin["Admin dashboard<br/>[AdminDashboard.tsx]"]
end

subgraph group_services["API services"]
  node_story_service["Story operations<br/>[stories.service.ts]"]
  node_bookmark_service["Bookmark operations"]
  node_comments_service["Comment operations"]
  node_admin_service["Admin operations<br/>[admin.service.ts]"]
  node_api_client["API client<br/>[api.ts]"]
  node_tts_service["Narration service<br/>[tts.service.ts]"]
end

node_reader(("Reader"))
node_author(("Author"))
node_admin_user(("Administrator"))
node_backend[("Stories backend")]

node_reader -->|"browses"| node_home
node_home -->|"renders"| node_feed
node_home -->|"loads fables"| node_fables
node_reader -->|"opens story"| node_story_detail
node_story_detail -->|"renders"| node_story_views
node_story_detail -->|"renders"| node_fable_view
node_story_views -->|"loads comments"| node_comments_service
node_story_views -->|"uses narration"| node_narration
node_narration -->|"requests audio"| node_tts_service
node_reader -->|"signs in"| node_login
node_login -->|"authenticates"| node_auth_service
node_auth_service -->|"sends requests"| node_api_client
node_author -->|"writes story"| node_editor
node_editor -->|"edits content"| node_markdown
node_editor -->|"saves or publishes"| node_story_service
node_reader -->|"browses stories"| node_feed
node_feed -->|"loads stories"| node_story_service
node_feed -->|"manages bookmarks"| node_bookmark_service
node_author -->|"manages stories"| node_personal
node_personal -->|"loads stories"| node_story_service
node_personal -->|"loads bookmarks"| node_bookmark_service
node_admin_user -->|"moderates"| node_admin
node_admin -->|"requests admin data"| node_admin_service
node_story_detail -->|"loads story"| node_story_service
node_story_service -->|"sends requests"| node_api_client
node_bookmark_service -->|"sends requests"| node_api_client
node_comments_service -->|"sends requests"| node_api_client
node_admin_service -->|"sends requests"| node_api_client
node_tts_service -.->|"sends requests"| node_api_client
node_api_client -->|"calls API"| node_backend
node_auth_service -->|"updates session"| node_auth_state
node_api_client -->|"reads token"| node_auth_state

click node_login "https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(auth)/login/LoginPageClient.tsx"
click node_auth_service "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/auth.service.ts"
click node_auth_state "https://github.com/bazuga02/stories-app-frontend/blob/main/src/store/authStore.ts"
click node_home "https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/home/EditorialHome.tsx"
click node_feed "https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/feed/HomeFeed.tsx"
click node_fables "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/aesop-stories.service.ts"
click node_story_detail "https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(site)/story/%5Bid%5D/StoryPageClient.tsx"
click node_story_views "https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/story/PublishedStoryView.tsx"
click node_fable_view "https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/story/AesopStoryView.tsx"
click node_narration "https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/story/useStoryNarration.ts"
click node_editor "https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(app)/editor/EditorPageClient.tsx"
click node_markdown "https://github.com/bazuga02/stories-app-frontend/blob/main/src/components/editor/RichMarkdownEditor.tsx"
click node_personal "https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(site)/dashboard/page.tsx"
click node_admin "https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/admin/AdminDashboard.tsx"
click node_story_service "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/stories.service.ts"
click node_bookmark_service "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/bookmarks.service.ts"
click node_comments_service "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/comments.service.ts"
click node_admin_service "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/admin.service.ts"
click node_api_client "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/api.ts"
click node_tts_service "https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/tts.service.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_login,node_auth_service,node_auth_state toneBlue
class node_home,node_feed,node_fables,node_story_detail,node_story_views,node_fable_view,node_narration,node_backend toneAmber
class node_editor,node_markdown toneMint
class node_personal,node_admin toneRose
class node_story_service,node_bookmark_service,node_comments_service,node_admin_service,node_api_client,node_tts_service,node_reader,node_author,node_admin_user toneIndigo
```

## Components

### Identity

- [Sign in and register](https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(auth)/login/LoginPageClient.tsx): `src/app/(auth)/login/LoginPageClient.tsx`
- [Authentication](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/auth.service.ts): `src/services/auth.service.ts`
- [Session state](https://github.com/bazuga02/stories-app-frontend/blob/main/src/store/authStore.ts): `src/store/authStore.ts`

### Reading

- [Editorial home](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/home/EditorialHome.tsx): `src/features/home/EditorialHome.tsx`
- [Published story feed](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/feed/HomeFeed.tsx): `src/features/feed/HomeFeed.tsx`
- [Aesop fables](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/aesop-stories.service.ts): `src/services/aesop-stories.service.ts`
- [Story detail route](https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(site)/story/%5Bid%5D/StoryPageClient.tsx): `src/app/(site)/story/[id]/StoryPageClient.tsx`
- [Story views](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/story/PublishedStoryView.tsx): `src/features/story/PublishedStoryView.tsx`
- [Fable view](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/story/AesopStoryView.tsx): `src/features/story/AesopStoryView.tsx`
- [Audio narration](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/story/useStoryNarration.ts): `src/features/story/useStoryNarration.ts`

### Story authoring

- [Story editor](https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(app)/editor/EditorPageClient.tsx): `src/app/(app)/editor/EditorPageClient.tsx`
- [Markdown editor](https://github.com/bazuga02/stories-app-frontend/blob/main/src/components/editor/RichMarkdownEditor.tsx): `src/components/editor/RichMarkdownEditor.tsx`

### Management

- [Personal dashboard](https://github.com/bazuga02/stories-app-frontend/blob/main/src/app/(site)/dashboard/page.tsx): `src/app/(site)/dashboard/page.tsx`
- [Admin dashboard](https://github.com/bazuga02/stories-app-frontend/blob/main/src/features/admin/AdminDashboard.tsx): `src/features/admin/AdminDashboard.tsx`

### API services

- [Story operations](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/stories.service.ts): `src/services/stories.service.ts`
- [Bookmark operations](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/bookmarks.service.ts): `src/services/bookmarks.service.ts`
- [Comment operations](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/comments.service.ts): `src/services/comments.service.ts`
- [Admin operations](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/admin.service.ts): `src/services/admin.service.ts`
- [API client](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/api.ts): `src/services/api.ts`
- [Narration service](https://github.com/bazuga02/stories-app-frontend/blob/main/src/services/tts.service.ts): `src/services/tts.service.ts`

### Other components

- **Reader**
- **Author**
- **Administrator**
- **Stories backend**

## Connections

- Reader → Editorial home: browses
- Editorial home → Published story feed: renders (evidence: `src/app/(site)/page.tsx`)
- Editorial home → Aesop fables: loads fables (evidence: `src/features/home/EditorialHome.tsx`)
- Reader → Story detail route: opens story (evidence: `src/app/(site)/story/[id]/StoryPageClient.tsx`)
- Story detail route → Story views: renders (evidence: `src/app/(site)/story/[id]/StoryPageClient.tsx`)
- Story detail route → Fable view: renders (evidence: `src/app/(site)/story/[id]/StoryPageClient.tsx`)
- Story views → Comment operations: loads comments (evidence: `src/features/story/PublishedStoryView.tsx`)
- Story views → Audio narration: uses narration (evidence: `src/features/story/PublishedStoryView.tsx`)
- Audio narration → Narration service: requests audio (evidence: `src/features/story/useStoryNarration.ts`)
- Reader → Sign in and register: signs in (evidence: `src/app/(auth)/login/LoginPageClient.tsx`)
- Sign in and register → Authentication: authenticates (evidence: `src/app/(auth)/login/LoginPageClient.tsx`)
- Authentication → API client: sends requests (evidence: `src/services/auth.service.ts`)
- Author → Story editor: writes story (evidence: `src/app/(app)/editor/EditorPageClient.tsx`)
- Story editor → Markdown editor: edits content (evidence: `src/app/(app)/editor/EditorPageClient.tsx`)
- Story editor → Story operations: saves or publishes (evidence: `src/app/(app)/editor/EditorPageClient.tsx`)
- Reader → Published story feed: browses stories
- Published story feed → Story operations: loads stories (evidence: `src/features/feed/HomeFeed.tsx`)
- Published story feed → Bookmark operations: manages bookmarks (evidence: `src/features/feed/HomeFeed.tsx`)
- Author → Personal dashboard: manages stories (evidence: `src/app/(site)/dashboard/page.tsx`)
- Personal dashboard → Story operations: loads stories (evidence: `src/app/(site)/dashboard/page.tsx`)
- Personal dashboard → Bookmark operations: loads bookmarks (evidence: `src/app/(site)/dashboard/page.tsx`)
- Administrator → Admin dashboard: moderates (evidence: `src/features/admin/AdminDashboard.tsx`)
- Admin dashboard → Admin operations: requests admin data (evidence: `src/features/admin/AdminDashboard.tsx`)
- Story detail route → Story operations: loads story (evidence: `src/app/(site)/story/[id]/StoryPageClient.tsx`)
- Story operations → API client: sends requests (evidence: `src/services/stories.service.ts`)
- Bookmark operations → API client: sends requests (evidence: `src/services/bookmarks.service.ts`)
- Comment operations → API client: sends requests (evidence: `src/features/story/PublishedStoryView.tsx`)
- Admin operations → API client: sends requests (evidence: `src/services/admin.service.ts`)
- Narration service → API client: sends requests
- API client → Stories backend: calls API (evidence: `src/services/api.ts`)
- Authentication → Session state: updates session (evidence: `src/services/auth.service.ts`)
- API client → Session state: reads token (evidence: `src/services/api.ts`)
