# islych/islynews architecture

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

- Interactive diagram: https://gitdiagram.com/islych/islynews
- Repository: https://github.com/islych/islynews

## Overview

Isly News is a reader-facing news platform with local journalism, external-news aggregation, and AI-assisted reading. The main reader flow opens the external-news feed, searches or filters stories, and can view analysis or save a story; journalist and administrator workflows add article submission and review. This map covers the Angular client shown in the tree. The README documents backend capabilities, but backend source is absent, so those server-side stages are represented only as an API boundary; unsampled UI relationships are not inferred.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/islych/islynews/blob/main/frontend/src/app/app.routes.ts) (Route map), [`frontend/src/app/features/external-news/external-news.component.ts`](https://github.com/islych/islynews/blob/main/frontend/src/app/features/external-news/external-news.component.ts) (External news feed), [`frontend/src/app/core/services/article.service.ts`](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/article.service.ts) (Article API client), [`frontend/src/app/features/articles/article-detail/unified-article-detail.ts`](https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/article-detail/unified-article-detail.ts) (Unified article detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_app_shell["App shell<br/>[app.ts]"]
  node_routes["Route map<br/>[app.routes.ts]"]
  node_navbar["Navigation and alerts<br/>[navbar.ts]"]
end

subgraph group_news["News and publishing"]
  node_external_feed["External news feed"]
  node_external_detail["External story detail"]
  node_article_detail["Unified article detail"]
  node_article_editor["Article authoring<br/>[create-article.ts]"]
  node_my_articles["My articles<br/>[my-articles.ts]"]
  node_admin_console["Editorial administration<br/>[admin.ts]"]
  node_saved_page["Saved articles<br/>[saved.ts]"]
  node_article_card["Article card<br/>[article-card.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_pages["Sign-in and registration<br/>[login.ts]"]
  node_registration["Registration verification<br/>[verify-email.ts]"]
end

subgraph group_services["Client services"]
  node_auth_service["Authentication state<br/>[auth.service.ts]"]
  node_article_service["Article API client<br/>[article.service.ts]"]
  node_news_service["External news and AI client"]
  node_saved_service["Saved article client"]
  node_user_service["User API client<br/>[user.service.ts]"]
  node_comment_service["Comment API client<br/>[comment.service.ts]"]
  node_like_service["Like API client<br/>[like.service.ts]"]
  node_notification_service["Notification client"]
  node_imported_service["Imported article client"]
  node_admin_service["Admin API client<br/>[admin.service.ts]"]
end

node_reader(("Reader"))
node_journalist(("Journalist"))
node_admin_user(("Administrator"))
node_api["Spring REST API"]

node_app_shell -->|"renders"| node_navbar
node_app_shell -->|"hosts routes"| node_routes
node_routes -->|"routes to"| node_external_feed
node_routes -->|"routes to"| node_external_detail
node_routes -->|"routes to"| node_article_detail
node_routes -->|"routes to"| node_article_editor
node_routes -->|"routes to"| node_my_articles
node_routes -->|"routes to"| node_admin_console
node_routes -->|"routes to"| node_saved_page
node_routes -->|"routes to"| node_auth_pages
node_routes -->|"routes to"| node_registration
node_reader -->|"browses"| node_external_feed
node_journalist -->|"authors"| node_article_editor
node_admin_user -->|"manages"| node_admin_console
node_auth_pages -->|"authenticates"| node_auth_service
node_registration -->|"verifies registration"| node_auth_service
node_navbar -->|"reads session"| node_auth_service
node_navbar -->|"loads alerts"| node_notification_service
node_external_feed -->|"searches and analyzes"| node_news_service
node_external_feed -->|"loads local stories"| node_article_service
node_external_feed -->|"checks saved status"| node_saved_service
node_external_detail -->|"loads story"| node_news_service
node_article_detail -->|"loads article"| node_article_service
node_article_detail -->|"manages comments"| node_comment_service
node_article_detail -->|"manages likes"| node_like_service
node_article_detail -->|"toggles saved"| node_saved_service
node_article_editor -->|"creates article"| node_article_service
node_my_articles -->|"manages articles"| node_article_service
node_my_articles -->|"loads profile"| node_user_service
node_admin_console -->|"loads admin data"| node_admin_service
node_admin_console -->|"manages users"| node_user_service
node_admin_console -->|"reviews articles"| node_article_service
node_saved_page -->|"loads saved stories"| node_saved_service
node_saved_page -->|"loads imports"| node_imported_service
node_external_feed -->|"displays stories"| node_article_card
node_saved_page -->|"displays stories"| node_article_card
node_auth_service -->|"HTTP requests"| node_api
node_article_service -->|"HTTP requests"| node_api
node_news_service -->|"HTTP requests"| node_api
node_saved_service -->|"HTTP requests"| node_api
node_user_service -->|"HTTP requests"| node_api
node_comment_service -->|"HTTP requests"| node_api
node_like_service -->|"HTTP requests"| node_api
node_notification_service -->|"HTTP requests"| node_api
node_imported_service -->|"HTTP requests"| node_api
node_admin_service -->|"HTTP requests"| node_api

click node_app_shell "https://github.com/islych/islynews/blob/main/frontend/src/app/app.ts"
click node_routes "https://github.com/islych/islynews/blob/main/frontend/src/app/app.routes.ts"
click node_navbar "https://github.com/islych/islynews/blob/main/frontend/src/app/layout/navbar/navbar.ts"
click node_external_feed "https://github.com/islych/islynews/blob/main/frontend/src/app/features/external-news/external-news.component.ts"
click node_external_detail "https://github.com/islych/islynews/blob/main/frontend/src/app/features/external-news/external-news-detail.component.ts"
click node_article_detail "https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/article-detail/unified-article-detail.ts"
click node_article_editor "https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/create-article/create-article.ts"
click node_my_articles "https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/my-articles/my-articles.ts"
click node_admin_console "https://github.com/islych/islynews/blob/main/frontend/src/app/features/admin/admin.ts"
click node_saved_page "https://github.com/islych/islynews/blob/main/frontend/src/app/features/saved/saved.ts"
click node_article_card "https://github.com/islych/islynews/blob/main/frontend/src/app/shared/article-card/article-card.ts"
click node_auth_pages "https://github.com/islych/islynews/blob/main/frontend/src/app/features/auth/login/login.ts"
click node_registration "https://github.com/islych/islynews/blob/main/frontend/src/app/features/auth/verify-email/verify-email.ts"
click node_auth_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/auth.service.ts"
click node_article_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/article.service.ts"
click node_news_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/external-news.service.ts"
click node_saved_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/saved-article.service.ts"
click node_user_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/user.service.ts"
click node_comment_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/comment.service.ts"
click node_like_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/like.service.ts"
click node_notification_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/notification.service.ts"
click node_imported_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/imported-article.service.ts"
click node_admin_service "https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/admin.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_app_shell,node_routes,node_navbar toneBlue
class node_external_feed,node_external_detail,node_article_detail,node_article_editor,node_my_articles,node_admin_console,node_saved_page,node_article_card toneAmber
class node_auth_pages,node_registration,node_api toneMint
class node_auth_service,node_article_service,node_news_service,node_saved_service,node_user_service,node_comment_service,node_like_service,node_notification_service,node_imported_service,node_admin_service toneRose
class node_reader,node_journalist,node_admin_user toneIndigo
```

## Components

### App navigation

- [App shell](https://github.com/islych/islynews/blob/main/frontend/src/app/app.ts): `frontend/src/app/app.ts`
- [Route map](https://github.com/islych/islynews/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Navigation and alerts](https://github.com/islych/islynews/blob/main/frontend/src/app/layout/navbar/navbar.ts): `frontend/src/app/layout/navbar/navbar.ts`

### News and publishing

- [External news feed](https://github.com/islych/islynews/blob/main/frontend/src/app/features/external-news/external-news.component.ts): `frontend/src/app/features/external-news/external-news.component.ts`
- [External story detail](https://github.com/islych/islynews/blob/main/frontend/src/app/features/external-news/external-news-detail.component.ts): `frontend/src/app/features/external-news/external-news-detail.component.ts`
- [Unified article detail](https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/article-detail/unified-article-detail.ts): `frontend/src/app/features/articles/article-detail/unified-article-detail.ts`
- [Article authoring](https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/create-article/create-article.ts): `frontend/src/app/features/articles/create-article/create-article.ts`
- [My articles](https://github.com/islych/islynews/blob/main/frontend/src/app/features/articles/my-articles/my-articles.ts): `frontend/src/app/features/articles/my-articles/my-articles.ts`
- [Editorial administration](https://github.com/islych/islynews/blob/main/frontend/src/app/features/admin/admin.ts): `frontend/src/app/features/admin/admin.ts`
- [Saved articles](https://github.com/islych/islynews/blob/main/frontend/src/app/features/saved/saved.ts): `frontend/src/app/features/saved/saved.ts`
- [Article card](https://github.com/islych/islynews/blob/main/frontend/src/app/shared/article-card/article-card.ts): `frontend/src/app/shared/article-card/article-card.ts`

### Identity and access

- [Sign-in and registration](https://github.com/islych/islynews/blob/main/frontend/src/app/features/auth/login/login.ts): `frontend/src/app/features/auth/login/login.ts`
- [Registration verification](https://github.com/islych/islynews/blob/main/frontend/src/app/features/auth/verify-email/verify-email.ts): `frontend/src/app/features/auth/verify-email/verify-email.ts`

### Client services

- [Authentication state](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/auth.service.ts): `frontend/src/app/core/services/auth.service.ts`
- [Article API client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/article.service.ts): `frontend/src/app/core/services/article.service.ts`
- [External news and AI client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/external-news.service.ts): `frontend/src/app/core/services/external-news.service.ts`
- [Saved article client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/saved-article.service.ts): `frontend/src/app/core/services/saved-article.service.ts`
- [User API client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/user.service.ts): `frontend/src/app/core/services/user.service.ts`
- [Comment API client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/comment.service.ts): `frontend/src/app/core/services/comment.service.ts`
- [Like API client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/like.service.ts): `frontend/src/app/core/services/like.service.ts`
- [Notification client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/notification.service.ts): `frontend/src/app/core/services/notification.service.ts`
- [Imported article client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/imported-article.service.ts): `frontend/src/app/core/services/imported-article.service.ts`
- [Admin API client](https://github.com/islych/islynews/blob/main/frontend/src/app/core/services/admin.service.ts): `frontend/src/app/core/services/admin.service.ts`

### Other components

- **Reader**
- **Journalist**
- **Administrator**
- **Spring REST API**

## Connections

- App shell → Navigation and alerts: renders (evidence: `frontend/src/app/app.ts`)
- App shell → Route map: hosts routes (evidence: `frontend/src/app/app.ts`)
- Route map → External news feed: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → External story detail: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → Unified article detail: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → Article authoring: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → My articles: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → Editorial administration: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → Saved articles: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → Sign-in and registration: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Route map → Registration verification: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Reader → External news feed: browses
- Journalist → Article authoring: authors
- Administrator → Editorial administration: manages
- Sign-in and registration → Authentication state: authenticates (evidence: `frontend/src/app/core/services/auth.service.ts`)
- Registration verification → Authentication state: verifies registration (evidence: `frontend/src/app/core/services/auth.service.ts`)
- Navigation and alerts → Authentication state: reads session (evidence: `frontend/src/app/layout/navbar/navbar.ts`)
- Navigation and alerts → Notification client: loads alerts (evidence: `frontend/src/app/layout/navbar/navbar.ts`)
- External news feed → External news and AI client: searches and analyzes (evidence: `frontend/src/app/features/external-news/external-news.component.ts`)
- External news feed → Article API client: loads local stories (evidence: `frontend/src/app/features/external-news/external-news.component.ts`)
- External news feed → Saved article client: checks saved status (evidence: `frontend/src/app/features/external-news/external-news.component.ts`)
- External story detail → External news and AI client: loads story (evidence: `frontend/src/app/features/external-news/external-news-detail.component.ts`)
- Unified article detail → Article API client: loads article (evidence: `frontend/src/app/features/articles/article-detail/unified-article-detail.ts`)
- Unified article detail → Comment API client: manages comments (evidence: `frontend/src/app/features/articles/article-detail/unified-article-detail.ts`)
- Unified article detail → Like API client: manages likes (evidence: `frontend/src/app/features/articles/article-detail/unified-article-detail.ts`)
- Unified article detail → Saved article client: toggles saved (evidence: `frontend/src/app/features/articles/article-detail/unified-article-detail.ts`)
- Article authoring → Article API client: creates article (evidence: `frontend/src/app/features/articles/create-article/create-article.ts`)
- My articles → Article API client: manages articles (evidence: `frontend/src/app/features/articles/my-articles/my-articles.ts`)
- My articles → User API client: loads profile (evidence: `frontend/src/app/features/articles/my-articles/my-articles.ts`)
- Editorial administration → Admin API client: loads admin data (evidence: `frontend/src/app/features/admin/admin.ts`)
- Editorial administration → User API client: manages users (evidence: `frontend/src/app/features/admin/admin.ts`)
- Editorial administration → Article API client: reviews articles (evidence: `frontend/src/app/features/admin/admin.ts`)
- Saved articles → Saved article client: loads saved stories (evidence: `frontend/src/app/features/saved/saved.ts`)
- Saved articles → Imported article client: loads imports (evidence: `frontend/src/app/features/saved/saved.ts`)
- External news feed → Article card: displays stories (evidence: `frontend/src/app/features/external-news/external-news.component.ts`)
- Saved articles → Article card: displays stories (evidence: `frontend/src/app/features/saved/saved.ts`)
- Authentication state → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/auth.service.ts`)
- Article API client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/article.service.ts`)
- External news and AI client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/external-news.service.ts`)
- Saved article client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/saved-article.service.ts`)
- User API client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/user.service.ts`)
- Comment API client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/comment.service.ts`)
- Like API client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/like.service.ts`)
- Notification client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/notification.service.ts`)
- Imported article client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/imported-article.service.ts`)
- Admin API client → Spring REST API: HTTP requests (evidence: `frontend/src/app/core/services/admin.service.ts`)
