chore: move frontend files

frontend/src/views/project/helpers/useGanttFilters.ts

@@ -0,0 +1,128 @@
+import type {Ref} from 'vue'
+import type {RouteLocationNormalized, RouteLocationRaw} from 'vue-router'
+
+import {isoToKebabDate} from '@/helpers/time/isoToKebabDate'
+import {parseDateProp} from '@/helpers/time/parseDateProp'
+import {parseBooleanProp} from '@/helpers/time/parseBooleanProp'
+import {useRouteFilters} from '@/composables/useRouteFilters'
+import {useGanttTaskList} from './useGanttTaskList'
+
+import type {IProject} from '@/modelTypes/IProject'
+import type {GetAllTasksParams} from '@/services/taskCollection'
+
+import type {DateISO} from '@/types/DateISO'
+import type {DateKebab} from '@/types/DateKebab'
+
+// convenient internal filter object
+export interface GanttFilters {
+	projectId: IProject['id']
+	dateFrom: DateISO
+	dateTo: DateISO
+	showTasksWithoutDates: boolean
+}
+
+const DEFAULT_SHOW_TASKS_WITHOUT_DATES = false
+
+const DEFAULT_DATEFROM_DAY_OFFSET = -15
+const DEFAULT_DATETO_DAY_OFFSET = +55
+
+const now = new Date()
+
+function getDefaultDateFrom() {
+	return new Date(now.getFullYear(), now.getMonth(), now.getDate() + DEFAULT_DATEFROM_DAY_OFFSET).toISOString()
+}
+
+function getDefaultDateTo() {
+	return new Date(now.getFullYear(), now.getMonth(), now.getDate() + DEFAULT_DATETO_DAY_OFFSET).toISOString()
+}
+
+// FIXME: use zod for this
+function ganttRouteToFilters(route: Partial<RouteLocationNormalized>): GanttFilters {
+	const ganttRoute = route
+	return {
+		projectId: Number(ganttRoute.params?.projectId),
+		dateFrom: parseDateProp(ganttRoute.query?.dateFrom as DateKebab) || getDefaultDateFrom(),
+		dateTo: parseDateProp(ganttRoute.query?.dateTo as DateKebab) || getDefaultDateTo(),
+		showTasksWithoutDates: parseBooleanProp(ganttRoute.query?.showTasksWithoutDates as string) || DEFAULT_SHOW_TASKS_WITHOUT_DATES,
+	}
+}
+
+function ganttGetDefaultFilters(route: Partial<RouteLocationNormalized>): GanttFilters {
+	return ganttRouteToFilters({params: {projectId: route.params?.projectId as string}})
+}
+
+// FIXME: use zod for this
+function ganttFiltersToRoute(filters: GanttFilters): RouteLocationRaw {
+	let query: Record<string, string> = {}
+	if (
+		filters.dateFrom !== getDefaultDateFrom() ||
+		filters.dateTo !== getDefaultDateTo()
+	) {
+		query = {
+			dateFrom: isoToKebabDate(filters.dateFrom),
+			dateTo: isoToKebabDate(filters.dateTo),
+		}
+	}
+
+	if (filters.showTasksWithoutDates) {
+		query.showTasksWithoutDates = String(filters.showTasksWithoutDates)
+	}
+
+	return {
+		name: 'project.gantt',
+		params: {projectId: filters.projectId},
+		query,
+	}
+}
+
+function ganttFiltersToApiParams(filters: GanttFilters): GetAllTasksParams {
+	return {
+		sort_by: ['start_date', 'done', 'id'],
+		order_by: ['asc', 'asc', 'desc'],
+		filter_by: ['start_date', 'start_date'],
+		filter_comparator: ['greater_equals', 'less_equals'],
+		filter_value: [isoToKebabDate(filters.dateFrom), isoToKebabDate(filters.dateTo)],
+		filter_concat: 'and',
+		filter_include_nulls: filters.showTasksWithoutDates,
+	}
+}
+
+export type UseGanttFiltersReturn =
+	ReturnType<typeof useRouteFilters<GanttFilters>> &
+	ReturnType<typeof useGanttTaskList<GanttFilters>>
+
+export function useGanttFilters(route: Ref<RouteLocationNormalized>): UseGanttFiltersReturn {
+	const {
+		filters,
+		hasDefaultFilters,
+		setDefaultFilters,
+	} = useRouteFilters<GanttFilters>(
+		route,
+		ganttGetDefaultFilters,
+		ganttRouteToFilters,
+		ganttFiltersToRoute,
+		['project.gantt'],
+	)
+
+	const {
+		tasks,
+		loadTasks,
+
+		isLoading,
+		addTask,
+		updateTask,
+	} = useGanttTaskList<GanttFilters>(filters, ganttFiltersToApiParams)
+
+	return {
+		filters,
+		hasDefaultFilters,
+		setDefaultFilters,
+
+		tasks,
+		loadTasks,
+
+		isLoading,
+		addTask,
+		updateTask,
+	}
+}

