# iampatil/social-app-new architecture

> Architecture diagram of the GitHub repository iampatil/social-app-new, 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/iampatil/social-app-new
- Repository: https://github.com/iampatil/social-app-new

## Overview

This is a social-media application whose main flow is an Angular user browsing the feed and managing posts and relationships through the gateway to Spring services. User-service owns authentication, profiles, privacy, follows, friend requests, suggestions, and blocks; post-service owns posts, feed assembly, likes, and comments. The README documents discovery registration and database boundaries; sampled source confirms key controller-to-service calls, but not all runtime wiring, so unverified service links are dashed.

Main entry points: [`api-gateway/src/main/java/com/social/gateway/JwtAuthFilter.java`](https://github.com/iampatil/social-app-new/blob/master/api-gateway/src/main/java/com/social/gateway/JwtAuthFilter.java) (API gateway), [`user-service/src/main/java/com/social/user/FriendService.java`](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendService.java) (Relationships and blocks), [`frontend/src/app/api.service.ts`](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/api.service.ts) (API client), [`discovery-server/src/main/java/com/social/discovery/DiscoveryServerApplication.java`](https://github.com/iampatil/social-app-new/blob/master/discovery-server/src/main/java/com/social/discovery/DiscoveryServerApplication.java) (Service discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_app["App shell and routes<br/>[app.component.ts]"]
  node_auth_ui["Login and registration<br/>[auth.service.ts]"]
  node_api_ui["API client<br/>[api.service.ts]"]
  node_feed_ui["Feed page<br/>[feed.component.ts]"]
  node_people_ui["People page"]
  node_friends_ui["Friends page"]
  node_profile_ui["Profile page"]
end

subgraph group_edge["Gateway and discovery"]
  node_gateway["API gateway<br/>[JwtAuthFilter.java]"]
  node_discovery["Service discovery"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_controller["Auth endpoints"]
  node_jwt["JWT issuance<br/>[JwtService.java]"]
  node_profiles["Profiles and privacy"]
  node_users["User search and follows"]
  node_user_store[("User records")]
end

subgraph group_social["Social graph"]
  node_friend_api["Friend endpoints"]
  node_friend_service["Relationships and blocks<br/>[FriendService.java]"]
  node_friend_store[("Friendship records")]
  node_follow_store[("Follow records")]
end

subgraph group_content["Posts and feed"]
  node_post_api["Post operations"]
  node_user_client["User-service client<br/>[UserClient.java]"]
  node_post_store[("Post records<br/>[Repositories.java]")]
  node_post_db[("Post database")]
end

node_person(("Social user"))

node_person -->|"uses"| node_app
node_app -->|"offers auth"| node_auth_ui
node_auth_ui -.->|"sends credentials"| node_gateway
node_api_ui -->|"calls API"| node_gateway
node_feed_ui -->|"requests feed"| node_api_ui
node_people_ui -->|"requests people"| node_api_ui
node_friends_ui -->|"manages friends"| node_api_ui
node_profile_ui -->|"loads profile"| node_api_ui
node_gateway -->|"routes requests"| node_auth_controller
node_gateway -->|"routes requests"| node_post_api
node_gateway -.->|"uses discovery"| node_discovery
node_auth_controller -->|"issues tokens"| node_jwt
node_auth_controller -->|"loads users"| node_user_store
node_profiles -->|"reads and saves"| node_user_store
node_profiles -->|"checks relationships"| node_friend_service
node_profiles -->|"reads follow counts"| node_follow_store
node_users -->|"searches users"| node_user_store
node_users -->|"checks blocks"| node_friend_service
node_users -->|"updates follows"| node_follow_store
node_friend_api -->|"delegates actions"| node_friend_service
node_friend_service -->|"loads people"| node_user_store
node_friend_service -->|"manages requests"| node_friend_store
node_friend_service -->|"manages follows"| node_follow_store
node_post_api -->|"gets feed IDs"| node_user_client
node_post_api -->|"reads and writes"| node_post_store
node_post_store -.->|"persists records"| node_post_db
node_user_client -.->|"requests follow IDs"| node_users
node_discovery -.->|"registers services"| node_gateway
node_discovery -.->|"registers services"| node_auth_controller
node_discovery -.->|"registers services"| node_post_api

click node_app "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/app.component.ts"
click node_auth_ui "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/auth.service.ts"
click node_api_ui "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/api.service.ts"
click node_feed_ui "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/feed.component.ts"
click node_people_ui "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/people.component.ts"
click node_friends_ui "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/friends.component.ts"
click node_profile_ui "https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/profile.component.ts"
click node_gateway "https://github.com/iampatil/social-app-new/blob/master/api-gateway/src/main/java/com/social/gateway/JwtAuthFilter.java"
click node_discovery "https://github.com/iampatil/social-app-new/blob/master/discovery-server/src/main/java/com/social/discovery/DiscoveryServerApplication.java"
click node_auth_controller "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/AuthController.java"
click node_jwt "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/JwtService.java"
click node_profiles "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/ProfileController.java"
click node_users "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/UserController.java"
click node_user_store "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/UserRepository.java"
click node_friend_api "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendController.java"
click node_friend_service "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendService.java"
click node_friend_store "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendshipRepository.java"
click node_follow_store "https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FollowRepository.java"
click node_post_api "https://github.com/iampatil/social-app-new/blob/master/post-service/src/main/java/com/social/post/PostController.java"
click node_user_client "https://github.com/iampatil/social-app-new/blob/master/post-service/src/main/java/com/social/post/UserClient.java"
click node_post_store "https://github.com/iampatil/social-app-new/blob/master/post-service/src/main/java/com/social/post/Repositories.java"

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,node_auth_ui,node_api_ui,node_feed_ui,node_people_ui,node_friends_ui,node_profile_ui,node_person toneBlue
class node_gateway,node_discovery toneAmber
class node_auth_controller,node_jwt,node_profiles,node_users,node_user_store toneMint
class node_friend_api,node_friend_service,node_friend_store,node_follow_store toneRose
class node_post_api,node_user_client,node_post_store,node_post_db toneIndigo
```

## Components

### Angular client

- [App shell and routes](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Login and registration](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/auth.service.ts): `frontend/src/app/auth.service.ts`
- [API client](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/api.service.ts): `frontend/src/app/api.service.ts`
- [Feed page](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/feed.component.ts): `frontend/src/app/pages/feed.component.ts`
- [People page](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/people.component.ts): `frontend/src/app/pages/people.component.ts`
- [Friends page](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/friends.component.ts): `frontend/src/app/pages/friends.component.ts`
- [Profile page](https://github.com/iampatil/social-app-new/blob/master/frontend/src/app/pages/profile.component.ts): `frontend/src/app/pages/profile.component.ts`

### Gateway and discovery

- [API gateway](https://github.com/iampatil/social-app-new/blob/master/api-gateway/src/main/java/com/social/gateway/JwtAuthFilter.java): `api-gateway/src/main/java/com/social/gateway/JwtAuthFilter.java`
- [Service discovery](https://github.com/iampatil/social-app-new/blob/master/discovery-server/src/main/java/com/social/discovery/DiscoveryServerApplication.java): `discovery-server/src/main/java/com/social/discovery/DiscoveryServerApplication.java`

### Identity and profiles

- [Auth endpoints](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/AuthController.java): `user-service/src/main/java/com/social/user/AuthController.java`
- [JWT issuance](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/JwtService.java): `user-service/src/main/java/com/social/user/JwtService.java`
- [Profiles and privacy](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/ProfileController.java): `user-service/src/main/java/com/social/user/ProfileController.java`
- [User search and follows](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/UserController.java): `user-service/src/main/java/com/social/user/UserController.java`
- [User records](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/UserRepository.java): `user-service/src/main/java/com/social/user/UserRepository.java`

### Social graph

- [Friend endpoints](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendController.java): `user-service/src/main/java/com/social/user/FriendController.java`
- [Relationships and blocks](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendService.java): `user-service/src/main/java/com/social/user/FriendService.java`
- [Friendship records](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FriendshipRepository.java): `user-service/src/main/java/com/social/user/FriendshipRepository.java`
- [Follow records](https://github.com/iampatil/social-app-new/blob/master/user-service/src/main/java/com/social/user/FollowRepository.java): `user-service/src/main/java/com/social/user/FollowRepository.java`

### Posts and feed

- [Post operations](https://github.com/iampatil/social-app-new/blob/master/post-service/src/main/java/com/social/post/PostController.java): `post-service/src/main/java/com/social/post/PostController.java`
- [User-service client](https://github.com/iampatil/social-app-new/blob/master/post-service/src/main/java/com/social/post/UserClient.java): `post-service/src/main/java/com/social/post/UserClient.java`
- [Post records](https://github.com/iampatil/social-app-new/blob/master/post-service/src/main/java/com/social/post/Repositories.java): `post-service/src/main/java/com/social/post/Repositories.java`
- **Post database**

### Other components

- **Social user**

## Connections

- Social user → App shell and routes: uses (evidence: `frontend/src/app/app.component.ts`)
- App shell and routes → Login and registration: offers auth (evidence: `frontend/src/app/app.component.ts`)
- Login and registration → API gateway: sends credentials
- API client → API gateway: calls API (evidence: `frontend/src/app/api.service.ts`)
- Feed page → API client: requests feed (evidence: `frontend/src/app/pages/feed.component.ts`)
- People page → API client: requests people (evidence: `frontend/src/app/pages/people.component.ts`)
- Friends page → API client: manages friends (evidence: `frontend/src/app/pages/friends.component.ts`)
- Profile page → API client: loads profile (evidence: `frontend/src/app/pages/profile.component.ts`)
- API gateway → Auth endpoints: routes requests (evidence: `README.md`)
- API gateway → Post operations: routes requests (evidence: `README.md`)
- API gateway → Service discovery: uses discovery
- Auth endpoints → JWT issuance: issues tokens (evidence: `user-service/src/main/java/com/social/user/AuthController.java`)
- Auth endpoints → User records: loads users (evidence: `user-service/src/main/java/com/social/user/AuthController.java`)
- Profiles and privacy → User records: reads and saves (evidence: `user-service/src/main/java/com/social/user/ProfileController.java`)
- Profiles and privacy → Relationships and blocks: checks relationships (evidence: `user-service/src/main/java/com/social/user/ProfileController.java`)
- Profiles and privacy → Follow records: reads follow counts (evidence: `user-service/src/main/java/com/social/user/ProfileController.java`)
- User search and follows → User records: searches users (evidence: `user-service/src/main/java/com/social/user/UserController.java`)
- User search and follows → Relationships and blocks: checks blocks (evidence: `user-service/src/main/java/com/social/user/UserController.java`)
- User search and follows → Follow records: updates follows (evidence: `user-service/src/main/java/com/social/user/UserController.java`)
- Friend endpoints → Relationships and blocks: delegates actions (evidence: `user-service/src/main/java/com/social/user/FriendController.java`)
- Relationships and blocks → User records: loads people (evidence: `user-service/src/main/java/com/social/user/FriendService.java`)
- Relationships and blocks → Friendship records: manages requests (evidence: `user-service/src/main/java/com/social/user/FriendService.java`)
- Relationships and blocks → Follow records: manages follows (evidence: `user-service/src/main/java/com/social/user/FriendService.java`)
- Post operations → User-service client: gets feed IDs (evidence: `post-service/src/main/java/com/social/post/PostController.java`)
- Post operations → Post records: reads and writes (evidence: `post-service/src/main/java/com/social/post/PostController.java`)
- Post records → Post database: persists records
- User-service client → User search and follows: requests follow IDs (evidence: `README.md`)
- Service discovery → API gateway: registers services (evidence: `README.md`)
- Service discovery → Auth endpoints: registers services (evidence: `README.md`)
- Service discovery → Post operations: registers services (evidence: `README.md`)
