feat(tracker): Gantt — #2 read-only viewlet

common/scripts/version.txt

@@ -1 +1 @@
-"0.7.422"
+"0.7.423"

models/tracker/src/__tests__/migration.test.ts

@@ -0,0 +1,49 @@
+//
+// Copyright © 2026 Hardcore Engineering Inc.
+//
+// Licensed under the Eclipse Public License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+//
+
+import { DOMAIN_TASK } from '@hcengineering/model-task'
+import tracker from '@hcengineering/tracker'
+
+import { DOMAIN_TRACKER } from '../types'
+import { migrateAddStartDate } from '../migration'
+
+describe('migrateAddStartDate', () => {
+  it('sets startDate=null on every Issue lacking the field (DOMAIN_TASK)', async () => {
+    const update = jest.fn().mockResolvedValue(undefined)
+    const client: any = { update }
+
+    await migrateAddStartDate(client)
+
+    expect(update).toHaveBeenCalledWith(
+      DOMAIN_TASK,
+      { _class: tracker.class.Issue, startDate: { $exists: false } },
+      { startDate: null }
+    )
+  })
+
+  it('sets startDate=null on every Milestone lacking the field (DOMAIN_TRACKER)', async () => {
+    const update = jest.fn().mockResolvedValue(undefined)
+    const client: any = { update }
+
+    await migrateAddStartDate(client)
+
+    expect(update).toHaveBeenCalledWith(
+      DOMAIN_TRACKER,
+      { _class: tracker.class.Milestone, startDate: { $exists: false } },
+      { startDate: null }
+    )
+  })
+
+  it('issues exactly two update calls (one per class)', async () => {
+    const update = jest.fn().mockResolvedValue(undefined)
+    const client: any = { update }
+
+    await migrateAddStartDate(client)
+
+    expect(update).toHaveBeenCalledTimes(2)
+  })
+})

models/tracker/src/index.ts

@@ -39,6 +39,7 @@ import {
   TClassicProjectTypeData,
   TComponent,
   TIssue,
+  TIssueRelation,
   TIssueStatus,
   TIssueTemplate,
   TIssueTypeData,
@@ -195,7 +196,9 @@ function defineFilters (builder: Builder): void {
         key: 'milestone',
         component: view.component.ObjectFilter,
         showNested: false
-      }
+      },
+      'startDate',
+      'dueDate'
     ],
     ignoreKeys: ['number', 'estimation', 'attachedTo'],
     getVisibleFilters: tracker.function.GetVisibleFilters
