feat: per-project workflow settings, statistics and "my work" home
Per-project settings (owners/admins, «Configuración» tab):
- Statuses with category (TODO, IN_PROGRESS, QA, DONE, CANCELLED), colour and
"requires reason"; configurable transitions; ticket types (icon, colour) and
areas. Defaults are the previous fixed values; projects created before keep
them without migration.
- Values are archived, never deleted: tickets, history and statistics keep
referring to them. Validated in the domain (ProjectSettingsChangedEvent).
- Releases, board, tracking and "my work" use categories, so custom statuses
keep working. Status changes carry name/category metadata for history.
- GraphQL: status/type/area are strings (breaking for clients sending enum
literals); Project.settings, updateProjectSettings, statusCategory,
myIssues(categories). REST: PUT /projects/{project}/settings, category filters.
- Read model: statusCategory on issues (backfilled at startup).
Statistics («Estadísticas» tab):
- New issue_timeline projection; pure functions compute created vs resolved,
cumulative flow, cycle/lead time (avg + p85), throughput per person, QA
pass/fail and release burnup. GraphQL Project.analytics(days),
Release.burnup; REST /projects/{project}/analytics, /releases/{id}/burnup.
- Web: SVG charts with validated light/dark palette, crosshair tooltip,
keyboard navigation, legend and data table.
Home "Mi trabajo": my open tickets across projects grouped by category (QA
failures first), tickets waiting for QA, upcoming releases and "Ir a…".
Tests: domain/application specs, e2e scenario for settings and analytics,
facade tests. Docs, READMEs, schema.gql/openapi.json and Word/PDF updated.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,12 +1,10 @@
|
||||
import { registerEnumType } from '@nestjs/graphql';
|
||||
import {
|
||||
IssueArea,
|
||||
IssueLinkType,
|
||||
IssuePriority,
|
||||
IssueStatus,
|
||||
IssueType,
|
||||
ProjectRole,
|
||||
ReleaseStatus,
|
||||
StatusCategory,
|
||||
} from '@task-stream/api/tracker/domain';
|
||||
|
||||
export enum LinkDirection {
|
||||
@@ -14,13 +12,12 @@ export enum LinkDirection {
|
||||
INWARD = 'INWARD',
|
||||
}
|
||||
|
||||
registerEnumType(IssueType, { name: 'IssueType' });
|
||||
registerEnumType(IssueArea, {
|
||||
name: 'IssueArea',
|
||||
description: 'Team/layer: links FE ↔ BE ↔ QA work',
|
||||
});
|
||||
registerEnumType(IssuePriority, { name: 'IssuePriority' });
|
||||
registerEnumType(IssueStatus, { name: 'IssueStatus' });
|
||||
registerEnumType(StatusCategory, {
|
||||
name: 'StatusCategory',
|
||||
description:
|
||||
'What a status means, whatever each project calls it. DONE and CANCELLED are finished.',
|
||||
});
|
||||
registerEnumType(IssueLinkType, { name: 'IssueLinkType' });
|
||||
registerEnumType(ProjectRole, { name: 'ProjectRole' });
|
||||
registerEnumType(ReleaseStatus, { name: 'ReleaseStatus' });
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
import { Field, ID, InputType, Int } from '@nestjs/graphql';
|
||||
import {
|
||||
IssueArea,
|
||||
IssueLinkType,
|
||||
IssuePriority,
|
||||
IssueStatus,
|
||||
IssueType,
|
||||
ProjectRole,
|
||||
StatusCategory,
|
||||
} from '@task-stream/api/tracker/domain';
|
||||
import { Type } from 'class-transformer';
|
||||
import {
|
||||
ArrayMaxSize,
|
||||
IsArray,
|
||||
IsBoolean,
|
||||
IsEnum,
|
||||
IsInt,
|
||||
@@ -22,8 +22,12 @@ import {
|
||||
MaxLength,
|
||||
Min,
|
||||
MinLength,
|
||||
ValidateNested,
|
||||
} from 'class-validator';
|
||||
|
||||
/** Ids of statuses, types and areas (checked against the project's settings). */
|
||||
const SETTING_ID = /^[A-Za-z][A-Za-z0-9_]{0,29}$/;
|
||||
|
||||
@InputType()
|
||||
export class CreateProjectInput {
|
||||
@Field({ description: '2-10 chars, e.g. "TS" → tickets TS-1, TS-2...' })
|
||||
@@ -74,10 +78,10 @@ abstract class IssueFieldsInput {
|
||||
@MaxLength(50000)
|
||||
description?: string | null;
|
||||
|
||||
@Field(() => IssueArea, { nullable: true })
|
||||
@Field(() => String, { nullable: true, description: 'An area id' })
|
||||
@IsOptional()
|
||||
@IsEnum(IssueArea)
|
||||
area?: IssueArea | null;
|
||||
@Matches(SETTING_ID)
|
||||
area?: string | null;
|
||||
|
||||
@Field(() => IssuePriority, { nullable: true })
|
||||
@IsOptional()
|
||||
@@ -114,7 +118,9 @@ abstract class IssueFieldsInput {
|
||||
@InputType()
|
||||
export class CreateIssueInput extends IssueFieldsInput {
|
||||
@Field(() => ID) @IsUUID() projectId!: string;
|
||||
@Field(() => IssueType) @IsEnum(IssueType) type!: IssueType;
|
||||
@Field({ description: 'A ticket type id' })
|
||||
@Matches(SETTING_ID)
|
||||
type!: string;
|
||||
@Field() @IsString() @MinLength(1) @MaxLength(255) title!: string;
|
||||
@Field(() => ID, { nullable: true }) @IsOptional() @IsString() assigneeId?:
|
||||
| string
|
||||
@@ -127,10 +133,10 @@ export class CreateIssueInput extends IssueFieldsInput {
|
||||
@InputType()
|
||||
export class UpdateIssueInput extends IssueFieldsInput {
|
||||
@Field(() => ID) @IsUUID() issueId!: string;
|
||||
@Field(() => IssueType, { nullable: true })
|
||||
@Field({ nullable: true })
|
||||
@IsOptional()
|
||||
@IsEnum(IssueType)
|
||||
type?: IssueType;
|
||||
@Matches(SETTING_ID)
|
||||
type?: string;
|
||||
@Field({ nullable: true })
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@@ -142,10 +148,12 @@ export class UpdateIssueInput extends IssueFieldsInput {
|
||||
@InputType()
|
||||
export class ChangeIssueStatusInput {
|
||||
@Field(() => ID) @IsUUID() issueId!: string;
|
||||
@Field(() => IssueStatus) @IsEnum(IssueStatus) status!: IssueStatus;
|
||||
@Field({ description: 'A status id' })
|
||||
@Matches(SETTING_ID)
|
||||
status!: string;
|
||||
@Field(() => String, {
|
||||
nullable: true,
|
||||
description: 'Required for QA_FAILED and CANCELLED',
|
||||
description: 'Required by statuses with requiresReason',
|
||||
})
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@@ -163,18 +171,22 @@ export class LinkIssuesInput {
|
||||
@InputType()
|
||||
export class IssueFilterInput {
|
||||
@Field(() => ID) @IsUUID() projectId!: string;
|
||||
@Field(() => [IssueStatus], { nullable: true })
|
||||
@Field(() => [String], { nullable: true })
|
||||
@IsOptional()
|
||||
@IsEnum(IssueStatus, { each: true })
|
||||
statuses?: IssueStatus[];
|
||||
@Field(() => [IssueType], { nullable: true })
|
||||
@IsString({ each: true })
|
||||
statuses?: string[];
|
||||
@Field(() => [StatusCategory], { nullable: true })
|
||||
@IsOptional()
|
||||
@IsEnum(IssueType, { each: true })
|
||||
types?: IssueType[];
|
||||
@Field(() => [IssueArea], { nullable: true })
|
||||
@IsEnum(StatusCategory, { each: true })
|
||||
categories?: StatusCategory[];
|
||||
@Field(() => [String], { nullable: true })
|
||||
@IsOptional()
|
||||
@IsEnum(IssueArea, { each: true })
|
||||
areas?: IssueArea[];
|
||||
@IsString({ each: true })
|
||||
types?: string[];
|
||||
@Field(() => [String], { nullable: true })
|
||||
@IsOptional()
|
||||
@IsString({ each: true })
|
||||
areas?: string[];
|
||||
@Field(() => [IssuePriority], { nullable: true })
|
||||
@IsOptional()
|
||||
@IsEnum(IssuePriority, { each: true })
|
||||
@@ -237,3 +249,77 @@ export class UpdateReleaseInput {
|
||||
@IsISO8601()
|
||||
targetDate?: string | null;
|
||||
}
|
||||
|
||||
/* Project settings (owners and admins). Values are archived, never deleted. */
|
||||
|
||||
@InputType()
|
||||
export class WorkflowStatusInput {
|
||||
@Field() @Matches(SETTING_ID) id!: string;
|
||||
@Field() @IsString() @MinLength(1) @MaxLength(40) name!: string;
|
||||
@Field(() => StatusCategory)
|
||||
@IsEnum(StatusCategory)
|
||||
category!: StatusCategory;
|
||||
@Field() @IsString() color!: string;
|
||||
@Field({ defaultValue: false }) @IsBoolean() requiresReason!: boolean;
|
||||
@Field({ defaultValue: false }) @IsBoolean() archived!: boolean;
|
||||
}
|
||||
|
||||
@InputType()
|
||||
export class StatusTransitionsInput {
|
||||
@Field() @Matches(SETTING_ID) from!: string;
|
||||
@Field(() => [String])
|
||||
@IsArray()
|
||||
@ArrayMaxSize(50)
|
||||
@Matches(SETTING_ID, { each: true })
|
||||
to!: string[];
|
||||
}
|
||||
|
||||
@InputType()
|
||||
export class IssueTypeOptionInput {
|
||||
@Field() @Matches(SETTING_ID) id!: string;
|
||||
@Field() @IsString() @MinLength(1) @MaxLength(40) name!: string;
|
||||
@Field() @IsString() icon!: string;
|
||||
@Field() @IsString() color!: string;
|
||||
@Field({ defaultValue: false }) @IsBoolean() archived!: boolean;
|
||||
}
|
||||
|
||||
@InputType()
|
||||
export class AreaOptionInput {
|
||||
@Field() @Matches(SETTING_ID) id!: string;
|
||||
@Field() @IsString() @MinLength(1) @MaxLength(40) name!: string;
|
||||
@Field({ defaultValue: false }) @IsBoolean() archived!: boolean;
|
||||
}
|
||||
|
||||
@InputType({
|
||||
description:
|
||||
'The whole configuration (replaces the previous one). Statuses go in board order.',
|
||||
})
|
||||
export class ProjectSettingsInput {
|
||||
@Field(() => [WorkflowStatusInput])
|
||||
@IsArray()
|
||||
@ArrayMaxSize(50)
|
||||
@ValidateNested({ each: true })
|
||||
@Type(() => WorkflowStatusInput)
|
||||
statuses!: WorkflowStatusInput[];
|
||||
|
||||
@Field(() => [StatusTransitionsInput])
|
||||
@IsArray()
|
||||
@ArrayMaxSize(50)
|
||||
@ValidateNested({ each: true })
|
||||
@Type(() => StatusTransitionsInput)
|
||||
transitions!: StatusTransitionsInput[];
|
||||
|
||||
@Field(() => [IssueTypeOptionInput])
|
||||
@IsArray()
|
||||
@ArrayMaxSize(50)
|
||||
@ValidateNested({ each: true })
|
||||
@Type(() => IssueTypeOptionInput)
|
||||
issueTypes!: IssueTypeOptionInput[];
|
||||
|
||||
@Field(() => [AreaOptionInput])
|
||||
@IsArray()
|
||||
@ArrayMaxSize(50)
|
||||
@ValidateNested({ each: true })
|
||||
@Type(() => AreaOptionInput)
|
||||
areas!: AreaOptionInput[];
|
||||
}
|
||||
|
||||
@@ -13,11 +13,11 @@ import { CurrentUser } from '@task-stream/api/identity/presenters';
|
||||
import {
|
||||
CommentsService,
|
||||
IssuesService,
|
||||
WorkflowsService,
|
||||
} from '@task-stream/api/tracker/application';
|
||||
import {
|
||||
IssueReadModel,
|
||||
IssueStatus,
|
||||
IssueWorkflow,
|
||||
StatusCategory,
|
||||
} from '@task-stream/api/tracker/domain';
|
||||
import {
|
||||
ChangeIssueStatusInput,
|
||||
@@ -40,6 +40,7 @@ export class IssueResolver {
|
||||
constructor(
|
||||
private readonly issuesService: IssuesService,
|
||||
private readonly commentsService: CommentsService,
|
||||
private readonly workflows: WorkflowsService,
|
||||
) {}
|
||||
|
||||
@Query(() => IssueGql)
|
||||
@@ -61,6 +62,29 @@ export class IssueResolver {
|
||||
return this.issuesService.search(me.id, { ...filter, limit, offset });
|
||||
}
|
||||
|
||||
@Query(() => IssuePageGql, {
|
||||
description:
|
||||
'Tickets across all my projects: assigned to me (default) or any (e.g. categories [QA])',
|
||||
})
|
||||
myIssues(
|
||||
@CurrentUser() me: User,
|
||||
@Args('assignedToMe', { defaultValue: true }) assignedToMe: boolean,
|
||||
@Args('statuses', { type: () => [String], nullable: true })
|
||||
statuses: string[] | undefined,
|
||||
@Args('categories', { type: () => [StatusCategory], nullable: true })
|
||||
categories: StatusCategory[] | undefined,
|
||||
@Args('limit', { type: () => Int, defaultValue: 50 }) limit: number,
|
||||
@Args('offset', { type: () => Int, defaultValue: 0 }) offset: number,
|
||||
) {
|
||||
return this.issuesService.mine(me.id, {
|
||||
assignedToMe,
|
||||
statuses: statuses ?? undefined,
|
||||
categories: categories ?? undefined,
|
||||
limit,
|
||||
offset,
|
||||
});
|
||||
}
|
||||
|
||||
@Query(() => [ActivityGql], {
|
||||
description: 'Project activity feed (newest first)',
|
||||
})
|
||||
@@ -80,11 +104,11 @@ export class IssueResolver {
|
||||
});
|
||||
}
|
||||
|
||||
@ResolveField(() => [IssueStatus], {
|
||||
description: 'Statuses this ticket can move to next',
|
||||
@ResolveField(() => [String], {
|
||||
description: "Statuses this ticket can move to next (project's workflow)",
|
||||
})
|
||||
allowedTransitions(@Parent() issue: IssueReadModel): readonly IssueStatus[] {
|
||||
return IssueWorkflow.allowedFrom(issue.status);
|
||||
allowedTransitions(@Parent() issue: IssueReadModel): Promise<string[]> {
|
||||
return this.workflows.allowedTransitions(issue);
|
||||
}
|
||||
|
||||
@ResolveField(() => [IssueGql], { description: 'Linked tickets I can see' })
|
||||
|
||||
@@ -11,16 +11,20 @@ import {
|
||||
import { User } from '@task-stream/api/identity/domain';
|
||||
import { AccessToken, CurrentUser } from '@task-stream/api/identity/presenters';
|
||||
import { ProjectsService } from '@task-stream/api/tracker/application';
|
||||
import { IssueArea, ProjectReadModel } from '@task-stream/api/tracker/domain';
|
||||
import { ProjectReadModel } from '@task-stream/api/tracker/domain';
|
||||
import { fromSettingsPayload, toSettingsPayload } from '../common/settings';
|
||||
import {
|
||||
CreateProjectInput,
|
||||
ProjectMemberInput,
|
||||
ProjectSettingsInput,
|
||||
UpdateProjectInput,
|
||||
} from './inputs';
|
||||
import {
|
||||
BoardColumnGql,
|
||||
CommandResultGql,
|
||||
ProjectAnalyticsGql,
|
||||
ProjectGql,
|
||||
ProjectSettingsGql,
|
||||
ProjectStatsGql,
|
||||
ReleaseGql,
|
||||
} from './types';
|
||||
@@ -43,6 +47,23 @@ export class ProjectResolver {
|
||||
return this.projects.findOne(me.id, idOrKey);
|
||||
}
|
||||
|
||||
@ResolveField(() => ProjectSettingsGql)
|
||||
settings(@Parent() project: ProjectReadModel) {
|
||||
return toSettingsPayload(project.settings);
|
||||
}
|
||||
|
||||
@ResolveField(() => ProjectAnalyticsGql, {
|
||||
description:
|
||||
'Statistics of the last `days` days (7-365): created vs resolved, cumulative flow, cycle/lead time, throughput and QA',
|
||||
})
|
||||
analytics(
|
||||
@CurrentUser() me: User,
|
||||
@Parent() project: ProjectReadModel,
|
||||
@Args('days', { type: () => Int, defaultValue: 90 }) days: number,
|
||||
) {
|
||||
return this.projects.analytics(me.id, project.id, days);
|
||||
}
|
||||
|
||||
@ResolveField(() => [ReleaseGql])
|
||||
releases(@CurrentUser() me: User, @Parent() project: ProjectReadModel) {
|
||||
return this.projects.releases(me.id, project.id);
|
||||
@@ -63,7 +84,7 @@ export class ProjectResolver {
|
||||
@Parent() project: ProjectReadModel,
|
||||
@Args('releaseId', { type: () => ID, nullable: true }) releaseId?: string,
|
||||
@Args('assigneeId', { type: () => ID, nullable: true }) assigneeId?: string,
|
||||
@Args('area', { type: () => IssueArea, nullable: true }) area?: IssueArea,
|
||||
@Args('area', { type: () => String, nullable: true }) area?: string,
|
||||
@Args('perColumn', { type: () => Int, defaultValue: 50 }) perColumn = 50,
|
||||
) {
|
||||
return this.projects.board(
|
||||
@@ -95,6 +116,22 @@ export class ProjectResolver {
|
||||
return this.projects.update(me.id, projectId, changes);
|
||||
}
|
||||
|
||||
@Mutation(() => CommandResultGql, {
|
||||
description:
|
||||
'Replace statuses, transitions, ticket types and areas (owners and admins). Values can be archived, not deleted.',
|
||||
})
|
||||
updateProjectSettings(
|
||||
@CurrentUser() me: User,
|
||||
@Args('projectId', { type: () => ID }) projectId: string,
|
||||
@Args('settings') settings: ProjectSettingsInput,
|
||||
) {
|
||||
return this.projects.updateSettings(
|
||||
me.id,
|
||||
projectId,
|
||||
fromSettingsPayload(settings),
|
||||
);
|
||||
}
|
||||
|
||||
@Mutation(() => CommandResultGql, {
|
||||
description: 'Add a Pireon user to the project',
|
||||
})
|
||||
|
||||
@@ -19,6 +19,7 @@ import { CreateReleaseInput, UpdateReleaseInput } from './inputs';
|
||||
import {
|
||||
CommandResultGql,
|
||||
IssuePageGql,
|
||||
ReleaseBurnupGql,
|
||||
ReleaseGql,
|
||||
ReleaseProgressGql,
|
||||
} from './types';
|
||||
@@ -35,11 +36,29 @@ export class ReleaseResolver {
|
||||
return this.releases.findOne(me.id, id);
|
||||
}
|
||||
|
||||
@Query(() => [ReleaseGql], {
|
||||
description:
|
||||
'Planned releases of all my projects, soonest target date first',
|
||||
})
|
||||
upcomingReleases(
|
||||
@CurrentUser() me: User,
|
||||
@Args('limit', { type: () => Int, defaultValue: 10 }) limit: number,
|
||||
) {
|
||||
return this.releases.upcoming(me.id, limit);
|
||||
}
|
||||
|
||||
@ResolveField(() => ReleaseProgressGql)
|
||||
progress(@CurrentUser() me: User, @Parent() release: ReleaseReadModel) {
|
||||
return this.releases.progress(me.id, release.id);
|
||||
}
|
||||
|
||||
@ResolveField(() => ReleaseBurnupGql, {
|
||||
description: 'Scope vs finished tickets, day by day',
|
||||
})
|
||||
burnup(@CurrentUser() me: User, @Parent() release: ReleaseReadModel) {
|
||||
return this.releases.burnup(me.id, release.id);
|
||||
}
|
||||
|
||||
@ResolveField(() => IssuePageGql, {
|
||||
description: 'Tickets included in this release',
|
||||
})
|
||||
|
||||
@@ -1,12 +1,10 @@
|
||||
import { Field, ID, Int, ObjectType } from '@nestjs/graphql';
|
||||
import { Field, Float, ID, Int, ObjectType } from '@nestjs/graphql';
|
||||
import {
|
||||
IssueArea,
|
||||
IssueLinkType,
|
||||
IssuePriority,
|
||||
IssueStatus,
|
||||
IssueType,
|
||||
ProjectRole,
|
||||
ReleaseStatus,
|
||||
StatusCategory,
|
||||
} from '@task-stream/api/tracker/domain';
|
||||
import { LinkDirection } from './enums';
|
||||
|
||||
@@ -22,6 +20,51 @@ export class ProjectMemberGql {
|
||||
@Field(() => ProjectRole) role!: ProjectRole;
|
||||
}
|
||||
|
||||
@ObjectType('WorkflowStatus')
|
||||
export class WorkflowStatusGql {
|
||||
@Field({ description: 'Stable id stored on tickets, e.g. IN_REVIEW' })
|
||||
id!: string;
|
||||
@Field() name!: string;
|
||||
@Field(() => StatusCategory) category!: StatusCategory;
|
||||
@Field({ description: 'Colour token: slate, violet, green…' }) color!: string;
|
||||
@Field({ description: 'Entering it needs a reason' })
|
||||
requiresReason!: boolean;
|
||||
@Field({ description: 'No new tickets or transitions into it' })
|
||||
archived!: boolean;
|
||||
}
|
||||
|
||||
@ObjectType('StatusTransitions')
|
||||
export class StatusTransitionsGql {
|
||||
@Field() from!: string;
|
||||
@Field(() => [String]) to!: string[];
|
||||
}
|
||||
|
||||
@ObjectType('IssueTypeOption')
|
||||
export class IssueTypeOptionGql {
|
||||
@Field() id!: string;
|
||||
@Field() name!: string;
|
||||
@Field() icon!: string;
|
||||
@Field() color!: string;
|
||||
@Field() archived!: boolean;
|
||||
}
|
||||
|
||||
@ObjectType('AreaOption')
|
||||
export class AreaOptionGql {
|
||||
@Field() id!: string;
|
||||
@Field() name!: string;
|
||||
@Field() archived!: boolean;
|
||||
}
|
||||
|
||||
@ObjectType('ProjectSettings', {
|
||||
description: 'Statuses (board order), transitions, ticket types and areas',
|
||||
})
|
||||
export class ProjectSettingsGql {
|
||||
@Field(() => [WorkflowStatusGql]) statuses!: WorkflowStatusGql[];
|
||||
@Field(() => [StatusTransitionsGql]) transitions!: StatusTransitionsGql[];
|
||||
@Field(() => [IssueTypeOptionGql]) issueTypes!: IssueTypeOptionGql[];
|
||||
@Field(() => [AreaOptionGql]) areas!: AreaOptionGql[];
|
||||
}
|
||||
|
||||
@ObjectType('Project')
|
||||
export class ProjectGql {
|
||||
@Field(() => ID) id!: string;
|
||||
@@ -59,11 +102,15 @@ export class IssueGql {
|
||||
@Field() projectKey!: string;
|
||||
@Field(() => Int) number!: number;
|
||||
@Field({ description: 'Human key, e.g. TS-42' }) key!: string;
|
||||
@Field(() => IssueType) type!: IssueType;
|
||||
@Field(() => IssueArea, { nullable: true }) area!: IssueArea | null;
|
||||
@Field({ description: "A ticket type id of the project's settings" })
|
||||
type!: string;
|
||||
@Field(() => String, { nullable: true, description: 'An area id' })
|
||||
area!: string | null;
|
||||
@Field() title!: string;
|
||||
@Field(() => String, { nullable: true }) description!: string | null;
|
||||
@Field(() => IssueStatus) status!: IssueStatus;
|
||||
@Field({ description: "A status id of the project's settings" })
|
||||
status!: string;
|
||||
@Field(() => StatusCategory) statusCategory!: StatusCategory;
|
||||
@Field(() => IssuePriority) priority!: IssuePriority;
|
||||
@Field(() => UserRefGql) reporter!: UserRefGql;
|
||||
@Field(() => UserRefGql, { nullable: true }) assignee!: UserRefGql | null;
|
||||
@@ -88,7 +135,7 @@ export class IssuePageGql {
|
||||
|
||||
@ObjectType('BoardColumn')
|
||||
export class BoardColumnGql {
|
||||
@Field(() => IssueStatus) status!: IssueStatus;
|
||||
@Field() status!: string;
|
||||
@Field(() => [IssueGql]) issues!: IssueGql[];
|
||||
@Field(() => Int) total!: number;
|
||||
}
|
||||
@@ -125,7 +172,7 @@ export class ReleaseGql {
|
||||
|
||||
@ObjectType('CountByStatus')
|
||||
export class CountByStatusGql {
|
||||
@Field(() => IssueStatus) key!: IssueStatus;
|
||||
@Field({ description: 'Status id' }) key!: string;
|
||||
@Field(() => Int) count!: number;
|
||||
}
|
||||
|
||||
@@ -221,3 +268,77 @@ export class ProjectChangeGql {
|
||||
@Field(() => ID) actorId!: string;
|
||||
@Field(() => ProjectGql) project!: ProjectGql;
|
||||
}
|
||||
|
||||
/* Statistics */
|
||||
|
||||
@ObjectType('CreatedResolved')
|
||||
export class CreatedResolvedGql {
|
||||
@Field({ description: 'Monday of the week (YYYY-MM-DD)' }) week!: string;
|
||||
@Field(() => Int) created!: number;
|
||||
@Field(() => Int) resolved!: number;
|
||||
}
|
||||
|
||||
@ObjectType('FlowSeries')
|
||||
export class FlowSeriesGql {
|
||||
@Field() status!: string;
|
||||
@Field(() => [Int]) counts!: number[];
|
||||
}
|
||||
|
||||
@ObjectType('CumulativeFlow')
|
||||
export class CumulativeFlowGql {
|
||||
@Field(() => [String]) dates!: string[];
|
||||
@Field(() => [FlowSeriesGql]) series!: FlowSeriesGql[];
|
||||
}
|
||||
|
||||
@ObjectType('DurationStats')
|
||||
export class DurationStatsGql {
|
||||
@Field(() => Int) count!: number;
|
||||
@Field(() => Float, { nullable: true }) averageDays!: number | null;
|
||||
@Field(() => Float, {
|
||||
nullable: true,
|
||||
description: '85% of tickets take at most this long',
|
||||
})
|
||||
p85Days!: number | null;
|
||||
}
|
||||
|
||||
@ObjectType('Throughput')
|
||||
export class ThroughputGql {
|
||||
@Field() week!: string;
|
||||
@Field(() => UserRefGql, { nullable: true }) user!: UserRefGql | null;
|
||||
@Field(() => Int) count!: number;
|
||||
}
|
||||
|
||||
@ObjectType('QaStats')
|
||||
export class QaStatsGql {
|
||||
@Field(() => Int) passed!: number;
|
||||
@Field(() => Int) failed!: number;
|
||||
@Field(() => Float, { nullable: true }) failureRate!: number | null;
|
||||
}
|
||||
|
||||
@ObjectType('ProjectAnalytics')
|
||||
export class ProjectAnalyticsGql {
|
||||
@Field() from!: string;
|
||||
@Field() to!: string;
|
||||
@Field(() => [CreatedResolvedGql]) createdVsResolved!: CreatedResolvedGql[];
|
||||
@Field(() => CumulativeFlowGql, {
|
||||
description: 'Tickets in each status at the end of every day',
|
||||
})
|
||||
cumulativeFlow!: CumulativeFlowGql;
|
||||
@Field(() => DurationStatsGql, { description: 'Start of work → done' })
|
||||
cycleTime!: DurationStatsGql;
|
||||
@Field(() => DurationStatsGql, { description: 'Creation → done' })
|
||||
leadTime!: DurationStatsGql;
|
||||
@Field(() => [ThroughputGql], { description: 'Finished per person and week' })
|
||||
throughput!: ThroughputGql[];
|
||||
@Field(() => QaStatsGql) qa!: QaStatsGql;
|
||||
}
|
||||
|
||||
@ObjectType('ReleaseBurnup')
|
||||
export class ReleaseBurnupGql {
|
||||
@Field(() => ID) releaseId!: string;
|
||||
@Field(() => String, { nullable: true }) targetDate!: string | null;
|
||||
@Field(() => [String]) dates!: string[];
|
||||
@Field(() => [Int], { description: 'Tickets in the release (not cancelled)' })
|
||||
scope!: number[];
|
||||
@Field(() => [Int]) done!: number[];
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user