# dad-groupe-6/breezy architecture

> Architecture diagram of the GitHub repository dad-groupe-6/breezy, 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/dad-groupe-6/breezy
- Repository: https://github.com/dad-groupe-6/breezy

## Overview

Breezy is a lightweight social network. Its principal user journey is browsing and creating posts, then interacting through likes, comments, follows, and recommendations; separate services handle identity, profiles, media, messaging, and notifications. The graph groups the web client and domain services, with one internal service/model layer shown where the supplied source supports it. Several service integrations and frontend-to-API links are not evidenced in the excerpts, so they are omitted rather than inferred.

Main entry points: [`Services/Auth/src/services/auth.service.js`](https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/services/auth.service.js) (Registration and login), [`Services/Post/src/services/post.service.js`](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/services/post.service.js) (Posts and comments), [`Services/Message/src/services/conversation.service.js`](https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/services/conversation.service.js) (Conversation management), [`Services/Post/src/services/recommendation.service.js`](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/services/recommendation.service.js) (Post recommendations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Breezy web app"]
  node_post_view["Post view<br/>[Post.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Authentication endpoints<br/>[auth.controller.js]"]
  node_auth_logic["Registration and login<br/>[auth.service.js]"]
  node_role_admin["Role administration<br/>[role.controller.js]"]
  node_role_logic["Role and permissions<br/>[role.service.js]"]
  node_auth_store[("Identity records<br/>[index.js]")]
end

subgraph group_social["Profiles and social graph"]
  node_user_api["User endpoints<br/>[user.controller.js]"]
  node_user_logic["Profile management<br/>[user.service.js]"]
  node_user_store[("User profiles<br/>[user.model.js]")]
  node_follow_api["Follow endpoints"]
  node_follow_logic["Follow relationships<br/>[follow.service.js]"]
end

subgraph group_publishing["Posts and media"]
  node_post_api["Post endpoints<br/>[post.controller.js]"]
  node_post_logic["Posts and comments<br/>[post.service.js]"]
  node_post_store[("Post records<br/>[post.model.js]")]
  node_like_store[("Like records<br/>[like.model.js]")]
  node_post_utils["Post view and paging<br/>[postView.js]"]
  node_recommend_api["Recommendation endpoints"]
  node_recommend_logic["Post recommendations"]
  node_media_api["Media endpoints"]
  node_media_logic["Media streaming<br/>[media.service.js]"]
  node_gridfs["GridFS storage adapter<br/>[gridfs.storage.js]"]
end

subgraph group_communication["Messaging and notifications"]
  node_message_api["Conversation endpoints"]
  node_conversation_logic["Conversation management"]
  node_message_logic["Message operations<br/>[message.service.js]"]
  node_conversation_store[("Conversation records")]
  node_message_store[("Message records<br/>[message.model.js]")]
  node_notification_api["Notification endpoints"]
  node_notification_logic["Notification service"]
  node_notification_store[("Notification records")]
  node_notification_consumer["Event consumer<br/>[consumer.js]"]
end

node_visitor(("Social network user"))

node_visitor -.->|"uses"| node_web
node_web -->|"renders"| node_post_view
node_auth_api -->|"delegates"| node_auth_logic
node_auth_logic -->|"reads/writes"| node_auth_store
node_auth_logic -->|"checks roles"| node_role_logic
node_auth_logic -->|"calls profile API"| node_user_api
node_role_admin -->|"delegates"| node_role_logic
node_role_logic -->|"reads/writes"| node_auth_store
node_user_api -->|"delegates"| node_user_logic
node_user_logic -->|"reads/writes"| node_user_store
node_follow_api -->|"delegates"| node_follow_logic
node_follow_logic -->|"reads/writes"| node_user_store
node_post_api -->|"delegates"| node_post_logic
node_post_logic -->|"reads/writes"| node_post_store
node_post_logic -->|"reads/writes"| node_like_store
node_post_logic -->|"formats and pages"| node_post_utils
node_recommend_api -->|"delegates"| node_recommend_logic
node_recommend_logic -->|"queries"| node_post_store
node_recommend_logic -->|"formats and pages"| node_post_utils
node_media_api -->|"delegates"| node_media_logic
node_gridfs -->|"streams files"| node_media_logic
node_message_api -->|"delegates"| node_conversation_logic
node_message_api -->|"deletes messages"| node_message_logic
node_conversation_logic -->|"reads/writes"| node_conversation_store
node_conversation_logic -->|"counts unread"| node_message_store
node_message_logic -->|"reads/writes"| node_message_store
node_message_logic -->|"updates preview"| node_conversation_logic
node_notification_api -->|"delegates"| node_notification_logic
node_notification_logic -->|"reads/writes"| node_notification_store

click node_web "https://github.com/dad-groupe-6/breezy/tree/main/front/src/app/(app)"
click node_post_view "https://github.com/dad-groupe-6/breezy/blob/main/front/src/components/post/Post.jsx"
click node_auth_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/controllers/auth.controller.js"
click node_auth_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/services/auth.service.js"
click node_role_admin "https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/controllers/role.controller.js"
click node_role_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/services/role.service.js"
click node_auth_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/models/index.js"
click node_user_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/controllers/user.controller.js"
click node_user_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/services/user.service.js"
click node_user_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/models/user.model.js"
click node_follow_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/controllers/follow.controller.js"
click node_follow_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/services/follow.service.js"
click node_post_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/controllers/post.controller.js"
click node_post_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/services/post.service.js"
click node_post_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/models/post.model.js"
click node_like_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/models/like.model.js"
click node_post_utils "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/utils/postView.js"
click node_recommend_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/controllers/recommendation.controller.js"
click node_recommend_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/services/recommendation.service.js"
click node_media_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/Media/src/controllers/media.controllers.js"
click node_media_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Media/src/services/media.service.js"
click node_gridfs "https://github.com/dad-groupe-6/breezy/blob/main/Services/Media/src/storage/gridfs.storage.js"
click node_message_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/controllers/conversation.controller.js"
click node_conversation_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/services/conversation.service.js"
click node_message_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/services/message.service.js"
click node_conversation_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/models/conversation.model.js"
click node_message_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/models/message.model.js"
click node_notification_api "https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/controllers/notification.controller.js"
click node_notification_logic "https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/services/notification.service.js"
click node_notification_store "https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/models/notification.model.js"
click node_notification_consumer "https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/messaging/consumer.js"

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_web,node_post_view,node_visitor toneBlue
class node_auth_api,node_auth_logic,node_role_admin,node_role_logic,node_auth_store toneAmber
class node_user_api,node_user_logic,node_user_store,node_follow_api,node_follow_logic toneMint
class node_post_api,node_post_logic,node_post_store,node_like_store,node_post_utils,node_recommend_api,node_recommend_logic,node_media_api,node_media_logic,node_gridfs toneRose
class node_message_api,node_conversation_logic,node_message_logic,node_conversation_store,node_message_store,node_notification_api,node_notification_logic,node_notification_store,node_notification_consumer toneIndigo
```

## Components

### Web client

- [Breezy web app](https://github.com/dad-groupe-6/breezy/tree/main/front/src/app/(app)): `front/src/app/(app)`
- [Post view](https://github.com/dad-groupe-6/breezy/blob/main/front/src/components/post/Post.jsx): `front/src/components/post/Post.jsx`

### Identity and access

- [Authentication endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/controllers/auth.controller.js): `Services/Auth/src/controllers/auth.controller.js`
- [Registration and login](https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/services/auth.service.js): `Services/Auth/src/services/auth.service.js`
- [Role administration](https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/controllers/role.controller.js): `Services/Auth/src/controllers/role.controller.js`
- [Role and permissions](https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/services/role.service.js): `Services/Auth/src/services/role.service.js`
- [Identity records](https://github.com/dad-groupe-6/breezy/blob/main/Services/Auth/src/models/index.js): `Services/Auth/src/models/index.js`

### Profiles and social graph

- [User endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/controllers/user.controller.js): `Services/User/src/controllers/user.controller.js`
- [Profile management](https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/services/user.service.js): `Services/User/src/services/user.service.js`
- [User profiles](https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/models/user.model.js): `Services/User/src/models/user.model.js`
- [Follow endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/controllers/follow.controller.js): `Services/User/src/controllers/follow.controller.js`
- [Follow relationships](https://github.com/dad-groupe-6/breezy/blob/main/Services/User/src/services/follow.service.js): `Services/User/src/services/follow.service.js`

### Posts and media

- [Post endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/controllers/post.controller.js): `Services/Post/src/controllers/post.controller.js`
- [Posts and comments](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/services/post.service.js): `Services/Post/src/services/post.service.js`
- [Post records](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/models/post.model.js): `Services/Post/src/models/post.model.js`
- [Like records](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/models/like.model.js): `Services/Post/src/models/like.model.js`
- [Post view and paging](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/utils/postView.js): `Services/Post/src/utils/postView.js`
- [Recommendation endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/controllers/recommendation.controller.js): `Services/Post/src/controllers/recommendation.controller.js`
- [Post recommendations](https://github.com/dad-groupe-6/breezy/blob/main/Services/Post/src/services/recommendation.service.js): `Services/Post/src/services/recommendation.service.js`
- [Media endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/Media/src/controllers/media.controllers.js): `Services/Media/src/controllers/media.controllers.js`
- [Media streaming](https://github.com/dad-groupe-6/breezy/blob/main/Services/Media/src/services/media.service.js): `Services/Media/src/services/media.service.js`
- [GridFS storage adapter](https://github.com/dad-groupe-6/breezy/blob/main/Services/Media/src/storage/gridfs.storage.js): `Services/Media/src/storage/gridfs.storage.js`

### Messaging and notifications

- [Conversation endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/controllers/conversation.controller.js): `Services/Message/src/controllers/conversation.controller.js`
- [Conversation management](https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/services/conversation.service.js): `Services/Message/src/services/conversation.service.js`
- [Message operations](https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/services/message.service.js): `Services/Message/src/services/message.service.js`
- [Conversation records](https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/models/conversation.model.js): `Services/Message/src/models/conversation.model.js`
- [Message records](https://github.com/dad-groupe-6/breezy/blob/main/Services/Message/src/models/message.model.js): `Services/Message/src/models/message.model.js`
- [Notification endpoints](https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/controllers/notification.controller.js): `Services/Notification/src/controllers/notification.controller.js`
- [Notification service](https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/services/notification.service.js): `Services/Notification/src/services/notification.service.js`
- [Notification records](https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/models/notification.model.js): `Services/Notification/src/models/notification.model.js`
- [Event consumer](https://github.com/dad-groupe-6/breezy/blob/main/Services/Notification/src/messaging/consumer.js): `Services/Notification/src/messaging/consumer.js`

### Other components

- **Social network user**

## Connections

- Social network user → Breezy web app: uses
- Breezy web app → Post view: renders (evidence: `front/src/app/(app)/explorer/page.jsx`)
- Authentication endpoints → Registration and login: delegates (evidence: `Services/Auth/src/controllers/auth.controller.js`)
- Registration and login → Identity records: reads/writes (evidence: `Services/Auth/src/services/auth.service.js`)
- Registration and login → Role and permissions: checks roles (evidence: `Services/Auth/src/services/auth.service.js`)
- Registration and login → User endpoints: calls profile API (evidence: `Services/Auth/src/services/auth.service.js`)
- Role administration → Role and permissions: delegates (evidence: `Services/Auth/src/controllers/role.controller.js`)
- Role and permissions → Identity records: reads/writes (evidence: `Services/Auth/src/services/role.service.js`)
- User endpoints → Profile management: delegates (evidence: `Services/User/src/controllers/user.controller.js`)
- Profile management → User profiles: reads/writes (evidence: `Services/User/src/services/user.service.js`)
- Follow endpoints → Follow relationships: delegates (evidence: `Services/User/src/controllers/follow.controller.js`)
- Follow relationships → User profiles: reads/writes (evidence: `Services/User/src/services/follow.service.js`)
- Post endpoints → Posts and comments: delegates (evidence: `Services/Post/src/controllers/post.controller.js`)
- Posts and comments → Post records: reads/writes (evidence: `Services/Post/src/services/post.service.js`)
- Posts and comments → Like records: reads/writes (evidence: `Services/Post/src/services/post.service.js`)
- Posts and comments → Post view and paging: formats and pages (evidence: `Services/Post/src/services/post.service.js`)
- Recommendation endpoints → Post recommendations: delegates (evidence: `Services/Post/src/controllers/recommendation.controller.js`)
- Post recommendations → Post records: queries (evidence: `Services/Post/src/services/recommendation.service.js`)
- Post recommendations → Post view and paging: formats and pages (evidence: `Services/Post/src/services/recommendation.service.js`)
- Media endpoints → Media streaming: delegates (evidence: `Services/Media/src/controllers/media.controllers.js`)
- GridFS storage adapter → Media streaming: streams files (evidence: `Services/Media/src/storage/gridfs.storage.js`)
- Conversation endpoints → Conversation management: delegates (evidence: `Services/Message/src/controllers/conversation.controller.js`)
- Conversation endpoints → Message operations: deletes messages (evidence: `Services/Message/src/controllers/conversation.controller.js`)
- Conversation management → Conversation records: reads/writes (evidence: `Services/Message/src/services/conversation.service.js`)
- Conversation management → Message records: counts unread (evidence: `Services/Message/src/services/conversation.service.js`)
- Message operations → Message records: reads/writes (evidence: `Services/Message/src/services/message.service.js`)
- Message operations → Conversation management: updates preview (evidence: `Services/Message/src/services/message.service.js`)
- Notification endpoints → Notification service: delegates (evidence: `Services/Notification/src/controllers/notification.controller.js`)
- Notification service → Notification records: reads/writes (evidence: `Services/Notification/src/services/notification.service.js`)
