# khlifihamza/01blog architecture

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

- Interactive diagram: https://gitdiagram.com/khlifihamza/01blog
- Repository: https://github.com/khlifihamza/01blog

## Overview

01Blog is a student-focused social blogging platform. Users register and authenticate, publish multimedia posts, discover people, follow authors, and interact through likes, comments, and notifications; reports and admin tools support moderation. The Angular client routes users to feature screens and communicates with a Spring Boot REST API backed by PostgreSQL. The graph preserves documented features, but some links are based only on README descriptions or source-index references because their implementations were not excerpted.

Main entry points: [`backend/src/main/java/com/dev/backend/controller`](https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/controller) (Spring REST API), [`frontend/src/app/app.routes.ts`](https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/app.routes.ts) (App routes), [`backend/src/main/java/com/dev/backend/repository`](https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/repository) (Data repositories), [`backend/src/main/java/com/dev/backend/service/PostService.java`](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/PostService.java) (Post management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_routes["App routes<br/>[app.routes.ts]"]
  node_authui["Login and register"]
  node_home["Activity feed<br/>[home.ts]"]
  node_postui["Post screens"]
  node_profileui["Profile screens"]
  node_discoveryui["Discovery screen<br/>[discovery.ts]"]
  node_notificationui["Notifications screen<br/>[notification.ts]"]
  node_adminui["Admin dashboard"]
end

subgraph group_content["Content and community"]
  node_api["Spring REST API"]
  node_posts["Post management<br/>[PostService.java]"]
  node_comments["Comments and replies"]
  node_engagement["Likes and follows"]
  node_notifications["Notification service"]
end

subgraph group_identity["Identity and discovery"]
  node_accounts["Account services<br/>[UserService.java]"]
  node_discovery["User discovery"]
end

subgraph group_moderation["Moderation and persistence"]
  node_reports["Reports and moderation<br/>[ReportService.java]"]
  node_admin["Admin operations<br/>[AdminService.java]"]
  node_entities["Domain entities"]
  node_repositories["Data repositories"]
  node_db[("PostgreSQL")]
end

node_user(("Student"))

node_user -->|"uses"| node_routes
node_routes -->|"routes to"| node_authui
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_postui
node_routes -->|"routes to"| node_profileui
node_routes -->|"routes to"| node_discoveryui
node_routes -->|"routes to"| node_notificationui
node_routes -->|"routes to"| node_adminui
node_authui -.->|"calls API"| node_api
node_home -.->|"loads feed"| node_api
node_postui -.->|"manages posts"| node_api
node_profileui -.->|"manages profile"| node_api
node_discoveryui -.->|"discovers users"| node_api
node_notificationui -.->|"reads activity"| node_api
node_adminui -.->|"moderates"| node_api
node_api -->|"invokes"| node_posts
node_api -->|"invokes"| node_comments
node_api -->|"invokes"| node_admin
node_api -->|"invokes"| node_accounts
node_api -->|"invokes"| node_reports
node_posts -->|"creates notices"| node_notifications
node_comments -->|"creates notices"| node_notifications
node_accounts -->|"delegates discovery"| node_discovery
node_posts -.->|"accesses data"| node_repositories
node_comments -->|"accesses data"| node_repositories
node_notifications -->|"accesses data"| node_repositories
node_accounts -->|"accesses data"| node_repositories
node_discovery -.->|"accesses data"| node_repositories
node_admin -->|"manages posts"| node_posts
node_admin -.->|"uses domain"| node_entities
node_repositories -.->|"maps entities"| node_entities
node_entities -->|"persisted via JPA"| node_db
node_engagement -.->|"activity notices"| node_notifications

click node_routes "https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/app.routes.ts"
click node_authui "https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/auth"
click node_home "https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/features/home/home.ts"
click node_postui "https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/post"
click node_profileui "https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/profile"
click node_discoveryui "https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/features/discovery/discovery.ts"
click node_notificationui "https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/features/notification/notification.ts"
click node_adminui "https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/admin"
click node_api "https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/controller"
click node_posts "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/PostService.java"
click node_comments "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/CommentService.java"
click node_engagement "https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/service"
click node_notifications "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/NotificationService.java"
click node_accounts "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/UserService.java"
click node_discovery "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/DiscoveryService.java"
click node_reports "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/ReportService.java"
click node_admin "https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/AdminService.java"
click node_entities "https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/model"
click node_repositories "https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/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_routes,node_authui,node_home,node_postui,node_profileui,node_discoveryui,node_notificationui,node_adminui toneBlue
class node_api,node_posts,node_comments,node_engagement,node_notifications toneAmber
class node_accounts,node_discovery toneMint
class node_reports,node_admin,node_entities,node_repositories,node_db toneRose
class node_user toneIndigo
```

## Components

### Angular client

- [App routes](https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Login and register](https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/auth): `frontend/src/app/features/auth`
- [Activity feed](https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/features/home/home.ts): `frontend/src/app/features/home/home.ts`
- [Post screens](https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/post): `frontend/src/app/features/post`
- [Profile screens](https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/profile): `frontend/src/app/features/profile`
- [Discovery screen](https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/features/discovery/discovery.ts): `frontend/src/app/features/discovery/discovery.ts`
- [Notifications screen](https://github.com/khlifihamza/01blog/blob/main/frontend/src/app/features/notification/notification.ts): `frontend/src/app/features/notification/notification.ts`
- [Admin dashboard](https://github.com/khlifihamza/01blog/tree/main/frontend/src/app/features/admin): `frontend/src/app/features/admin`

### Content and community

- [Spring REST API](https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/controller): `backend/src/main/java/com/dev/backend/controller`
- [Post management](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/PostService.java): `backend/src/main/java/com/dev/backend/service/PostService.java`
- [Comments and replies](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/CommentService.java): `backend/src/main/java/com/dev/backend/service/CommentService.java`
- [Likes and follows](https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/service): `backend/src/main/java/com/dev/backend/service`
- [Notification service](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/NotificationService.java): `backend/src/main/java/com/dev/backend/service/NotificationService.java`

### Identity and discovery

- [Account services](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/UserService.java): `backend/src/main/java/com/dev/backend/service/UserService.java`
- [User discovery](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/DiscoveryService.java): `backend/src/main/java/com/dev/backend/service/DiscoveryService.java`

### Moderation and persistence

- [Reports and moderation](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/ReportService.java): `backend/src/main/java/com/dev/backend/service/ReportService.java`
- [Admin operations](https://github.com/khlifihamza/01blog/blob/main/backend/src/main/java/com/dev/backend/service/AdminService.java): `backend/src/main/java/com/dev/backend/service/AdminService.java`
- [Domain entities](https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/model): `backend/src/main/java/com/dev/backend/model`
- [Data repositories](https://github.com/khlifihamza/01blog/tree/main/backend/src/main/java/com/dev/backend/repository): `backend/src/main/java/com/dev/backend/repository`
- **PostgreSQL**

### Other components

- **Student**

## Connections

- Student → App routes: uses
- App routes → Login and register: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Activity feed: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Post screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Profile screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Discovery screen: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Notifications screen: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Admin dashboard: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Login and register → Spring REST API: calls API
- Activity feed → Spring REST API: loads feed
- Post screens → Spring REST API: manages posts
- Profile screens → Spring REST API: manages profile
- Discovery screen → Spring REST API: discovers users
- Notifications screen → Spring REST API: reads activity
- Admin dashboard → Spring REST API: moderates
- Spring REST API → Post management: invokes (evidence: `backend/src/main/java/com/dev/backend/controller/PostController.java`)
- Spring REST API → Comments and replies: invokes (evidence: `backend/src/main/java/com/dev/backend/controller/CommentController.java`)
- Spring REST API → Admin operations: invokes (evidence: `backend/src/main/java/com/dev/backend/controller/AdminController.java`)
- Spring REST API → Account services: invokes (evidence: `backend/src/main/java/com/dev/backend/controller/AdminController.java`)
- Spring REST API → Reports and moderation: invokes (evidence: `backend/src/main/java/com/dev/backend/controller/AdminController.java`)
- Post management → Notification service: creates notices (evidence: `backend/src/main/java/com/dev/backend/service/PostService.java`)
- Comments and replies → Notification service: creates notices (evidence: `backend/src/main/java/com/dev/backend/service/CommentService.java`)
- Account services → User discovery: delegates discovery (evidence: `backend/src/main/java/com/dev/backend/service/UserService.java`)
- Post management → Data repositories: accesses data (evidence: `backend/src/main/java/com/dev/backend/service/PostService.java`)
- Comments and replies → Data repositories: accesses data (evidence: `backend/src/main/java/com/dev/backend/service/CommentService.java`)
- Notification service → Data repositories: accesses data (evidence: `backend/src/main/java/com/dev/backend/service/NotificationService.java`)
- Account services → Data repositories: accesses data (evidence: `backend/src/main/java/com/dev/backend/service/UserService.java`)
- User discovery → Data repositories: accesses data
- Admin operations → Post management: manages posts (evidence: `backend/src/main/java/com/dev/backend/controller/AdminController.java`)
- Admin operations → Domain entities: uses domain
- Data repositories → Domain entities: maps entities (evidence: `backend/src/main/java/com/dev/backend/repository/PostRepository.java`)
- Domain entities → PostgreSQL: persisted via JPA
- Likes and follows → Notification service: activity notices (evidence: `backend/src/main/java/com/dev/backend/service/PostService.java`)
