HyvFlow (Project Management)

Routes

Route	Purpose
/hyvflow	Workspace listing
/hyvflow/[id]	Portfolio view within workspace
/hyvflow/[id]/pf/[portfolioId]/p/[projectId]/m/[milestoneId]	Task management
/my-tasks	Personal tasks across all workspaces

---

Hierarchy

Workspace → Portfolio → Project → Milestone → Sprint → Task → Subtask

---

Workspace

Fields

Field	Type	Required	Validation
name	text	Yes	Non-empty
members	multi-select	No	From all system users
isdraft	boolean	No	Draft = visible only to creator

On Create

• Generates UUID, sets status (Draft or Active)
• Creates default portfolio: “New Portfolio Beta”
• Notifications sent to assigned members

---

Portfolio

Fields

Field	Type	Required	Validation
name	text	Yes	Non-empty
members	multi-select	No	From workspace members

Member Sync

When members are removed from portfolio, they’re automatically removed from all child projects.

---

Project

Fields

Field	Type	Required	Validation
name	text	Yes	Non-empty
description	textarea	Yes	Non-empty
objectives	textarea	No
requirements	textarea	No
scope	textarea	No
risks	textarea	No
vision	textarea	No
resources	number	No	Min 0
members	multi-select	No	From workspace members
startDate	date	No	Min today
dueDate	date	No	Min startDate

On Create

• Creates default milestone “Milestone” with:
  • 3 status columns: “TO DO” (#E2E8F0), “IN PROGRESS” (#60A5FA), “COMPLETE” (#4ADE80)
  • 1 default sprint: “Sprint 1”
• Project members synced to portfolio
• Notifications sent to all members

---

Milestone

Fields

Field	Type	Required	Validation
name	text	Yes	Non-empty
description	textarea	Yes	Non-empty
startDate	date	No	Min today
dueDate	date	No	Min startDate

Custom Status Columns

Each milestone has configurable status columns (arrayStatus) with name, color, and position. Default: TO DO, IN PROGRESS, COMPLETE.

---

Sprint

Fields

Field	Type	Required	Validation
name	text	Yes	Non-empty
startDate	date	No	Min today
endDate	date	No	Min startDate

Sprints organize tasks within milestones. Can insert at specific positions.

---

Task

All Task Fields

Field	Type	Required	Notes
name	text	Yes	Task title
description	text	No	Rich text content
status	select	Auto	From milestone status columns
priority	enum	Auto (Normal)	Urgent, High, Normal, Low
startDate	date	No
dueDate	date	No
assignees	multi-select	No	Team member UIDs
tags	array	No	Tag objects with title
timeEstimate	string	No	Estimated duration
trackTime	string	No	Actual tracked time
sprintId	string	Auto	Sprint assignment
taskType	enum	Auto (Task)	Task or Milestone
parentId	string	No	For subtasks

Task Creation

1. Type task name in inline form
2. Optionally set start/due dates
3. Click “Add” - creates with Normal priority and current sprint/status

Subtasks

• Created via parentId linking to parent task
• Inherit milestoneId and sprintId from parent
• Expandable/collapsible in task cards
• Count shown as badge

Checklist

• Add items by typing name + Enter
• Toggle done/undone with circle icon
• Each item can have assignees
• Progress shown as {done}/{total}

File Attachments

• Drag-drop or click to upload
• Max 30MB per file
• Checks subscription storage limit
• Storage path: tasks/{taskId}/files/{fileID}
• Creates storage metadata at storageUser/{userId}/files/{fileID}

Activity & Comments

• Comment: Enter text (Enter to submit, Alt+Enter for newline)
• @Mentions: Type @ for autocomplete dropdown, searches by displayName/email
• Image attachments in comments (drag-drop)
• Reply threads stored as nested replies
• Edit/delete own comments
• Activity auto-logged: status changes, file uploads, checklist updates

Relationships & Dependencies

• Types: link, waiting (blocked by), blocking (blocks others)
• Blocker: Cannot mark task complete if waiting relationships have incomplete blockers
• Alert shows: “Hold on - There Are Dependent Tasks” with list
• URL dependencies for external links

Status Update with Subtasks

When marking a task complete that has subtasks:

• Dialog: “Update Task and All Subtasks” or “Update Only This Task”
• Recursive update available

---

Task Views

Kanban Board (Default)

• Sprint sections (collapsible)
• Status columns within each sprint
• Drag-drop tasks between statuses or within column
• Visual drop indicator

List View

• Sprint-grouped task listing
• Status sections within sprints

Table View

• Columns: #, Name, Assignees, Status, Due Date, Created Date, Created By, Tags, Priority, Last Updated
• Sortable by: Name (A-Z), Status, Priority, Due Date, Created At
• Filterable by: Status, Priority, Tags
• Subtask show/hide toggle

Gantt Chart

• Powered by dhtmlx-gantt
• Timeline: 31-day range (past 3 days to future)
• Sprints as parent rows, tasks as children
• Today highlighted
• Click task to open modal

View Switching

View preference persisted via userInterfacesManager.

---

My Tasks (/my-tasks)

Aggregates all tasks assigned to current user across all workspaces/portfolios/projects. Same task modal and editing capabilities as project view.

---

Favorites

Bookmark projects, milestones, or tasks. Shown in sidebar favorites menu.

---

Notifications

Sent on create/edit of workspaces, portfolios, projects, milestones. Contains link to item. @mentions create separate notification records.