Some checks failed
Deploy Production / Build, push, deploy, verify (push) Has been cancelled
- 移除已迁移业务 AppData 运行时 fallback,改走领域 API 和关系表快读 - 补齐需求产品负责人、版本计划任务 JSON 和成员 username 回填迁移 - 统一治理字典入口,并补充 AI provider、数据源契约和领域服务测试 Co-Authored-By: Codex GPT-5 <codex@openai.com>
1063 lines
38 KiB
TypeScript
1063 lines
38 KiB
TypeScript
import { api } from './api';
|
|
import type { Bug, BugSeverity, BugStatus } from './bug';
|
|
import type { DevTask, DevTaskStatus, Reference } from './dev-task';
|
|
import type { Priority } from './derive';
|
|
import type { Member } from './members';
|
|
import type { OvertimeRecord } from './overtime';
|
|
import type { Requirement, RequirementStatus, SourceType } from './requirement';
|
|
import type { TaskCategory } from './task-category';
|
|
import type { TaskWorklog } from './task-worklog';
|
|
import type { TestCase, TestCaseStatus } from './test-case';
|
|
import type { PlanTask, VersionPlan, VersionPlanLog, VersionPlanRequirementCoverage } from './version-plan';
|
|
import type { WorkActivity, WorkActivityCategory, WorkActivityDraft, WorkActivitySourceType } from './work-activity';
|
|
|
|
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;
|
|
productOwnerId?: string | null;
|
|
productOwnerName?: string | null;
|
|
productOwner?: { 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}`);
|
|
}
|
|
|
|
interface DomainVersionPlanRow {
|
|
id: string;
|
|
versionId: string;
|
|
type: string;
|
|
title: string;
|
|
status?: string | null;
|
|
ownerId?: string | null;
|
|
expectedStartAt?: string | Date | null;
|
|
expectedEndAt?: string | Date | null;
|
|
actualStartAt?: string | Date | null;
|
|
completedAt?: string | Date | null;
|
|
resultUrl?: string | null;
|
|
tasks?: unknown;
|
|
requirementCoverage?: unknown;
|
|
logs?: unknown;
|
|
createdAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainDevTaskRow {
|
|
id: string;
|
|
versionId: string;
|
|
requirementId?: string | null;
|
|
categoryId?: string | null;
|
|
code: string;
|
|
title: string;
|
|
description?: string | null;
|
|
status?: string | null;
|
|
priority?: string | number | null;
|
|
assigneeId?: string | null;
|
|
creatorId?: string | null;
|
|
isBlocked?: boolean | null;
|
|
blockReason?: string | null;
|
|
expectedStartAt?: string | Date | null;
|
|
expectedEndAt?: string | Date | null;
|
|
startDate?: string | Date | null;
|
|
completedAt?: string | Date | null;
|
|
estimateHours?: number | null;
|
|
aiEstimateHours?: number | null;
|
|
references?: unknown;
|
|
aiDraft?: boolean | null;
|
|
aiDraftAt?: string | Date | null;
|
|
createdAt?: string | Date | null;
|
|
updatedAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainTestCaseRow {
|
|
id: string;
|
|
versionId: string;
|
|
requirementId?: string | null;
|
|
categoryId?: string | null;
|
|
code: string;
|
|
title: string;
|
|
description?: string | null;
|
|
status?: string | null;
|
|
roundNo?: number | null;
|
|
priority?: string | number | null;
|
|
assigneeId?: string | null;
|
|
creatorId?: string | null;
|
|
plannedTestAt?: string | Date | null;
|
|
plannedEndAt?: string | Date | null;
|
|
startedAt?: string | Date | null;
|
|
completedAt?: string | Date | null;
|
|
estimateHours?: number | null;
|
|
aiEstimateHours?: number | null;
|
|
references?: unknown;
|
|
aiDraft?: boolean | null;
|
|
aiDraftAt?: string | Date | null;
|
|
createdAt?: string | Date | null;
|
|
updatedAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainBugRow {
|
|
id: string;
|
|
versionId: string;
|
|
testCaseId?: string | null;
|
|
code: string;
|
|
title: string;
|
|
description?: string | null;
|
|
status?: string | null;
|
|
severity?: string | null;
|
|
priority?: string | number | null;
|
|
assigneeId?: string | null;
|
|
reporterId?: string | null;
|
|
plannedFixAt?: string | Date | null;
|
|
resolvedAt?: string | Date | null;
|
|
closedAt?: string | Date | null;
|
|
resolution?: string | null;
|
|
createdAt?: string | Date | null;
|
|
updatedAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainWorkActivityRow {
|
|
id: string;
|
|
actorId?: string | null;
|
|
actorName?: string | null;
|
|
sourceType: string;
|
|
sourceId: string;
|
|
action: string;
|
|
title: string;
|
|
metadata?: unknown;
|
|
occurredAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainMemberRow {
|
|
id: string;
|
|
name: string;
|
|
username?: string | null;
|
|
departmentId?: string | null;
|
|
roleId?: string | null;
|
|
phone?: string | null;
|
|
email?: string | null;
|
|
password?: string | null;
|
|
isSystem?: boolean | null;
|
|
createdAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainTaskCategoryRow {
|
|
id: string;
|
|
name: string;
|
|
code?: string | null;
|
|
group: string;
|
|
isSystem?: boolean | null;
|
|
createdAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainTaskWorklogRow {
|
|
id: string;
|
|
userId?: string | null;
|
|
sourceId: string;
|
|
workDate?: string | Date | null;
|
|
hours?: number | null;
|
|
content?: string | null;
|
|
createdAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainOvertimeRow {
|
|
id: string;
|
|
productId?: string | null;
|
|
projectId?: string | null;
|
|
versionId?: string | null;
|
|
userId?: string | null;
|
|
reason?: string | null;
|
|
startAt?: string | Date | null;
|
|
endAt?: string | Date | null;
|
|
hours?: number | null;
|
|
createdAt?: string | Date | null;
|
|
}
|
|
|
|
interface DomainMutationResponse<T> {
|
|
item: T;
|
|
activities?: DomainWorkActivityRow[];
|
|
}
|
|
|
|
interface DomainBatchMutationResponse<T> {
|
|
items: T[];
|
|
activities?: DomainWorkActivityRow[];
|
|
}
|
|
|
|
export async function listVersionPlansByVersionId(versionId: string): Promise<VersionPlan[]> {
|
|
const rows = await api.get<DomainVersionPlanRow[]>(`/versions/${versionId}/plans`);
|
|
return rows.map(normalizeVersionPlan);
|
|
}
|
|
|
|
export async function createVersionPlanByVersionId(
|
|
versionId: string,
|
|
data: Partial<VersionPlan>,
|
|
) {
|
|
return normalizeMutation(
|
|
await api.post<DomainMutationResponse<DomainVersionPlanRow>>(`/versions/${versionId}/plans`, toVersionPlanPayload(data)),
|
|
normalizeVersionPlan,
|
|
);
|
|
}
|
|
|
|
export async function updateVersionPlanByVersionId(
|
|
versionId: string,
|
|
planId: string,
|
|
data: Partial<VersionPlan>,
|
|
) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainVersionPlanRow>>(`/versions/${versionId}/plans/${planId}`, toVersionPlanPayload(data)),
|
|
normalizeVersionPlan,
|
|
);
|
|
}
|
|
|
|
export async function completeVersionPlanByVersionId(
|
|
versionId: string,
|
|
planId: string,
|
|
data: Partial<VersionPlan>,
|
|
) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainVersionPlanRow>>(`/versions/${versionId}/plans/${planId}/complete`, toVersionPlanPayload(data)),
|
|
normalizeVersionPlan,
|
|
);
|
|
}
|
|
|
|
export async function deleteVersionPlanByVersionId(versionId: string, planId: string): Promise<void> {
|
|
await api.delete(`/versions/${versionId}/plans/${planId}`);
|
|
}
|
|
|
|
export async function listDevTasksByVersionId(versionId: string): Promise<DevTask[]> {
|
|
const rows = await api.get<DomainDevTaskRow[]>(`/versions/${versionId}/dev-tasks`);
|
|
return rows.map(normalizeDevTask);
|
|
}
|
|
|
|
export async function createDevTaskByVersionId(versionId: string, data: Partial<DevTask>) {
|
|
return normalizeMutation(
|
|
await api.post<DomainMutationResponse<DomainDevTaskRow>>(`/versions/${versionId}/dev-tasks`, toDevTaskPayload(data)),
|
|
normalizeDevTask,
|
|
);
|
|
}
|
|
|
|
export async function updateDevTaskByVersionId(versionId: string, taskId: string, data: Partial<DevTask>) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainDevTaskRow>>(`/versions/${versionId}/dev-tasks/${taskId}`, toDevTaskPayload(data)),
|
|
normalizeDevTask,
|
|
);
|
|
}
|
|
|
|
export async function updateDevTaskStatusByVersionId(versionId: string, taskId: string, status: DevTaskStatus) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainDevTaskRow>>(`/versions/${versionId}/dev-tasks/${taskId}/status`, { status }),
|
|
normalizeDevTask,
|
|
);
|
|
}
|
|
|
|
export async function setDevTaskBlockedByVersionId(
|
|
versionId: string,
|
|
taskId: string,
|
|
blocked: boolean,
|
|
reason?: string,
|
|
) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainDevTaskRow>>(`/versions/${versionId}/dev-tasks/${taskId}/block`, { blocked, reason }),
|
|
normalizeDevTask,
|
|
);
|
|
}
|
|
|
|
export async function transferDevTaskByVersionId(versionId: string, taskId: string, assigneeId: string) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainDevTaskRow>>(`/versions/${versionId}/dev-tasks/${taskId}/transfer`, { assigneeId }),
|
|
normalizeDevTask,
|
|
);
|
|
}
|
|
|
|
export async function deleteDevTaskByVersionId(versionId: string, taskId: string): Promise<void> {
|
|
await api.delete(`/versions/${versionId}/dev-tasks/${taskId}`);
|
|
}
|
|
|
|
export async function listTestCasesByVersionId(versionId: string): Promise<TestCase[]> {
|
|
const rows = await api.get<DomainTestCaseRow[]>(`/versions/${versionId}/test-cases`);
|
|
return rows.map(normalizeTestCase);
|
|
}
|
|
|
|
export async function createTestCaseByVersionId(versionId: string, data: Partial<TestCase>) {
|
|
return normalizeMutation(
|
|
await api.post<DomainMutationResponse<DomainTestCaseRow>>(`/versions/${versionId}/test-cases`, toTestCasePayload(data)),
|
|
normalizeTestCase,
|
|
);
|
|
}
|
|
|
|
export async function createTestCasesByVersionId(versionId: string, items: Partial<TestCase>[]) {
|
|
return normalizeBatchMutation(
|
|
await api.post<DomainBatchMutationResponse<DomainTestCaseRow>>(
|
|
`/versions/${versionId}/test-cases/batch`,
|
|
{ items: items.map(toTestCasePayload) },
|
|
),
|
|
normalizeTestCase,
|
|
);
|
|
}
|
|
|
|
export async function updateTestCaseByVersionId(versionId: string, testCaseId: string, data: Partial<TestCase>) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainTestCaseRow>>(`/versions/${versionId}/test-cases/${testCaseId}`, toTestCasePayload(data)),
|
|
normalizeTestCase,
|
|
);
|
|
}
|
|
|
|
export async function updateTestCaseStatusByVersionId(versionId: string, testCaseId: string, status: TestCaseStatus) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainTestCaseRow>>(`/versions/${versionId}/test-cases/${testCaseId}/status`, { status }),
|
|
normalizeTestCase,
|
|
);
|
|
}
|
|
|
|
export async function deleteTestCaseByVersionId(versionId: string, testCaseId: string): Promise<void> {
|
|
await api.delete(`/versions/${versionId}/test-cases/${testCaseId}`);
|
|
}
|
|
|
|
export async function listBugsByVersionId(versionId: string): Promise<Bug[]> {
|
|
const rows = await api.get<DomainBugRow[]>(`/versions/${versionId}/bugs`);
|
|
return rows.map(normalizeBug);
|
|
}
|
|
|
|
export async function createBugByVersionId(versionId: string, data: Partial<Bug>) {
|
|
return normalizeMutation(
|
|
await api.post<DomainMutationResponse<DomainBugRow>>(`/versions/${versionId}/bugs`, toBugPayload(data)),
|
|
normalizeBug,
|
|
);
|
|
}
|
|
|
|
export async function updateBugByVersionId(versionId: string, bugId: string, data: Partial<Bug>) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainBugRow>>(`/versions/${versionId}/bugs/${bugId}`, toBugPayload(data)),
|
|
normalizeBug,
|
|
);
|
|
}
|
|
|
|
export async function updateBugStatusByVersionId(
|
|
versionId: string,
|
|
bugId: string,
|
|
status: BugStatus,
|
|
options: { operator?: string; resolution?: string } = {},
|
|
) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainBugRow>>(`/versions/${versionId}/bugs/${bugId}/status`, { status, ...options }),
|
|
normalizeBug,
|
|
);
|
|
}
|
|
|
|
export async function transferBugByVersionId(versionId: string, bugId: string, assigneeId: string, operator?: string) {
|
|
return normalizeMutation(
|
|
await api.patch<DomainMutationResponse<DomainBugRow>>(`/versions/${versionId}/bugs/${bugId}/transfer`, { assigneeId, operator }),
|
|
normalizeBug,
|
|
);
|
|
}
|
|
|
|
export async function deleteBugByVersionId(versionId: string, bugId: string): Promise<void> {
|
|
await api.delete(`/versions/${versionId}/bugs/${bugId}`);
|
|
}
|
|
|
|
export async function listMembersDomain(): Promise<Member[]> {
|
|
const rows = await api.get<DomainMemberRow[]>('/members');
|
|
return rows.map(normalizeMember);
|
|
}
|
|
|
|
export async function createMemberDomain(data: Partial<Member>, _existing?: Member[]): Promise<Member> {
|
|
return normalizeMember(await api.post<DomainMemberRow>('/members', toMemberPayload(data)));
|
|
}
|
|
|
|
export async function updateMemberDomain(memberId: string, data: Partial<Member>): Promise<Member> {
|
|
return normalizeMember(await api.patch<DomainMemberRow>(`/members/${memberId}`, toMemberPayload(data)));
|
|
}
|
|
|
|
export async function deleteMemberDomain(memberId: string): Promise<void> {
|
|
await api.delete(`/members/${memberId}`);
|
|
}
|
|
|
|
export async function listTaskCategoriesDomain(): Promise<TaskCategory[]> {
|
|
const rows = await api.get<DomainTaskCategoryRow[]>('/task-categories');
|
|
return rows.map((row, index) => normalizeTaskCategory(row, index));
|
|
}
|
|
|
|
export async function createTaskCategoryDomain(data: Partial<TaskCategory>): Promise<TaskCategory> {
|
|
return normalizeTaskCategory(await api.post<DomainTaskCategoryRow>('/task-categories', toTaskCategoryPayload(data)), 0);
|
|
}
|
|
|
|
export async function updateTaskCategoryDomain(categoryId: string, data: Partial<TaskCategory>): Promise<TaskCategory> {
|
|
return normalizeTaskCategory(await api.patch<DomainTaskCategoryRow>(`/task-categories/${categoryId}`, toTaskCategoryPayload(data)), 0);
|
|
}
|
|
|
|
export async function deleteTaskCategoryDomain(categoryId: string): Promise<void> {
|
|
await api.delete(`/task-categories/${categoryId}`);
|
|
}
|
|
|
|
export async function listTaskWorklogsDomain(): Promise<TaskWorklog[]> {
|
|
const rows = await api.get<DomainTaskWorklogRow[]>('/task-worklogs');
|
|
return rows.map(normalizeTaskWorklog);
|
|
}
|
|
|
|
export async function createTaskWorklogDomain(data: TaskWorklog): Promise<TaskWorklog> {
|
|
return normalizeTaskWorklog(await api.post<DomainTaskWorklogRow>('/task-worklogs', toTaskWorklogPayload(data)));
|
|
}
|
|
|
|
export async function deleteTaskWorklogDomain(worklogId: string): Promise<void> {
|
|
await api.delete(`/task-worklogs/${worklogId}`);
|
|
}
|
|
|
|
export async function listOvertimeRecordsDomain(): Promise<OvertimeRecord[]> {
|
|
const rows = await api.get<DomainOvertimeRow[]>('/overtime');
|
|
return rows.map(normalizeOvertimeRecord);
|
|
}
|
|
|
|
export async function createOvertimeRecordDomain(data: OvertimeRecord): Promise<OvertimeRecord> {
|
|
return normalizeOvertimeRecord(await api.post<DomainOvertimeRow>('/overtime', toOvertimePayload(data)));
|
|
}
|
|
|
|
export async function updateOvertimeRecordDomain(recordId: string, data: Partial<OvertimeRecord>): Promise<void> {
|
|
await api.patch(`/overtime/${recordId}`, toOvertimePayload(data));
|
|
}
|
|
|
|
export async function deleteOvertimeRecordDomain(recordId: string): Promise<void> {
|
|
await api.delete(`/overtime/${recordId}`);
|
|
}
|
|
|
|
export async function listWorkActivitiesDomain(): Promise<WorkActivity[]> {
|
|
const rows = await api.get<DomainWorkActivityRow[]>('/work-activities');
|
|
return rows.map(normalizeWorkActivity);
|
|
}
|
|
|
|
export async function createWorkActivityDomain(data: WorkActivity | WorkActivityDraft): Promise<WorkActivity> {
|
|
return normalizeWorkActivity(await api.post<DomainWorkActivityRow>('/work-activities', toWorkActivityPayload(data)));
|
|
}
|
|
|
|
export async function deleteWorkActivityDomain(activityId: string): Promise<void> {
|
|
await api.delete(`/work-activities/${activityId}`);
|
|
}
|
|
|
|
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) }),
|
|
...(data.productOwner !== undefined && { productOwnerId: data.productOwner }),
|
|
};
|
|
}
|
|
|
|
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',
|
|
productOwner: row.productOwner?.name ?? row.productOwnerName ?? row.productOwnerId ?? '',
|
|
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();
|
|
}
|
|
|
|
function optionalIso(value: string | Date | null | undefined): string | undefined {
|
|
if (!value) return undefined;
|
|
return isoString(value);
|
|
}
|
|
|
|
function toVersionPlanPayload(data: Partial<VersionPlan>) {
|
|
return {
|
|
...(data.type !== undefined && { type: data.type }),
|
|
...(data.title !== undefined && { title: data.title }),
|
|
...(data.status !== undefined && { status: data.status }),
|
|
...(data.owner !== undefined && { owner: data.owner }),
|
|
...(data.startTime !== undefined && { startTime: data.startTime }),
|
|
...(data.endTime !== undefined && { endTime: data.endTime }),
|
|
...(data.actualStartAt !== undefined && { actualStartAt: data.actualStartAt }),
|
|
...(data.completedAt !== undefined && { completedAt: data.completedAt }),
|
|
...(data.resultUrl !== undefined && { resultUrl: data.resultUrl }),
|
|
...(data.tasks !== undefined && { tasks: data.tasks }),
|
|
...(data.linkedRequirementIds !== undefined && { linkedRequirementIds: data.linkedRequirementIds }),
|
|
...(data.requirementCoverage !== undefined && { requirementCoverage: data.requirementCoverage }),
|
|
...(data.logs !== undefined && { logs: data.logs }),
|
|
};
|
|
}
|
|
|
|
function normalizeVersionPlan(row: DomainVersionPlanRow): VersionPlan {
|
|
const requirementCoverage = asArray<VersionPlanRequirementCoverage>(row.requirementCoverage);
|
|
return {
|
|
id: row.id,
|
|
versionId: row.versionId,
|
|
type: toPlanType(row.type),
|
|
title: row.title,
|
|
owner: row.ownerId ?? '',
|
|
startTime: isoString(row.expectedStartAt),
|
|
endTime: isoString(row.expectedEndAt),
|
|
status: toPlanStatus(row.status),
|
|
tasks: asArray<PlanTask>(row.tasks),
|
|
completedRequirementIds: requirementCoverage
|
|
.filter((item) => item?.status === 'completed')
|
|
.map((item) => item.requirementId)
|
|
.filter(Boolean),
|
|
linkedRequirementIds: requirementCoverage.map((item) => item?.requirementId).filter(Boolean),
|
|
requirementCoverage,
|
|
logs: asArray<VersionPlanLog>(row.logs),
|
|
resultUrl: row.resultUrl ?? undefined,
|
|
actualStartAt: optionalIso(row.actualStartAt),
|
|
createdAt: isoString(row.createdAt),
|
|
completedAt: optionalIso(row.completedAt),
|
|
addedBy: row.ownerId ?? '',
|
|
};
|
|
}
|
|
|
|
function toPlanType(value: string): VersionPlan['type'] {
|
|
return value === 'research' || value === 'ui' ? value : 'product';
|
|
}
|
|
|
|
function toPlanStatus(value: string | null | undefined): VersionPlan['status'] {
|
|
return value === 'in_progress' || value === 'completed' ? value : 'pending';
|
|
}
|
|
|
|
function toDevTaskPayload(data: Partial<DevTask>) {
|
|
return {
|
|
...(data.versionId !== undefined && { versionId: data.versionId }),
|
|
...(data.requirementId !== undefined && { requirementId: data.requirementId }),
|
|
...(data.categoryId !== undefined && { categoryId: data.categoryId }),
|
|
...(data.taskNo !== undefined && { taskNo: data.taskNo }),
|
|
...(data.title !== undefined && { title: data.title }),
|
|
...(data.description !== undefined && { description: data.description }),
|
|
...(data.status !== undefined && { status: data.status }),
|
|
...(data.priority !== undefined && { priority: priorityToNumber(data.priority) }),
|
|
...(data.assigneeId !== undefined && { assigneeId: data.assigneeId }),
|
|
...(data.createdBy !== undefined && { createdBy: data.createdBy }),
|
|
...(data.isBlocked !== undefined && { isBlocked: data.isBlocked }),
|
|
...(data.blockReason !== undefined && { blockReason: data.blockReason }),
|
|
...(data.expectedStartAt !== undefined && { expectedStartAt: data.expectedStartAt }),
|
|
...(data.expectedEndAt !== undefined && { expectedEndAt: data.expectedEndAt }),
|
|
...(data.actualStartAt !== undefined && { actualStartAt: data.actualStartAt }),
|
|
...(data.actualEndAt !== undefined && { actualEndAt: data.actualEndAt }),
|
|
...(data.estimateHours !== undefined && { estimateHours: data.estimateHours }),
|
|
...(data.aiEstimateHours !== undefined && { aiEstimateHours: data.aiEstimateHours }),
|
|
...(data.references !== undefined && { references: data.references }),
|
|
...(data.aiDraft !== undefined && { aiDraft: data.aiDraft }),
|
|
...(data.aiDraftAt !== undefined && { aiDraftAt: data.aiDraftAt }),
|
|
};
|
|
}
|
|
|
|
function normalizeDevTask(row: DomainDevTaskRow): DevTask {
|
|
return {
|
|
id: row.id,
|
|
taskNo: row.code,
|
|
versionId: row.versionId,
|
|
requirementId: row.requirementId ?? '',
|
|
title: row.title,
|
|
description: row.description ?? '',
|
|
categoryId: row.categoryId ?? '',
|
|
assigneeId: row.assigneeId ?? '',
|
|
priority: toPriority(row.priority),
|
|
expectedStartAt: isoString(row.expectedStartAt),
|
|
expectedEndAt: isoString(row.expectedEndAt),
|
|
estimateHours: row.estimateHours ?? undefined,
|
|
aiEstimateHours: row.aiEstimateHours ?? undefined,
|
|
actualStartAt: optionalIso(row.startDate),
|
|
actualEndAt: optionalIso(row.completedAt),
|
|
status: toDevTaskStatus(row.status),
|
|
isBlocked: Boolean(row.isBlocked),
|
|
blockReason: row.blockReason ?? undefined,
|
|
references: asArray<Reference>(row.references),
|
|
aiDraft: Boolean(row.aiDraft),
|
|
aiDraftAt: optionalIso(row.aiDraftAt),
|
|
createdBy: row.creatorId ?? '',
|
|
createdAt: isoString(row.createdAt),
|
|
updatedAt: isoString(row.updatedAt),
|
|
};
|
|
}
|
|
|
|
function toDevTaskStatus(value: string | null | undefined): DevTaskStatus {
|
|
return value === 'in_progress' || value === 'testing' || value === 'submitted' ? value : 'todo';
|
|
}
|
|
|
|
function toTestCasePayload(data: Partial<TestCase>) {
|
|
return {
|
|
...(data.versionId !== undefined && { versionId: data.versionId }),
|
|
...(data.requirementId !== undefined && { requirementId: data.requirementId }),
|
|
...(data.categoryId !== undefined && { categoryId: data.categoryId }),
|
|
...(data.caseNo !== undefined && { caseNo: data.caseNo }),
|
|
...(data.title !== undefined && { title: data.title }),
|
|
...(data.description !== undefined && { description: data.description }),
|
|
...(data.status !== undefined && { status: data.status }),
|
|
...(data.roundNo !== undefined && { roundNo: data.roundNo }),
|
|
...(data.priority !== undefined && { priority: priorityToNumber(data.priority) }),
|
|
...(data.assigneeId !== undefined && { assigneeId: data.assigneeId }),
|
|
...(data.createdBy !== undefined && { createdBy: data.createdBy }),
|
|
...(data.plannedTestAt !== undefined && { plannedTestAt: data.plannedTestAt }),
|
|
...(data.plannedEndAt !== undefined && { plannedEndAt: data.plannedEndAt }),
|
|
...(data.startedAt !== undefined && { startedAt: data.startedAt }),
|
|
...(data.completedAt !== undefined && { completedAt: data.completedAt }),
|
|
...(data.estimateHours !== undefined && { estimateHours: data.estimateHours }),
|
|
...(data.aiEstimateHours !== undefined && { aiEstimateHours: data.aiEstimateHours }),
|
|
...(data.references !== undefined && { references: data.references }),
|
|
...(data.aiDraft !== undefined && { aiDraft: data.aiDraft }),
|
|
...(data.aiDraftAt !== undefined && { aiDraftAt: data.aiDraftAt }),
|
|
};
|
|
}
|
|
|
|
function normalizeTestCase(row: DomainTestCaseRow): TestCase {
|
|
return {
|
|
id: row.id,
|
|
caseNo: row.code,
|
|
versionId: row.versionId,
|
|
requirementId: row.requirementId ?? undefined,
|
|
roundNo: row.roundNo && row.roundNo > 0 ? Math.floor(row.roundNo) : 1,
|
|
title: row.title,
|
|
description: row.description ?? '',
|
|
categoryId: row.categoryId ?? '',
|
|
priority: toPriority(row.priority),
|
|
assigneeId: row.assigneeId ?? undefined,
|
|
status: toTestCaseStatus(row.status),
|
|
estimateHours: row.estimateHours ?? undefined,
|
|
aiEstimateHours: row.aiEstimateHours ?? undefined,
|
|
plannedTestAt: optionalIso(row.plannedTestAt),
|
|
plannedEndAt: optionalIso(row.plannedEndAt),
|
|
startedAt: optionalIso(row.startedAt),
|
|
completedAt: optionalIso(row.completedAt),
|
|
executedAt: optionalIso(row.completedAt),
|
|
references: asArray<Reference>(row.references),
|
|
aiDraft: Boolean(row.aiDraft),
|
|
aiDraftAt: optionalIso(row.aiDraftAt),
|
|
createdBy: row.creatorId ?? '',
|
|
createdAt: isoString(row.createdAt),
|
|
updatedAt: isoString(row.updatedAt),
|
|
};
|
|
}
|
|
|
|
function toTestCaseStatus(value: string | null | undefined): TestCaseStatus {
|
|
if (value === 'running' || value === 'passed' || value === 'failed' || value === 'blocked') return value;
|
|
return 'pending';
|
|
}
|
|
|
|
function toBugPayload(data: Partial<Bug>) {
|
|
return {
|
|
...(data.versionId !== undefined && { versionId: data.versionId }),
|
|
...(data.testCaseId !== undefined && { testCaseId: data.testCaseId }),
|
|
...(data.bugNo !== undefined && { bugNo: data.bugNo }),
|
|
...(data.title !== undefined && { title: data.title }),
|
|
...(data.description !== undefined && { description: data.description }),
|
|
...(data.status !== undefined && { status: data.status }),
|
|
...(data.severity !== undefined && { severity: data.severity }),
|
|
...(data.priority !== undefined && { priority: priorityToNumber(data.priority) }),
|
|
...(data.assigneeId !== undefined && { assigneeId: data.assigneeId }),
|
|
...(data.reportedBy !== undefined && { reportedBy: data.reportedBy }),
|
|
...(data.plannedFixAt !== undefined && { plannedFixAt: data.plannedFixAt }),
|
|
...(data.resolvedAt !== undefined && { resolvedAt: data.resolvedAt }),
|
|
...(data.closedAt !== undefined && { closedAt: data.closedAt }),
|
|
...(data.resolution !== undefined && { resolution: data.resolution }),
|
|
};
|
|
}
|
|
|
|
function normalizeBug(row: DomainBugRow): Bug {
|
|
return {
|
|
id: row.id,
|
|
bugNo: row.code,
|
|
versionId: row.versionId,
|
|
testCaseId: row.testCaseId ?? '',
|
|
title: row.title,
|
|
description: row.description ?? '',
|
|
severity: toBugSeverity(row.severity),
|
|
priority: toPriority(row.priority),
|
|
reportedBy: row.reporterId ?? '',
|
|
assigneeId: row.assigneeId ?? '',
|
|
status: toBugStatus(row.status),
|
|
resolvedAt: optionalIso(row.resolvedAt),
|
|
closedAt: optionalIso(row.closedAt),
|
|
resolution: row.resolution ?? undefined,
|
|
plannedFixAt: optionalIso(row.plannedFixAt),
|
|
createdAt: isoString(row.createdAt),
|
|
updatedAt: isoString(row.updatedAt),
|
|
};
|
|
}
|
|
|
|
function toBugStatus(value: string | null | undefined): BugStatus {
|
|
if (value === 'fixing' || value === 'fixed' || value === 'verifying' || value === 'closed' || value === 'rejected') return value;
|
|
return 'open';
|
|
}
|
|
|
|
function toBugSeverity(value: string | null | undefined): BugSeverity {
|
|
if (value === 'critical' || value === 'major' || value === 'trivial') return value;
|
|
return 'minor';
|
|
}
|
|
|
|
function toMemberPayload(data: Partial<Member>) {
|
|
return {
|
|
...(data.id !== undefined && { id: data.id }),
|
|
...(data.name !== undefined && { name: data.name }),
|
|
...(data.username !== undefined && { username: data.username }),
|
|
...(data.departmentId !== undefined && { departmentId: data.departmentId }),
|
|
...(data.roleId !== undefined && { roleId: data.roleId }),
|
|
...(data.phone !== undefined && { phone: data.phone }),
|
|
...(data.email !== undefined && { email: data.email }),
|
|
...(data.password !== undefined && { password: data.password }),
|
|
...(data.isSystem !== undefined && { isSystem: data.isSystem }),
|
|
};
|
|
}
|
|
|
|
function normalizeMember(row: DomainMemberRow): Member {
|
|
return {
|
|
id: row.id,
|
|
name: row.name,
|
|
username: row.username ?? undefined,
|
|
departmentId: row.departmentId ?? '',
|
|
roleId: row.roleId ?? 'member',
|
|
phone: row.phone ?? '',
|
|
email: row.email ?? '',
|
|
password: row.password ?? '',
|
|
createdAt: isoString(row.createdAt).slice(0, 10),
|
|
isSystem: Boolean(row.isSystem),
|
|
};
|
|
}
|
|
|
|
function toTaskCategoryPayload(data: Partial<TaskCategory>) {
|
|
return {
|
|
...(data.name !== undefined && { name: data.name }),
|
|
...(data.group !== undefined && { group: data.group }),
|
|
...(data.code !== undefined && { code: data.code }),
|
|
...(data.isSystem !== undefined && { isSystem: data.isSystem }),
|
|
};
|
|
}
|
|
|
|
function normalizeTaskCategory(row: DomainTaskCategoryRow, index: number): TaskCategory {
|
|
return {
|
|
id: row.id,
|
|
code: row.code ?? row.name,
|
|
name: row.name,
|
|
group: toCategoryGroup(row.group),
|
|
sortOrder: index + 1,
|
|
isSystem: Boolean(row.isSystem),
|
|
};
|
|
}
|
|
|
|
function toCategoryGroup(value: string): TaskCategory['group'] {
|
|
if (value === 'development' || value === 'testing' || value === 'implementation') return value;
|
|
return 'other';
|
|
}
|
|
|
|
function toTaskWorklogPayload(data: TaskWorklog) {
|
|
return {
|
|
taskId: data.taskId,
|
|
userId: data.userId,
|
|
date: data.date,
|
|
hours: data.hours,
|
|
workContent: data.workContent,
|
|
};
|
|
}
|
|
|
|
function normalizeTaskWorklog(row: DomainTaskWorklogRow): TaskWorklog {
|
|
return {
|
|
id: row.id,
|
|
taskId: row.sourceId,
|
|
userId: row.userId ?? '',
|
|
date: isoString(row.workDate).slice(0, 10),
|
|
hours: row.hours ?? 0,
|
|
workContent: row.content ?? '',
|
|
createdAt: isoString(row.createdAt),
|
|
};
|
|
}
|
|
|
|
function toOvertimePayload(data: Partial<OvertimeRecord>) {
|
|
return {
|
|
...(data.productId !== undefined && { productId: data.productId }),
|
|
...(data.projectId !== undefined && { projectId: data.projectId }),
|
|
...(data.versionId !== undefined && { versionId: data.versionId }),
|
|
...(data.person !== undefined && { person: data.person }),
|
|
...(data.startTime !== undefined && { startTime: data.startTime }),
|
|
...(data.endTime !== undefined && { endTime: data.endTime }),
|
|
...(data.duration !== undefined && { duration: data.duration }),
|
|
...(data.reasonId !== undefined && { reasonId: data.reasonId }),
|
|
...(data.remark !== undefined && { remark: data.remark }),
|
|
};
|
|
}
|
|
|
|
function normalizeOvertimeRecord(row: DomainOvertimeRow): OvertimeRecord {
|
|
const [reasonId, ...remarkParts] = (row.reason ?? '').split(':');
|
|
return {
|
|
id: row.id,
|
|
projectId: row.projectId ?? '',
|
|
versionId: row.versionId ?? undefined,
|
|
person: row.userId ?? '',
|
|
startTime: isoString(row.startAt),
|
|
endTime: isoString(row.endAt),
|
|
duration: row.hours ?? 0,
|
|
reasonId,
|
|
remark: remarkParts.join(':') || undefined,
|
|
createdAt: isoString(row.createdAt).slice(0, 10),
|
|
};
|
|
}
|
|
|
|
function toWorkActivityPayload(data: WorkActivity | WorkActivityDraft) {
|
|
return {
|
|
actorId: data.actorId,
|
|
sourceType: data.sourceType,
|
|
sourceId: data.sourceId,
|
|
action: data.action,
|
|
title: data.title,
|
|
category: data.category,
|
|
summary: data.summary,
|
|
metadata: data.metadata,
|
|
occurredAt: data.occurredAt,
|
|
};
|
|
}
|
|
|
|
function normalizeMutation<Row, Item>(
|
|
response: DomainMutationResponse<Row>,
|
|
mapper: (row: Row) => Item,
|
|
): { item: Item; activities: WorkActivity[] } {
|
|
return {
|
|
item: mapper(response.item),
|
|
activities: (response.activities ?? []).map(normalizeWorkActivity),
|
|
};
|
|
}
|
|
|
|
function normalizeBatchMutation<Row, Item>(
|
|
response: DomainBatchMutationResponse<Row>,
|
|
mapper: (row: Row) => Item,
|
|
): { items: Item[]; activities: WorkActivity[] } {
|
|
return {
|
|
items: (response.items ?? []).map(mapper),
|
|
activities: (response.activities ?? []).map(normalizeWorkActivity),
|
|
};
|
|
}
|
|
|
|
function normalizeWorkActivity(row: DomainWorkActivityRow): WorkActivity {
|
|
const metadata = isRecord(row.metadata) ? row.metadata : {};
|
|
return {
|
|
id: row.id,
|
|
actorId: row.actorId ?? row.actorName ?? '',
|
|
date: isoString(row.occurredAt).slice(0, 10),
|
|
occurredAt: isoString(row.occurredAt),
|
|
sourceType: toWorkActivitySourceType(row.sourceType),
|
|
sourceId: row.sourceId,
|
|
action: row.action as WorkActivity['action'],
|
|
category: toWorkActivityCategory(metadata.category),
|
|
title: row.title,
|
|
summary: typeof metadata.summary === 'string' ? metadata.summary : row.title,
|
|
metadata,
|
|
};
|
|
}
|
|
|
|
function toWorkActivitySourceType(value: string): WorkActivitySourceType {
|
|
if (value === 'version_plan' || value === 'dev_task' || value === 'test_case' || value === 'bug') return value;
|
|
return 'manual';
|
|
}
|
|
|
|
function toWorkActivityCategory(value: unknown): WorkActivityCategory {
|
|
if (value === 'delivery' || value === 'progress' || value === 'creation' || value === 'risk') return value;
|
|
return 'note';
|
|
}
|
|
|
|
function asArray<T>(value: unknown): T[] {
|
|
return Array.isArray(value) ? value as T[] : [];
|
|
}
|
|
|
|
function isRecord(value: unknown): value is Record<string, unknown> {
|
|
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
}
|