# ali-ncibi/wassla-app architecture

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

- Interactive diagram: https://gitdiagram.com/ali-ncibi/wassla-app
- Repository: https://github.com/ali-ncibi/wassla-app
- Video tour (about a minute): https://gitdiagram.com/ali-ncibi/wassla-app/video

## Overview

Wassla ingests RSS articles, processes them through a multi-agent translation and quality pipeline, stores multilingual content and vectors, then serves a trilingual reader and semantic search with cited answers. The graph also preserves article, search, and stats API branches plus tracing and offline evaluation. Relationships among sampled pipeline modules are grounded in excerpts; frontend and some service connections rely on README documentation, since their source excerpts were not provided.

Main entry points: [`pipeline/app/graph/pipeline.py`](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/pipeline.py) (Article Graph), [`web/server/api/[...].ts`](https://github.com/ali-ncibi/wassla-app/blob/main/web/server/api/%5B...%5D.ts) (API Proxy), [`pipeline/app/repo.py`](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/repo.py) (Repository), [`pipeline/app/providers/__init__.py`](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/providers/__init__.py) (LLM Providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["RSS Ingestion"]
  node_ingest_api["Ingest API<br/>[ingest.py]"]
  node_feed_fetch["Feed Fetcher<br/>[feeds.py]"]
  node_outer_graph["Ingest Graph<br/>[pipeline.py]"]
end

subgraph group_processing["Article Processing"]
  node_article_graph["Article Graph<br/>[pipeline.py]"]
  node_translate["Translation<br/>[nodes.py]"]
  node_categorize["Categorization<br/>[nodes.py]"]
  node_summarize["Summarization<br/>[nodes.py]"]
  node_evaluate["Quality Evaluation<br/>[nodes.py]"]
  node_embed["Embedding<br/>[nodes.py]"]
  node_prompts["Task Prompts<br/>[prompts.py]"]
  node_providers["LLM Providers<br/>[__init__.py]"]
  node_embedding_provider["Embedding Provider<br/>[embeddings.py]"]
end

subgraph group_data_api["Storage and API"]
  node_article_api["Article API<br/>[articles.py]"]
  node_search_api["Search API<br/>[search.py]"]
  node_meta_api["Metadata API<br/>[meta.py]"]
  node_rag["RAG Search<br/>[rag.py]"]
  node_repository["Repository<br/>[repo.py]"]
  node_postgres[("PostgreSQL + pgvector")]
end

subgraph group_web["Reader and Search"]
  node_web_pages["Reader Pages<br/>[index.vue]"]
  node_article_page["Article Page<br/>[&#91;id&#93;.vue]"]
  node_search_page["Search Page<br/>[search.vue]"]
  node_stats_page["Stats Page<br/>[stats.vue]"]
  node_web_proxy["API Proxy<br/>[&#91;...&#93;.ts]"]
end

subgraph group_ops["Tracing and Evaluation"]
  node_phoenix["Phoenix"]
  node_evals["Offline Evaluations<br/>[run_evals.py]"]
end

node_reader(("Reader"))

node_reader -->|"browses"| node_web_pages
node_reader -->|"searches"| node_search_page
node_web_pages -.->|"requests data"| node_web_proxy
node_article_page -.->|"requests article"| node_web_proxy
node_search_page -.->|"submits query"| node_web_proxy
node_stats_page -.->|"requests stats"| node_web_proxy
node_web_proxy -->|"proxies requests"| node_article_api
node_web_proxy -->|"proxies requests"| node_search_api
node_web_proxy -->|"proxies requests"| node_meta_api
node_reader -.->|"triggers ingest"| node_ingest_api
node_ingest_api -->|"invokes"| node_outer_graph
node_outer_graph -->|"fetches items"| node_feed_fetch
node_outer_graph -->|"dispatches articles"| node_article_graph
node_article_graph -->|"runs first"| node_translate
node_article_graph -->|"runs next"| node_categorize
node_article_graph -->|"runs next"| node_summarize
node_article_graph -->|"runs next"| node_evaluate
node_article_graph -->|"runs next"| node_embed
node_translate -->|"builds messages"| node_prompts
node_categorize -->|"builds messages"| node_prompts
node_summarize -->|"builds messages"| node_prompts
node_evaluate -->|"builds messages"| node_prompts
node_translate -->|"calls model"| node_providers
node_categorize -->|"calls model"| node_providers
node_summarize -->|"calls model"| node_providers
node_evaluate -->|"calls model"| node_providers
node_embed -->|"creates vectors"| node_embedding_provider
node_article_graph -->|"persists results"| node_repository
node_repository -->|"reads and writes"| node_postgres
node_feed_fetch -->|"reads sources"| node_postgres
node_article_api -->|"reads articles"| node_repository
node_meta_api -->|"reads metadata"| node_repository
node_search_api -->|"runs search"| node_rag
node_rag -->|"retrieves matches"| node_repository
node_rag -->|"embeds query"| node_embedding_provider
node_rag -->|"generates answer"| node_providers
node_evals -->|"replays articles"| node_article_graph
node_evals -->|"stores experiments"| node_phoenix
node_outer_graph -.->|"traces runs"| node_phoenix

click node_ingest_api "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/ingest.py"
click node_feed_fetch "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/feeds.py"
click node_outer_graph "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/pipeline.py"
click node_article_graph "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/pipeline.py"
click node_translate "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py"
click node_categorize "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py"
click node_summarize "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py"
click node_evaluate "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py"
click node_embed "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py"
click node_prompts "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/prompts.py"
click node_providers "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/providers/__init__.py"
click node_embedding_provider "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/providers/embeddings.py"
click node_article_api "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/articles.py"
click node_search_api "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/search.py"
click node_meta_api "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/meta.py"
click node_rag "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/rag.py"
click node_repository "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/repo.py"
click node_web_pages "https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/index.vue"
click node_article_page "https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/article/%5Bid%5D.vue"
click node_search_page "https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/search.vue"
click node_stats_page "https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/stats.vue"
click node_web_proxy "https://github.com/ali-ncibi/wassla-app/blob/main/web/server/api/%5B...%5D.ts"
click node_evals "https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/evals/run_evals.py"

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_ingest_api,node_feed_fetch,node_outer_graph toneBlue
class node_article_graph,node_translate,node_categorize,node_summarize,node_evaluate,node_embed,node_prompts,node_providers,node_embedding_provider toneAmber
class node_article_api,node_search_api,node_meta_api,node_rag,node_repository,node_postgres toneMint
class node_web_pages,node_article_page,node_search_page,node_stats_page,node_web_proxy toneRose
class node_phoenix,node_evals,node_reader toneIndigo
```

## Components

### RSS Ingestion

- [Ingest API](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/ingest.py): `pipeline/app/routes/ingest.py`
- [Feed Fetcher](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/feeds.py): `pipeline/app/feeds.py`
- [Ingest Graph](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/pipeline.py): `pipeline/app/graph/pipeline.py`

### Article Processing

- [Article Graph](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/pipeline.py): `pipeline/app/graph/pipeline.py`
- [Translation](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py): `pipeline/app/graph/nodes.py`
- [Categorization](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py): `pipeline/app/graph/nodes.py`
- [Summarization](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py): `pipeline/app/graph/nodes.py`
- [Quality Evaluation](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py): `pipeline/app/graph/nodes.py`
- [Embedding](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/nodes.py): `pipeline/app/graph/nodes.py`
- [Task Prompts](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/graph/prompts.py): `pipeline/app/graph/prompts.py`
- [LLM Providers](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/providers/__init__.py): `pipeline/app/providers/__init__.py`
- [Embedding Provider](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/providers/embeddings.py): `pipeline/app/providers/embeddings.py`

### Storage and API

- [Article API](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/articles.py): `pipeline/app/routes/articles.py`
- [Search API](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/search.py): `pipeline/app/routes/search.py`
- [Metadata API](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/routes/meta.py): `pipeline/app/routes/meta.py`
- [RAG Search](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/rag.py): `pipeline/app/rag.py`
- [Repository](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/app/repo.py): `pipeline/app/repo.py`
- **PostgreSQL + pgvector**

### Reader and Search

- [Reader Pages](https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/index.vue): `web/app/pages/index.vue`
- [Article Page](https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/article/%5Bid%5D.vue): `web/app/pages/article/[id].vue`
- [Search Page](https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/search.vue): `web/app/pages/search.vue`
- [Stats Page](https://github.com/ali-ncibi/wassla-app/blob/main/web/app/pages/stats.vue): `web/app/pages/stats.vue`
- [API Proxy](https://github.com/ali-ncibi/wassla-app/blob/main/web/server/api/%5B...%5D.ts): `web/server/api/[...].ts`

### Tracing and Evaluation

- **Phoenix**
- [Offline Evaluations](https://github.com/ali-ncibi/wassla-app/blob/main/pipeline/evals/run_evals.py): `pipeline/evals/run_evals.py`

### Other components

- **Reader**

## Connections

- Reader → Reader Pages: browses (evidence: `README.md`)
- Reader → Search Page: searches (evidence: `README.md`)
- Reader Pages → API Proxy: requests data
- Article Page → API Proxy: requests article
- Search Page → API Proxy: submits query
- Stats Page → API Proxy: requests stats
- API Proxy → Article API: proxies requests (evidence: `README.md`)
- API Proxy → Search API: proxies requests (evidence: `README.md`)
- API Proxy → Metadata API: proxies requests (evidence: `README.md`)
- Reader → Ingest API: triggers ingest
- Ingest API → Ingest Graph: invokes (evidence: `pipeline/app/routes/ingest.py`)
- Ingest Graph → Feed Fetcher: fetches items (evidence: `pipeline/app/graph/pipeline.py`)
- Ingest Graph → Article Graph: dispatches articles (evidence: `pipeline/app/graph/pipeline.py`)
- Article Graph → Translation: runs first (evidence: `pipeline/app/graph/pipeline.py`)
- Article Graph → Categorization: runs next (evidence: `pipeline/app/graph/pipeline.py`)
- Article Graph → Summarization: runs next (evidence: `pipeline/app/graph/pipeline.py`)
- Article Graph → Quality Evaluation: runs next (evidence: `pipeline/app/graph/pipeline.py`)
- Article Graph → Embedding: runs next (evidence: `pipeline/app/graph/pipeline.py`)
- Translation → Task Prompts: builds messages (evidence: `pipeline/app/graph/nodes.py`)
- Categorization → Task Prompts: builds messages (evidence: `pipeline/app/graph/nodes.py`)
- Summarization → Task Prompts: builds messages (evidence: `pipeline/app/graph/nodes.py`)
- Quality Evaluation → Task Prompts: builds messages (evidence: `pipeline/app/graph/nodes.py`)
- Translation → LLM Providers: calls model (evidence: `pipeline/app/graph/nodes.py`)
- Categorization → LLM Providers: calls model (evidence: `pipeline/app/graph/nodes.py`)
- Summarization → LLM Providers: calls model (evidence: `pipeline/app/graph/nodes.py`)
- Quality Evaluation → LLM Providers: calls model (evidence: `pipeline/app/graph/nodes.py`)
- Embedding → Embedding Provider: creates vectors (evidence: `pipeline/app/graph/nodes.py`)
- Article Graph → Repository: persists results
- Repository → PostgreSQL + pgvector: reads and writes (evidence: `pipeline/app/repo.py`)
- Feed Fetcher → PostgreSQL + pgvector: reads sources (evidence: `pipeline/app/feeds.py`)
- Article API → Repository: reads articles (evidence: `pipeline/app/routes/articles.py`)
- Metadata API → Repository: reads metadata (evidence: `pipeline/app/routes/meta.py`)
- Search API → RAG Search: runs search (evidence: `pipeline/app/routes/search.py`)
- RAG Search → Repository: retrieves matches (evidence: `pipeline/app/rag.py`)
- RAG Search → Embedding Provider: embeds query (evidence: `pipeline/app/rag.py`)
- RAG Search → LLM Providers: generates answer (evidence: `pipeline/app/rag.py`)
- Offline Evaluations → Article Graph: replays articles (evidence: `pipeline/evals/run_evals.py`)
- Offline Evaluations → Phoenix: stores experiments (evidence: `pipeline/evals/run_evals.py`)
- Ingest Graph → Phoenix: traces runs (evidence: `README.md`)
