# kadir-yilmaz/wordstation architecture

> Architecture diagram of the GitHub repository kadir-yilmaz/wordstation, 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/kadir-yilmaz/wordstation
- Repository: https://github.com/kadir-yilmaz/wordstation

## Overview

WordStation is a word-learning application with an ASP.NET MVC web UI backed by a separate Web API and layered business/data services. The main user workflow is browsing and studying words; the UI also exposes daily-word study and authentication, while the API includes quiz-history capabilities. The API’s registration and sampled controller/service relationships are visible in the excerpts and SOURCE INDEX. Some unsampled controller and UI wiring is shown as unverified rather than inferred as a confirmed call.

Main entry points: [`WordStation.DAL/AppDbContext.cs`](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/AppDbContext.cs) (Application database), [`WordStation.WebAPI/Program.cs`](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Program.cs) (Web API), [`WordStation.BLL/Concrete/DailyWordService.cs`](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/DailyWordService.cs) (Daily-word service), [`WordStation.WebAPI/Controllers/WordsController.cs`](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/WordsController.cs) (Word endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_webui["Web interface"]
  node_ui_words["Word pages<br/>[WordController.cs]"]
  node_ui_daily["Daily study pages"]
  node_ui_account["Account pages"]
  node_ui_word_client["Word API client<br/>[WordApiService.cs]"]
  node_ui_daily_client["Daily API client"]
  node_ui_auth_client["Auth API client<br/>[AuthApiService.cs]"]
end

subgraph group_api["HTTP API"]
  node_web_api["Web API<br/>[Program.cs]"]
  node_api_words["Word endpoints<br/>[WordsController.cs]"]
  node_api_daily["Daily endpoints"]
  node_api_auth["Auth endpoints<br/>[AuthController.cs]"]
  node_api_quiz["Quiz history endpoints"]
end

subgraph group_business["Business services"]
  node_auth_service["Authentication<br/>[AuthService.cs]"]
  node_word_service["Word service<br/>[WordService.cs]"]
  node_daily_service["Daily-word service"]
  node_quiz_service["Quiz-history service"]
end

subgraph group_data["Persistence"]
  node_word_repo["Word repository<br/>[WordRepository.cs]"]
  node_daily_repo["Daily-word repository"]
  node_quiz_repo["Quiz-history repository"]
  node_token_repo["Refresh-token repository"]
  node_db[("Application database<br/>[AppDbContext.cs]")]
end

node_learner(("Learner"))
node_sqlserver[("SQL Server")]

node_learner -->|"uses"| node_ui_words
node_ui_words -->|"requests words"| node_ui_word_client
node_ui_daily -->|"requests study data"| node_ui_daily_client
node_ui_account -.->|"uses"| node_ui_auth_client
node_ui_word_client -.->|"HTTP requests"| node_api_words
node_ui_daily_client -.->|"HTTP requests"| node_api_daily
node_ui_auth_client -->|"posts auth requests"| node_api_auth
node_web_api -->|"maps controllers"| node_api_words
node_web_api -->|"maps controllers"| node_api_daily
node_web_api -->|"maps controllers"| node_api_auth
node_api_words -->|"calls"| node_word_service
node_api_daily -->|"calls"| node_daily_service
node_api_auth -->|"calls"| node_auth_service
node_api_quiz -.->|"calls"| node_quiz_service
node_web_api -->|"maps controllers"| node_api_quiz
node_word_service -->|"uses repository"| node_word_repo
node_daily_service -->|"uses repository"| node_daily_repo
node_daily_service -->|"reads words"| node_word_repo
node_quiz_service -->|"uses repository"| node_quiz_repo
node_auth_service -->|"reads and writes tokens"| node_token_repo
node_web_api -->|"configures context"| node_db
node_word_repo -->|"uses context"| node_db
node_quiz_repo -->|"uses context"| node_db
node_daily_repo -.->|"uses context"| node_db
node_token_repo -.->|"uses context"| node_db
node_db -->|"stores data"| node_sqlserver

click node_ui_words "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Controllers/WordController.cs"
click node_ui_daily "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Controllers/DailyWordController.cs"
click node_ui_account "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Controllers/AccountController.cs"
click node_ui_word_client "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Services/Concrete/WordApiService.cs"
click node_ui_daily_client "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Services/Concrete/DailyWordApiService.cs"
click node_ui_auth_client "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Services/Concrete/AuthApiService.cs"
click node_web_api "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Program.cs"
click node_api_words "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/WordsController.cs"
click node_api_daily "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/DailyWordController.cs"
click node_api_auth "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/AuthController.cs"
click node_api_quiz "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/QuizHistoryController.cs"
click node_auth_service "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/AuthService.cs"
click node_word_service "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/WordService.cs"
click node_daily_service "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/DailyWordService.cs"
click node_quiz_service "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/QuizHistoryService.cs"
click node_word_repo "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/WordRepository.cs"
click node_daily_repo "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/DailyWordRepository.cs"
click node_quiz_repo "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/QuizHistoryRepository.cs"
click node_token_repo "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/RefreshTokenRepository.cs"
click node_db "https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/AppDbContext.cs"

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_ui_words,node_ui_daily,node_ui_account,node_ui_word_client,node_ui_daily_client,node_ui_auth_client toneBlue
class node_web_api,node_api_words,node_api_daily,node_api_auth,node_api_quiz,node_sqlserver toneAmber
class node_auth_service,node_word_service,node_daily_service,node_quiz_service toneMint
class node_word_repo,node_daily_repo,node_quiz_repo,node_token_repo,node_db toneRose
class node_learner toneIndigo
```

## Components

### Web interface

- [Word pages](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Controllers/WordController.cs): `WordStation.WebUI/Controllers/WordController.cs`
- [Daily study pages](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Controllers/DailyWordController.cs): `WordStation.WebUI/Controllers/DailyWordController.cs`
- [Account pages](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Controllers/AccountController.cs): `WordStation.WebUI/Controllers/AccountController.cs`
- [Word API client](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Services/Concrete/WordApiService.cs): `WordStation.WebUI/Services/Concrete/WordApiService.cs`
- [Daily API client](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Services/Concrete/DailyWordApiService.cs): `WordStation.WebUI/Services/Concrete/DailyWordApiService.cs`
- [Auth API client](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebUI/Services/Concrete/AuthApiService.cs): `WordStation.WebUI/Services/Concrete/AuthApiService.cs`

### HTTP API

- [Web API](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Program.cs): `WordStation.WebAPI/Program.cs`
- [Word endpoints](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/WordsController.cs): `WordStation.WebAPI/Controllers/WordsController.cs`
- [Daily endpoints](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/DailyWordController.cs): `WordStation.WebAPI/Controllers/DailyWordController.cs`
- [Auth endpoints](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/AuthController.cs): `WordStation.WebAPI/Controllers/AuthController.cs`
- [Quiz history endpoints](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.WebAPI/Controllers/QuizHistoryController.cs): `WordStation.WebAPI/Controllers/QuizHistoryController.cs`

### Business services

- [Authentication](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/AuthService.cs): `WordStation.BLL/Concrete/AuthService.cs`
- [Word service](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/WordService.cs): `WordStation.BLL/Concrete/WordService.cs`
- [Daily-word service](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/DailyWordService.cs): `WordStation.BLL/Concrete/DailyWordService.cs`
- [Quiz-history service](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.BLL/Concrete/QuizHistoryService.cs): `WordStation.BLL/Concrete/QuizHistoryService.cs`

### Persistence

- [Word repository](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/WordRepository.cs): `WordStation.DAL/EFCore/WordRepository.cs`
- [Daily-word repository](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/DailyWordRepository.cs): `WordStation.DAL/EFCore/DailyWordRepository.cs`
- [Quiz-history repository](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/QuizHistoryRepository.cs): `WordStation.DAL/EFCore/QuizHistoryRepository.cs`
- [Refresh-token repository](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/EFCore/RefreshTokenRepository.cs): `WordStation.DAL/EFCore/RefreshTokenRepository.cs`
- [Application database](https://github.com/kadir-yilmaz/wordstation/blob/main/WordStation.DAL/AppDbContext.cs): `WordStation.DAL/AppDbContext.cs`

### Other components

- **Learner**
- **SQL Server**

## Connections

- Learner → Word pages: uses
- Word pages → Word API client: requests words (evidence: `WordStation.WebUI/Controllers/WordController.cs`)
- Daily study pages → Daily API client: requests study data (evidence: `WordStation.WebUI/Controllers/DailyWordController.cs`)
- Account pages → Auth API client: uses
- Word API client → Word endpoints: HTTP requests
- Daily API client → Daily endpoints: HTTP requests
- Auth API client → Auth endpoints: posts auth requests (evidence: `WordStation.WebUI/Services/Concrete/AuthApiService.cs`)
- Web API → Word endpoints: maps controllers (evidence: `WordStation.WebAPI/Program.cs`)
- Web API → Daily endpoints: maps controllers (evidence: `WordStation.WebAPI/Program.cs`)
- Web API → Auth endpoints: maps controllers (evidence: `WordStation.WebAPI/Program.cs`)
- Word endpoints → Word service: calls (evidence: `WordStation.WebAPI/Controllers/WordsController.cs`)
- Daily endpoints → Daily-word service: calls (evidence: `WordStation.WebAPI/Controllers/DailyWordController.cs`)
- Auth endpoints → Authentication: calls (evidence: `WordStation.WebAPI/Controllers/AuthController.cs`)
- Quiz history endpoints → Quiz-history service: calls
- Web API → Quiz history endpoints: maps controllers (evidence: `WordStation.WebAPI/Program.cs`)
- Word service → Word repository: uses repository (evidence: `WordStation.BLL/Concrete/WordService.cs`)
- Daily-word service → Daily-word repository: uses repository (evidence: `WordStation.BLL/Concrete/DailyWordService.cs`)
- Daily-word service → Word repository: reads words (evidence: `WordStation.BLL/Concrete/DailyWordService.cs`)
- Quiz-history service → Quiz-history repository: uses repository (evidence: `WordStation.BLL/Concrete/QuizHistoryService.cs`)
- Authentication → Refresh-token repository: reads and writes tokens (evidence: `WordStation.BLL/Concrete/AuthService.cs`)
- Web API → Application database: configures context (evidence: `WordStation.WebAPI/Program.cs`)
- Word repository → Application database: uses context (evidence: `WordStation.DAL/EFCore/WordRepository.cs`)
- Quiz-history repository → Application database: uses context (evidence: `WordStation.DAL/EFCore/QuizHistoryRepository.cs`)
- Daily-word repository → Application database: uses context
- Refresh-token repository → Application database: uses context
- Application database → SQL Server: stores data
