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:
2026-10-06 20:53:45 +02:00
parent 240ea9a539
commit 0e301ad545
143 changed files with 10291 additions and 1052 deletions

View File

@@ -0,0 +1,76 @@
import { EventsHandler, IEventHandler } from '@nestjs/cqrs';
import {
DEFAULT_PROJECT_SETTINGS,
IssueCreatedEvent,
IssueReleaseChangedEvent,
IssueStatusChangedEvent,
ProjectWorkflow,
TrackerEvent,
} from '@task-stream/api/tracker/domain';
import { FindIssuesRepository } from '../ports/find-issues.repository';
import { FindProjectsRepository } from '../ports/find-projects.repository';
import { UpsertMaterializedTimelineRepository } from '../ports/upsert-materialized-timeline.repository';
import { versionOf } from './read-model-notifier';
/**
* The life of every ticket, step by step: where it went (status + category)
* and which release it joined. Statistics are computed from it.
*/
@EventsHandler(
IssueCreatedEvent,
IssueStatusChangedEvent,
IssueReleaseChangedEvent,
)
export class IssueTimelineEventHandler implements IEventHandler<TrackerEvent> {
constructor(
private readonly timeline: UpsertMaterializedTimelineRepository,
private readonly findProjects: FindProjectsRepository,
private readonly findIssues: FindIssuesRepository,
) {}
async handle(event: TrackerEvent) {
const base = {
id: `${event.aggregateId}:${versionOf(event)}`,
issueId: event.aggregateId,
projectId: event.projectId,
at: event.occurredAt,
};
if (event instanceof IssueCreatedEvent) {
const { issue } = event;
await this.timeline.record({
...base,
kind: 'status',
status: issue.status,
category: (await this.workflowOf(event)).categoryOf(issue.status),
assigneeId: issue.assigneeId,
});
return;
}
if (event instanceof IssueStatusChangedEvent) {
const issue = await this.findIssues.findById(event.aggregateId);
await this.timeline.record({
...base,
kind: 'status',
status: event.to,
category:
event.meta?.toCategory ??
(await this.workflowOf(event)).categoryOf(event.to),
assigneeId: issue?.assignee?.id ?? null,
});
return;
}
if (event instanceof IssueReleaseChangedEvent) {
await this.timeline.record({
...base,
kind: 'release',
releaseId: event.releaseId,
});
}
}
private async workflowOf(event: TrackerEvent): Promise<ProjectWorkflow> {
const project = await this.findProjects.findById(event.projectId);
return new ProjectWorkflow(project?.settings ?? DEFAULT_PROJECT_SETTINGS);
}
}