Task Management Documentation - ProjectHub

Task Management Documentation

This section details the processes involved in managing tasks within ProjectHub, including task creation, assignment, tracking, and completion.

UI Components Structure

graph TD %% Main Components Root[BorderPane: Root] TopBar[HBox: TopBar] Content[SplitPane: Content] SideNav[VBox: Navigation] TaskList[VBox: TaskList] Details[ScrollPane: Details] %% Task List Components SearchBar[SearchBar] TaskTable[TableView: Tasks] Filters[HBox: Filters] %% Task Details Components TaskForm[Form: TaskDetails] Actions[HBox: Actions] Status[StatusBar] %% Hierarchy Root --> TopBar Root --> Content Content --> SideNav Content --> TaskList Content --> Details %% Task List Breakdown TaskList --> SearchBar TaskList --> Filters TaskList --> TaskTable %% Details Breakdown Details --> TaskForm Details --> Actions Details --> Status %% Styling classDef container fill:#e1f5fe,stroke:#01579b classDef component fill:#fff,stroke:#0288d1 classDef action fill:#e8f5e9,stroke:#2e7d32 class Root,Content,TaskList,Details container class SearchBar,TaskTable,TaskForm,Status component class TopBar,Actions,Filters action

Task Operations Sequence

sequenceDiagram actor User participant View participant Controller participant ViewModel participant Service participant DB Note over User,View: Task Creation Flow User->>View: Click Add Task View->>Controller: handleAddTask() Controller->>View: showTaskForm() User->>View: Fill Task Details User->>View: Click Save View->>Controller: handleSaveTask() Controller->>ViewModel: saveTask(TaskDTO) ViewModel->>Service: saveTask() Service->>DB: persist() DB-->>Service: success Service-->>ViewModel: update ViewModel-->>Controller: refresh Controller-->>View: showSuccess() Note over User,View: Task Search Flow User->>View: Enter Search Query View->>Controller: onSearchChange() Controller->>ViewModel: searchTasks() ViewModel->>Service: searchByQuery() Service-->>ViewModel: results ViewModel-->>View: updateTaskList

Data Dictionary

Entities

Entity	Fields	Description
Task	UUID id String name String description String status LocalDate dueDate UUID assigneeId	Task entity

Components

Component	Type	Description
TaskDetailsController	Controller	Handles user interactions and view logic
TaskDetailsViewModel	ViewModel	Manages task data and business logic
TaskService	Service	Handles task persistence and retrieval

Data Transfer Objects

DTO	Fields	Description
TaskDTO	UUID id String name String description String status LocalDate dueDate UUID assigneeId	Task data transfer object

View States

State	Type	Description
selectedTask	SimpleObjectProperty<TaskDTO>	Currently selected task
searchQuery	SimpleStringProperty	Current search filter
tasks	ObservableList<TaskDTO>	List of visible tasks