产品设计

涉及页面

• 设计项目列表页（mes/pd/project/index）
• 设计项目详情/新增/编辑弹窗
• 资料子表管理弹窗
• 资料审核弹窗
• 归档台账列表页（mes/pd/archive/index）
• 归档台账详情/新增/编辑弹窗

状态流转

待发布(0) → 待上传(1) → 待审核(2) → 待归档(3) → 已归档(4)

API

设计项目

创建/更新请求参数：

分页请求参数：

响应： 在基础字段上额外包含 chiefDesignerNickname（主设计师名称）、reviewerNickname（审核人名称）

设计资料

创建/更新请求参数：

响应： 在基础字段上额外包含 uploadUserNickname（上传人名称）、fileUrl（文件URL）

资料审核

创建/更新请求参数：

响应： 在基础字段上额外包含 reviewerNickname（审核人名称）

归档台账

创建/更新请求参数：

响应： 在基础字段上额外包含 archiverNickname（归档人名称）、taskCode（任务编码）、taskName（任务名称）

前端修改点

1. 设计项目列表页

<!-- 状态标签 -->
<el-tag :type="getStatusTagType(row.status)">
  {{ getStatusLabel(row.status) }}
</el-tag>

<!-- 状态流转按钮 -->
<el-button v-if="row.status === 0" @click="handlePublish(row.id)" type="primary">发布</el-button>
<el-button v-if="row.status === 1" @click="handleUpload(row.id)" type="warning">上传资料</el-button>
<el-button v-if="row.status === 2" @click="handleAudit(row.id)" type="success">审核</el-button>
<el-button v-if="row.status === 3" @click="handleArchive(row.id)" type="danger">归档</el-button>

2. data 数据

data() {
  return {
    // 状态流转API映射
    statusFlowApi: {
      0: publishProject,
      1: uploadProject,
      2: auditProject,
      3: archiveProject,
    },
  }
}

3. 方法

// 状态流转
handlePublish(id) {
  publishProject(id).then(() => { this.getList() })
},
handleUpload(id) {
  uploadProject(id).then(() => { this.getList() })
},
handleAudit(id) {
  auditProject(id).then(() => { this.getList() })
},
handleArchive(id) {
  archiveProject(id).then(() => { this.getList() })
},

// 资料子表 - 打开弹窗
handleDocument(projectId) {
  this.documentOpen = true
  this.documentProjectId = projectId
  this.getDocumentList()
},

4. API 定义

// 设计项目
export function createProject(data) { return request({ url: '/mes/pd/project/create', method: 'post', data }) }
export function updateProject(data) { return request({ url: '/mes/pd/project/update', method: 'put', data }) }
export function deleteProject(id) { return request({ url: '/mes/pd/project/delete', method: 'delete', params: { id } }) }
export function getProject(id) { return request({ url: '/mes/pd/project/get', method: 'get', params: { id } }) }
export function getProjectPage(params) { return request({ url: '/mes/pd/project/page', method: 'get', params }) }
export function exportProjectExcel(params) { return request({ url: '/mes/pd/project/export-excel', method: 'get', params, responseType: 'blob' }) }
export function publishProject(id) { return request({ url: '/mes/pd/project/publish', method: 'put', params: { id } }) }
export function uploadProject(id) { return request({ url: '/mes/pd/project/upload', method: 'put', params: { id } }) }
export function auditProject(id) { return request({ url: '/mes/pd/project/audit', method: 'put', params: { id } }) }
export function archiveProject(id) { return request({ url: '/mes/pd/project/archive', method: 'put', params: { id } }) }

// 设计资料
export function createDocument(data) { return request({ url: '/mes/pd/document/create', method: 'post', data }) }
export function updateDocument(data) { return request({ url: '/mes/pd/document/update', method: 'put', data }) }
export function deleteDocument(id) { return request({ url: '/mes/pd/document/delete', method: 'delete', params: { id } }) }
export function getDocument(id) { return request({ url: '/mes/pd/document/get', method: 'get', params: { id } }) }
export function getDocumentPage(params) { return request({ url: '/mes/pd/document/page', method: 'get', params }) }

