Files
ftb-project-management/apps/web/lib/domain-api.ts
2026-07-08 12:18:15 +08:00

240 lines
8.2 KiB
TypeScript

import { api } from './api';
import type { Priority } from './derive';
import type { Requirement, RequirementStatus, SourceType } from './requirement';
export interface RootProject {
id: string;
name: string;
description: string;
createdAt: string;
}
export interface RootVersion {
id: string;
productId?: string;
projectId?: string | null;
name: string;
status?: string;
releaseDate: string | null;
createdAt: string;
currentStage?: string | null;
startDate?: string | null;
expectedReleaseDate?: string | null;
members?: unknown[];
progress?: unknown[];
priority?: string;
links?: unknown;
}
export interface RootProduct {
id: string;
name: string;
description: string;
createdAt: string;
updatedAt: string;
projects: RootProject[];
versions: RootVersion[];
_count?: { requirements: number; projects: number; versions?: number };
}
export async function createProductRoot(data: { name: string; description?: string }): Promise<RootProduct> {
const product = await api.post<Omit<RootProduct, 'projects' | 'versions'>>('/products', data);
return normalizeProductRoot({ ...product, projects: [], versions: [] });
}
export async function updateProductRoot(
productId: string,
data: { name?: string; description?: string },
): Promise<Partial<RootProduct>> {
return api.patch<Partial<RootProduct>>(`/products/${productId}`, data);
}
export async function deleteProductRoot(productId: string): Promise<void> {
await api.delete(`/products/${productId}`);
}
export async function createProjectByProductId(
productId: string,
data: { name: string; description?: string },
): Promise<RootProject> {
return api.post<RootProject>(`/products/${productId}/projects`, data);
}
export async function updateProjectByProductId(
productId: string,
projectId: string,
data: { name?: string; description?: string },
): Promise<RootProject> {
return api.patch<RootProject>(`/products/${productId}/projects/${projectId}`, data);
}
export async function deleteProjectByProductId(productId: string, projectId: string): Promise<void> {
await api.delete(`/products/${productId}/projects/${projectId}`);
}
export async function createVersionByProductId(
productId: string,
data: { name: string; status?: string; projectId?: string },
): Promise<RootVersion> {
return normalizeVersionRoot(await api.post<RootVersion>(`/products/${productId}/versions`, data));
}
export async function updateVersionByProductId(
productId: string,
versionId: string,
data: Record<string, unknown>,
): Promise<RootVersion> {
return normalizeVersionRoot(await api.patch<RootVersion>(`/products/${productId}/versions/${versionId}`, data));
}
export async function deleteVersionByProductId(productId: string, versionId: string): Promise<void> {
await api.delete(`/products/${productId}/versions/${versionId}`);
}
interface DomainRequirementRow {
id: string;
productId: string;
projectId?: string | null;
versionId?: string | null;
code: string;
title: string;
description?: string | null;
status?: string | null;
priority?: string | number | null;
type?: string | null;
sourceType?: string | null;
sourceTarget?: string | null;
platform?: string | null;
creatorId?: string | null;
creatorName?: string | null;
creator?: { id?: string | null; name?: string | null } | null;
createdAt?: string | Date | null;
}
export async function createRequirementByProductId(
productId: string,
data: Partial<Requirement>,
): Promise<Requirement> {
return normalizeRequirement(await api.post<DomainRequirementRow>(
`/products/${productId}/requirements`,
toRequirementPayload(data),
));
}
export async function updateRequirementByProductId(
productId: string,
requirementId: string,
data: Partial<Requirement>,
): Promise<Requirement> {
return normalizeRequirement(await api.patch<DomainRequirementRow>(
`/products/${productId}/requirements/${requirementId}`,
toRequirementPayload(data),
));
}
export async function updateRequirementStatusByProductId(
productId: string,
requirementId: string,
status: RequirementStatus,
): Promise<Requirement> {
return normalizeRequirement(await api.patch<DomainRequirementRow>(
`/products/${productId}/requirements/${requirementId}/status`,
{ status },
));
}
export async function deleteRequirementByProductId(productId: string, requirementId: string): Promise<void> {
await api.delete(`/products/${productId}/requirements/${requirementId}`);
}
function normalizeProductRoot(product: RootProduct): RootProduct {
return {
...product,
projects: product.projects ?? [],
versions: (product.versions ?? []).map(normalizeVersionRoot),
_count: product._count ?? { requirements: 0, projects: product.projects?.length ?? 0, versions: product.versions?.length ?? 0 },
};
}
function normalizeVersionRoot(version: RootVersion): RootVersion {
return {
...version,
status: version.status ?? 'planned',
releaseDate: version.releaseDate ?? null,
members: Array.isArray(version.members) ? version.members : [],
progress: Array.isArray(version.progress) ? version.progress : [],
links: version.links && typeof version.links === 'object' ? version.links : {},
};
}
function toRequirementPayload(data: Partial<Requirement>) {
return {
...(data.code !== undefined && { code: data.code }),
...(data.title !== undefined && { title: data.title }),
...(data.description !== undefined && { description: data.description }),
...(data.projectId !== undefined && { projectId: data.projectId }),
...(data.versionId !== undefined && { versionId: data.versionId ?? null }),
...(data.typeId !== undefined && { type: data.typeId }),
...(data.sourceType !== undefined && { sourceType: data.sourceType }),
...(data.sourceTarget !== undefined && { sourceTarget: data.sourceTarget }),
...(data.platforms !== undefined && { platform: data.platforms.join(',') }),
...(data.priority !== undefined && { priority: priorityToNumber(data.priority) }),
};
}
function normalizeRequirement(row: DomainRequirementRow): Requirement {
return {
id: row.id,
code: row.code,
title: row.title,
description: row.description ?? '',
productId: row.productId,
projectId: row.projectId ?? '',
versionId: row.versionId ?? undefined,
sourceType: toSourceType(row.sourceType),
sourceTarget: row.sourceTarget ?? '',
platforms: splitCsv(row.platform),
typeId: row.type ?? '',
status: toRequirementStatus(row.status),
priority: toPriority(row.priority),
effort: 'M',
creator: row.creator?.name ?? row.creatorName ?? row.creatorId ?? '',
createdAt: isoString(row.createdAt),
};
}
function toSourceType(value: string | null | undefined): SourceType {
const allowed = new Set<SourceType>(['customer', 'internal', 'operation', 'aftersale', 'market', 'competitor', 'management']);
return allowed.has(value as SourceType) ? value as SourceType : 'internal';
}
function toRequirementStatus(value: string | null | undefined): RequirementStatus {
const allowed = new Set<RequirementStatus>(['pending_review', 'adopted', 'rejected', 'planned', 'developing', 'testing', 'released', 'closed']);
return allowed.has(value as RequirementStatus) ? value as RequirementStatus : 'pending_review';
}
function toPriority(value: string | number | null | undefined): Priority {
if (typeof value === 'string' && /^P[0-4]$/.test(value)) return value as Priority;
const parsed = Number(value ?? 2);
const normalized = Number.isFinite(parsed) ? Math.max(0, Math.min(4, Math.floor(parsed))) : 2;
return `P${normalized}` as Priority;
}
function priorityToNumber(value: Priority | undefined): number | undefined {
if (!value) return undefined;
const match = /^P([0-4])$/.exec(value);
return match ? Number(match[1]) : undefined;
}
function splitCsv(value: string | null | undefined): string[] {
if (!value) return [];
return value.split(',').map((item) => item.trim()).filter(Boolean);
}
function isoString(value: string | Date | null | undefined): string {
if (!value) return new Date().toISOString();
if (value instanceof Date) return value.toISOString();
const time = new Date(value).getTime();
return Number.isFinite(time) ? new Date(time).toISOString() : new Date().toISOString();
}