# qingtian1927/w architecture

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

- Interactive diagram: https://gitdiagram.com/qingtian1927/w
- Repository: https://github.com/qingtian1927/w

## Overview

W is a Spring Boot social-network application modeled on X. The principal workflow is a user creating or browsing posts, then interacting through follows, likes, comments, reposts, bookmarks, and notifications; profile management and search provide adjacent workflows. The graph groups related controllers and service domains while retaining search, administration, authentication, and persistence as distinct responsibilities. Some controller-to-service relationships are visible in the source index; other capability links are documented by the README. Unsampled implementation details are represented only at their enclosing directory level.

Main entry points: [`src/main/java/com/github/qingtian1927/w/repository`](https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/repository) (Repositories), [`src/main/java/com/github/qingtian1927/w/controller/PostController.java`](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/PostController.java) (Post workflow), [`src/main/java/com/github/qingtian1927/w/controller/UserController.java`](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/UserController.java) (Account workflows), [`src/main/java/com/github/qingtian1927/w/service/implementations/PostServiceImpl.java`](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/PostServiceImpl.java) (Post services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_main["Feeds and home"]
  node_posts["Post workflow"]
end

subgraph group_social["Social interactions"]
  node_postservice["Post services"]
  node_comments["Comments"]
  node_notifications["Notifications"]
  node_socialservices["Social services"]
  node_bookmarks["Bookmarks"]
end

subgraph group_identity["Identity and profiles"]
  node_users["Account workflows"]
  node_profiles["Profiles"]
  node_auth["Authentication"]
  node_security["Security configuration"]
  node_captcha["CAPTCHA filter"]
end

subgraph group_discovery["Discovery and administration"]
  node_search["Search workflow"]
  node_searchservice["Search service"]
  node_searchrepo["Search queries"]
  node_admin["Administration"]
  node_stats["Statistics"]
end

subgraph group_data["Domain and persistence"]
  node_domain["Social domain"]
  node_formatter["Content formatting"]
  node_database[("SQL database")]
  node_repositories["Repositories"]
end

node_user(("W user"))

node_user -->|"opens feed"| node_main
node_user -->|"creates and interacts"| node_posts
node_user -->|"manages account"| node_users
node_user -->|"searches content"| node_search
node_user -.->|"administers"| node_admin
node_main -->|"loads posts"| node_postservice
node_main -->|"loads notifications"| node_notifications
node_posts -->|"manages posts"| node_postservice
node_posts -->|"manages comments"| node_comments
node_posts -->|"creates alerts"| node_notifications
node_posts -->|"handles reactions"| node_socialservices
node_users -->|"edits profiles"| node_profiles
node_users -->|"manages alerts"| node_notifications
node_users -->|"follows users"| node_socialservices
node_search -.->|"submits queries"| node_searchservice
node_searchservice -->|"queries content"| node_searchrepo
node_searchrepo -->|"resolves posts"| node_postservice
node_searchrepo -->|"resolves comments"| node_comments
node_searchrepo -->|"runs native queries"| node_repositories
node_admin -->|"requests statistics"| node_stats
node_admin -->|"manages posts"| node_postservice
node_admin -.->|"manages users"| node_users
node_security -.->|"authenticates users"| node_auth
node_security -.->|"configures filter"| node_captcha
node_postservice -.->|"persists posts"| node_repositories
node_comments -.->|"persists comments"| node_repositories
node_profiles -.->|"persists profiles"| node_repositories
node_socialservices -.->|"persists interactions"| node_repositories
node_notifications -.->|"persists alerts"| node_repositories
node_stats -.->|"reads aggregates"| node_repositories
node_repositories -.->|"reads and writes"| node_database
node_domain -->|"formats content"| node_formatter

click node_main "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/MainController.java"
click node_posts "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/PostController.java"
click node_postservice "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/PostServiceImpl.java"
click node_comments "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/interfaces/CommentService.java"
click node_notifications "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/interfaces/NotificationService.java"
click node_socialservices "https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/service/implementations"
click node_bookmarks "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/BookmarkServiceImpl.java"
click node_users "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/UserController.java"
click node_profiles "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/ProfileServiceImpl.java"
click node_auth "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/CustomUserDetailsService.java"
click node_security "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/config/SecurityConfig.java"
click node_captcha "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/security/CaptchaAuthenticationFilter.java"
click node_search "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/SearchController.java"
click node_searchservice "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/SearchServiceImpl.java"
click node_searchrepo "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java"
click node_admin "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/AdminController.java"
click node_stats "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/StatisticsServiceImpl.java"
click node_domain "https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/model"
click node_formatter "https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/utils/ContentFormatter.java"
click node_repositories "https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/repository"

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_main,node_posts,node_user toneBlue
class node_postservice,node_comments,node_notifications,node_socialservices,node_bookmarks toneAmber
class node_users,node_profiles,node_auth,node_security,node_captcha toneMint
class node_search,node_searchservice,node_searchrepo,node_admin,node_stats toneRose
class node_domain,node_formatter,node_database,node_repositories toneIndigo
```

## Components

### Web workflows

- [Feeds and home](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/MainController.java): `src/main/java/com/github/qingtian1927/w/controller/MainController.java`
- [Post workflow](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/PostController.java): `src/main/java/com/github/qingtian1927/w/controller/PostController.java`

### Social interactions

- [Post services](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/PostServiceImpl.java): `src/main/java/com/github/qingtian1927/w/service/implementations/PostServiceImpl.java`
- [Comments](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/interfaces/CommentService.java): `src/main/java/com/github/qingtian1927/w/service/interfaces/CommentService.java`
- [Notifications](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/interfaces/NotificationService.java): `src/main/java/com/github/qingtian1927/w/service/interfaces/NotificationService.java`
- [Social services](https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/service/implementations): `src/main/java/com/github/qingtian1927/w/service/implementations`
- [Bookmarks](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/BookmarkServiceImpl.java): `src/main/java/com/github/qingtian1927/w/service/implementations/BookmarkServiceImpl.java`

### Identity and profiles

- [Account workflows](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/UserController.java): `src/main/java/com/github/qingtian1927/w/controller/UserController.java`
- [Profiles](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/ProfileServiceImpl.java): `src/main/java/com/github/qingtian1927/w/service/implementations/ProfileServiceImpl.java`
- [Authentication](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/CustomUserDetailsService.java): `src/main/java/com/github/qingtian1927/w/service/implementations/CustomUserDetailsService.java`
- [Security configuration](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/config/SecurityConfig.java): `src/main/java/com/github/qingtian1927/w/config/SecurityConfig.java`
- [CAPTCHA filter](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/security/CaptchaAuthenticationFilter.java): `src/main/java/com/github/qingtian1927/w/security/CaptchaAuthenticationFilter.java`

### Discovery and administration

- [Search workflow](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/SearchController.java): `src/main/java/com/github/qingtian1927/w/controller/SearchController.java`
- [Search service](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/SearchServiceImpl.java): `src/main/java/com/github/qingtian1927/w/service/implementations/SearchServiceImpl.java`
- [Search queries](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java): `src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java`
- [Administration](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/controller/AdminController.java): `src/main/java/com/github/qingtian1927/w/controller/AdminController.java`
- [Statistics](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/service/implementations/StatisticsServiceImpl.java): `src/main/java/com/github/qingtian1927/w/service/implementations/StatisticsServiceImpl.java`

### Domain and persistence

- [Social domain](https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/model): `src/main/java/com/github/qingtian1927/w/model`
- [Content formatting](https://github.com/qingtian1927/w/blob/master/src/main/java/com/github/qingtian1927/w/utils/ContentFormatter.java): `src/main/java/com/github/qingtian1927/w/utils/ContentFormatter.java`
- **SQL database**
- [Repositories](https://github.com/qingtian1927/w/tree/master/src/main/java/com/github/qingtian1927/w/repository): `src/main/java/com/github/qingtian1927/w/repository`

### Other components

- **W user**

## Connections

- W user → Feeds and home: opens feed
- W user → Post workflow: creates and interacts
- W user → Account workflows: manages account
- W user → Search workflow: searches content
- W user → Administration: administers
- Feeds and home → Post services: loads posts (evidence: `src/main/java/com/github/qingtian1927/w/controller/MainController.java`)
- Feeds and home → Notifications: loads notifications (evidence: `src/main/java/com/github/qingtian1927/w/controller/MainController.java`)
- Post workflow → Post services: manages posts (evidence: `src/main/java/com/github/qingtian1927/w/controller/PostController.java`)
- Post workflow → Comments: manages comments (evidence: `src/main/java/com/github/qingtian1927/w/controller/PostController.java`)
- Post workflow → Notifications: creates alerts (evidence: `src/main/java/com/github/qingtian1927/w/controller/PostController.java`)
- Post workflow → Social services: handles reactions (evidence: `src/main/java/com/github/qingtian1927/w/controller/PostController.java`)
- Account workflows → Profiles: edits profiles (evidence: `src/main/java/com/github/qingtian1927/w/controller/UserController.java`)
- Account workflows → Notifications: manages alerts (evidence: `src/main/java/com/github/qingtian1927/w/controller/UserController.java`)
- Account workflows → Social services: follows users (evidence: `src/main/java/com/github/qingtian1927/w/controller/UserController.java`)
- Search workflow → Search service: submits queries
- Search service → Search queries: queries content (evidence: `src/main/java/com/github/qingtian1927/w/service/implementations/SearchServiceImpl.java`)
- Search queries → Post services: resolves posts (evidence: `src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java`)
- Search queries → Comments: resolves comments (evidence: `src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java`)
- Search queries → Repositories: runs native queries (evidence: `src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java`)
- Administration → Statistics: requests statistics (evidence: `src/main/java/com/github/qingtian1927/w/controller/AdminController.java`)
- Administration → Post services: manages posts (evidence: `src/main/java/com/github/qingtian1927/w/controller/AdminController.java`)
- Administration → Account workflows: manages users
- Security configuration → Authentication: authenticates users
- Security configuration → CAPTCHA filter: configures filter
- Post services → Repositories: persists posts (evidence: `src/main/java/com/github/qingtian1927/w/service/implementations/PostServiceImpl.java`)
- Comments → Repositories: persists comments (evidence: `src/main/java/com/github/qingtian1927/w/repository/SearchRepository.java`)
- Profiles → Repositories: persists profiles
- Social services → Repositories: persists interactions (evidence: `src/main/java/com/github/qingtian1927/w/service/implementations/SearchServiceImpl.java`)
- Notifications → Repositories: persists alerts
- Statistics → Repositories: reads aggregates
- Repositories → SQL database: reads and writes
- Social domain → Content formatting: formats content (evidence: `src/main/java/com/github/qingtian1927/w/model/Post.java`)