// 文件上传（通用接口，上传后返回URL，存入资料表 fileUrl 字段）
export function uploadFile(file, directory) { return request({ url: '/infra/file/upload', method: 'post', data: { file, directory }, headers: { 'Content-Type': 'multipart/form-data' } }) }

// 资料审核（前端无需调用 create，上传资料时后端自动创建）
export function updateDocumentAudit(data) { return request({ url: '/mes/pd/document-audit/update', method: 'put', data }) }
export function deleteDocumentAudit(id) { return request({ url: '/mes/pd/document-audit/delete', method: 'delete', params: { id } }) }
export function getDocumentAuditPage(params) { return request({ url: '/mes/pd/document-audit/page', method: 'get', params }) }

// 归档台账（前端无需调用 create，归档时后端自动创建）
export function updateArchive(data) { return request({ url: '/mes/pd/archive/update', method: 'put', data }) }
export function deleteArchive(id) { return request({ url: '/mes/pd/archive/delete', method: 'delete', params: { id } }) }
export function getArchive(id) { return request({ url: '/mes/pd/archive/get', method: 'get', params: { id } }) }
export function getArchivePage(params) { return request({ url: '/mes/pd/archive/page', method: 'get', params }) }
export function exportArchiveExcel(params) { return request({ url: '/mes/pd/archive/export-excel', method: 'get', params, responseType: 'blob' }) }

5. 资料子表 - 文件上传组件

<!-- 设计资料新增/编辑弹窗中添加文件上传 -->
<el-form-item label="文件" prop="fileUrl">
  <UploadFile v-model="formData.fileUrl" :limit="1" />
</el-form-item>

<!-- 资料列表中显示文件链接 -->
<el-table-column label="文件" prop="fileUrl">
  <template #default="{ row }">
    <el-link v-if="row.fileUrl" :href="row.fileUrl" target="_blank" type="primary">
      {{ row.fileName || '查看文件' }}
    </el-link>
    <span v-else>-</span>
  </template>
</el-table-column>

// 文件上传回调
handleFileUploadSuccess(url) {
  this.formData.fileUrl = url
},

6. 字典数据更新 SQL

UPDATE system_dict_data SET label = '待发布' WHERE dict_type = 'mes_pd_project_status' AND value = '0';
UPDATE system_dict_data SET label = '待上传' WHERE dict_type = 'mes_pd_project_status' AND value = '1';
UPDATE system_dict_data SET label = '待审核' WHERE dict_type = 'mes_pd_project_status' AND value = '2';
UPDATE system_dict_data SET label = '待归档' WHERE dict_type = 'mes_pd_project_status' AND value = '3';
UPDATE system_dict_data SET label = '已归档' WHERE dict_type = 'mes_pd_project_status' AND value = '4';

编码规则配置

需要在编码规则管理中新增以下两条规则：

注意事项

• 设计项目状态流转为线性5状态（0→1→2→3→4），不支持回退或取消
• 只有待发布(0)状态才允许修改和删除设计项目
• 删除设计项目会级联删除其下的所有资料记录
• 资料子表的 fileUrl 字段存储文件URL，前端通过 /infra/file/upload 通用接口上传文件后获取URL
• 资料审核表与资料子表为一对多关系，一条资料可以有多条审核记录
• 字典类型需要在系统管理中配置：mes_pd_project_status、mes_pd_document_type、mes_pd_document_audit_status、mes_pd_archive_status
• mes_pd_document_type（资料类型）的字典数据需要根据实际业务补充
• 上传资料时后端自动为项目下所有资料创建审核记录（审核人=项目 reviewer，审核状态=待审核），前端无需单独调用 POST /mes/pd/document-audit/create
• 归档时后端自动创建归档台账记录（归档人=当前登录用户，归档时间=当前时间），前端无需单独调用 POST /mes/pd/archive/create
• 上传资料和归档操作是事务性的，状态更新和子表创建在同一个事务中，要么全部成功要么全部回滚