# yannhallage/acredi-space architecture

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

- Interactive diagram: https://gitdiagram.com/yannhallage/acredi-space
- Repository: https://github.com/yannhallage/acredi-space

## Overview

AcrediSpace is a Spring Boot collaboration backend. Its principal workflow is organization-scoped account access, followed by team collaboration and work through files, checklists, communication, and scheduling; notifications deliver updates in real time. The graph includes the documented modules and substantial product areas present in the tree. Source excerpts establish several service calls; other subsystem links are omitted where neither an excerpt nor the README establishes the relationship.

Main entry points: [`src/main/java/com/acredispace/backend/file/service/FileService.java`](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/file/service/FileService.java) (File management), [`src/main/java/com/acredispace/backend/notification/service/NotificationService.java`](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/notification/service/NotificationService.java) (Notifications), [`src/main/java/com/acredispace/backend/team/service/TeamService.java`](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/team/service/TeamService.java) (Teams), [`src/main/java/com/acredispace/backend/storage/service/CloudflareImageStorageService.java`](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/storage/service/CloudflareImageStorageService.java) (Image storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_user["Users<br/>[UserService.java]"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_organization["Organizations"]
  node_teams["Teams<br/>[TeamService.java]"]
  node_access["Org access"]
end

subgraph group_work["Work and files"]
  node_files["File management<br/>[FileService.java]"]
  node_filedata[("File records<br/>[FileResource.java]")]
  node_folders["Folders<br/>[FolderService.java]"]
  node_checklists["Checklists"]
  node_polls["Polls<br/>[PollService.java]"]
end

subgraph group_communication["Communication"]
  node_chat["Chat<br/>[ChatService.java]"]
  node_groupchat["Group discussions"]
  node_notifications["Notifications"]
  node_presence["Presence"]
end

subgraph group_coordination["Scheduling and insights"]
  node_calendar["Calendar"]
  node_meetings["Meetings"]
  node_dashboard["Dashboard"]
  node_billing["Billing"]
end

subgraph group_platform["Shared platform"]
  node_audit["Audit log"]
  node_image_storage["Image storage"]
end

node_r2[("Cloudflare R2")]
node_actor(("User"))
node_stomp(("STOMP clients"))

node_actor -.->|"signs in"| node_auth
node_actor -.->|"manages account"| node_user
node_actor -.->|"sets up organization"| node_organization
node_actor -.->|"manages teams"| node_teams
node_actor -.->|"manages files"| node_files
node_actor -.->|"manages tasks"| node_checklists
node_actor -.->|"runs polls"| node_polls
node_actor -.->|"sends messages"| node_chat
node_actor -.->|"schedules events"| node_calendar
node_actor -.->|"joins meetings"| node_meetings
node_teams -->|"adds members"| node_groupchat
node_teams -->|"notifies invitees"| node_notifications
node_files -->|"resolves folder"| node_folders
node_files -->|"saves records"| node_filedata
node_files -.->|"stores objects"| node_r2
node_organization -->|"uploads logo"| node_image_storage
node_image_storage -->|"uploads images"| node_r2
node_user -->|"deletes avatar"| node_image_storage
node_checklists -->|"notifies members"| node_notifications
node_polls -->|"notifies participants"| node_notifications
node_notifications -->|"delivers after commit"| node_stomp
node_actor -.->|"views indicators"| node_dashboard
node_actor -.->|"manages subscription"| node_billing
node_actor -.->|"reviews activity"| node_audit

click node_user "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/user/service/UserService.java"
click node_auth "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/auth/service/AuthService.java"
click node_organization "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/organization/service/OrganizationService.java"
click node_teams "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/team/service/TeamService.java"
click node_access "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/common/security/OrganizationAccess.java"
click node_files "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/file/service/FileService.java"
click node_filedata "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/file/model/FileResource.java"
click node_folders "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/folder/service/FolderService.java"
click node_checklists "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/checklist/service/ChecklistService.java"
click node_polls "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/poll/service/PollService.java"
click node_chat "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/chat/service/ChatService.java"
click node_groupchat "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/groupdiscussion/service/GroupDiscussionService.java"
click node_notifications "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/notification/service/NotificationService.java"
click node_presence "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/presence/service/PresenceService.java"
click node_calendar "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/calendar/service/CalendarService.java"
click node_meetings "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/meeting/service/MeetingService.java"
click node_dashboard "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/dashboard/service/DashboardService.java"
click node_billing "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/billing/service/SubscriptionService.java"
click node_audit "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/audit/service/AuditLogService.java"
click node_image_storage "https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/storage/service/CloudflareImageStorageService.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_user,node_auth,node_organization,node_teams,node_access,node_actor,node_stomp toneBlue
class node_files,node_filedata,node_folders,node_checklists,node_polls,node_r2 toneAmber
class node_chat,node_groupchat,node_notifications,node_presence toneMint
class node_calendar,node_meetings,node_dashboard,node_billing toneRose
class node_audit,node_image_storage toneIndigo
```

## Components

### Identity and access

- [Users](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/user/service/UserService.java): `src/main/java/com/acredispace/backend/user/service/UserService.java`
- [Authentication](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/auth/service/AuthService.java): `src/main/java/com/acredispace/backend/auth/service/AuthService.java`
- [Organizations](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/organization/service/OrganizationService.java): `src/main/java/com/acredispace/backend/organization/service/OrganizationService.java`
- [Teams](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/team/service/TeamService.java): `src/main/java/com/acredispace/backend/team/service/TeamService.java`
- [Org access](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/common/security/OrganizationAccess.java): `src/main/java/com/acredispace/backend/common/security/OrganizationAccess.java`

### Work and files

- [File management](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/file/service/FileService.java): `src/main/java/com/acredispace/backend/file/service/FileService.java`
- [File records](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/file/model/FileResource.java): `src/main/java/com/acredispace/backend/file/model/FileResource.java`
- [Folders](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/folder/service/FolderService.java): `src/main/java/com/acredispace/backend/folder/service/FolderService.java`
- [Checklists](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/checklist/service/ChecklistService.java): `src/main/java/com/acredispace/backend/checklist/service/ChecklistService.java`
- [Polls](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/poll/service/PollService.java): `src/main/java/com/acredispace/backend/poll/service/PollService.java`

### Communication

- [Chat](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/chat/service/ChatService.java): `src/main/java/com/acredispace/backend/chat/service/ChatService.java`
- [Group discussions](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/groupdiscussion/service/GroupDiscussionService.java): `src/main/java/com/acredispace/backend/groupdiscussion/service/GroupDiscussionService.java`
- [Notifications](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/notification/service/NotificationService.java): `src/main/java/com/acredispace/backend/notification/service/NotificationService.java`
- [Presence](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/presence/service/PresenceService.java): `src/main/java/com/acredispace/backend/presence/service/PresenceService.java`

### Scheduling and insights

- [Calendar](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/calendar/service/CalendarService.java): `src/main/java/com/acredispace/backend/calendar/service/CalendarService.java`
- [Meetings](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/meeting/service/MeetingService.java): `src/main/java/com/acredispace/backend/meeting/service/MeetingService.java`
- [Dashboard](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/dashboard/service/DashboardService.java): `src/main/java/com/acredispace/backend/dashboard/service/DashboardService.java`
- [Billing](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/billing/service/SubscriptionService.java): `src/main/java/com/acredispace/backend/billing/service/SubscriptionService.java`

### Shared platform

- [Audit log](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/audit/service/AuditLogService.java): `src/main/java/com/acredispace/backend/audit/service/AuditLogService.java`
- [Image storage](https://github.com/yannhallage/acredi-space/blob/feature/develop/src/main/java/com/acredispace/backend/storage/service/CloudflareImageStorageService.java): `src/main/java/com/acredispace/backend/storage/service/CloudflareImageStorageService.java`

### Other components

- **Cloudflare R2**
- **User**
- **STOMP clients**

## Connections

- User → Authentication: signs in
- User → Users: manages account
- User → Organizations: sets up organization
- User → Teams: manages teams
- User → File management: manages files
- User → Checklists: manages tasks
- User → Polls: runs polls
- User → Chat: sends messages
- User → Calendar: schedules events
- User → Meetings: joins meetings
- Teams → Group discussions: adds members (evidence: `src/main/java/com/acredispace/backend/team/service/TeamService.java`)
- Teams → Notifications: notifies invitees (evidence: `src/main/java/com/acredispace/backend/team/service/TeamService.java`)
- File management → Folders: resolves folder (evidence: `src/main/java/com/acredispace/backend/checklist/service/ChecklistService.java`)
- File management → File records: saves records (evidence: `src/main/java/com/acredispace/backend/file/service/FileService.java`)
- File management → Cloudflare R2: stores objects
- Organizations → Image storage: uploads logo (evidence: `src/main/java/com/acredispace/backend/organization/service/OrganizationService.java`)
- Image storage → Cloudflare R2: uploads images (evidence: `src/main/java/com/acredispace/backend/storage/service/CloudflareImageStorageService.java`)
- Users → Image storage: deletes avatar (evidence: `src/main/java/com/acredispace/backend/user/service/UserService.java`)
- Checklists → Notifications: notifies members (evidence: `src/main/java/com/acredispace/backend/checklist/service/ChecklistService.java`)
- Polls → Notifications: notifies participants (evidence: `src/main/java/com/acredispace/backend/poll/service/PollService.java`)
- Notifications → STOMP clients: delivers after commit (evidence: `src/main/java/com/acredispace/backend/notification/service/NotificationService.java`)
- User → Dashboard: views indicators
- User → Billing: manages subscription
- User → Audit log: reviews activity
