# abbos-khamidov/blog-aisolution architecture

> Architecture diagram of the GitHub repository abbos-khamidov/blog-aisolution, 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/abbos-khamidov/blog-aisolution
- Repository: https://github.com/abbos-khamidov/blog-aisolution

## Overview

This is a bilingual Russian/Uzbek startup-analysis publication. Visitors browse a localized home feed, filter and open articles, and explore rating, topic-cluster, opinion, and author pages; article pages can also link to AISOLUTION services. Content is read and validated from MDX, then formatted for display and structured metadata. The source index establishes many module references, but unsampled implementations—especially push subscription wiring—limit how specifically those relationships can be described.

Main entry points: [`lib/content.ts`](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/content.ts) (MDX content access), [`components/ContentPostCard.tsx`](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/ContentPostCard.tsx) (Article card), [`app/[locale]/blog/[slug]/page.tsx`](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/blog/%5Bslug%5D/page.tsx) (Article page), [`components/BlogHome.tsx`](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/BlogHome.tsx) (Feed composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public pages"]
  node_home["Localized home<br/>[page.tsx]"]
  node_article["Article page<br/>[page.tsx]"]
  node_author["Author page<br/>[page.tsx]"]
  node_opinion["Opinion page<br/>[page.tsx]"]
  node_cluster["Cluster page<br/>[page.tsx]"]
  node_rating["Rating page<br/>[page.tsx]"]
  node_sitemap["Sitemap<br/>[sitemap.ts]"]
end

subgraph group_display["Page presentation"]
  node_bloghome["Feed composition<br/>[BlogHome.tsx]"]
  node_header["Site navigation<br/>[SiteHeader.tsx]"]
  node_postcard["Article card"]
  node_feedfilter["Feed filter<br/>[FeedFilter.tsx]"]
  node_hero["Editorial hero<br/>[Hero.tsx]"]
  node_cover["Article cover<br/>[PostCover.tsx]"]
end

subgraph group_content["Editorial content"]
  node_content["MDX content access<br/>[content.ts]"]
  node_schema["Frontmatter validation<br/>[schema.ts]"]
  node_authors[("Author registry<br/>[authors.ts]")]
  node_postdisplay["Post display rules<br/>[post-display.ts]"]
  node_i18n["Locale dictionaries<br/>[i18n.ts]"]
  node_jsonld["Structured metadata<br/>[jsonld.ts]"]
end

subgraph group_engage["Reader engagement"]
  node_pushui["Push controls<br/>[PushSubscribe.tsx]"]
  node_subscribe["Subscribe endpoint<br/>[route.ts]"]
  node_unsubscribe["Unsubscribe endpoint<br/>[route.ts]"]
  node_push["Push service logic<br/>[push.ts]"]
end

node_visitor(("Visitor"))
node_service["AISOLUTION services"]

node_visitor -->|"browses"| node_home
node_visitor -->|"opens"| node_article
node_home -->|"renders"| node_bloghome
node_home -->|"localizes"| node_i18n
node_bloghome -->|"loads feed"| node_content
node_bloghome -->|"renders cards"| node_postcard
node_bloghome -->|"renders filter"| node_feedfilter
node_bloghome -->|"renders hero"| node_hero
node_bloghome -->|"renders header"| node_header
node_article -->|"loads article"| node_content
node_article -->|"resolves byline"| node_authors
node_article -->|"builds graph"| node_jsonld
node_article -->|"renders related cards"| node_postcard
node_article -->|"renders cover"| node_cover
node_article -->|"links service"| node_service
node_author -->|"loads author posts"| node_content
node_author -->|"resolves profile"| node_authors
node_author -->|"builds graph"| node_jsonld
node_author -->|"renders cards"| node_postcard
node_opinion -->|"loads opinions"| node_content
node_opinion -->|"lists authors"| node_authors
node_opinion -->|"builds graph"| node_jsonld
node_opinion -->|"renders cards"| node_postcard
node_cluster -->|"loads cluster posts"| node_content
node_cluster -->|"builds graph"| node_jsonld
node_cluster -->|"renders cards"| node_postcard
node_rating -->|"loads rated posts"| node_content
node_rating -->|"renders cards"| node_postcard
node_sitemap -->|"enumerates posts"| node_content
node_content -->|"validates metadata"| node_schema
node_content -->|"checks authors"| node_authors
node_content -->|"uses display rules"| node_postdisplay
node_content -->|"uses locales"| node_i18n
node_postcard -->|"renders cover"| node_cover
node_postcard -->|"resolves byline"| node_authors
node_postcard -->|"formats post"| node_postdisplay
node_postcard -->|"reads labels"| node_i18n
node_header -->|"shows controls"| node_pushui
node_pushui -.->|"subscribes"| node_subscribe
node_pushui -.->|"unsubscribes"| node_unsubscribe
node_subscribe -->|"delegates"| node_push
node_unsubscribe -->|"delegates"| node_push
node_jsonld -->|"uses profiles"| node_authors

click node_home "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/page.tsx"
click node_article "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/blog/%5Bslug%5D/page.tsx"
click node_author "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/authors/%5Bauthor%5D/page.tsx"
click node_opinion "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/opinion/page.tsx"
click node_cluster "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/cluster/%5Bcluster%5D/page.tsx"
click node_rating "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/rating/page.tsx"
click node_sitemap "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/sitemap.ts"
click node_bloghome "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/BlogHome.tsx"
click node_header "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/SiteHeader.tsx"
click node_postcard "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/ContentPostCard.tsx"
click node_feedfilter "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/FeedFilter.tsx"
click node_hero "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/Hero.tsx"
click node_cover "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/PostCover.tsx"
click node_content "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/content.ts"
click node_schema "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/schema.ts"
click node_authors "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/authors.ts"
click node_postdisplay "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/post-display.ts"
click node_i18n "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/i18n.ts"
click node_jsonld "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/jsonld.ts"
click node_pushui "https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/PushSubscribe.tsx"
click node_subscribe "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/api/push/subscribe/route.ts"
click node_unsubscribe "https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/api/push/unsubscribe/route.ts"
click node_push "https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/push.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_home,node_article,node_author,node_opinion,node_cluster,node_rating,node_sitemap toneBlue
class node_bloghome,node_header,node_postcard,node_feedfilter,node_hero,node_cover toneAmber
class node_content,node_schema,node_authors,node_postdisplay,node_i18n,node_jsonld toneMint
class node_pushui,node_subscribe,node_unsubscribe,node_push toneRose
class node_visitor,node_service toneIndigo
```

## Components

### Public pages

- [Localized home](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/page.tsx): `app/[locale]/page.tsx`
- [Article page](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/blog/%5Bslug%5D/page.tsx): `app/[locale]/blog/[slug]/page.tsx`
- [Author page](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/authors/%5Bauthor%5D/page.tsx): `app/[locale]/authors/[author]/page.tsx`
- [Opinion page](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/opinion/page.tsx): `app/[locale]/opinion/page.tsx`
- [Cluster page](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/cluster/%5Bcluster%5D/page.tsx): `app/[locale]/cluster/[cluster]/page.tsx`
- [Rating page](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/%5Blocale%5D/rating/page.tsx): `app/[locale]/rating/page.tsx`
- [Sitemap](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/sitemap.ts): `app/sitemap.ts`

### Page presentation

- [Feed composition](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/BlogHome.tsx): `components/BlogHome.tsx`
- [Site navigation](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/SiteHeader.tsx): `components/SiteHeader.tsx`
- [Article card](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/ContentPostCard.tsx): `components/ContentPostCard.tsx`
- [Feed filter](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/FeedFilter.tsx): `components/FeedFilter.tsx`
- [Editorial hero](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/Hero.tsx): `components/Hero.tsx`
- [Article cover](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/PostCover.tsx): `components/PostCover.tsx`

### Editorial content

- [MDX content access](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/content.ts): `lib/content.ts`
- [Frontmatter validation](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/schema.ts): `lib/schema.ts`
- [Author registry](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/authors.ts): `lib/authors.ts`
- [Post display rules](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/post-display.ts): `lib/post-display.ts`
- [Locale dictionaries](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/i18n.ts): `lib/i18n.ts`
- [Structured metadata](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/jsonld.ts): `lib/jsonld.ts`

### Reader engagement

- [Push controls](https://github.com/abbos-khamidov/blog-aisolution/blob/main/components/PushSubscribe.tsx): `components/PushSubscribe.tsx`
- [Subscribe endpoint](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/api/push/subscribe/route.ts): `app/api/push/subscribe/route.ts`
- [Unsubscribe endpoint](https://github.com/abbos-khamidov/blog-aisolution/blob/main/app/api/push/unsubscribe/route.ts): `app/api/push/unsubscribe/route.ts`
- [Push service logic](https://github.com/abbos-khamidov/blog-aisolution/blob/main/lib/push.ts): `lib/push.ts`

### Other components

- **Visitor**
- **AISOLUTION services**

## Connections

- Visitor → Localized home: browses
- Visitor → Article page: opens
- Localized home → Feed composition: renders (evidence: `app/[locale]/page.tsx`)
- Localized home → Locale dictionaries: localizes (evidence: `app/[locale]/page.tsx`)
- Feed composition → MDX content access: loads feed (evidence: `components/BlogHome.tsx`)
- Feed composition → Article card: renders cards (evidence: `components/BlogHome.tsx`)
- Feed composition → Feed filter: renders filter (evidence: `components/BlogHome.tsx`)
- Feed composition → Editorial hero: renders hero (evidence: `components/BlogHome.tsx`)
- Feed composition → Site navigation: renders header (evidence: `components/BlogHome.tsx`)
- Article page → MDX content access: loads article (evidence: `app/[locale]/blog/[slug]/page.tsx`)
- Article page → Author registry: resolves byline (evidence: `app/[locale]/blog/[slug]/page.tsx`)
- Article page → Structured metadata: builds graph (evidence: `app/[locale]/blog/[slug]/page.tsx`)
- Article page → Article card: renders related cards (evidence: `app/[locale]/blog/[slug]/page.tsx`)
- Article page → Article cover: renders cover (evidence: `app/[locale]/blog/[slug]/page.tsx`)
- Article page → AISOLUTION services: links service
- Author page → MDX content access: loads author posts (evidence: `app/[locale]/authors/[author]/page.tsx`)
- Author page → Author registry: resolves profile (evidence: `app/[locale]/authors/[author]/page.tsx`)
- Author page → Structured metadata: builds graph (evidence: `app/[locale]/authors/[author]/page.tsx`)
- Author page → Article card: renders cards (evidence: `app/[locale]/authors/[author]/page.tsx`)
- Opinion page → MDX content access: loads opinions (evidence: `app/[locale]/opinion/page.tsx`)
- Opinion page → Author registry: lists authors (evidence: `app/[locale]/opinion/page.tsx`)
- Opinion page → Structured metadata: builds graph (evidence: `app/[locale]/opinion/page.tsx`)
- Opinion page → Article card: renders cards (evidence: `app/[locale]/opinion/page.tsx`)
- Cluster page → MDX content access: loads cluster posts (evidence: `app/[locale]/cluster/[cluster]/page.tsx`)
- Cluster page → Structured metadata: builds graph (evidence: `app/[locale]/cluster/[cluster]/page.tsx`)
- Cluster page → Article card: renders cards (evidence: `app/[locale]/cluster/[cluster]/page.tsx`)
- Rating page → MDX content access: loads rated posts (evidence: `app/[locale]/rating/page.tsx`)
- Rating page → Article card: renders cards (evidence: `app/[locale]/rating/page.tsx`)
- Sitemap → MDX content access: enumerates posts (evidence: `app/sitemap.ts`)
- MDX content access → Frontmatter validation: validates metadata (evidence: `lib/content.ts`)
- MDX content access → Author registry: checks authors (evidence: `lib/content.ts`)
- MDX content access → Post display rules: uses display rules (evidence: `lib/content.ts`)
- MDX content access → Locale dictionaries: uses locales (evidence: `lib/content.ts`)
- Article card → Article cover: renders cover (evidence: `components/ContentPostCard.tsx`)
- Article card → Author registry: resolves byline (evidence: `components/ContentPostCard.tsx`)
- Article card → Post display rules: formats post (evidence: `components/ContentPostCard.tsx`)
- Article card → Locale dictionaries: reads labels (evidence: `components/ContentPostCard.tsx`)
- Site navigation → Push controls: shows controls (evidence: `components/SiteHeader.tsx`)
- Push controls → Subscribe endpoint: subscribes
- Push controls → Unsubscribe endpoint: unsubscribes
- Subscribe endpoint → Push service logic: delegates (evidence: `app/api/push/subscribe/route.ts`)
- Unsubscribe endpoint → Push service logic: delegates (evidence: `app/api/push/unsubscribe/route.ts`)
- Structured metadata → Author registry: uses profiles (evidence: `lib/jsonld.ts`)