@@ -441,6 +444,7 @@ export function createModel (builder: Builder): void {
     TProject,
     TComponent,
     TIssue,
+    TIssueRelation,
     TIssueTemplate,
     TIssueStatus,
     TTypeIssuePriority,

models/tracker/src/migration.ts

@@ -47,6 +47,7 @@ import tracker, {
 } from '@hcengineering/tracker'
 
 import { classicIssueTaskStatuses } from '.'
+import { DOMAIN_TRACKER } from './types'
 
 async function createDefaultProject (tx: TxOperations): Promise<void> {
   const current = await tx.findOne(tracker.class.Project, {
@@ -170,6 +171,20 @@ async function migrateIdentifiers (client: MigrationClient): Promise<void> {
   }
 }
 
+export async function migrateAddStartDate (client: MigrationClient): Promise<void> {
+  // Issues live in DOMAIN_TASK; Milestones live in DOMAIN_TRACKER.
+  await client.update(
+    DOMAIN_TASK,
+    { _class: tracker.class.Issue, startDate: { $exists: false } },
+    { startDate: null }
+  )
+  await client.update(
+    DOMAIN_TRACKER,
+    { _class: tracker.class.Milestone, startDate: { $exists: false } },
+    { startDate: null }
+  )
+}
+
 async function migrateDefaultStatuses (client: MigrationClient, logger: ModelLogger): Promise<void> {
   const defaultTypeId = tracker.ids.ClassingProjectType
   const typeDescriptor = tracker.descriptors.ProjectType
@@ -398,6 +413,11 @@ export const trackerOperation: MigrateOperation = {
         state: 'migrateDefaultTypeMixins',
         mode: 'upgrade',
         func: migrateDefaultTypeMixins
+      },
+      {
+        state: 'gantt-add-startdate',
+        mode: 'upgrade',
+        func: migrateAddStartDate
       }
     ])
   },

models/tracker/src/types.ts

@@ -58,10 +58,12 @@ import time, { type ToDo } from '@hcengineering/time'
 import {
   type ProjectTargetPreference,
   type Component,
+  type DependencyKind,
   type Issue,
   type IssueChildInfo,
   type IssueParentInfo,
   type IssuePriority,
+  type IssueRelation,
   type IssueStatus,
   type IssueTemplate,
   type IssueTemplateChild,
@@ -233,6 +235,10 @@ export class TIssue extends TTask implements Issue {
   @ReadOnly()
   declare space: Ref<Project>
 
+  @Prop(TypeDate(DateRangeMode.DATETIME), tracker.string.IssueStartDate)
+  @Index(IndexKind.Indexed)
+  declare startDate: Timestamp | null
+
   @Prop(TypeDate(DateRangeMode.DATETIME), tracker.string.DueDate)
   declare dueDate: Timestamp | null
 
@@ -340,6 +346,28 @@ export class TTimeSpendReport extends TAttachedDoc implements TimeSpendReport {
   @Prop(TypeString(), tracker.string.TimeSpendReportDescription)
     description!: string
 }
+
+/**
+ * @public
+ */
+@Model(tracker.class.IssueRelation, core.class.AttachedDoc, DOMAIN_TRACKER)
+@UX(tracker.string.GanttDependency, tracker.icon.Issue)
+export class TIssueRelation extends TAttachedDoc implements IssueRelation {
+  @Prop(TypeRef(tracker.class.Issue), tracker.string.Issue)
+  declare attachedTo: Ref<Issue>
+
+  declare collection: 'relations'
+
+  @Prop(TypeRef(tracker.class.Issue), tracker.string.Issue)
+  @Index(IndexKind.Indexed)
+    target!: Ref<Issue>
+
+  @Prop(TypeString(), tracker.string.GanttDependency)
+    kind!: DependencyKind
+
+  @Prop(TypeNumber(), tracker.string.GanttLag)
+    lag!: number
+}
 /**
  * @public
  */
@@ -389,6 +417,9 @@ export class TMilestone extends TDoc implements Milestone {
   @Prop(Collection(attachment.class.Attachment), attachment.string.Attachments, { shortLabel: attachment.string.Files })
     attachments?: number
 
+  @Prop(TypeDate(), tracker.string.StartDate)
+    startDate!: Timestamp | null
+
   @Prop(TypeDate(), tracker.string.TargetDate)
     targetDate!: Timestamp
 

models/tracker/src/viewlets.ts

@@ -212,6 +212,51 @@ export function issueConfig (
   ]
 }
 
+export function ganttViewOptions (): ViewOptionsModel {
+  // PR 2 ships a minimal read-only Gantt. Group-by + Show-colors are
+  // intentionally NOT advertised — the canvas does not honour them yet.
+  // The two sidebar-column toggles below ARE wired up to GanttSidebar.
+  return {
+    groupBy: [],
+    orderBy: [
+      ['startDate', SortingOrder.Ascending],
+      ['rank', SortingOrder.Ascending],
+      ['dueDate', SortingOrder.Ascending]
+    ],
+    other: [
+      {
+        key: 'ganttShowIssueCode',
+        type: 'toggle',
+        defaultValue: false,
+        actionTarget: 'display',
+        label: tracker.string.GanttShowIssueCode
+      },
+      {
+        key: 'ganttShowTitle',
+        type: 'toggle',
+        defaultValue: true,
+        actionTarget: 'display',
+        label: tracker.string.GanttShowTitle
+      },
+      {
+        key: 'ganttShowStatus',
+        type: 'toggle',
+        defaultValue: true,
+        actionTarget: 'display',
+        label: tracker.string.GanttShowStatus
+      }
+    ]
+  }
+}
+
+export function ganttConfig (): BuildModelKey[] {
+  // Minimal config — Gantt drives its own column layout.
+  return [
+    { key: '', presenter: tracker.component.PriorityEditor, label: tracker.string.Priority, props: { kind: 'list', size: 'small' } },
+    { key: '', presenter: tracker.component.IssuePresenter, label: tracker.string.Issue }
+  ]
+}
+
 export function defineViewlets (builder: Builder): void {
   builder.createDoc(
     view.class.ViewletDescriptor,
@@ -224,6 +269,17 @@ export function defineViewlets (builder: Builder): void {
     tracker.viewlet.Kanban
   )
 
+  builder.createDoc(
+    view.class.ViewletDescriptor,
+    core.space.Model,
+    {
+      label: tracker.string.Gantt,
+      icon: tracker.icon.Gantt,
+      component: tracker.component.GanttView
+    },
+    tracker.viewlet.Gantt
+  )
+
   builder.createDoc(
     view.class.Viewlet,
     core.space.Model,
@@ -501,6 +557,23 @@ export function defineViewlets (builder: Builder): void {
     tracker.viewlet.IssueKanban
   )
 
+  // Gantt is registered AFTER List + Kanban so List remains the default
+  // viewlet (ViewletSelector falls back to viewlets[0] when no preference
+  // is saved). Putting Gantt last avoids surprising users with an empty
+  // canvas on first visit.
+  builder.createDoc(
+    view.class.Viewlet,
+    core.space.Model,
+    {
+      attachTo: tracker.class.Issue,
+      descriptor: tracker.viewlet.Gantt,
+      viewOptions: ganttViewOptions(),
+      configOptions: { strict: true, hiddenKeys: ['title'] },
+      config: ganttConfig()
+    },
+    tracker.viewlet.IssueGantt
+  )
+
   const componentListViewOptions: ViewOptionsModel = {
     groupBy: ['lead', 'createdBy', 'modifiedBy'],
     orderBy: [
@@ -663,7 +736,7 @@ export function defineViewlets (builder: Builder): void {
       viewOptions: milestoneOptions,
       configOptions: {
         strict: true,
-        hiddenKeys: ['targetDate', 'label', 'description']
+        hiddenKeys: ['startDate', 'targetDate', 'label', 'description']
       },
       config: [
         {
@@ -672,6 +745,12 @@ export function defineViewlets (builder: Builder): void {
         },
         { key: '', presenter: tracker.component.MilestonePresenter, props: { shouldUseMargin: true } },
         { key: '', displayProps: { grow: true } },
+        {
+          key: '',
+          label: tracker.string.StartDate,
+          presenter: tracker.component.MilestoneDatePresenter,
+          props: { field: 'startDate' }
+        },
         {
           key: '',
           label: tracker.string.TargetDate,

packages/importer/src/importer/importer.ts

@@ -591,6 +591,7 @@ export class WorkspaceImporter {
       rank,
       comments: issue.comments?.length ?? 0,
       subIssues: issue.subdocs.length,
+      startDate: null,
       dueDate: null,
       parents: parentsInfo,
       remainingTime,

plugins/tracker-assets/lang/cs.json

@@ -115,6 +115,9 @@
     "NoAssignee": "Bez přiřazení",
     "LastUpdated": "Poslední aktualizace",
     "DueDate": "Datum splnění",
+    "IssueStartDate": "Datum zahájení",
+    "GanttDependency": "Dependency",
+    "GanttLag": "Lag",
     "Manual": "Manuální",
     "All": "Vše",
     "PastWeek": "Minulý týden",
@@ -280,7 +283,26 @@
     "UnsetParentIssue": "Odebrat nadřazený úkol",
     "ForbidCreateProjectPermission": "Zakázat vytvoření projektu",
     "ForbidCreateProjectPermissionDescription": "Zakazuje uživatelům vytvářet nové projekty",
-    "AllowCreatingIssues": "Povolit vytváření úkolů"
+    "AllowCreatingIssues": "Povolit vytváření úkolů",
+    "Day": "Day",
+    "Week": "Week",
+    "Month": "Month",
+    "Quarter": "Quarter",
+    "Gantt": "Gantt",
+    "GanttShowIssueCode": "Show issue code",
+    "GanttShowTitle": "Show title",
+    "GanttShowStatus": "Show status",
+    "GanttToday": "Today",
+    "GanttJumpToStart": "Jump to start",
+    "GanttJumpToEnd": "Jump to end",
+    "GanttJumpToDate": "Jump to date",
+    "GanttPreviousPeriod": "Previous period",
+    "GanttNextPeriod": "Next period",
+    "GanttScrollLeftToBar": "Scroll left to bar",
+    "GanttScrollRightToBar": "Scroll right to bar",
+    "GanttExpand": "Expand",
+    "GanttCollapse": "Collapse"
+
   },
   "status": {}
 }

plugins/tracker-assets/lang/de.json

@@ -125,6 +125,9 @@
     "NoAssignee": "Nicht zugewiesen",
     "LastUpdated": "Zuletzt aktualisiert",
     "DueDate": "Fälligkeitsdatum",
+    "IssueStartDate": "Startdatum",
+    "GanttDependency": "Abhängigkeit",
+    "GanttLag": "Verzögerung",
     "Manual": "Manuell",
     "All": "Alle",
     "PastWeek": "Letzte Woche",
@@ -290,7 +293,26 @@
     "UnsetParentIssue": "Übergeordnete Aufgabe entfernen",
     "ForbidCreateProjectPermission": "Projekterstellung verbieten",
     "ForbidCreateProjectPermissionDescription": "Verbietet Benutzern das Erstellen neuer Projekte",
-    "AllowCreatingIssues": "Erstellen von Aufgaben erlauben"
+    "AllowCreatingIssues": "Erstellen von Aufgaben erlauben",
+    "Day": "Day",
+    "Week": "Week",
+    "Month": "Month",
+    "Quarter": "Quarter",
+    "Gantt": "Gantt",
+    "GanttShowIssueCode": "Show issue code",
+    "GanttShowTitle": "Show title",
+    "GanttShowStatus": "Show status",
+    "GanttToday": "Today",
+    "GanttJumpToStart": "Jump to start",
+    "GanttJumpToEnd": "Jump to end",
+    "GanttJumpToDate": "Jump to date",
+    "GanttPreviousPeriod": "Previous period",
+    "GanttNextPeriod": "Next period",
+    "GanttScrollLeftToBar": "Scroll left to bar",
+    "GanttScrollRightToBar": "Scroll right to bar",
+    "GanttExpand": "Expand",
+    "GanttCollapse": "Collapse"
+
   },
   "status": {}
 }