TaskView is a self-hosted project and task management platform focused on clarity, ownership, and control. TaskView is built for teams that want a transparent, self-hosted alternative to SaaS task managers.
TypeScript graphviewkanban-boardnodejsproductivityproject-managementself-hostedtasktask-managementtask-managertodoapp
import { defineStore } from 'pinia'
import type { GoalItem, KanbanArgDeleteColumn, KanbanArgUpdateColumn, KanbanArgUpdateTasksOrder, KanbanColumnItem, KanbanFilters, TaskArgAdd, KanbanArgAddColumn } from 'taskview-api'
import { DEFAULT_ID } from '@/types/app.types'
import type { KanbanMoveStatusArgs, KanbanStoreState } from '@/types/kanban.types'
import { $tvApi } from '@/plugins/axios'
import { TaskItem } from '@/types/tasks.types'
import { hasActiveFilters } from '@/helpers/Helper'
export const useKanbanStore = defineStore('kanban', {
state(): KanbanStoreState {
return {
tasksData: {},
statuses: [],
goalId: DEFAULT_ID,
filters: {},
}
},
actions: {
async fetchTasksForColumn(goalId: GoalItem['id'], columnId: KanbanColumnItem['id'] | null, cursor: string | number | null) {
const result = await $tvApi.kanban.fetchTasksForColumn(goalId, columnId, cursor, this.filters).catch(console.error)
if (!result) {
if (!this.tasksData[columnId ?? DEFAULT_ID]) {
this.tasksData[columnId ?? DEFAULT_ID] = {
tasks: [],
nextCursor: null,
columnVersion: null,
}
}
return
}
if (!this.tasksData[columnId ?? DEFAULT_ID]) {
this.tasksData[columnId ?? DEFAULT_ID] = {
tasks: [],
nextCursor: null,
columnVersion: null,
}
}
// if (cursor === null) {
// this.tasksData[columnId ?? DEFAULT_ID]!.tasks = result.tasks
// } else {
// A task can already be on the board when a real-time insert lands while the page is in flight
this.tasksData[columnId ?? DEFAULT_ID]!.tasks.push(...result.tasks.filter((task) => !this.hasTask(task.id)))
// }
this.tasksData[columnId ?? DEFAULT_ID]!.nextCursor = result.nextCursor
this.tasksData[columnId ?? DEFAULT_ID]!.columnVersion = result.columnVersion
},
// async fetchTasksOrderForColumnAndCursor(goalId: GoalItem['id'], columnId: Task['statusId'], cursor: string | number | null) {
// const result = await $tvApi.kanban.getTasksOrderForColumnAndCursor(goalId, columnId, cursor).catch(console.error);
// if (!result) {
// return;
// }
// result.forEach((task) => {
// const localTask = this.tasksData[columnId ?? DEFAULT_ID]?.tasks.find((t) => t.id === task.id);
// if (!localTask) return;
// localTask.kanbanOrder = task.kanbanOrder;
// });
// },
async updateTasksOrderAndColumn(data: KanbanArgUpdateTasksOrder) {
const result = await $tvApi.kanban.updateTasksOrderAndColumn(data).catch(console.error)
if (!result) {
return
}
result.tasks.forEach((task) => {
const localTask = this.tasksData[data.columnId ?? DEFAULT_ID]?.tasks.find((t) => t.id === task.id)
if (!localTask) return
localTask.kanbanOrder = task.kanbanOrder
})
// if the column version is different, fetch the tasks again
if (this.tasksData[data.columnId ?? DEFAULT_ID]!.columnVersion !== result.columnVersion) {
this.tasksData[data.columnId ?? DEFAULT_ID]!.tasks = []
this.tasksData[data.columnId ?? DEFAULT_ID]!.nextCursor = null
this.tasksData[data.columnId ?? DEFAULT_ID]!.columnVersion = null
await this.fetchTasksForColumn(this.goalId, data.columnId ?? null, null)
}
this.tasksData[data.columnId ?? DEFAULT_ID]!.columnVersion = result.columnVersion
},
async addTask(taskArg: TaskArgAdd) {
const result = await $tvApi.tasks.createTask(taskArg).catch(console.error)
if (!result) {
return
}
// The real-time insert of this task may have landed before the response
if (this.hasTask(result.id)) return
this.tasksData[taskArg.statusId ?? DEFAULT_ID]?.tasks.unshift(result)
},
async fetchStatuses(goalId: GoalItem['id']) {
const result = await $tvApi.kanban.fetchAllColumns(goalId)
if (!result) {
return
}
this.statuses = result
this.statuses.unshift({
id: DEFAULT_ID,
name: 'msg.allTasks',
goalId: this.goalId,
viewOrder: 0,
})
},
async addStatus(data: KanbanArgAddColumn) {
const result = await $tvApi.kanban.addColumn(data)
if (!result) {
return
}
this.statuses.push(result)
this.tasksData[result.id] = {
tasks: [],
nextCursor: null,
columnVersion: null,
}
},
async moveStatus(args: KanbanMoveStatusArgs): Promise<boolean> {
const backlog = this.statuses.filter((stat) => stat.id === DEFAULT_ID)
const columns = this.statuses.filter((stat) => stat.id !== DEFAULT_ID)
const index = columns.findIndex((stat) => stat.id === args.statusId)
const target = args.direction === 'left' ? index - 1 : index + 1
if (index === -1 || target < 0 || target >= columns.length) return false
const previous = [...this.statuses]
const [moved] = columns.splice(index, 1)
columns.splice(target, 0, moved)
this.statuses = [...backlog, ...columns]
try {
const saved = await $tvApi.kanban.reorderColumns({
goalId: this.goalId,
statusIds: columns.map((stat) => stat.id),
})
this.statuses = [...backlog, ...saved]
return true
} catch {
this.statuses = previous
return false
}
},
async updateStatus(data: KanbanArgUpdateColumn) {
const result = await $tvApi.kanban.updateColumn(data)
if (!result) {
return
}
const index = this.statuses.findIndex((stat) => stat.id === data.id)
if (index !== -1) {
this.statuses[index] = { ...this.statuses[index], ...data }
}
},
syncTask(task: TaskItem) {
const targetColumnId = task.statusId ?? DEFAULT_ID
for (const columnId of Object.keys(this.tasksData)) {
const column = this.tasksData[Number(columnId)]
if (!column) continue
const index = column.tasks.findIndex((t) => t.id === task.id)
if (index === -1) continue
if (Number(columnId) === targetColumnId) {
Object.assign(column.tasks[index], task)
} else {
column.tasks.splice(index, 1)
const targetColumn = this.tasksData[targetColumnId]
if (targetColumn) {
targetColumn.tasks.unshift(task)
}
}
return
}
},
hasTask(taskId: number): boolean {
return Object.values(this.tasksData).some((column) => column?.tasks.some((task) => task.id === taskId))
},
insertTask(task: TaskItem) {
if (this.goalId !== task.goalId || task.parentId || hasActiveFilters(this.filters)) return
const column = this.tasksData[task.statusId ?? DEFAULT_ID]
if (!column || this.hasTask(task.id)) return
column.tasks.unshift(task)
},
removeTask(taskId: number) {
for (const columnId of Object.keys(this.tasksData)) {
const column = this.tasksData[Number(columnId)]
if (!column) continue
const index = column.tasks.findIndex((t: { id: number }) => t.id === taskId)
if (index !== -1) {
column.tasks.splice(index, 1)
return
}
}
},
setFilters(filters: KanbanFilters) {
this.filters = filters
},
async reloadColumns() {
this.tasksData = {}
await Promise.all(this.statuses.map((status) =>
this.fetchTasksForColumn(this.goalId, status.id === DEFAULT_ID ? null : status.id, null),
))
},
async deleteStatus(data: KanbanArgDeleteColumn) {
const result = await $tvApi.kanban.deleteColumn(data)
if (!result) {
return
}
const index = this.statuses.findIndex((stat) => stat.id === data.id)
if (index !== -1) {
this.statuses.splice(index, 1)
}
this.tasksData[data.id]?.tasks.forEach((t) => {
if (t.statusId === data.id) {
t.statusId = null
}
})
delete this.tasksData[data.id]
},
},
})