# shashankfeb16/devloom architecture

> Architecture diagram of the GitHub repository shashankfeb16/devloom, 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/shashankfeb16/devloom
- Repository: https://github.com/shashankfeb16/devloom

## Overview

Devloom is a Phoenix/LiveView shared developer workspace. Users register or sign in, enter a membership-scoped workspace, then collaborate through its board, whiteboard, chat, meetings, and recordings. Workspace membership and invitations govern access; PostgreSQL persists account and collaboration state. The router excerpt establishes the web entry points, and the README documents major product behavior. Most LiveView and meeting implementation files were not sampled, so their internal calls and data flows are omitted rather than inferred.

Main entry points: [`lib/devloom_web/router.ex`](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/router.ex) (Web router), [`lib/devloom_web/live/chat_live.ex`](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/chat_live.ex) (Team & direct chat), [`lib/devloom_web/controllers/recording_controller.ex`](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/recording_controller.ex) (Recording delivery), [`lib/devloom/repo.ex`](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/repo.ex) (PostgreSQL repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity &amp; Workspaces"]
  node_registration["Registration"]
  node_session["Sign-in session"]
  node_accounts["Accounts<br/>[accounts.ex]"]
  node_workspaces["Workspace access<br/>[workspaces.ex]"]
  node_members["Member management"]
  node_invitations["Invitations<br/>[invitation_live.ex]"]
  node_workspace_view["Workspace home<br/>[workspace_live.ex]"]
end

subgraph group_collaboration["Workspace Collaboration"]
  node_board_view["Kanban board<br/>[board_live.ex]"]
  node_boards["Board domain<br/>[boards.ex]"]
  node_whiteboard_view["Shared whiteboard<br/>[whiteboard_live.ex]"]
  node_whiteboards["Whiteboard domain<br/>[whiteboards.ex]"]
  node_chat_view["Team &amp; direct chat<br/>[chat_live.ex]"]
  node_chat["Team chat domain<br/>[chat.ex]"]
  node_direct_messages["Direct messages<br/>[direct_messages.ex]"]
end

subgraph group_meetings["Meetings &amp; Media"]
  node_meeting_view["Meetings<br/>[meeting_live.ex]"]
  node_meeting_domain["Meeting services<br/>[meetings.ex]"]
  node_recordings_view["Recordings<br/>[recordings_live.ex]"]
  node_recordings["Recording services<br/>[recordings.ex]"]
  node_recording_delivery["Recording delivery"]
  node_transcripts["Transcription service<br/>[server.py]"]
end

subgraph group_runtime["Application Runtime"]
  node_endpoint["Phoenix endpoint<br/>[endpoint.ex]"]
  node_router["Web router<br/>[router.ex]"]
  node_repo[("PostgreSQL repository<br/>[repo.ex]")]
end

node_member(("Workspace user"))
node_object_storage[("S3-compatible storage")]

node_member -->|"opens app"| node_endpoint
node_endpoint -.->|"routes requests"| node_router
node_router -->|"routes registration"| node_registration
node_router -->|"routes sign-in"| node_session
node_router -->|"routes workspace"| node_workspace_view
node_router -->|"routes members"| node_members
node_router -->|"routes invitations"| node_invitations
node_router -->|"routes board"| node_board_view
node_router -->|"routes whiteboard"| node_whiteboard_view
node_router -->|"routes chat"| node_chat_view
node_router -->|"routes meetings"| node_meeting_view
node_router -->|"routes recordings"| node_recordings_view
node_router -->|"routes video"| node_recording_delivery
node_registration -->|"registers with"| node_workspaces
node_session -->|"authenticates via"| node_accounts
node_board_view -.->|"uses board data"| node_boards
node_whiteboard_view -.->|"uses canvas data"| node_whiteboards
node_chat_view -.->|"uses team chat"| node_chat
node_chat_view -.->|"supports direct chat"| node_direct_messages
node_meeting_view -.->|"uses meeting services"| node_meeting_domain
node_recordings_view -.->|"uses recordings"| node_recordings
node_recording_delivery -->|"redirects to playback"| node_object_storage
node_recording_delivery -->|"fetches recording"| node_recordings
node_boards -->|"persists changes"| node_repo
node_whiteboards -->|"autosaves canvas"| node_repo
node_chat -->|"persists messages"| node_repo
node_meeting_domain -.->|"transcription integration"| node_transcripts

click node_endpoint "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/endpoint.ex"
click node_router "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/router.ex"
click node_registration "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/registration_controller.ex"
click node_session "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/session_controller.ex"
click node_accounts "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/accounts.ex"
click node_workspaces "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/workspaces.ex"
click node_members "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/workspace_members_live.ex"
click node_invitations "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/invitation_live.ex"
click node_workspace_view "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/workspace_live.ex"
click node_board_view "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/board_live.ex"
click node_boards "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/boards.ex"
click node_whiteboard_view "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/whiteboard_live.ex"
click node_whiteboards "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/whiteboards.ex"
click node_chat_view "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/chat_live.ex"
click node_chat "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/chat.ex"
click node_direct_messages "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/direct_messages.ex"
click node_meeting_view "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/meeting_live.ex"
click node_meeting_domain "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/meetings.ex"
click node_recordings_view "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/recordings_live.ex"
click node_recordings "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/meetings/recordings.ex"
click node_recording_delivery "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/recording_controller.ex"
click node_transcripts "https://github.com/shashankfeb16/devloom/blob/main/docker/transcription/server.py"
click node_repo "https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/repo.ex"

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_registration,node_session,node_accounts,node_workspaces,node_members,node_invitations,node_workspace_view,node_member toneBlue
class node_board_view,node_boards,node_whiteboard_view,node_whiteboards,node_chat_view,node_chat,node_direct_messages,node_object_storage toneAmber
class node_meeting_view,node_meeting_domain,node_recordings_view,node_recordings,node_recording_delivery,node_transcripts toneMint
class node_endpoint,node_router,node_repo toneRose
```

## Components

### Identity & Workspaces

- [Registration](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/registration_controller.ex): `lib/devloom_web/controllers/registration_controller.ex`
- [Sign-in session](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/session_controller.ex): `lib/devloom_web/controllers/session_controller.ex`
- [Accounts](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/accounts.ex): `lib/devloom/accounts.ex`
- [Workspace access](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/workspaces.ex): `lib/devloom/workspaces.ex`
- [Member management](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/workspace_members_live.ex): `lib/devloom_web/live/workspace_members_live.ex`
- [Invitations](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/invitation_live.ex): `lib/devloom_web/live/invitation_live.ex`
- [Workspace home](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/workspace_live.ex): `lib/devloom_web/live/workspace_live.ex`

### Workspace Collaboration

- [Kanban board](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/board_live.ex): `lib/devloom_web/live/board_live.ex`
- [Board domain](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/boards.ex): `lib/devloom/boards.ex`
- [Shared whiteboard](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/whiteboard_live.ex): `lib/devloom_web/live/whiteboard_live.ex`
- [Whiteboard domain](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/whiteboards.ex): `lib/devloom/whiteboards.ex`
- [Team & direct chat](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/chat_live.ex): `lib/devloom_web/live/chat_live.ex`
- [Team chat domain](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/chat.ex): `lib/devloom/chat.ex`
- [Direct messages](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/direct_messages.ex): `lib/devloom/direct_messages.ex`

### Meetings & Media

- [Meetings](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/meeting_live.ex): `lib/devloom_web/live/meeting_live.ex`
- [Meeting services](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/meetings.ex): `lib/devloom/meetings.ex`
- [Recordings](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/live/recordings_live.ex): `lib/devloom_web/live/recordings_live.ex`
- [Recording services](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/meetings/recordings.ex): `lib/devloom/meetings/recordings.ex`
- [Recording delivery](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/controllers/recording_controller.ex): `lib/devloom_web/controllers/recording_controller.ex`
- [Transcription service](https://github.com/shashankfeb16/devloom/blob/main/docker/transcription/server.py): `docker/transcription/server.py`

### Application Runtime

- [Phoenix endpoint](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/endpoint.ex): `lib/devloom_web/endpoint.ex`
- [Web router](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom_web/router.ex): `lib/devloom_web/router.ex`
- [PostgreSQL repository](https://github.com/shashankfeb16/devloom/blob/main/lib/devloom/repo.ex): `lib/devloom/repo.ex`

### Other components

- **Workspace user**
- **S3-compatible storage**

## Connections

- Workspace user → Phoenix endpoint: opens app
- Phoenix endpoint → Web router: routes requests
- Web router → Registration: routes registration (evidence: `lib/devloom_web/router.ex`)
- Web router → Sign-in session: routes sign-in (evidence: `lib/devloom_web/router.ex`)
- Web router → Workspace home: routes workspace (evidence: `lib/devloom_web/router.ex`)
- Web router → Member management: routes members (evidence: `lib/devloom_web/router.ex`)
- Web router → Invitations: routes invitations (evidence: `lib/devloom_web/router.ex`)
- Web router → Kanban board: routes board (evidence: `lib/devloom_web/router.ex`)
- Web router → Shared whiteboard: routes whiteboard (evidence: `lib/devloom_web/router.ex`)
- Web router → Team & direct chat: routes chat (evidence: `lib/devloom_web/router.ex`)
- Web router → Meetings: routes meetings (evidence: `lib/devloom_web/router.ex`)
- Web router → Recordings: routes recordings (evidence: `lib/devloom_web/router.ex`)
- Web router → Recording delivery: routes video (evidence: `lib/devloom_web/router.ex`)
- Registration → Workspace access: registers with (evidence: `lib/devloom_web/controllers/registration_controller.ex`)
- Sign-in session → Accounts: authenticates via (evidence: `lib/devloom_web/controllers/session_controller.ex`)
- Kanban board → Board domain: uses board data
- Shared whiteboard → Whiteboard domain: uses canvas data
- Team & direct chat → Team chat domain: uses team chat
- Team & direct chat → Direct messages: supports direct chat
- Meetings → Meeting services: uses meeting services
- Recordings → Recording services: uses recordings
- Recording delivery → S3-compatible storage: redirects to playback (evidence: `lib/devloom_web/controllers/recording_controller.ex`)
- Recording delivery → Recording services: fetches recording (evidence: `lib/devloom_web/controllers/recording_controller.ex`)
- Board domain → PostgreSQL repository: persists changes
- Whiteboard domain → PostgreSQL repository: autosaves canvas
- Team chat domain → PostgreSQL repository: persists messages
- Meeting services → Transcription service: transcription integration
