/** * 演示文库与页面模型之间的归一。 * * 状态口径与标签见 ./library,这里只管「演示文库(utils/mock-document-library) * ↔ 页面模型(DocumentDepartment)」的字段补齐,不掺展示映射。 * * utils/mock-document-library 刻意只声明自己用到的字段(不反向依赖 views 的类型), * 它返回的文书缺了页面模型要求的 category / updatedBy / updatedAt,code 也可能为空。 * 两种口径不一致会在 loadLibrary / saveDocumentLibrary 处直接报类型错误, * 因此在这一层做一次显式补齐——而不是让 utils 反过来依赖 views, * 也不是把页面的必填字段放宽成可选(放宽会掩盖真实接口返回缺字段的问题)。 * * 补齐用的值都标注了是演示数据的缺省值,不冒充真实字段: * 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, code: document.code ?? '', category: categoryName, updatedBy: '演示数据', updatedAt: document.updatedAt ?? '', } } export function toDocumentDepartment(department: LocalDepartment): DocumentDepartment { return { ...department, categories: department.categories.map((category) => ({ ...category, documents: category.documents.map((document) => toDocumentRecord(document, category.name)), })), } } /** 读取演示文书库:优先用本地保存的,没有则用种子(调用方负责再克隆一份使用) */ export function loadDocumentLibrary(): DocumentDepartment[] { return readDocumentLibrary().map(toDocumentDepartment) } /** * 保存演示文书库。 * 落本地时要把 category 摘掉(LocalDocument 没有 category 字段, * 分类信息在 categories 这一层的 name 上),否则多存一个字段会在下次读取时对不上。 * updatedBy 同理:它是页面模型为「必须有人维护」补的展示字段,不是演示文库的数据。 */ export function saveDocumentLibrary(library: DocumentDepartment[]): void { writeDocumentLibrary( library.map((department) => ({ ...department, categories: department.categories.map((category) => ({ name: category.name, documents: category.documents.map(toLocalDocument), })), })), ) } /** * 页面模型的文书 → 演示文库存储结构。 * * 逐字段列出而不是解构剔除:解构剔除(`const { category, ...rest }`)会因为 * 被剔除的变量未使用而触发 lint,且多加一个页面专用字段时容易忘掉同步。 * 这里明确列出演示文库认识哪些字段,多出来的页面字段(category / updatedBy)自然被丢掉。 */ function toLocalDocument(document: DocumentRecord): LocalDocument { return { id: document.id, name: document.name, code: document.code, version: document.version, status: document.status, backendStatus: document.backendStatus, description: document.description ?? '', versionId: document.versionId, departmentId: document.departmentId, departmentName: document.departmentName, sharedDepartments: document.sharedDepartments, campusId: document.campusId, campusName: document.campusName, updatedAt: document.updatedAt, contentHtml: document.contentHtml, contentSha256: document.contentSha256, } }