feat(projects): 1、执行、任务、工作日志开发调试；2、增加富文本、附件等支撑

src/service/api/project-shared.ts

@@ -36,14 +36,14 @@ export type ProjectExecutionResponse = Omit<
   progressRate?: number | null;
 };
 
-export type ExecutionMemberResponse = Omit<Api.Project.ExecutionMember, 'id' | 'executionId' | 'userId'> & {
+export type ExecutionAssigneeResponse = Omit<Api.Project.ExecutionAssignee, 'id' | 'executionId' | 'userId'> & {
   id: StringIdResponse;
   executionId: StringIdResponse;
   userId: StringIdResponse;
 };
 
-export type ExecutionMemberLogResponse = Omit<
-  Api.Project.ExecutionMemberLog,
+export type ExecutionAssigneeLogResponse = Omit<
+  Api.Project.ExecutionAssigneeLog,
   'id' | 'executionId' | 'userId' | 'operatorUserId'
 > & {
   id: StringIdResponse;
@@ -52,6 +52,55 @@ export type ExecutionMemberLogResponse = Omit<
   operatorUserId: StringIdResponse;
 };
 
+type TaskAssigneeRefResponse = Omit<Api.Project.TaskAssigneeRef, 'id' | 'userId'> & {
+  id: StringIdResponse;
+  userId: StringIdResponse;
+};
+
+/**
+ * 后端 attachments 项的兼容形态：历史/当前响应字段名是 `id`，前端类型统一用 `fileId`。
+ * normalizeAttachments 负责把两者归一成 `fileId`。
+ */
+type AttachmentItemResponse = Omit<Api.Project.AttachmentItem, 'fileId'> & {
+  fileId?: StringIdResponse;
+  id?: StringIdResponse;
+};
+
+function normalizeAttachments(list?: AttachmentItemResponse[] | null): Api.Project.AttachmentItem[] | null {
+  if (!list) {
+    return null;
+  }
+  return list.map(item => {
+    const rawId = item.fileId ?? item.id;
+    return {
+      ...item,
+      fileId: rawId === null || rawId === undefined ? '' : String(rawId)
+    };
+  });
+}
+
+/**
+ * 5.6 单独接口返的协办人字段（与 5.3 嵌入字段命名口径不一致：返 userNickname 而非 nickname）。
+ * 经 normalizeTaskAssignee 归一化后对外统一为 Api.Project.TaskAssigneeRef。
+ */
+export type TaskAssigneeFromApiResponse = {
+  id: StringIdResponse;
+  taskId: StringIdResponse;
+  userId: StringIdResponse;
+  userNickname?: string | null;
+  joinedAt?: string | null;
+};
+
+export type TaskAssigneeLogResponse = Omit<
+  Api.Project.TaskAssigneeLog,
+  'id' | 'taskId' | 'userId' | 'operatorUserId'
+> & {
+  id: StringIdResponse;
+  taskId: StringIdResponse;
+  userId: StringIdResponse;
+  operatorUserId: StringIdResponse;
+};
+
 export type ProjectTaskResponse = Omit<
   Api.Project.ProjectTask,
   | 'id'
@@ -65,6 +114,8 @@ export type ProjectTaskResponse = Omit<
   | 'actualStartDate'
   | 'actualEndDate'
   | 'progressRate'
+  | 'assignees'
+  | 'attachments'
 > & {
   id: StringIdResponse;
   projectId: StringIdResponse;
@@ -77,6 +128,16 @@ export type ProjectTaskResponse = Omit<
   actualStartDate?: ProjectLocalDateValue;
   actualEndDate?: ProjectLocalDateValue;
   progressRate?: number | null;
+  assignees?: TaskAssigneeRefResponse[] | null;
+  attachments?: AttachmentItemResponse[] | null;
+  totalSpentHours?: number | null;
+};
+
+export type TaskWorklogResponse = Omit<Api.Project.TaskWorklog, 'id' | 'taskId' | 'userId' | 'attachments'> & {
+  id: StringIdResponse;
+  taskId: StringIdResponse;
+  userId: StringIdResponse;
+  attachments?: AttachmentItemResponse[] | null;
 };
 
 export interface ProjectMemberResponse {
@@ -194,7 +255,7 @@ export function normalizeProjectExecution(response: ProjectExecutionResponse): A
   };
 }
 
-export function normalizeExecutionMember(response: ExecutionMemberResponse): Api.Project.ExecutionMember {
+export function normalizeExecutionAssignee(response: ExecutionAssigneeResponse): Api.Project.ExecutionAssignee {
   return {
     ...response,
     id: normalizeStringId(response.id),
@@ -207,7 +268,9 @@ export function normalizeExecutionMember(response: ExecutionMemberResponse): Api
   };
 }
 
-export function normalizeExecutionMemberLog(response: ExecutionMemberLogResponse): Api.Project.ExecutionMemberLog {
+export function normalizeExecutionAssigneeLog(
+  response: ExecutionAssigneeLogResponse
+): Api.Project.ExecutionAssigneeLog {
   return {
     ...response,
     id: normalizeStringId(response.id),
@@ -239,6 +302,49 @@ export function normalizeProjectTask(response: ProjectTaskResponse): Api.Project
     actualStartDate: normalizeProjectLocalDate(response.actualStartDate),
     actualEndDate: normalizeProjectLocalDate(response.actualEndDate),
     taskDesc: response.taskDesc ?? null,
-    lastStatusReason: response.lastStatusReason ?? null
+    lastStatusReason: response.lastStatusReason ?? null,
+    assignees:
+      response.assignees?.map(item => ({
+        id: normalizeStringId(item.id),
+        userId: normalizeStringId(item.userId),
+        nickname: item.nickname ?? ''
+      })) ?? null,
+    attachments: normalizeAttachments(response.attachments),
+    totalSpentHours: response.totalSpentHours ?? null
+  };
+}
+
+export function normalizeTaskWorklog(response: TaskWorklogResponse): Api.Project.TaskWorklog {
+  return {
+    ...response,
+    id: normalizeStringId(response.id),
+    taskId: normalizeStringId(response.taskId),
+    userId: normalizeStringId(response.userId),
+    userNickname: response.userNickname ?? null,
+    workContent: response.workContent ?? null,
+    attachments: normalizeAttachments(response.attachments),
+    progressRate: typeof response.progressRate === 'number' ? response.progressRate : 0
+  };
+}
+
+export function normalizeTaskAssignee(response: TaskAssigneeFromApiResponse): Api.Project.TaskAssigneeRef {
+  return {
+    id: normalizeStringId(response.id),
+    userId: normalizeStringId(response.userId),
+    nickname: response.userNickname ?? '',
+    joinedAt: response.joinedAt ?? null
+  };
+}
+
+export function normalizeTaskAssigneeLog(response: TaskAssigneeLogResponse): Api.Project.TaskAssigneeLog {
+  return {
+    ...response,
+    id: normalizeStringId(response.id),
+    taskId: normalizeStringId(response.taskId),
+    userId: normalizeStringId(response.userId),
+    operatorUserId: normalizeStringId(response.operatorUserId),
+    userNicknameSnapshot: response.userNicknameSnapshot ?? null,
+    operatorNicknameSnapshot: response.operatorNicknameSnapshot ?? null,
+    reason: response.reason ?? null
   };
 }