# profvhs/corkboard architecture

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

- Interactive diagram: https://gitdiagram.com/profvhs/corkboard
- Repository: https://github.com/profvhs/corkboard

## Overview

Corkboard is a real-time project-management application: users work in workspace-scoped release boards and backlogs, manage tasks and tags, and collaborate on workspace documents. The React client presents these workflows and communicates with a Rails backend; Rails routes requests to domain controllers, which persist project data and publish updates. Action Cable and the separate collaboration package support live behavior. The README documents the product capabilities, while the sampled controller and routing excerpts provide only limited implementation-level evidence, so unsampled connections are not asserted.

Main entry points: [`corkboard-backend/config/routes.rb`](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/config/routes.rb) (HTTP routes), [`corkboard-backend/db/schema.rb`](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/db/schema.rb) (PostgreSQL), [`corkboard-frontend/src/main.tsx`](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/main.tsx) (App routes), [`corkboard-backend/app/controllers/tasks_controller.rb`](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/tasks_controller.rb) (Task endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routes<br/>[main.tsx]"]
  node_boards["Release boards"]
  node_backlog["Backlog<br/>[BacklogPage.tsx]"]
  node_documents["Document editor<br/>[Documents.tsx]"]
  node_settings["Workspace settings"]
  node_taskui["Task status UI"]
  node_tagsui["Tag manager<br/>[TagsManager.tsx]"]
  node_api["HTTP API client<br/>[api.ts]"]
end

subgraph group_backend["Rails API"]
  node_routes["HTTP routes<br/>[routes.rb]"]
  node_taskctrl["Task endpoints"]
  node_workspacectrl["Workspace endpoints"]
  node_releasectrl["Release endpoints"]
  node_documentctrl["Document endpoints"]
  node_tagctrl["Tag endpoints<br/>[tags_controller.rb]"]
end

subgraph group_domain["Project domain"]
  node_taskmodel["Task records<br/>[task.rb]"]
  node_workspacemodel["Workspace records<br/>[workspace.rb]"]
  node_releasemodel["Release records<br/>[release.rb]"]
  node_documentmodel["Document records<br/>[document.rb]"]
  node_tagmodel["Tag records<br/>[tag.rb]"]
  node_database[("PostgreSQL<br/>[schema.rb]")]
end

subgraph group_realtime["Live collaboration"]
  node_cable["Action Cable channels"]
  node_broadcaster["Workspace broadcaster"]
  node_collab["Document collaboration<br/>[index.ts]"]
end

subgraph group_auth["Identity and preferences"]
  node_authctrl["Session endpoints"]
  node_preferences["User preferences"]
end

node_user(("Team member"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_boards
node_app -->|"routes to"| node_backlog
node_app -->|"routes to"| node_documents
node_app -->|"routes to"| node_settings
node_boards -.->|"updates status"| node_taskui
node_taskui -.->|"requests update"| node_api
node_tagsui -->|"requests tags"| node_api
node_api -.->|"sends requests"| node_routes
node_routes -->|"routes tasks"| node_taskctrl
node_routes -->|"routes workspaces"| node_workspacectrl
node_routes -->|"routes releases"| node_releasectrl
node_routes -->|"routes documents"| node_documentctrl
node_routes -->|"routes tags"| node_tagctrl
node_routes -->|"routes sessions"| node_authctrl
node_taskctrl -->|"creates and updates"| node_taskmodel
node_taskctrl -->|"creates document"| node_documentmodel
node_taskctrl -->|"broadcasts changes"| node_broadcaster
node_workspacectrl -->|"updates workspace"| node_workspacemodel
node_releasectrl -.->|"manages releases"| node_releasemodel
node_documentctrl -.->|"manages documents"| node_documentmodel
node_tagctrl -.->|"manages tags"| node_tagmodel
node_authctrl -->|"authenticates"| node_user
node_cable -.->|"streams updates"| node_user
node_collab -.->|"enables live editing"| node_documents
node_taskmodel -.->|"persists"| node_database
node_workspacemodel -.->|"persists"| node_database
node_releasemodel -.->|"persists"| node_database
node_documentmodel -.->|"persists"| node_database
node_tagmodel -.->|"persists"| node_database
node_preferences -.->|"persists"| node_database

click node_app "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/main.tsx"
click node_boards "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/pages/CurrentReleasePage/CurrentReleasePage.tsx"
click node_backlog "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/pages/BacklogPage/BacklogPage.tsx"
click node_documents "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/features/Documents/Documents.tsx"
click node_settings "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/features/Settings/WorkspaceGeneral/WorkspaceGeneral.tsx"
click node_taskui "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/ui/Popovers/TaskStatusPopover/useTaskStatusPopover.ts"
click node_tagsui "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/features/Settings/TagsManager/TagsManager.tsx"
click node_api "https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/api/api.ts"
click node_routes "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/config/routes.rb"
click node_taskctrl "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/tasks_controller.rb"
click node_workspacectrl "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/workspaces_controller.rb"
click node_releasectrl "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/releases_controller.rb"
click node_documentctrl "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/documents_controller.rb"
click node_tagctrl "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/tags_controller.rb"
click node_taskmodel "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/task.rb"
click node_workspacemodel "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/workspace.rb"
click node_releasemodel "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/release.rb"
click node_documentmodel "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/document.rb"
click node_tagmodel "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/tag.rb"
click node_database "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/db/schema.rb"
click node_authctrl "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/users/sessions_controller.rb"
click node_preferences "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/user_preferences_controller.rb"
click node_cable "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/channels/workspace_channel.rb"
click node_broadcaster "https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/broadcasters/workspace_broadcaster.rb"
click node_collab "https://github.com/profvhs/corkboard/blob/production/corkboard-collaboration/src/index.ts"

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_boards,node_backlog,node_documents,node_settings,node_taskui,node_tagsui,node_api toneBlue
class node_routes,node_taskctrl,node_workspacectrl,node_releasectrl,node_documentctrl,node_tagctrl toneAmber
class node_taskmodel,node_workspacemodel,node_releasemodel,node_documentmodel,node_tagmodel,node_database toneMint
class node_cable,node_broadcaster,node_collab toneRose
class node_authctrl,node_preferences,node_user toneIndigo
```

## Components

### React client

- [App routes](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/main.tsx): `corkboard-frontend/src/main.tsx`
- [Release boards](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/pages/CurrentReleasePage/CurrentReleasePage.tsx): `corkboard-frontend/src/pages/CurrentReleasePage/CurrentReleasePage.tsx`
- [Backlog](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/pages/BacklogPage/BacklogPage.tsx): `corkboard-frontend/src/pages/BacklogPage/BacklogPage.tsx`
- [Document editor](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/features/Documents/Documents.tsx): `corkboard-frontend/src/components/features/Documents/Documents.tsx`
- [Workspace settings](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/features/Settings/WorkspaceGeneral/WorkspaceGeneral.tsx): `corkboard-frontend/src/components/features/Settings/WorkspaceGeneral/WorkspaceGeneral.tsx`
- [Task status UI](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/ui/Popovers/TaskStatusPopover/useTaskStatusPopover.ts): `corkboard-frontend/src/components/ui/Popovers/TaskStatusPopover/useTaskStatusPopover.ts`
- [Tag manager](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/components/features/Settings/TagsManager/TagsManager.tsx): `corkboard-frontend/src/components/features/Settings/TagsManager/TagsManager.tsx`
- [HTTP API client](https://github.com/profvhs/corkboard/blob/production/corkboard-frontend/src/api/api.ts): `corkboard-frontend/src/api/api.ts`

### Rails API

- [HTTP routes](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/config/routes.rb): `corkboard-backend/config/routes.rb`
- [Task endpoints](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/tasks_controller.rb): `corkboard-backend/app/controllers/tasks_controller.rb`
- [Workspace endpoints](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/workspaces_controller.rb): `corkboard-backend/app/controllers/workspaces_controller.rb`
- [Release endpoints](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/releases_controller.rb): `corkboard-backend/app/controllers/releases_controller.rb`
- [Document endpoints](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/documents_controller.rb): `corkboard-backend/app/controllers/documents_controller.rb`
- [Tag endpoints](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/tags_controller.rb): `corkboard-backend/app/controllers/tags_controller.rb`

### Project domain

- [Task records](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/task.rb): `corkboard-backend/app/models/task.rb`
- [Workspace records](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/workspace.rb): `corkboard-backend/app/models/workspace.rb`
- [Release records](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/release.rb): `corkboard-backend/app/models/release.rb`
- [Document records](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/document.rb): `corkboard-backend/app/models/document.rb`
- [Tag records](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/models/tag.rb): `corkboard-backend/app/models/tag.rb`
- [PostgreSQL](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/db/schema.rb): `corkboard-backend/db/schema.rb`

### Live collaboration

- [Action Cable channels](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/channels/workspace_channel.rb): `corkboard-backend/app/channels/workspace_channel.rb`
- [Workspace broadcaster](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/broadcasters/workspace_broadcaster.rb): `corkboard-backend/app/broadcasters/workspace_broadcaster.rb`
- [Document collaboration](https://github.com/profvhs/corkboard/blob/production/corkboard-collaboration/src/index.ts): `corkboard-collaboration/src/index.ts`

### Identity and preferences

- [Session endpoints](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/users/sessions_controller.rb): `corkboard-backend/app/controllers/users/sessions_controller.rb`
- [User preferences](https://github.com/profvhs/corkboard/blob/production/corkboard-backend/app/controllers/user_preferences_controller.rb): `corkboard-backend/app/controllers/user_preferences_controller.rb`

### Other components

- **Team member**

## Connections

- Team member → App routes: uses (evidence: `corkboard-frontend/src/main.tsx`)
- App routes → Release boards: routes to (evidence: `corkboard-frontend/src/main.tsx`)
- App routes → Backlog: routes to (evidence: `corkboard-frontend/src/main.tsx`)
- App routes → Document editor: routes to (evidence: `corkboard-frontend/src/main.tsx`)
- App routes → Workspace settings: routes to (evidence: `corkboard-frontend/src/main.tsx`)
- Release boards → Task status UI: updates status
- Task status UI → HTTP API client: requests update
- Tag manager → HTTP API client: requests tags (evidence: `corkboard-frontend/src/components/features/Settings/TagsManager/TagsManager.tsx`)
- HTTP API client → HTTP routes: sends requests
- HTTP routes → Task endpoints: routes tasks (evidence: `corkboard-backend/config/routes.rb`)
- HTTP routes → Workspace endpoints: routes workspaces (evidence: `corkboard-backend/config/routes.rb`)
- HTTP routes → Release endpoints: routes releases (evidence: `corkboard-backend/config/routes.rb`)
- HTTP routes → Document endpoints: routes documents (evidence: `corkboard-backend/config/routes.rb`)
- HTTP routes → Tag endpoints: routes tags (evidence: `corkboard-backend/config/routes.rb`)
- HTTP routes → Session endpoints: routes sessions (evidence: `corkboard-backend/config/routes.rb`)
- Task endpoints → Task records: creates and updates (evidence: `corkboard-backend/app/controllers/tasks_controller.rb`)
- Task endpoints → Document records: creates document (evidence: `corkboard-backend/app/controllers/tasks_controller.rb`)
- Task endpoints → Workspace broadcaster: broadcasts changes (evidence: `corkboard-backend/app/controllers/tasks_controller.rb`)
- Workspace endpoints → Workspace records: updates workspace (evidence: `corkboard-backend/app/controllers/workspaces_controller.rb`)
- Release endpoints → Release records: manages releases
- Document endpoints → Document records: manages documents
- Tag endpoints → Tag records: manages tags
- Session endpoints → Team member: authenticates (evidence: `corkboard-backend/app/controllers/users/sessions_controller.rb`)
- Action Cable channels → Team member: streams updates
- Document collaboration → Document editor: enables live editing
- Task records → PostgreSQL: persists
- Workspace records → PostgreSQL: persists
- Release records → PostgreSQL: persists
- Document records → PostgreSQL: persists
- Tag records → PostgreSQL: persists
- User preferences → PostgreSQL: persists