frontend/src/views/project/helpers/useGanttTaskList.ts

@@ -0,0 +1,102 @@
+import {computed, ref, shallowReactive, watch, type Ref} from 'vue'
+import {klona} from 'klona/lite'
+
+import type {Filters} from '@/composables/useRouteFilters'
+import type {ITask, ITaskPartialWithId} from '@/modelTypes/ITask'
+
+import TaskCollectionService, {type GetAllTasksParams} from '@/services/taskCollection'
+import TaskService from '@/services/task'
+
+import TaskModel from '@/models/task'
+import {error, success} from '@/message'
+
+// FIXME: unify with general `useTaskList`
+export function useGanttTaskList<F extends Filters>(
+	filters: Ref<F>,
+	filterToApiParams: (filters: F) => GetAllTasksParams,
+	options: {
+		loadAll?: boolean,
+	} = {
+		loadAll: true,
+	}) {
+	const taskCollectionService = shallowReactive(new TaskCollectionService())
+	const taskService = shallowReactive(new TaskService())
+
+	const isLoading = computed(() => taskCollectionService.loading)
+
+	const tasks = ref<Map<ITask['id'], ITask>>(new Map())
+
+	async function fetchTasks(params: GetAllTasksParams, page = 1): Promise<ITask[]> {
+		const tasks = await taskCollectionService.getAll({projectId: filters.value.projectId}, params, page) as ITask[]
+		if (options.loadAll && page < taskCollectionService.totalPages) {
+			const nextTasks = await fetchTasks(params, page + 1)
+			return tasks.concat(nextTasks)
+		}
+		return tasks
+	}
+
+	/**
+	 * Load and assign new tasks
+	 * Normally there is no need to trigger this manually
+	 */
+	async function loadTasks() {
+		const params: GetAllTasksParams = filterToApiParams(filters.value)
+
+		const loadedTasks = await fetchTasks(params)
+		tasks.value = new Map()
+		loadedTasks.forEach(t => tasks.value.set(t.id, t))
+	}
+
+	/**
+	 * Load tasks when filters change
+	 */
+	watch(
+		filters,
+		() => loadTasks(),
+		{immediate: true, deep: true},
+	)
+
+	async function addTask(task: Partial<ITask>) {
+		const newTask = await taskService.create(new TaskModel({...task}))
+		tasks.value.set(newTask.id, newTask)
+
+		return newTask
+	}
+
+	async function updateTask(task: ITaskPartialWithId) {
+		const oldTask = klona(tasks.value.get(task.id))
+
+		if (!oldTask) return
+
+		// we extend the task with potentially missing info
+		const newTask: ITask = {
+			...oldTask,
+			...task,
+		}
+
+		// set in expectation that server update works
+		tasks.value.set(newTask.id, newTask)
+
+		try {
+			const updatedTask = await taskService.update(newTask)
+			// update the task with possible changes from server
+			tasks.value.set(updatedTask.id, updatedTask)
+			success('Saved')
+		} catch (e) {
+			error('Something went wrong saving the task')
+			// roll back changes
+			tasks.value.set(task.id, oldTask)
+		}
+	}
+
+
+	return {
+		tasks,
+
+		isLoading,
+		loadTasks,
+
+		addTask,
+		updateTask,
+	}
+}