feat(项目需求): 开发项目需求的功能。

2026-05-13 21:13:21 +08:00
parent 28c47b14a3
commit 60debcda8a
19 changed files with 3562 additions and 92 deletions
--- a/src/service/api/product.ts
+++ b/src/service/api/product.ts
@@ -91,7 +91,7 @@ function createProductActivityTimelinePageQuery(params: Api.Product.ProductActiv
  return query.toString();
 }

-/** 鑾峰彇浜у搧鍒嗛〉 */
+/** 获取产品分页 */
 export async function fetchGetProductPage(params?: Api.Product.ProductSearchParams) {
  const result = await request<ProductPageResponse>({
    ...safeJsonRequestConfig,
@@ -115,7 +115,7 @@ export function fetchGetProductOverviewSummary() {
  });
 }

-/** 鑾峰彇浜у搧璇︽儏 */
+/** 获取产品详情 */
 export async function fetchGetProduct(id: string) {
  const result = await request<ProductResponse>({
    ...safeJsonRequestConfig,
@@ -127,7 +127,7 @@ export async function fetchGetProduct(id: string) {
  return mapServiceResult(result as ServiceRequestResult<ProductResponse>, normalizeProduct);
 }

-/** 鍒涘缓浜у搧 */
+/** 新增产品 */
 export async function fetchCreateProduct(data: Api.Product.SaveProductParams) {
  const result = await request<string | number>({
    ...safeJsonRequestConfig,
@@ -139,7 +139,7 @@ export async function fetchCreateProduct(data: Api.Product.SaveProductParams) {
  return mapServiceResult(result as ServiceRequestResult<string | number>, normalizeStringId);
 }

-/** 鏇存柊浜у搧 */
+/** 更新产品 */
 export function fetchUpdateProduct(data: Api.Product.UpdateProductParams) {
  return request<boolean>({
    url: `${PRODUCT_PREFIX}/update`,
@@ -148,7 +148,7 @@ export function fetchUpdateProduct(data: Api.Product.UpdateProductParams) {
  });
 }

-/** 鍙樻洿浜у搧鐘舵€? */
+/** 改变产品状态 */
 export function fetchChangeProductStatus(data: Api.Product.ChangeProductStatusParams) {
  return request<boolean>({
    url: `${PRODUCT_PREFIX}/change-status`,
@@ -157,7 +157,7 @@ export function fetchChangeProductStatus(data: Api.Product.ChangeProductStatusPa
  });
 }

-/** 鍒犻櫎浜у搧 */
+/** 删除产品 */
 export function fetchDeleteProduct(data: Api.Product.DeleteProductParams) {
  return request<boolean>({
    url: `${PRODUCT_PREFIX}/delete`,
@@ -353,6 +353,26 @@ export async function fetchGetRequirementTerminalStatusDict() {
  return mapServiceResult(result as ServiceRequestResult<Api.Product.RequirementStatusDict[]>, data => data);
 }

+/** 判断产品需求是否已分流生成项目需求 */
+export async function fetchHasDispatchedProjectRequirement(requirementId: string, productId: string) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${REQUIREMENT_PREFIX}/has-dispatched`,
+    method: 'get',
+    params: { requirementId, productId }
+  });
+}
+
+/** 根据当前产品需求id获取对应地，所流转到项目侧的项目需求id */
+export async function fetchGetDispatchedProjectLink(productRequirementId: string) {
+  return request<{ projectRequirementId: string; projectId: string }>({
+    ...safeJsonRequestConfig,
+    url: `${REQUIREMENT_PREFIX}/dispatched-project-link`,
+    method: 'get',
+    params: { productRequirementId }
+  });
+}
+
 // ========== 模块管理 API ==========
 type RequirementModuleResponse = Omit<Api.Product.RequirementModule, 'id' | 'parentId' | 'productId'> & {
  id: string | number;
--- a/src/service/api/project.ts
+++ b/src/service/api/project.ts
@@ -542,3 +542,256 @@ export function fetchChangeProjectTaskStatus(
    data: payload.data
  });
 }
+
+// ========== 项目需求 API ==========
+const PROJECT_REQUIREMENT_PREFIX = `${WEB_SERVICE_PREFIX}/project/project/requirement`;
+
+type ProjectRequirementResponse = Omit<
+  Api.Project.ProjectRequirement,
+  'id' | 'projectId' | 'parentId' | 'moduleId' | 'proposerId' | 'currentHandlerUserId' | 'sourceBizId'
+> & {
+  id: string | number;
+  projectId: string | number;
+  parentId: string | number;
+  moduleId: string | number;
+  proposerId: string | number;
+  currentHandlerUserId?: string | number | null;
+  sourceBizId?: string | number | null;
+  children?: ProjectRequirementResponse[];
+};
+
+type ProjectRequirementPageResponse = Api.Project.PageResult<ProjectRequirementResponse>;
+
+type ProjectRequirementModuleResponse = Omit<Api.Project.ProjectRequirementModule, 'id' | 'parentId' | 'projectId'> & {
+  id: string | number;
+  parentId: string | number;
+  projectId: string | number;
+  children?: ProjectRequirementModuleResponse[];
+};
+
+function normalizeProjectRequirement(requirement: ProjectRequirementResponse): Api.Project.ProjectRequirement {
+  return {
+    ...requirement,
+    id: normalizeStringId(requirement.id),
+    projectId: normalizeStringId(requirement.projectId),
+    parentId: normalizeStringId(requirement.parentId),
+    moduleId: normalizeStringId(requirement.moduleId),
+    proposerId: normalizeStringId(requirement.proposerId),
+    currentHandlerUserId: normalizeNullableStringId(requirement.currentHandlerUserId),
+    sourceBizId: normalizeNullableStringId(requirement.sourceBizId),
+    children: requirement.children?.map(normalizeProjectRequirement)
+  };
+}
+
+function normalizeProjectRequirementModule(
+  module: ProjectRequirementModuleResponse
+): Api.Project.ProjectRequirementModule {
+  return {
+    ...module,
+    id: normalizeStringId(module.id),
+    parentId: normalizeStringId(module.parentId),
+    projectId: normalizeStringId(module.projectId),
+    children: module.children?.map(normalizeProjectRequirementModule)
+  };
+}
+
+/** 获取项目需求分页列表 */
+export async function fetchGetProjectRequirementPage(params?: Api.Project.ProjectRequirementSearchParams) {
+  const result = await request<ProjectRequirementPageResponse>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/page`,
+    method: 'get',
+    params
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<ProjectRequirementPageResponse>, data => ({
+    ...data,
+    list: data.list.map(normalizeProjectRequirement)
+  }));
+}
+
+/** 获取项目需求树形列表 */
+export async function fetchGetProjectRequirementTree(params?: Api.Project.ProjectRequirementSearchParams) {
+  const result = await request<ProjectRequirementPageResponse>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/tree`,
+    method: 'get',
+    params
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<ProjectRequirementPageResponse>, data => ({
+    ...data,
+    list: data.list.map(normalizeProjectRequirement)
+  }));
+}
+
+/** 获取项目需求详情 */
+export async function fetchGetProjectRequirement(id: string, projectId: string) {
+  const result = await request<ProjectRequirementResponse>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/get`,
+    method: 'get',
+    params: { id, projectId }
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<ProjectRequirementResponse>, normalizeProjectRequirement);
+}
+
+/** 创建项目需求 */
+export async function fetchCreateProjectRequirement(data: Api.Project.SaveProjectRequirementParams) {
+  const result = await request<string | number>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/create`,
+    method: 'post',
+    data
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<string | number>, normalizeStringId);
+}
+
+/** 更新项目需求 */
+export function fetchUpdateProjectRequirement(data: Api.Project.UpdateProjectRequirementParams) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/update`,
+    method: 'put',
+    data
+  });
+}
+
+/** 变更项目需求状态 */
+export function fetchChangeProjectRequirementStatus(data: Api.Project.ChangeProjectRequirementStatusParams) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/change-status`,
+    method: 'post',
+    data
+  });
+}
+
+/** 删除项目需求 */
+export function fetchDeleteProjectRequirement(data: Api.Project.DeleteProjectRequirementParams) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/delete`,
+    method: 'post',
+    data
+  });
+}
+
+/** 拆分项目需求 */
+export async function fetchSplitProjectRequirement(data: Api.Project.SplitProjectRequirementParams) {
+  const result = await request<string | number>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/split`,
+    method: 'post',
+    data
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<string | number>, normalizeStringId);
+}
+
+/** 关闭项目需求 */
+export function fetchCloseProjectRequirement(data: Api.Project.CloseProjectRequirementParams) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/close`,
+    method: 'post',
+    data
+  });
+}
+
+/** 获取项目需求可执行状态动作列表 */
+export async function fetchGetProjectRequirementAllowedTransitions(requirementId: string, projectId: string) {
+  const result = await request<Api.Project.ProjectRequirementLifecycleAction[]>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/allowed-transitions`,
+    method: 'get',
+    params: { requirementId, projectId }
+  });
+
+  return mapServiceResult(
+    result as ServiceRequestResult<Api.Project.ProjectRequirementLifecycleAction[]>,
+    data => data
+  );
+}
+
+/** 获取项目需求生命周期信息 */
+export async function fetchGetProjectRequirementLifecycle(requirementId: string, projectId: string) {
+  const result = await request<Api.Project.ProjectRequirementLifecycleInfo>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/lifecycle`,
+    method: 'get',
+    params: { requirementId, projectId }
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<Api.Project.ProjectRequirementLifecycleInfo>, data => data);
+}
+
+/** 获取项目需求状态字典 */
+export async function fetchGetProjectRequirementStatusDict() {
+  const result = await request<Api.Project.ProjectRequirementStatusDict[]>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/status/dict`,
+    method: 'get'
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<Api.Project.ProjectRequirementStatusDict[]>, data => data);
+}
+
+/** 获取项目需求终态状态字典 */
+export async function fetchGetProjectRequirementTerminalStatusDict() {
+  const result = await request<Api.Project.ProjectRequirementStatusDict[]>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/status/dict/terminal`,
+    method: 'get'
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<Api.Project.ProjectRequirementStatusDict[]>, data => data);
+}
+
+/** 获取项目需求模块树 */
+export async function fetchGetProjectRequirementModuleTree(projectId: string) {
+  const result = await request<ProjectRequirementModuleResponse[]>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/module/tree`,
+    method: 'get',
+    params: { projectId }
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<ProjectRequirementModuleResponse[]>, data =>
+    data.map(normalizeProjectRequirementModule)
+  );
+}
+
+/** 创建项目需求模块 */
+export async function fetchCreateProjectRequirementModule(data: Api.Project.SaveProjectRequirementModuleParams) {
+  const result = await request<string | number>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/module/create`,
+    method: 'post',
+    data
+  });
+
+  return mapServiceResult(result as ServiceRequestResult<string | number>, normalizeStringId);
+}
+
+/** 更新项目需求模块 */
+export function fetchUpdateProjectRequirementModule(data: Api.Project.SaveProjectRequirementModuleParams) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/module/update`,
+    method: 'put',
+    data
+  });
+}
+
+/** 删除项目需求模块 */
+export function fetchDeleteProjectRequirementModule(data: Api.Project.DeleteProjectRequirementModuleParams) {
+  return request<boolean>({
+    ...safeJsonRequestConfig,
+    url: `${PROJECT_REQUIREMENT_PREFIX}/module/delete`,
+    method: 'post',
+    data
+  });
+}