feat(docs): 添加档案管理模块业务流程文档

云

2026-09-29 f87ce86307056f63f79312178037cc8714eb2b13

 docs/project-business/data/objects.json

@@ -48,13 +48,16 @@
    {"name": "排班计划", "module": "设备", "table": "mes_cal_plan", "doc": "班组×班次×日期排班，供生产与考勤引用", "upstream": [], "downstream": ["生产任务", "考勤"], "keywords": "排班 班组 班次 日历"},
    {"name": "报告模板", "module": "质检报告", "table": "qc_report_template", "doc": "智能质检报告模板，启用0/停用1；画布内容存在 qc_report_template_version（草稿0/已发布1/已停用2，已发布不可覆盖），currentVersion 指向当前已发布版本；源文件经 AI 导入识别成草稿后由人工确认才成为版本；同一模板重复导入按【替换】处理——先删旧附件（连带 blob 行与磁盘文件）再绑新的，不留孤儿文件；删除模板会连带清附件", "upstream": ["人工设计(GrapesJS 设计器)", "AI 导入草稿(qc-report/ai-import/draft)"], "downstream": ["模板版本", "报告实例"], "keywords": "报告模板 质检报告 template 设计器 版本 AI导入 识别 草稿 源文件替换"},
    {"name": "报告实例", "module": "质检报告", "table": "qc_report_instance", "doc": "出件产物，编号 QR+yyyyMMdd+4位流水按天独立且业务唯一，可显式指定覆盖（注意 uk_report_no 不区分软删除，删掉的号不回收）；两条出件入口：通用 generate（调用方自带 context）与 generate-from-qc（数据从 MES 质检单取，权限码 qc-report:instance:generate 已入 system_menu id=1075416，五道校验按业务优先级只报第一处：105_000 类型非法 / 105_001 单据不存在 / 105_002 未完成 / 105_003 未判定 / 105_005 模板类型不符 / 105_006 无可用检验项；四张质检单列表的行操作「出报告」仅在 status=已完成时可见，弹窗只列 reportType 一致、模板启用、且 currentVersion 指向的版本已发布的模板（后端 /qc-report/template/selectable 判定——停用版本不清空 currentVersion，前端拿分页结果自己推导会漏），结果就地展示并跳本页列表）；冻结 data_snapshot（判定后数据，含后端算好的 PASS/FAIL 与合格率）与 render_html；regenerate 只重渲排版、数据与编号不变；business_id/business_type 存 MES 表名（mes_qc_iqc 等）与单据 ID，可反查、一单可出多份；报告头另带单据原判定 qcResult(数)/qcResultText(中文，合格/特采/不合格退货/不合格报废)，与引擎三态判定并存互不覆盖；响应带 undecidableCount=快照中 result 为空串的项数与 warnings（分组标题跳过/指标已删/未录实测值/样品超3），两者都不落库、事后看不到", "upstream": ["报告模板版本", "质检单上下文(通用 generate 由调用方传入)", "MES 质检单 IQC/IPQC/OQC/RQC(generate-from-qc 经 MesQcReportApi 取数)"], "downstream": ["前端实例页 /qc/report-instance(列表·iframe预览·快照页签·导出PDF)", "PDF归档(system_storage_attachment recordType=qc_report_instance)"], "keywords": "报告实例 出件 QR编号 快照 复现 regenerate PDF归档 报告实例页 导出PDF generate-from-qc 质检单出报告 出报告弹窗 qcResult undecidableCount warnings 待判定 反查 业务单据筛选"},
    {"name": "报销单", "module": "财务报销", "table": "finance_reimbursement", "doc": "单号可自定义(中间不允许空格，与已有单号重复则报错)；新增时留空或纯空格由系统生成 BX+yyyyMMdd+6位流水(Redis 每日重置)，修改时留空表示保持不变。status: 0草稿/15审批中/20已通过/35已驳回/40已归档；仅草稿可删、草稿与已驳回可改、仅已通过可归档；提交后由 BPM 监听器按结果回写状态(取消退回草稿)，审批中 processInstanceId 被回写。来源两条：① 财务模块页面人工填报 ②课题管理「经费拨付」经 FinanceReimbursementApi(yudao-module-finance-api)自动建单并立即提交(1:1、金额一致、系统固定 1 行明细·费用类型=其他)——后者的审批结果由课题侧 ResearchFundStatusListener 订阅同一流程回写拨款台账，报销单本身不回写任何外部单据", "upstream": ["课题管理(经费拨付·经 FinanceReimbursementApi 自动建单)", "人工填报"], "downstream": ["报销明细", "发票附件(storage_attachment·recordType=finance_reimbursement)", "课题拨款台账(仅经 BPM 事件回写状态)"], "keywords": "报销单 报销 发票 reimbursement BX 归档 财务 费用 自定义单号 课题经费拨付 自动建单 FinanceReimbursementApi"},
    {"name": "报销单", "module": "财务报销", "table": "finance_reimbursement", "doc": "单号可自定义(中间不允许空格，与已有单号重复则报错)；新增时留空或纯空格由系统生成 BX+yyyyMMdd+6位流水(Redis 每日重置)，修改时留空表示保持不变。status: 0草稿/15审批中/20已通过/35已驳回/40已归档；仅草稿可删、草稿与已驳回可改、仅已通过可归档；提交后由 BPM 监听器按结果回写状态(取消退回草稿)，审批中 processInstanceId 被回写。来源两条：① 财务模块页面人工填报 ②课题管理「经费拨付」经 FinanceReimbursementApi(yudao-module-finance-api)自动建单并立即提交(1:1、金额一致、系统固定 1 行明细·费用类型=其他)——后者的审批结果由课题侧 ResearchFundStatusListener 订阅同一流程回写拨款台账，报销单本身不回写任何外部单据；archive_document_id 非空表示已归档", "upstream": ["课题管理(经费拨付·经 FinanceReimbursementApi 自动建单)", "人工填报"], "downstream": ["报销明细", "发票附件(storage_attachment·recordType=finance_reimbursement)", "课题拨款台账(仅经 BPM 事件回写状态)", "档案管理(既有归档动作同事务叠加·生成「保密 3」级财务档案并回写 archive_document_id)"], "keywords": "报销单 报销 发票 reimbursement BX 归档 财务 费用 自定义单号 课题经费拨付 自动建单 FinanceReimbursementApi 财务档案 保密 archive_document_id"},
    {"name": "报销明细", "module": "财务报销", "table": "finance_reimbursement_item", "doc": "报销单的费用行：费用类型(1差旅/2办公/3招待/4交通/5其他)、发票号码、发票金额、发票日期、开票方、费用说明；随主表一次性提交(先删后增全量覆盖)，提交时必须剥掉行 id 与 reimbursementId —— 明细删除是软删，回传原 id 会与已软删行主键冲突", "upstream": ["报销单"], "downstream": [], "keywords": "报销明细 费用明细 费用类型 发票金额 item 明细行 差旅"},
    {"name": "入会申请单", "module": "会员管理", "table": "ums_application", "doc": "单号 SQ+yyyyMMdd+6位流水(Redis 每日重置)，后端生成不可自定义；memberType 1个人/2单位决定字段分叉(个人用 workUnit/title，单位用 legalPerson/organizationCode)；memberGrade 按类型取不同字典；status: 0草稿/15审批中/20已通过/35已驳回。仅草稿可删(连带清附件)、草稿与已驳回可改可重提；提交后由 BPM 监听器按结果回写(取消退回草稿)，审批中回写 processInstanceId；审批通过触发自动建会员与系统账号。独立模块，不与其它业务模块产生单据关联", "upstream": ["人工填报(申请人)", "证明材料附件(storage_attachment·recordType=ums_application)"], "downstream": ["会员(审批通过自动创建)", "BPM 流程实例(ums_membership_approve 分类)"], "keywords": "入会申请 入会 会员申请 application SQ 秘书处 理事会 审批 会员类型 个人 单位 法定代表人 研究方向 申请等级"},
    {"name": "会员", "module": "会员管理", "table": "ums_member", "doc": "单号 HY+yyyyMMdd+6位流水(Redis 每日重置)；两个来源：①入会申请审批通过自动创建(回填 applicationId 与 userName/系统账号) ②会员列表手工新增。status: 1正常/0暂停；memberGrade 按 memberType 取对应字典，校验规则是单位会员(type=2)不可选『理事长』(grade=5)。自动建档时入会日期=当天、不搬运 contactUser/unitIntro/expireDate(申请单无对应字段)；自动建的系统账号用户名为联系电话且初始密码同为联系电话，部门固定为「学会会员」；手机号重复会明确报错且整单事务回滚", "upstream": ["入会申请单(审批通过)", "人工新增", "附件(storage_attachment·recordType=ums_member)"], "downstream": ["会员通讯录(按 regionCode/industry 检索)", "system_users(登录账号)"], "keywords": "会员 member HY 会员编号 会员等级 会员类型 通讯录 地区 行业 入会日期 有效期"},
    {"name": "会员", "module": "会员管理", "table": "ums_member", "doc": "单号 HY+yyyyMMdd+6位流水(Redis 每日重置)；两个来源：①入会申请审批通过自动创建(回填 applicationId 与 userName/系统账号) ②会员列表手工新增。status: 1正常/0暂停；memberGrade 按 memberType 取对应字典，校验规则是单位会员(type=2)不可选『理事长』(grade=5)。自动建档时入会日期=当天、不搬运 contactUser/unitIntro/expireDate(申请单无对应字段)；自动建的系统账号用户名为联系电话且初始密码同为联系电话，部门固定为「学会会员」；手机号重复会明确报错且整单事务回滚；archive_document_id 非空表示已归档（归档后列表页隐藏「归档」按钮）", "upstream": ["入会申请单(审批通过)", "人工新增", "附件(storage_attachment·recordType=ums_member)"], "downstream": ["会员通讯录(按 regionCode/industry 检索)", "档案管理(手动「归档」·仅正常状态可归档·经 yudao-module-archive-api 生成档案并回写 archive_document_id)", "system_users(登录账号)"], "keywords": "会员 member HY 会员编号 会员等级 会员类型 通讯录 地区 行业 入会日期 有效期 归档 archive_document_id"},
    {"name": "课题指南", "module": "课题管理", "table": "research_guideline", "doc": "指南编号 GL+yyyyMMdd+6位流水(Redis 每日重置)；category 1重点课题/2一般课题；publishStatus 0草稿/20已发布/30已截止，仅草稿可改可删，publish 发布回写 publishTime，close 截止置 30；已产生申报单(applicationMapper.selectCountByGuidelineId 大于 0)的指南禁止删除并在提示中报出该指南下已有多少张申报单；正文 content 为长文本；附件 recordType=research_guideline", "upstream": ["人工维护(学会秘书处)", "指南附件(storage_attachment·recordType=research_guideline)"], "downstream": ["课题申报书(申报时引用且必须已发布并在申报期内)"], "keywords": "课题指南 指南 发布 截止 重点课题 一般课题 GL 指南编号 申报期 申报起止"},
    {"name": "课题申报书", "module": "课题管理", "table": "research_application", "doc": "申报编号 SB+yyyyMMdd+6位流水(Redis 每日重置)；guidelineId 关联指南、memberId 关联 ums_member(软关联无外键，会员删除后会留下悬空 memberId 需容错显示)；applicantName/workUnit/jobTitle/contactPhone/contactEmail 由选会员自动带出可手改；category 冗余自指南且不信任前端传值；budgetAmount 申请经费为拨付上限；status: 0草稿/15审批中/20已立项/35已驳回。仅草稿可删(连带清附件)、草稿与已驳回可改可重提；submit 前逐条校验「指南已发布」与「现在在申报期内」，任一不满足即拒绝并按维度给出指南名与实际值；审批通过由监听器生成立项编号 researchNo(LX+同日流水)与 approveTime(已有编号幂等跳过)；reviewAvgScore/reviewPass 为评审汇总回写值，明细删空时清成未汇总；noticeId 记录已发布的立项通知公告，重复发布被拦截", "upstream": ["课题指南(必须已发布且在申报期内)", "会员(ums_member·带出申报人信息)", "申报附件(storage_attachment·recordType=research_application)"], "downstream": ["专家评审明细", "经费拨付记录", "立项通知(system_notice 公告)", "BPM 流程实例(research_topic_approve 分类)", "附件中心"], "keywords": "课题申报 申报书 申报单 SB 申报编号 立项 立项编号 LX 申请经费 申报书正文 课题组成员 专家评审 评审汇总 立项通知 发布通知 提交审批 驳回 重提"},
    {"name": "课题申报书", "module": "课题管理", "table": "research_application", "doc": "申报编号 SB+yyyyMMdd+6位流水(Redis 每日重置)；guidelineId 关联指南、memberId 关联 ums_member(软关联无外键，会员删除后会留下悬空 memberId 需容错显示)；applicantName/workUnit/jobTitle/contactPhone/contactEmail 由选会员自动带出可手改；category 冗余自指南且不信任前端传值；budgetAmount 申请经费为拨付上限；status: 0草稿/15审批中/20已立项/35已驳回。仅草稿可删(连带清附件)、草稿与已驳回可改可重提；submit 前逐条校验「指南已发布」与「现在在申报期内」，任一不满足即拒绝并按维度给出指南名与实际值；审批通过由监听器生成立项编号 researchNo(LX+同日流水)与 approveTime(已有编号幂等跳过)；reviewAvgScore/reviewPass 为评审汇总回写值，明细删空时清成未汇总；noticeId 记录已发布的立项通知公告，重复发布被拦截；archive_document_id 非空表示已归档（归档后列表页隐藏「归档」按钮）", "upstream": ["课题指南(必须已发布且在申报期内)", "会员(ums_member·带出申报人信息)", "申报附件(storage_attachment·recordType=research_application)"], "downstream": ["专家评审明细", "经费拨付记录", "立项通知(system_notice 公告)", "BPM 流程实例(research_topic_approve 分类)", "档案管理(手动「归档」·仅已立项可归档·经 yudao-module-archive-api 生成档案并回写 archive_document_id)", "附件中心"], "keywords": "课题申报 申报书 申报单 SB 申报编号 立项 立项编号 LX 申请经费 申报书正文 课题组成员 专家评审 评审汇总 立项通知 发布通知 提交审批 驳回 重提 归档 archive_document_id"},
    {"name": "专家评审明细", "module": "课题管理", "table": "research_topic_review", "doc": "一位专家一行的一主多行子表：evaluatorName/evaluatorUnit/evaluatorTitle + topicScore 选题价值与意义(权重0.3) + planScore 研究方案可行性(0.3) + teamScore 团队与研究基础(0.2) + resultScore 预期成果与效益(0.2) + conclusion 1推荐立项/2不推荐立项 + opinion 评审意见 + reviewTime。compositeScore 由后端 weightedScore 计算、ranking 由后端按加权分降序重排，均不接受前端传值；每次增删改后调 recalculate 回写主单 reviewAvgScore(全部专家加权分均值·保留2位)与 reviewPass(均分达标 且 多数结论为推荐立项时为 1)；四项分值超出 0~100 时提示指出具体维度与实际值；仅在申报单 status=15 审批中可增删改", "upstream": ["课题申报书(仅审批中可写)"], "downstream": ["课题申报书(回写 reviewAvgScore/reviewPass)"], "keywords": "专家评审 评审明细 评分 加权 权重 排名 ranking compositeScore 推荐立项 评审意见 均分"},
    {"name": "档案分类", "module": "档案管理", "table": "archive_category", "doc": "树形书架分类(parentId·0=顶级)，承载「分层分列」规整：6 条初始分类 会员档案 member / 课题档案 research / 会议档案 meeting / 财务档案 finance / 文书档案 document / 党建档案 party；code 全局唯一 uk_code；defaultSecretLevel 为该分类下档案的默认密级(1公开/2内部/3保密，财务分类=3)；status 0启用/1停用。仅可改可删，有子分类禁删、该分类下有档案禁删、父分类不能设为自身或其子分类。会议/党建档案系统内无来源模块，仅支持手工录入档案", "upstream": ["人工维护(档案管理员)"], "downstream": ["档案(新增时带出默认密级)"], "keywords": "档案分类 书架 分层分列 会员档案 课题档案 会议档案 财务档案 文书档案 党建档案 category 默认密级"},
    {"name": "档案", "module": "档案管理", "table": "archive_document", "doc": "档案主表，编号 DA+yyyyMMdd+6位流水(Redis 每日重置)。电子与实体兼具：电子走 system 附件中心 recordType=archive_document(表内不存文件地址)、实体记 shelfNo 书架号/layerNo 层号/columnNo 列号/boxNo 册号档案盒 + storePlace 存放位置描述。carrierType 1电子/2实体/3电子+实体；secretLevel 1公开/2内部/3保密(为 3 且当前用户无 archive:document:sensitive 时详情报错、列表与导出强制过滤)；sourceType 1手工/2课题/3会员/4财务 + sourceNo/sourceId/sourceTitle 记录来源快照以便检索；status 10在库/20借出中(借出中禁改、存在未归还借阅单时禁删)。来源为 2/3/4 的档案由三方列表页「归档」按钮经 ArchiveDocumentApi.archiveBySource 生成(幂等)，并回写来源表 archive_document_id", "upstream": ["档案分类", "档案登记(人工)", "课题归档(已立项申报书)", "会员归档(正常会员)", "财务归档(已通过报销单)"], "downstream": ["借阅单", "附件中心(recordType=archive_document)", "来源表 archive_document_id 回写"], "keywords": "档案 文档 document DA 档案编号 密级 保密 公开 内部 敏感档案 载体 电子 实体 书架号 层号 列号 册号 档案盒 归档日期 在库 借出中 检索 关键词 tags 来源单号 归档联动"},
    {"name": "借阅单", "module": "档案管理", "table": "archive_borrow", "doc": "借阅与归还合一，编号 JY+yyyyMMdd+6位流水(Redis 每日重置)。记录借阅人/部门/电话、借阅日期、借阅目的、归还期限(returnDeadline·逾期实时计算基准)；documentNo/documentTitle 为档案快照。status 0草稿/15审批中/20借出中/30已归还/35已驳回：仅 0 与 35 可改可重提、仅 0 可删、仅 20 可登记归还。submit 前校验同一档案不得已有 15/20 的借阅单(命中报已借用并带档案名与已存在借阅单号)；流程 key archive_borrow_approve 两级(档案管理员审核→分管领导审批)，前端不写死 key。审批通过由 ArchiveBorrowStatusListener 回写 20+approveTime 并条件更新档案 SET status=20 WHERE status=10(影响 0 行报档案已被占用并回滚)；归还登记条件更新 20→30 并回写 returnTime/归还确认人。逾期不落库，查询时实时算 overdueDays 并在列表渲染红色「逾期 N 天」，另有 /overdue-page 独立入口", "upstream": ["档案(仅 在库 10 可选)", "BPM(流程 archive_borrow_approve)", "人工登记"], "downstream": ["档案(状态 20 借出中 / 归还回 10 在库)"], "keywords": "借阅 借阅单 借阅登记 归还 归还登记 逾期 逾期未还 借阅人 借阅目的 归还期限 JY 借阅单号 档案管理员审核 分管领导审批 流转闭环"},
    {"name": "经费拨付记录", "module": "课题管理", "table": "research_fund_record", "doc": "一主多行的拨款台账：batchName 批次名称/amount 拨付金额/payDate 拨付日期/payee 收款单位/remark，凭证附件走 system 附件中心 recordType=research_fund_record(表内不存文件地址)。status: 0待拨付/15报销审批中/20已拨付/30已驳回，由系统与 BPM 驱动，新增/修改接口已移除 status 入参(防伪造「已拨付」)。登记即一条龙：落台账 → 同一批 blob 双绑 → 经 FinanceReimbursementApi 自动生成 1:1 的 finance_reimbursement 并立即提交 BPM → 回写 reimbursement_id/reimbursement_no 并置 15；审批结果由监听器回写：通过→20、驳回→30(+reject_reason/reject_time)、取消流程→退回 0（发起人撤回只退回发起节点、流程未结束，状态不变）。仅申报单 status=20 已立项可登记；凭证必填；金额校验：已登记金额(该单全部记录求和) + 本次金额 不得超出申报单 budgetAmount，超出时提示报出本次、已登记、合计、预算四项数值；仅「待拨付」可删(联动删除财务侧草稿报销单，非草稿则拒绝)，「待拨付」「已驳回」可改并重新发起报销(已驳回改后清空 reject_reason/reject_time)，编辑时把本行金额加回可用余额展示避免误解。与报销单为软关联(无外键)，财务侧直接删单会留下悬空 reimbursement_id，此时修改报「报销单已不存在，请删除本条记录后重新登记」", "upstream": ["课题申报书(必须已立项)", "财务报销单(1:1 自动生成·软关联 reimbursement_id)"], "downstream": ["拨付凭证(storage_attachment·recordType=research_fund_record)", "财务报销单(生成并提交出账·审批结果回写本台账)"], "keywords": "经费拨付 拨款 拨付记录 批次 拨付金额 凭证 待拨付 报销审批中 已拨付 已驳回 驳回原因 财务报销单号 reimbursement_id 收款单位 资助金额 预算 超额 重新发起报销"}
  ]
}