feat(签署文书): 统一签署态文书样式并精简演示种子为单份麻精同意书
This commit is contained in:
yelan
@@ -1,22 +1,9 @@
|
||||
/**
|
||||
* 文档库的演示数据与展示文案。
|
||||
*
|
||||
* 状态标签放在这里而不是随演示数据一起删掉：标签是纯展示映射，
|
||||
* 接真实接口后照样要用，不能和"演示数据"捆在一起。
|
||||
*
|
||||
* 演示文书库的种子与读写逻辑在 utils/mock-document-library：
|
||||
* 文档库页面和签署工作台必须读同一份数据，否则会出现「文档库里维护的模板，签署端选不到」，
|
||||
* 或者签署端混着一批文档库里看不到、也无法维护的模板。
|
||||
*/
|
||||
import type { DocumentRecord } from '@/api/management/types'
|
||||
import type { LocalDocument, LocalDepartment } from '@/utils/mock-document-library'
|
||||
import { readDocumentLibrary, writeDocumentLibrary } from '@/utils/mock-document-library'
|
||||
|
||||
import type { DocumentDepartment, DocumentBackendStatus, DocumentStatus } from './types'
|
||||
|
||||
/**
|
||||
* 演示文库与页面模型之间的归一。
|
||||
*
|
||||
* 状态口径与标签见 ./library，这里只管「演示文库（utils/mock-document-library）
|
||||
* ↔ 页面模型（DocumentDepartment）」的字段补齐，不掺展示映射。
|
||||
*
|
||||
* utils/mock-document-library 刻意只声明自己用到的字段（不反向依赖 views 的类型），
|
||||
* 它返回的文书缺了页面模型要求的 category / updatedBy / updatedAt，code 也可能为空。
|
||||
* 两种口径不一致会在 loadLibrary / saveDocumentLibrary 处直接报类型错误，
|
||||
@@ -26,6 +13,12 @@ import type { DocumentDepartment, DocumentBackendStatus, DocumentStatus } from '
|
||||
* 补齐用的值都标注了是演示数据的缺省值，不冒充真实字段：
|
||||
* updatedAt 留空串，页面会显示成"—"，不会假装有一份真实的更新时间。
|
||||
*/
|
||||
import type { DocumentRecord } from '@/api/management/types'
|
||||
import type { LocalDocument, LocalDepartment } from '@/utils/mock-document-library'
|
||||
import { readDocumentLibrary, writeDocumentLibrary } from '@/utils/mock-document-library'
|
||||
|
||||
import type { DocumentDepartment } from './types'
|
||||
|
||||
function toDocumentRecord(document: LocalDocument, categoryName: string): DocumentRecord {
|
||||
return {
|
||||
...document,
|
||||
@@ -88,6 +81,7 @@ function toLocalDocument(document: DocumentRecord): LocalDocument {
|
||||
versionId: document.versionId,
|
||||
departmentId: document.departmentId,
|
||||
departmentName: document.departmentName,
|
||||
sharedDepartments: document.sharedDepartments,
|
||||
campusId: document.campusId,
|
||||
campusName: document.campusName,
|
||||
updatedAt: document.updatedAt,
|
||||
@@ -95,132 +89,3 @@ function toLocalDocument(document: DocumentRecord): LocalDocument {
|
||||
contentSha256: document.contentSha256,
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 状态标签。键集合与后端模板状态枚举一一对应
|
||||
* （见 api/management/types.ts 的 BackendTemplateStatus 与 documents.ts 的 normalizeDocumentStatus），
|
||||
* 不再有后端枚举里不存在的 enabled。
|
||||
*/
|
||||
export const documentStatusLabels: Record<DocumentStatus, string> = {
|
||||
draft: '草稿',
|
||||
review: '需复审',
|
||||
published: '已发布',
|
||||
archived: '已归档',
|
||||
}
|
||||
|
||||
/**
|
||||
* 后端原始状态 → 中文标签。
|
||||
*
|
||||
* 卡片与预览弹窗用它，而不是归一后的 documentStatusLabels：归一过程把
|
||||
* PENDING_REVIEW（待审核）和 REJECTED（已驳回）都并成了 review，
|
||||
* 只看「需复审」分不清是「还等着审」还是「已经被打回」。
|
||||
*/
|
||||
export const backendStatusLabels: Record<DocumentBackendStatus, string> = {
|
||||
DRAFT: '草稿',
|
||||
PENDING_REVIEW: '待审核',
|
||||
REJECTED: '已驳回',
|
||||
APPROVED: '审核通过',
|
||||
PUBLISHED: '已发布',
|
||||
DISABLED: '已停用',
|
||||
ARCHIVED: '已归档',
|
||||
}
|
||||
|
||||
/**
|
||||
* 状态页签的固定展示顺序：按文书生命周期排列（草稿 → 送审 → 驳回/通过 → 发布 → 停用 → 归档）。
|
||||
* 固定顺序而不是按接口返回顺序，否则同一个库里状态一多，页签会来回跳。
|
||||
*/
|
||||
export const backendStatusOrder: DocumentBackendStatus[] = [
|
||||
'DRAFT',
|
||||
'PENDING_REVIEW',
|
||||
'REJECTED',
|
||||
'APPROVED',
|
||||
'PUBLISHED',
|
||||
'DISABLED',
|
||||
'ARCHIVED',
|
||||
]
|
||||
|
||||
/** 取状态标签：优先用后端原始状态（更精确），拿不到再退回归一后的状态 */
|
||||
export function readStatusLabel(template: {
|
||||
status: DocumentStatus
|
||||
backendStatus?: string
|
||||
}): string {
|
||||
const backendLabel = template.backendStatus
|
||||
? backendStatusLabels[template.backendStatus as DocumentBackendStatus]
|
||||
: undefined
|
||||
|
||||
return backendLabel ?? documentStatusLabels[template.status]
|
||||
}
|
||||
|
||||
/**
|
||||
* 按后端状态取标签。
|
||||
* 版本历史只有后端状态，没有归一后的 status，因此单独开一个入口。
|
||||
* 遇到未知状态原样显示，不显示成空白——后端新增状态时至少能看见它是什么。
|
||||
*/
|
||||
export function readBackendStatusLabel(status: string | null | undefined): string {
|
||||
if (!status) {
|
||||
return '—'
|
||||
}
|
||||
|
||||
return backendStatusLabels[status as DocumentBackendStatus] ?? status
|
||||
}
|
||||
|
||||
/**
|
||||
* 状态色调：决定状态徽标用哪一套配色。
|
||||
*
|
||||
* 不能直接用归一后的 DocumentStatus 当配色键——PENDING_REVIEW 与 REJECTED
|
||||
* 归一后都是 review，两者会共用同一个颜色，页签与文字已经区分开了、颜色却还糊在一起。
|
||||
*/
|
||||
export type DocumentStatusTone = 'draft' | 'review' | 'rejected' | 'published' | 'archived'
|
||||
|
||||
export function readStatusTone(template: {
|
||||
status: DocumentStatus
|
||||
backendStatus?: string
|
||||
}): DocumentStatusTone {
|
||||
switch (readBackendStatus(template)) {
|
||||
case 'PENDING_REVIEW':
|
||||
return 'review'
|
||||
case 'REJECTED':
|
||||
return 'rejected'
|
||||
case 'APPROVED':
|
||||
case 'PUBLISHED':
|
||||
return 'published'
|
||||
case 'DISABLED':
|
||||
case 'ARCHIVED':
|
||||
return 'archived'
|
||||
case 'DRAFT':
|
||||
default:
|
||||
return 'draft'
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 取文书的后端原始状态，供状态页签归类。
|
||||
*
|
||||
* 真实模式的列表接口会给 backendStatus；演示库与部分历史数据可能没有，
|
||||
* 这时按归一后的 status 反推一个等价状态，避免这类文书在页签里被漏掉。
|
||||
*
|
||||
* 反推对 'review' 是有损的：归一过程把 PENDING_REVIEW 与 REJECTED 合并了，
|
||||
* 只能归到 PENDING_REVIEW。这只是缺字段时的兜底，不改变页签按真实状态过滤的口径。
|
||||
*/
|
||||
export function readBackendStatus(template: {
|
||||
status: DocumentStatus
|
||||
backendStatus?: string
|
||||
}): DocumentBackendStatus {
|
||||
const known = backendStatusOrder.find((status) => status === template.backendStatus)
|
||||
|
||||
if (known) {
|
||||
return known
|
||||
}
|
||||
|
||||
switch (template.status) {
|
||||
case 'published':
|
||||
return 'PUBLISHED'
|
||||
case 'review':
|
||||
return 'PENDING_REVIEW'
|
||||
case 'archived':
|
||||
return 'ARCHIVED'
|
||||
case 'draft':
|
||||
default:
|
||||
return 'DRAFT'
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user