feat: sprints with burndown and carry-over

Plan sprints with dates and a goal, run one at a time per project, and
put tickets in them from the ticket page. The Sprints tab follows the one
under way with its progress and a burndown in tickets or points against
the ideal line. Closing a sprint sends what was left to the next one or
back to the backlog; the board can be filtered by sprint.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

libs/api/tracker/presenters/src/lib/http/dto/requests.dto.ts

@@ -285,6 +285,11 @@ export class BoardQueryDto {
   @IsBoolean()
   unassigned?: boolean;
 
+  @ApiPropertyOptional({ format: 'uuid', description: 'Only this sprint' })
+  @IsOptional()
+  @IsUUID()
+  sprintId?: string;
+
   @ApiPropertyOptional({ type: Number, default: 50, minimum: 1, maximum: 200 })
   @IsOptional()
   @Type(() => Number)
@@ -451,6 +456,17 @@ export class IssueSearchQueryDto extends PageQueryDto {
   @IsString()
   parent?: string;
 
+  @ApiPropertyOptional({ format: 'uuid', description: 'Only this sprint' })
+  @IsOptional()
+  @IsUUID()
+  sprintId?: string;
+
+  @ApiPropertyOptional({ description: 'Only tickets in no sprint' })
+  @IsOptional()
+  @Transform(toBoolean)
+  @IsBoolean()
+  noSprint?: boolean;
+
   @ApiPropertyOptional({
     enum: IssueSort,
     enumName: 'IssueSort',
@@ -819,6 +835,66 @@ export class CreateReleaseDto {
 
 export class UpdateReleaseDto extends PartialType(CreateReleaseDto) {}
 
+const DAY = /^\d{4}-\d{2}-\d{2}$/;
+
+export class CreateSprintDto {
+  @ApiProperty({ example: 'Sprint 14', maxLength: 80 })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(80)
+  name!: string;
+
+  @ApiPropertyOptional({
+    type: String,
+    nullable: true,
+    maxLength: 500,
+    example: 'Pagos con tarjeta en producción',
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  goal?: string | null;
+
+  @ApiProperty({ format: 'date', example: '2026-10-12' })
+  @Matches(DAY)
+  startDate!: string;
+
+  @ApiProperty({
+    format: 'date',
+    example: '2026-10-23',
+    description: 'Last day, included',
+  })
+  @Matches(DAY)
+  endDate!: string;
+}
+
+export class UpdateSprintDto extends PartialType(CreateSprintDto) {}
+
+export class CloseSprintDto {
+  @ApiPropertyOptional({
+    type: String,
+    nullable: true,
+    format: 'uuid',
+    description:
+      'Open sprint of the same project that takes the unfinished tickets; null or absent: back to the backlog',
+  })
+  @IsOptional()
+  @IsUUID()
+  carryOverTo?: string | null;
+}
+
+export class SetIssueSprintDto {
+  @ApiProperty({
+    type: String,
+    nullable: true,
+    format: 'uuid',
+    description: 'Open sprint of the project, or null for the backlog',
+  })
+  @ValidateIf((dto: SetIssueSprintDto) => dto.sprintId !== null)
+  @IsUUID()
+  sprintId!: string | null;
+}
+
 export class PublishReleaseDto {
   @ApiPropertyOptional({
     type: Boolean,

libs/api/tracker/presenters/src/lib/http/dto/responses.dto.ts

@@ -5,6 +5,7 @@ import {
   NotificationKind,
   ProjectRole,
   ReleaseStatus,
+  SprintStatus,
   SETTING_COLORS,
   StatusCategory,
   TYPE_ICONS,
@@ -135,6 +136,11 @@ export class IssueParentDto {
   @ApiProperty({ example: 'Pago con tarjeta' }) title!: string;
 }
 
+export class SprintRefDto {
+  @ApiProperty({ format: 'uuid' }) id!: string;
+  @ApiProperty({ example: 'Sprint 14' }) name!: string;
+}
+
 export class IssueDto {
   @ApiProperty({ format: 'uuid' }) id!: string;
   @ApiProperty({ format: 'uuid' }) projectId!: string;
@@ -163,6 +169,8 @@ export class IssueDto {
   assignee!: UserRefDto | null;
   @ApiProperty({ type: ReleaseRefDto, nullable: true })
   release!: ReleaseRefDto | null;
+  @ApiProperty({ type: SprintRefDto, nullable: true })
+  sprint!: SprintRefDto | null;
   @ApiProperty({ type: [String] }) labels!: string[];
   @ApiProperty({ type: String, nullable: true, description: 'Figma frame' })
   figmaUrl!: string | null;
@@ -255,6 +263,50 @@ export class CommentPageDto {
   @ApiProperty() total!: number;
 }
 
+export class SprintDto {
+  @ApiProperty({ format: 'uuid' }) id!: string;
+  @ApiProperty({ format: 'uuid' }) projectId!: string;
+  @ApiProperty({ example: 'Sprint 14' }) name!: string;
+  @ApiProperty({ type: String, nullable: true }) goal!: string | null;
+  @ApiProperty({ format: 'date' }) startDate!: string;
+  @ApiProperty({ format: 'date', description: 'Last day, included' })
+  endDate!: string;
+  @ApiProperty({ enum: SprintStatus, enumName: 'SprintStatus' })
+  status!: SprintStatus;
+  @ApiProperty({ type: String, nullable: true, format: 'date-time' })
+  startedAt!: string | null;
+  @ApiProperty({ type: String, nullable: true, format: 'date-time' })
+  closedAt!: string | null;
+  @ApiProperty({ format: 'date-time' }) createdAt!: string;
+  @ApiProperty() version!: number;
+}
+
+export class SprintProgressDto {
+  @ApiProperty() total!: number;
+  @ApiProperty({ description: 'Done or cancelled' }) finished!: number;
+  @ApiProperty({ minimum: 0, maximum: 100 }) percent!: number;
+  @ApiProperty() storyPoints!: number;
+  @ApiProperty() finishedStoryPoints!: number;
+}
+
+export class SprintBurndownDto {
+  @ApiProperty({ format: 'uuid' }) sprintId!: string;
+  @ApiProperty({ type: [String], format: 'date' }) dates!: string[];
+  @ApiProperty({
+    type: [Number],
+    nullable: true,
+    description: 'Tickets in the sprint (null: days to come)',
+  })
+  scope!: (number | null)[];
+  @ApiProperty({ type: [Number], nullable: true }) remaining!: (
+    | number
+    | null
+  )[];
+  @ApiProperty({ type: [Number], nullable: true })
+  remainingPoints!: (number | null)[];
+  @ApiProperty({ type: [Number] }) ideal!: number[];
+}
+
 export class ReleaseDto {
   @ApiProperty({ format: 'uuid' }) id!: string;
   @ApiProperty({ format: 'uuid' }) projectId!: string;