# gmtdn67/production-project architecture

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

- Interactive diagram: https://gitdiagram.com/gmtdn67/production-project
- Repository: https://github.com/gmtdn67/production-project

## Overview

This is a Feature-Sliced React frontend for an article community, with authentication, profiles, comments, ratings, recommendations, and user interface preferences. The main workflow initializes the user session, enters the routed app, and lets users browse and filter articles or open article details and interact with them. The graph includes major documented feature branches as well as application, routing, and state layers. Some feature and page internals were not sampled, so those connections are shown as unverified rather than asserted as calls.

Main entry points: [`src/app/App.tsx`](https://github.com/gmtdn67/production-project/blob/master/src/app/App.tsx) (App shell), [`src/pages/ArticleDetailsPage`](https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticleDetailsPage) (Article details), [`src/index.tsx`](https://github.com/gmtdn67/production-project/blob/master/src/index.tsx) (React bootstrap), [`src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts`](https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts) (Article filters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_bootstrap["React bootstrap<br/>[index.tsx]"]
  node_app["App shell<br/>[App.tsx]"]
  node_router["App router<br/>[AppRouter.tsx]"]
  node_routes["Route config<br/>[routeConfig.tsx]"]
end

subgraph group_content["Article experience"]
  node_articles["Article browsing"]
  node_filters["Article filters"]
  node_article_state["Article list state"]
  node_article_fetch["Article list fetch"]
  node_details["Article details"]
  node_article_entity["Article entity"]
end

subgraph group_identity["Identity and profiles"]
  node_session["Session init<br/>[initAuthData.ts]"]
  node_user_api["User API<br/>[userApi.ts]"]
  node_login["Username login"]
  node_profile["Profile editing"]
end

subgraph group_engagement["Community features"]
  node_comments["Comments"]
  node_add_comment["Add comment"]
  node_recommendations["Recommendations"]
  node_ratings["Article rating"]
  node_profile_rating["Profile rating"]
end

subgraph group_foundation["Shared foundation"]
  node_store["Redux store<br/>[StateSchema.ts]"]
  node_shared_api["RTK Query API<br/>[rtkApi.ts]"]
  node_ui_prefs["UI preferences"]
  node_flags["Feature flags<br/>[index.ts]"]
  node_theme["Theme provider<br/>[ThemeProvider.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens app"| node_bootstrap
node_bootstrap -->|"renders"| node_app
node_app -->|"initializes session"| node_session
node_session -->|"queries user"| node_user_api
node_app -->|"renders routes"| node_router
node_router -->|"uses route config"| node_routes
node_bootstrap -.->|"provides state"| node_store
node_app -->|"toggles layouts"| node_flags
node_app -.->|"reads theme"| node_theme
node_filters -->|"updates filters"| node_article_state
node_filters -->|"dispatches fetch"| node_article_fetch
node_articles -.->|"uses filters"| node_filters
node_article_fetch -.->|"loads articles"| node_article_entity
node_details -.->|"shows article"| node_article_entity
node_details -.->|"shows comments"| node_comments
node_details -.->|"shows recommendations"| node_recommendations
node_details -.->|"offers rating"| node_ratings
node_comments -.->|"offers comment form"| node_add_comment
node_profile -.->|"offers profile rating"| node_profile_rating
node_login -.->|"authenticates"| node_user_api
node_store -.->|"includes API state"| node_shared_api

click node_bootstrap "https://github.com/gmtdn67/production-project/blob/master/src/index.tsx"
click node_app "https://github.com/gmtdn67/production-project/blob/master/src/app/App.tsx"
click node_router "https://github.com/gmtdn67/production-project/blob/master/src/app/providers/router/ui/AppRouter.tsx"
click node_routes "https://github.com/gmtdn67/production-project/blob/master/src/app/providers/router/config/routeConfig.tsx"
click node_store "https://github.com/gmtdn67/production-project/blob/master/src/app/providers/StoreProvider/config/StateSchema.ts"
click node_session "https://github.com/gmtdn67/production-project/blob/master/src/entities/User/model/services/initAuthData.ts"
click node_user_api "https://github.com/gmtdn67/production-project/blob/master/src/entities/User/api/userApi.ts"
click node_login "https://github.com/gmtdn67/production-project/tree/master/src/features/AuthByUsername"
click node_profile "https://github.com/gmtdn67/production-project/blob/master/src/features/editableProfileCard/ui/EditableProfileCardHeader/EditableProfileCardHeader.tsx"
click node_articles "https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticlesPage"
click node_filters "https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts"
click node_article_state "https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/model/slices/articlesPageSlice.ts"
click node_article_fetch "https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/model/services/fetchArticlesList/fetchArticlesList.ts"
click node_details "https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticleDetailsPage"
click node_article_entity "https://github.com/gmtdn67/production-project/tree/master/src/entities/Article"
click node_comments "https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticleDetailsPage"
click node_add_comment "https://github.com/gmtdn67/production-project/tree/master/src/features/addCommentForm"
click node_recommendations "https://github.com/gmtdn67/production-project/tree/master/src/features/ArticleRecommendationsList"
click node_ratings "https://github.com/gmtdn67/production-project/tree/master/src/features/articleRating"
click node_profile_rating "https://github.com/gmtdn67/production-project/tree/master/src/features/profileRating"
click node_shared_api "https://github.com/gmtdn67/production-project/blob/master/src/shared/api/rtkApi.ts"
click node_ui_prefs "https://github.com/gmtdn67/production-project/tree/master/src/features/UI"
click node_flags "https://github.com/gmtdn67/production-project/blob/master/src/shared/lib/features/index.ts"
click node_theme "https://github.com/gmtdn67/production-project/blob/master/src/app/providers/ThemeProvider/ui/ThemeProvider.tsx"

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_bootstrap,node_app,node_router,node_routes toneBlue
class node_articles,node_filters,node_article_state,node_article_fetch,node_details,node_article_entity toneAmber
class node_session,node_user_api,node_login,node_profile toneMint
class node_comments,node_add_comment,node_recommendations,node_ratings,node_profile_rating toneRose
class node_store,node_shared_api,node_ui_prefs,node_flags,node_theme,node_visitor toneIndigo
```

## Components

### Application runtime

- [React bootstrap](https://github.com/gmtdn67/production-project/blob/master/src/index.tsx): `src/index.tsx`
- [App shell](https://github.com/gmtdn67/production-project/blob/master/src/app/App.tsx): `src/app/App.tsx`
- [App router](https://github.com/gmtdn67/production-project/blob/master/src/app/providers/router/ui/AppRouter.tsx): `src/app/providers/router/ui/AppRouter.tsx`
- [Route config](https://github.com/gmtdn67/production-project/blob/master/src/app/providers/router/config/routeConfig.tsx): `src/app/providers/router/config/routeConfig.tsx`

### Article experience

- [Article browsing](https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticlesPage): `src/pages/ArticlesPage`
- [Article filters](https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts): `src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts`
- [Article list state](https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/model/slices/articlesPageSlice.ts): `src/pages/ArticlesPage/model/slices/articlesPageSlice.ts`
- [Article list fetch](https://github.com/gmtdn67/production-project/blob/master/src/pages/ArticlesPage/model/services/fetchArticlesList/fetchArticlesList.ts): `src/pages/ArticlesPage/model/services/fetchArticlesList/fetchArticlesList.ts`
- [Article details](https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticleDetailsPage): `src/pages/ArticleDetailsPage`
- [Article entity](https://github.com/gmtdn67/production-project/tree/master/src/entities/Article): `src/entities/Article`

### Identity and profiles

- [Session init](https://github.com/gmtdn67/production-project/blob/master/src/entities/User/model/services/initAuthData.ts): `src/entities/User/model/services/initAuthData.ts`
- [User API](https://github.com/gmtdn67/production-project/blob/master/src/entities/User/api/userApi.ts): `src/entities/User/api/userApi.ts`
- [Username login](https://github.com/gmtdn67/production-project/tree/master/src/features/AuthByUsername): `src/features/AuthByUsername`
- [Profile editing](https://github.com/gmtdn67/production-project/blob/master/src/features/editableProfileCard/ui/EditableProfileCardHeader/EditableProfileCardHeader.tsx): `src/features/editableProfileCard/ui/EditableProfileCardHeader/EditableProfileCardHeader.tsx`

### Community features

- [Comments](https://github.com/gmtdn67/production-project/tree/master/src/pages/ArticleDetailsPage): `src/pages/ArticleDetailsPage`
- [Add comment](https://github.com/gmtdn67/production-project/tree/master/src/features/addCommentForm): `src/features/addCommentForm`
- [Recommendations](https://github.com/gmtdn67/production-project/tree/master/src/features/ArticleRecommendationsList): `src/features/ArticleRecommendationsList`
- [Article rating](https://github.com/gmtdn67/production-project/tree/master/src/features/articleRating): `src/features/articleRating`
- [Profile rating](https://github.com/gmtdn67/production-project/tree/master/src/features/profileRating): `src/features/profileRating`

### Shared foundation

- [Redux store](https://github.com/gmtdn67/production-project/blob/master/src/app/providers/StoreProvider/config/StateSchema.ts): `src/app/providers/StoreProvider/config/StateSchema.ts`
- [RTK Query API](https://github.com/gmtdn67/production-project/blob/master/src/shared/api/rtkApi.ts): `src/shared/api/rtkApi.ts`
- [UI preferences](https://github.com/gmtdn67/production-project/tree/master/src/features/UI): `src/features/UI`
- [Feature flags](https://github.com/gmtdn67/production-project/blob/master/src/shared/lib/features/index.ts): `src/shared/lib/features/index.ts`
- [Theme provider](https://github.com/gmtdn67/production-project/blob/master/src/app/providers/ThemeProvider/ui/ThemeProvider.tsx): `src/app/providers/ThemeProvider/ui/ThemeProvider.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → React bootstrap: opens app (evidence: `src/index.tsx`)
- React bootstrap → App shell: renders (evidence: `src/index.tsx`)
- App shell → Session init: initializes session (evidence: `src/app/App.tsx`)
- Session init → User API: queries user (evidence: `src/entities/User/model/services/initAuthData.ts`)
- App shell → App router: renders routes (evidence: `src/app/App.tsx`)
- App router → Route config: uses route config (evidence: `src/app/providers/router/ui/AppRouter.tsx`)
- React bootstrap → Redux store: provides state (evidence: `src/index.tsx`)
- App shell → Feature flags: toggles layouts (evidence: `src/app/App.tsx`)
- App shell → Theme provider: reads theme (evidence: `src/app/App.tsx`)
- Article filters → Article list state: updates filters (evidence: `src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts`)
- Article filters → Article list fetch: dispatches fetch (evidence: `src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts`)
- Article browsing → Article filters: uses filters (evidence: `src/pages/ArticlesPage/lib/hooks/useArticleFilters.ts`)
- Article list fetch → Article entity: loads articles
- Article details → Article entity: shows article
- Article details → Comments: shows comments
- Article details → Recommendations: shows recommendations
- Article details → Article rating: offers rating
- Comments → Add comment: offers comment form
- Profile editing → Profile rating: offers profile rating
- Username login → User API: authenticates
- Redux store → RTK Query API: includes API state (evidence: `src/app/providers/StoreProvider/config/StateSchema.ts`)
