档案管理

档案管理是智档宝的基础业务主线，负责把库区、档案、档案装具、借阅、盘点和权限组织成可管理、可查询、可追溯的业务体系。

业务定位

档案管理重点回答三个问题：

• 档案在哪里：档案归属哪个库房、库区、架体、柜体或格口。
• 档案是什么：档案有哪些著录信息、密级、保管期限、电子文件和业务扩展字段。
• 档案怎么流转：档案从建档、上架、借阅、归还、盘点异常到销毁如何变化。

目录总览

目录	解决的问题	主要内容
库区	档案和装具实际放在哪里	库房、库区、层级结构、密集架、回转柜、当前接入类型
档案	一份档案如何建档、扩展和流转	档案主数据、档案分类、自定义字段、导入导出、生命周期、借阅、回转柜盘点
档案装具	档案盒、袋、夹等载体如何管理	装具类型、装具位置、装具字段、装具内档案、装具借阅和盘点
打印	档案业务中哪些内容需要输出纸质或标签	档案标签、装具标签、借阅单、移交单、盘点单、模板和字段
研发参考	研发如何理解产品对象和代码模块	产品对象、模型映射、前后端入口、关联仓库
产品边界	哪些内容属于档案管理，哪些不属于	数字化、RFID、环境控制、设备协议和系统架构边界

核心对象

对象	说明
库区	档案存放的业务空间，承载架体、柜体、权限、统计和盘点范围
档案	系统管理的核心业务对象，包含基础信息、状态、位置、扩展字段和关联文件
档案装具	档案盒、档案袋、档案夹、档案箱、防磁柜、光盘、磁带等承载对象
档案架具	密集架、固定列、回转柜等实体或逻辑存放结构
借阅记录	记录借阅申请、审批、借出、归还和超期情况
盘点记录	记录盘点任务、盘点结果、差异和处理状态
用户 / 权限	控制人员能访问的库房、档案范围和操作能力

前端页面结构

当前前端主线按“档案概览 / 档案维护”组织。档案概览面向日常检索、建档和对象操作；档案维护面向待办队列、异常处理和借阅流转。

一级入口	二级入口	主要处理对象	前端目录
档案概览	档案概览	单份档案、电子档案、档案位置、暂存、组卷、借阅、转移、删除、出库、导出	fit-archive-ng/src/views/ArchivesManagement/overview/File
档案概览	档案装具概览	档案盒、袋、夹、箱等装具，支持暂存、拆卷、借阅、转移、删除、出库、导出	fit-archive-ng/src/views/ArchivesManagement/overview/FileBox
档案维护	新档上架	待分配明确库位的档案和装具	fit-archive-ng/src/views/ArchivesManagement/maintain/PutOnShelves
档案维护	档案回收站	已删除但可恢复或销毁的档案和装具	fit-archive-ng/src/views/ArchivesManagement/maintain/RecycleBin
档案维护	遗失档案	现场确认遗失后的档案和装具，可找回或彻底遗失处理	fit-archive-ng/src/views/ArchivesManagement/maintain/LostFile
档案维护	借阅审批	待审批、已通过、已拒绝等借阅申请	fit-archive-ng/src/views/ArchivesManagement/maintain/BorrowingApproval
档案维护	待取档案	审批通过后等待现场取档的借阅对象	fit-archive-ng/src/views/ArchivesManagement/maintain/PendingFile
档案维护	在借档案	已借出、可归还或标记遗失的对象	fit-archive-ng/src/views/ArchivesManagement/maintain/BorrowingFiles
档案维护	超期档案	超过借阅期限的在借对象	fit-archive-ng/src/views/ArchivesManagement/maintain/OverdueFile
档案维护	归还上架	已归还但还需要重新确认位置的档案和装具	fit-archive-ng/src/views/ArchivesManagement/maintain/ReturnToShelf
档案维护	借阅用户	借阅人账号、审批人和借阅权限维护	fit-archive-ng/src/views/ArchivesManagement/maintain/FileUser
档案维护	已出库档案	已出库但可找回的档案和装具	fit-archive-ng/src/views/ArchivesManagement/maintain/outLibraryFile

页面上看到的“档案概览”和“档案装具概览”是两套对象列表，但维护页通常会同时提供档案和装具两个 Tab。写业务说明时不要把“档案”和“档案装具”合成一个对象，也不要把“分类”写成实体装具。

库区

库区用于描述档案实物存放的空间范围。它是库房管理、上架、查找、借阅取档、归还上架、盘点和大屏统计的共同基础。

层级结构

库房
└─ 库区
   └─ 架体 / 柜体
      ├─ 密集架：列 / 左右侧 / 节 / 层 / 格
      └─ 回转柜：柜体 / 层 / 格口
         └─ 档案 / 档案装具

层级	产品含义
库房	档案保管的物理空间，通常也是权限、统计和大屏展示的基础范围
库区	库房下的业务分区，可按楼层、房间、区域或项目习惯划分
架体 / 柜体	密集架、固定列、回转柜等档案架具
密集架位置	通过列、左右侧、节、层、格定位档案或装具
回转柜位置	通过柜体、层、格口定位档案
档案 / 装具	最终落位到库区中的实体对象

对外或跨系统调用开架能力时，不能只提供“第几列”。密集架同一列通常有左右两面，必须提供档案所在侧，必要时再带上节、层、格。推荐位置编码可按“区域号-列号-侧编码-节-层-格”组织，例如 A01-3-01-2-4-5，其中 01 表示左侧，02 表示右侧。

密集架

密集架是库区中最常见的智能架具。产品上需要把“库位结构”和“设备联动”分开理解：档案管理负责库位、状态和业务流程，设备服务负责执行开架、闭架、移动列控制和状态回传。

能力	产品说明
固定列 / 移动列	维护密集架的固定列、移动列和列号关系
架体结构	维护区、列、左侧 / 右侧、节、层、格等空间结构
库位映射	将档案、档案盒或档案袋绑定到具体库位
上架 / 下架	将待上架档案放入指定库位，或从库位移出
开架 / 闭架联动	在业务操作中触发或提示现场架体动作
状态回传	展示架体在线、移动、异常、占用等状态
盘点联动	结合库位清单、设备状态或 RFID 结果完成盘点

结构 / 统计	说明
固定列位置	支持左侧、右侧、中间等固定列位置口径
列号范围	描述一个库区内密集架可用列号
业务列号 / 设备列号	用户看到的列号和硬件通信使用的列号可能不同
左右侧节层格	左侧和右侧可分别配置节数、层数、格数
左右侧在库数	按左右侧统计在库档案数量
左右侧借阅数	按左右侧统计借阅相关档案数量
通道距离	可展示当前通道距离百分比
AI / 异物状态	可展示分析中、空闲、资源不足、平台离线、无异物、有物、有人有物等状态

密集架接入类型

接入类型	当前实现口径	协议	对接文档 / 资料
FD-01	方德密集架	TCP Client / USB Serial	FD-01 协议文档，网盘：固定列与计算机间通讯协议 V5
FD-02	北泰 / TLU6820 系列	HTTP	网盘：密集架远程对接接口 V1.9、密集架远程控制实例
FD-03	天骄固定列 WebApi	HTTP	网盘：密集架固定列 WebApi 通信协议 v3.1.1
FD-04	云档密集架	HTTP	网盘：云档 Apifox 导出
FD-05	华升 / 高频密集架	HTTP	网盘：高频密集架管理系统对接接口说明书 V1.4、智能密集架控制系统对接接口说明书 V1.3、华升密集架.rar
FD-06	飞度密集架	HTTP / WS	网盘：飞度密集架 Apifox 导出，以 fit-denserack、smart-doc-vault 中的 FD-06 实现和现场镜像为准

网盘目录：开发 / 对接文档。

接入类型	现场识别特征	代码入口
FD-01	固定列协议，走串口服务器或 USB 串口；库区配置里 accessMode 常见为 串口服务器 或 USB串口	smart-doc-vault/pkg/mjj/fd01_mjj.go、service/system/mjj.go
FD-02	HTTP 路径为 /IntelligentCabinetAPIServer/...，常见接口有 OpenCol、ReportStatus、ReportInfo，文档默认端口为 16000	smart-doc-vault/pkg/mjj/fd02_mjj.go、service/system/mjj_fd02.go
FD-03	HTTP 路径为 /MjjWebApi/...，请求头 token 由开发识别码、用户名、密码 Base64 生成；库区配置会额外维护授权码、用户名、密码	smart-doc-vault/pkg/mjj/fd03_mjj.go
FD-04	HTTP 固定请求 /MjjWebApi，动作放在 JSON 字段 Op，例如 GetConfig、getShelfStatus、OpenShelf、CloseShelf	smart-doc-vault/pkg/mjj/fd04_mjj.go
FD-05	HTTP 路径为 /denseshelf/...，返回字段常见 resultcode、resultdata，按 zone 区号操作	smart-doc-vault/pkg/mjj/fd05_mjj.go
FD-06	飞度自研密集架，平台侧维护 FD06AuthCode，支持 WebSocket 绑定和 /mjj/fd06proxy/... HTTP 代理	smart-doc-vault/pkg/mjj/fd06_mjj.go、mjjs/mjj_fd06.go、service/system/mjj_ws.go

当前代码实现中，FD-03 是天骄固定列 WebApi，FD-04 是云档密集架；历史资料里如果出现相反写法，以代码实现和现场接口路径为准。

回转柜

回转柜也是库区中的智能架具，更适合按“档案直接落格口”理解。它和密集架一样归入库区管理，但现场动作、通信协议和控制程序通常会单独实现。

RFID 在这里可以理解为“给档案或装具一个可被无线读取的身份”。档案绑定 RFID 标签后，读写器可以在取档、归档、盘点时读取标签号，再和系统中的档案、格口、库位关系进行比对。回转柜场景下，RFID 通常不直接决定业务状态，而是作为辅助识别手段，用来确认“拿到的是不是这份档案”“归回的是不是这个格口”“盘点结果和系统记录是否一致”。

能力	产品说明
柜体管理	维护回转柜设备和所属库区
格口 / 库位	将柜体内部空间映射成可绑定档案的位置
取档	根据档案位置找到对应柜体和格口，辅助现场取档
归档	将归还档案重新绑定到柜体库位
状态同步	展示柜体在线、故障、占用或执行状态
项目定制	不同项目的柜体型号、库位规则和操作流程可能不同

统计项	产品说明
全部档案	柜内系统记录的总档案数，不论状态
在库档案	柜内实际可视为在库的档案，包含在库和借阅未取
在借档案	借阅流程中的档案，包含借阅中和在借未取
不在库档案	系统记录在柜内，但盘点不到或未按借阅流程出库的档案
剩余格口	回转柜总格口数减去已占用档案数

回转柜档案状态

回转柜有一套特殊的档案展示状态。普通密集架主要看 ArchiveModel.Status，而回转柜档案会优先结合最新盘点结果 InventoryResultModel.NewBorrowStatus 展示状态；同时用盘点结果判断 HzgStatus，结果为“正常 / 盘盈”时视为在位，其他结果通常视为不在位。

回转柜展示状态	形成口径	产品含义
待上架	业务状态仍是待上架	档案还没有完成格口确认
在库	档案状态、借阅关系和盘点结果一致，或归还后已盘到原格口	柜内可视为正常在位
未在库	系统认为应在库，但盘点未识别到对应 RFID	需要人工确认是漏读、错放、取走未登记还是遗失
借阅审批	档案在库，存在待审批借阅申请	审批未完成，现场不应直接取走
借阅待取	审批通过，等待现场取档	柜内仍可能在位，表示审批通过但尚未取走
借阅	档案处于借阅流程，且盘点关系支持当前状态	业务上已进入借阅状态
借阅未取	档案业务状态是借阅，但回转柜盘点仍显示在位	常见于系统已登记借出、现场尚未取走或状态未同步
归还待上架	档案已归还，但盘点或位置尚未确认	需要完成归还上架或重新确认格口
借阅超期	借阅超过期限	借阅流程异常状态，仍需结合在位 / 不在位判断现场处理

这组状态不应直接套到密集架或普通档案盒上。回转柜状态更像“业务状态 + 借阅审批状态 + RFID 盘点结果”的合成展示，用来指导现场开柜、取档、归还和异常处理。

回转柜不要默认套用档案盒上架逻辑。具体 TCP 服务、控制命令和厂商差异放到系统架构或设备调试文档。

回转柜接入类型

接入类型	厂商	协议	对接文档
FD-01	中芯回转柜	TCP server	网盘：回转柜通讯协议、回转柜补充，调试：网络协议调试地址

调试协议侧已有旧文档记录：

标识	说明
hzg	回转柜，TCP server
mjj	密集架，TCP Client / USB，其中 USB 已弃用
udp	设备调试，UDP
mqtt	设备通信，MQTT

档案

档案是一切业务流转的核心对象。它既包含标准著录信息，也需要承接项目差异字段，并且要在生命周期中持续变化。

档案主数据

字段方向	产品说明
基础信息	档案名称、档案编号、备注、维护人、创建时间
分类信息	目录位置、分类路径、年度、类别、全宗或项目定义的分类字段
保管属性	保密等级、有效期、保管期限、责任部门
实体位置	库房、库区、架体、柜体、层级位置
装具关系	档案可以归属到档案盒、档案袋等装具
电子档案	物理档案可以挂接电子档案文件
RFID	档案可绑定 RFID 标签，用于盘点和状态判断
审批关系	档案可关联借阅审批
回转柜盘点关系	档案可关联最新回转柜盘点结果，展示在位 / 不在位

类型	当前口径
保密等级	公开、内部、秘密、机密、绝密
有效期	永久、三年、五年、十年、十五年、二十年、二十五年、三十年

当前前端“新建档案”不是单一表单，而是先选择档案类型，再决定是否直接入库或进入待上架队列。

前端档案类型	代码值	产品含义
独立成盒	A	不需要记录装具内部细分档案信息，按单份档案选择位置或进入待上架
存入现有盒	B	将档案信息存入一个已有档案装具内，不单独选择上架模式
多册组卷	C	创建新的档案装具并记录其中档案信息，后续按装具位置处理

上架模式	代码值	产品含义
直接入库	A	直接选择档案位置或档案装具位置，创建后自动完成上架
暂不分配位置	B	先选择大致库房位置，创建后进入“新档上架”等待分配明确库位

本地静态词典里还保留了“档案载体类型”和“档案门类”的基础口径：载体类型包括纸质档案、电子档案、照片档案、音视频档案；档案门类包括文书档案、科技档案、会计档案、声像档案。项目落地时可以扩展字段，但这些名称应优先作为检索和导入导出的稳定口径。

这些字段是查询、权限、借阅审批和档案移交销毁判断的基础，不建议只作为普通备注字段维护。

档案分类

档案分类用于替代传统“卷宗”在系统里的组织作用。传统卷宗更像一组纸质材料的业务集合，但在智档宝里，分类应当承担“怎么归类、怎么检索、怎么授权、怎么统计”的职责；实体承载关系交给档案装具处理。

概念	当前口径
档案分类	档案的业务归属和目录层级，用来组织档案、设置查询条件、统计范围和权限范围
卷宗	作为传统业务说法保留理解，不建议在新模型里作为独立核心对象扩展
档案装具	档案盒、袋、夹等实体承载对象，解决“档案放在哪个盒子里”
库区位置	库房、库区、架体、层格等空间位置，解决“档案或装具放在哪里”

分类可以按客户业务定义成多级树，例如“年度 / 门类 / 保管期限 / 项目 / 部门”。同一份档案只要分类路径清楚，就可以被查询、导入、导出、授权和统计；是否装入某个档案盒，不应该改变它的分类含义。

前端实现上，档案分类对应的是 /dir/* 目录树接口，而不是一个叫“卷宗”的独立模型。系统支持维护根分类名称、加载子目录、新增、编辑、删除和批量排序。

能力	接口口径
分类树	/dir/getDirs、/dir/getDirChildren
新增 / 编辑 / 删除	/dir/addDir、/dir/editDir、/dir/deleteDir
排序	/dir/batchSort
根分类名称	/setting/getRootDirName、/setting/setRootDirName

档案分类
├─ 文书档案
│  ├─ 永久
│  └─ 定期
├─ 项目档案
│  ├─ 项目 A
│  └─ 项目 B
└─ 会计档案

维护分类时要避免把“分类”和“装具”混用：分类是逻辑目录，装具是实体载体。一个分类下可以有很多档案，这些档案可以分布在多个档案盒中；一个档案盒也可能承载同一分类下的一批档案。

自定义字段

自定义字段用于承接不同项目、不同客户、不同档案类型的著录差异。它的目标是让项目可以扩展字段，而不是为了每个客户反复修改档案主数据。

字段类型	说明
档案扩展字段	补充档案主数据之外的项目著录项，例如合同编号、业务系统编号、责任人、所属项目等
字段展示	在档案详情、列表、查询条件中按项目需要展示
导入导出	导入模板、导出表格、批量维护时需要保持字段含义一致
项目差异	不同客户项目可以维护不同字段，但同一项目内字段命名要稳定

历史方案演进

自定义字段在智档宝里不是一次成型的能力，历史上大致经历了“JSON 扩展字段”到“字段定义 + EAV 值表 + 表头配置”的演进。

阶段	方案	解决的问题	局限
早期方案	在档案或装具主数据里保存 JSON 格式扩展字段	不改数据库表结构就能承接项目著录差异，适合快速交付	查询、筛选、导入校验、字段重命名和统计都比较重，跨数据库兼容也不好控制
过渡方案	保留前端 extends 结构，字段用 id-字段ID 作为动态列标识	前端列表、详情、导入导出可以用统一方式处理标准字段和扩展字段	值如果只靠 JSON 保存，精确筛选和全文搜索仍然依赖额外解析
当前主线	字段定义表 + EAV 值表 + 每用户表头配置	字段可配置，值可按字段 ID 查询和筛选，列表列宽、排序、显隐可按用户保存	字段数量过多时查询会变复杂，需要控制字段治理和索引策略

当前实现里，档案和档案装具各自有一套扩展字段体系：档案使用 sys_archive_extend、sys_archive_extend_value、sys_archive_field；装具使用 sys_box_extend、sys_box_extend_value、sys_box_field。字段类型目前以 text、date、select 为主，select 字段需要维护可选值，必填字段会在建档或建装具时校验。

当前能力	档案接口 / 表	装具接口 / 表	说明
字段定义	/archive/addArchiveExt、/archive/editArchiveExt、/archive/deleteArchiveExt、sys_archive_extend	/box/addBoxExt、/box/editBoxExt、/box/deleteBoxExt、sys_box_extend	维护字段名称、类型、选项、必填和备注
字段值	sys_archive_extend_value	sys_box_extend_value	按对象 ID + 字段 ID 保存值，字段名冗余保存用于减少关联成本
表头配置	/archive/getArchiveSysExtList、/archive/setArchiveField、/archive/setArchiveFieldWidth、sys_archive_field	/box/getBoxExtSysList、/box/setBoxField、/box/setBoxFieldWidth、sys_box_field	支持列表列显隐、排序、列宽和动态字段列
查询筛选	id-字段ID 进入字段过滤，EAV 子查询匹配	id-字段ID 进入字段过滤，EAV 子查询匹配	前端动态列的 dataIndex 形如 id-12
导入导出	archive_excel.go	box_excel.go	导入模板和导出清单会读取扩展字段定义

因此，文档里说“自定义字段”时要区分三个层面：字段定义决定能填什么，字段值记录每个档案或装具填了什么，表头配置决定某个用户在列表里怎么看。不要把扩展字段直接理解成“在主表里临时加一列”。

维护原则：

• 标准字段用于所有项目都稳定存在的内容，例如档案编号、名称、状态、密级、位置。
• 自定义字段用于项目差异和客户著录差异，例如额外编号、业务分类、备注字段。
• 自定义字段应进入查询、导入、导出和详情展示，但不应直接替代生命周期状态、库位、借阅审批等核心字段。
• 字段名称、字段类型和导入导出口径需要稳定维护，避免同一含义在不同项目中出现多个名字。

导入导出

导入导出是档案管理的批量交付入口。它不只是“下载 Excel / 上传 Excel”，还承担字段模板、数据校验、错误回填、批量建档、批量建装具和现场核对清单的职责。

能力	档案	档案装具	说明
下载模板	/archive/excelTemplate	/box/excelTemplate	根据基础字段和当前扩展字段生成模板
上传文件	/archive/importExcelUpload	/box/importExcelUpload	上传后校验文件类型、表头和重复导入
开始导入	/archive/importExcelStart	/box/importExcelStart	使用上传返回的 key 执行导入，档案装具导入还会带位置和分类参数
错误文件	/archive/downloadExcelError	/box/downloadExcelError	把验证错误、创建错误写回原 Excel，便于修正后重新提交
导出列表	/archive/exportArchiveList	/box/exportBoxList	支持导出所选、导出本页、导出全部
出库导出	出库档案列表	出库档案装具列表	表头会把删除人、删除原因、删除时间替换成出库人、出库原因、出库时间

当前导入流程分两步：先上传 Excel，后端读取并缓存文件，返回导入 key；再由前端带 key 调用开始导入接口。这样做的好处是可以先做表头校验和重复文件判断，再进入真正的数据校验和批量创建。

下载模板
  ↓
填写 Excel
  ↓
上传文件，得到 key
  ↓
开始导入
  ├─ 成功：生成档案 / 装具并写入日志
  └─ 失败：下载带错误列和批注的 Excel，修正后重新上传

校验点	产品口径
表头校验	档案模板必须包含“档案名称”，装具模板必须包含“档案装具名称”
必填字段	档案名称、档案编号、装具名称、编号、类型，以及自定义字段中标记为必填的字段
编号唯一	档案编号和装具编号不应重复，批量文件内部也要避免重复
下拉字段	保密等级、有效期、装具类型、select 自定义字段需要使用模板提供的可选值
时间字段	支持常见日期时间格式，导入错误文件会尽量保留时间列格式
位置和分类	导入时需要明确对象最终归属的库房、库区、位置或分类，不能只靠 Excel 备注描述
并发导入	当前档案导入和装具导入各自有导入锁，同一类导入任务同时只处理一个
重复文件	后端会计算文件 MD5，避免同一文件被重复导入

导出要区分“业务清单”和“数据迁移”。导出所选、本页、全部适合现场核对和交付清单；如果要做系统间迁移，必须确认字段定义、分类树、库区位置和装具关系是否已经在目标系统中存在。不要把导出的列表文件直接当作完整备份。

档案生命周期

档案生命周期描述实体档案从建档、上架、借阅、归还到异常处理和最终销毁的完整状态流转。

建档 / 导入
  ↓
待上架
  ↓
在库
  ├─ 借阅审批中
  │   ↓
  │  借阅待取
  │   ↓
  │  借阅中
  │   ↓
  │  归还待上架
  │   ↓
  │  在库
  ├─ 盘点异常
  │   ├─ 不在库
  │   └─ 遗失
  ├─ 删除 / 回收站
  └─ 已销毁

状态 / 场景	产品说明
待上架	档案已经建档或导入，但还没有落到明确库位
在库	档案已经绑定库位，处于可借阅、可盘点状态
借阅审批中	借阅申请已提交，等待审批
借阅待取	审批通过但档案还未被取走
借阅中	档案已经借出
归还待上架	档案已归还，但还未重新绑定或确认库位
借阅超期	借阅超过期限，需要提醒或处理
不在库	盘点或现场识别发现档案不在预期位置
遗失	经业务确认后的遗失状态
删除 / 回收站	软删除状态，可恢复
已出库	通过出库操作移出当前库内管理，可在“已出库档案”中找回
已销毁	业务上已销毁或停止使用，不再作为正常档案流转

当前前端列表常用状态筛选集中在 待上架、在库、借阅、归还上架。借阅审批、待取档案、在借档案、超期档案更多体现为维护页队列和审批关系，不应简单等同于档案主表的单一状态。回转柜还会额外使用 未在库、借阅未取、归还待上架 等合成展示状态，具体口径见“回转柜档案状态”。

回转柜盘点会影响状态展示。例如回转柜盘点结果为“正常 / 盘盈”时，可以展示为“在位”；否则展示为“不在位”。回转柜盘点结果不应直接替代业务审批流程，但会提示后续处理动作。

借阅与归还

借阅能力由审批流程承载，档案和装具都可能参与借阅。

阶段	产品说明
申请	用户选择档案、装具或电子档案发起借阅
审批	审批人确认是否允许借阅
待取	审批通过，等待现场取档
借阅中	档案已从库位取走，进入借阅周期
归还	借阅完成后归还档案
归还待上架	归还后还需要重新确认库位
超期	超过借阅期限，进入提醒或处理

前端真实流程里，借阅从“借阅车”开始，审批通过后进入待取，现场取档后进入在借，归还后再进入归还上架。

操作入口	接口口径	说明
借阅车	/borrow/list、/borrow/add、/borrow/delete、/borrow/deletes	临时收集要借阅的档案、装具或电子档案
创建借阅	/borrow/create	提交用途、原因、期限、审批人和借阅对象
审批列表 / 详情	/approval/list、/approval/info	查看审批单及其中的档案、装具对象
同意 / 拒绝	/approval/agree、/approval/reject	审批人处理申请
开始取档	/approval/start	审批通过后进入现场取档阶段
归还	/approval/return	借阅完成后登记归还
归还上架	/approval/getArchiveList、/approval/getBoxList、/approval/returnShelf	对已归还对象重新确认库位

借阅状态和回转柜盘点结果会互相影响展示。例如“借阅待取”但回转柜盘点仍在位，可以理解为审批通过但现场未取；“借阅中”但回转柜盘点仍在位，则需要业务处理确认。

维护页面口径

档案维护页本质是一组待办和异常队列，和概览页的对象清单互相补充。

维护入口	产品口径	关键动作
新档上架	创建时选择“暂不分配位置”的档案和装具	计算可用容量、选择明确位置、完成上架
档案回收站	软删除后的档案和装具	恢复、销毁、导出
遗失档案	借阅或盘点后确认遗失的对象	找回、彻底遗失、导出
已出库档案	出库后的档案和装具	找回到原位置或进入新档上架
待取档案	审批通过但尚未取走的对象	查看审批、开始取档或后续流转
在借档案	已借出对象	查看审批、全部归还上架、标记存在遗失
超期档案	借阅超过期限的对象	提醒处理、归还上架、标记遗失
归还上架	已归还但未重新上架的对象	选择上架模式、确认位置、完成归还上架
借阅用户	借阅人和审批相关账号	新增、编辑、启停、修改密码

回转柜盘点

这里的盘点特指回转柜盘点，用于校验系统记录和回转柜内实物是否一致。当前支持定时、手动、自动等盘点类型，结果包含正常、盘盈、盘亏、异常、设备忙、设备离线。

回转柜盘点结果	产品说明
正常	系统记录和现场识别一致
盘盈	现场识别到系统预期外或位置外的档案
盘亏	系统记录应在库，但现场未识别到
异常	盘点过程出现业务或数据异常
设备忙	回转柜设备暂时无法执行盘点
设备离线	设备不可用或通信失败

回转柜盘点结果需要给出处理动作，例如更改档案状态为未在库、档案上架至位置、档案转移至位置、借阅未取、已借阅取走、已归还上架、新建未知档案等。处理动作应由业务人员确认后执行，避免设备误读直接改变档案业务状态。

档案装具

档案装具用于承载和组织实体档案。它既有自己的基础信息和状态，也能绑定位置、参与借阅和盘点。

装具类型	说明
档案盒	最常见的档案载体，可包含多份档案
档案袋	适合零散或特定材料归集
档案夹	适合临时或轻量归档
档案箱	适合批量存放
档案架	可作为普通实体架具记录
防磁柜	适合特殊载体或安全要求更高的材料
光盘 / 磁带	用于电子介质归档

能力	说明
基础信息	装具名称、编号、类型、状态、密级、有效期
自定义字段	承接不同项目对装具的额外著录要求
装具内档案	一个装具可包含多份档案
所在库位	装具可以落到库区、密集架或其他库位中
借阅 / 归还	装具可参与借阅、归还和待上架流程
盘点 / 异常处理	装具可参与盘点、异常定位和差异处理

组卷与拆卷

组卷和拆卷在系统里更适合理解为“档案与装具关系的建立、重建和销毁”，而不是重新发明一个卷宗对象。当前前端的拆卷口径比较强：拆卷时会销毁档案装具，并要求给拆出的档案重新指定位置或待上架范围。

操作	产品含义	系统变化
组卷到新装具	把若干份档案归入新建档案盒、档案袋或档案夹	先创建装具，再调用 /archive/archiveRoll 建立档案与新装具关系
组卷到已有装具	把若干份档案归入已有档案装具	直接调用 /archive/archiveRoll，档案原先在其他装具中时会移入目标装具
拆卷	将一个装具拆开，拆出的档案重新选择位置、库房位置和分类	调用 /box/unRoll；前端提示会销毁档案装具，并记录拆卷原因
位置转移	档案或装具从一个库位转移到另一个库位	调用档案或装具批量转移接口，分类不应变化
整盒上架	装具整体绑定到库位	装具内档案继承或关联该装具位置，现场按盒取放
整盒借阅	借阅对象选择装具	装具和装具内档案都需要进入可追踪的借阅状态

组卷时要先确认档案分类和基础著录已经稳定，再把档案放入装具。前端组卷弹窗会提示：如果所选档案在现有装具中，组卷完成后档案将移入新的装具。拆卷时必须保留操作记录，尤其是借阅中、归还待上架、盘点异常的档案，不能只删除装具关系后就认为业务完成。

上架时既可能直接上架档案，也可能先把档案归入装具，再把装具放到密集架或其他库位中。回转柜当前更适合按档案直接落格口理解，不建议默认把装具逻辑套到回转柜上。

打印

打印在档案管理中主要服务于“实物标识”和“业务单据”。产品上要先明确打印对象、模板字段和触发场景，具体打印服务、本地驱动、RFID 打印机协议等实现细节放到系统架构或设备文档中维护。

打印对象

对象	产品说明
档案标签	给单份档案生成纸质标签、条码、二维码或 RFID 标签内容，用于粘贴、识别和盘点
档案装具标签	给档案盒、档案袋、档案箱等装具生成标签，便于装具上架、借阅和盘点
借阅单	借阅审批通过后输出取档、借出、归还或签收单据
移交 / 上架单	批量建档、移交、上架、归档时输出操作清单
盘点单	盘点任务执行前后输出盘点范围、结果差异和处理记录
查询结果	按查询条件导出或打印档案列表，适合现场核对和人工流转

触发场景

场景	说明
建档后打印	档案建档或导入后打印档案标签
装具生成后打印	新建档案盒、档案袋或档案箱后打印装具标签
上架前打印	上架前打印位置、编号、装具和档案清单，便于现场核对
借阅审批后打印	审批通过后打印借阅单、取档单或签收单
归还处理时打印	归还后打印归还确认单或重新上架清单
盘点前后打印	盘点前打印盘点范围，盘点后打印差异和处理结果

模板和字段

打印模板应围绕业务对象维护，不建议在代码里写死版式。不同项目可以有不同模板，但字段含义要稳定。

模板字段	说明
基础字段	档案编号、档案名称、分类、年度、密级、保管期限
位置字段	库房、库区、架体、列、侧、节、层、格或回转柜格口
装具字段	装具编号、装具名称、装具类型、装具内档案数量
借阅字段	借阅人、部门、审批人、借阅时间、归还期限、用途
标识字段	条码、二维码、RFID 编码、系统唯一编号
项目字段	通过自定义字段补充项目特定著录项

服务演进和仓库

档案管理里的打印能力不是单个接口。它经历过普通标签 / 单据打印、本地打印服务增强，再到 RFID 标签打印的演进。写业务文档时建议按“业务对象”和“本地服务形态”分开描述。

阶段	GitLab 仓库	当前定位	主要说明
老打印服务	fit-archive/electron-hiprint	普通打印和早期标签打印服务	基于 Electron 和 vue-plugin-hiprint，面向本机打印机列表、静默打印、PDF / HTML 打印等基础能力；历史接口以 Socket.IO news 等事件为主
新打印服务	fit-archive/rfid/rfid-printer-node	当前打印服务演进版本	继续兼容普通打印，同时补充服务面板、打印机能力识别、日志、驱动检查、Socket.IO 17521 端口和 /api/printer-list 等能力
RFID 打印衍生	fit-archive/rfid/rfid-printer-node、fit-archive/rfid/fit-archive-ng、fit-archive/rfid/smart-doc-vault-rfid、fit-archive/rfid/rfid-device-go	RFID 标签打印、读写和现场识别链路	前端选择 RFID 打印能力，后端维护档案 / 标签业务关系，本地服务调用 RFID 打印机读 TID、写 EPC 或打印标签；设备服务负责 RFID 读写器和现场设备侧能力

普通打印和 RFID 打印不要混成同一种能力。普通打印解决“把单据或标签版式打出来”，RFID 打印还要处理标签芯片识别、TID / EPC、厂商 SDK、驱动、耗材状态和现场读写验证。

产品边界

• 档案管理负责决定“打印什么、什么时候打印、模板使用哪些业务字段”。
• 老打印服务、新打印服务和 RFID 打印服务都属于实现形态；档案管理页只维护业务对象、触发场景和字段口径。
• RFID 标签写入、RFID 打印机、TID / EPC 和标签协议归入 RFID 或设备接入文档。
• 普通打印机驱动、本地打印服务、electron-hiprint、rfid-printer-node、部署端口等实现放到系统架构或本地服务文档。
• 导出 Excel / PDF 和打印可以共用字段口径，但不要把导出能力直接等同于打印能力。

研发参考

结合当前智档宝代码结构，档案管理的核心模型不是单表档案，而是一组围绕“库区 + 档案 + 装具 + 状态 + 审批 + 盘点”的模型。

产品对象	代码模型 / 模块	产品含义
档案	ArchiveModel / sys_archive	档案主数据，包含编号、名称、状态、密级、有效期、位置、RFID、扩展字段和电子档案挂接
档案装具	BoxModel / sys_box	档案盒、袋、夹、箱等实体载体，可绑定多个档案
库房位置	LocationModel	库房位置树，承载库房、楼层、房间等位置路径
库区	AreaModel	库房下的业务区域，区分智能密集架、回转柜等库区类型
架体 / 柜体	ShelfModel / sys_shelf	密集架列、固定列、移动列、回转柜柜体等实体架具
借阅审批	ApprovalModel / ApprovalConnectModel	借阅、待取、归还、超期、驳回、取消等流程状态
盘点任务	InventoryModel	手动、定时、自动盘点任务
回转柜盘点结果	InventoryResultModel	正常、盘盈、盘亏、异常、设备忙、设备离线等回转柜盘点明细

前端主要入口集中在 fit-archive-ng/src/views/ArchivesManagement，接口层集中在 fit-archive-ng/src/api/ArchivesManagement、ApiBorrowManagement、ApiSystemManagement/apiArchivesSort、ApiReservoirManagement 等目录。后端路由侧主要在 smart-doc-vault/router/system/archive.go、box.go、borrow.go、approval.go、shelf.go、location.go、mjj.go、hzg.go。

前端模块	主要接口	说明
overview/File	/archive/getArchiveList、/archive/addArchive、/archive/editArchive、/archive/archiveRoll、/archive/batchTransferArchive、/archive/exportArchiveList	档案概览、新建、编辑、组卷、转移、导出和暂存
overview/FileBox	/box/getBoxList、/box/addBox、/box/editBox、/box/unRoll、/box/batchTransferBox、/box/exportBoxList	档案装具概览、新建、编辑、拆卷、转移、导出和暂存
maintain/PutOnShelves	/maintain/putOnShelves/getArchiveList、/archive/newArchiveShelf、/maintain/putOnShelves/getBoxList、/box/newBoxShelf	新档上架，分档案和装具
maintain/RecycleBin	/maintain/deleteArchiveList、/archive/recoverArchive、/archive/batchDestroyArchive、/maintain/deleteBoxList、/box/recoverBox、/box/batchDestroyBox	回收站恢复和销毁
ApiBorrowManagement	/borrow/create、/approval/list、/approval/info、/approval/agree、/approval/reject、/approval/start、/approval/return、/approval/returnShelf	借阅申请、审批、取档、归还和归还上架
ApiSystemManagement/apiArchivesSort	/dir/getDirs、/dir/getDirChildren、/dir/addDir、/dir/editDir、/dir/deleteDir、/dir/batchSort	档案分类目录树

关联仓库

仓库 / 目录	视角	说明
fit-archive/fdmjj	密集架主线	飞度密集架相关前后端、设备联动和项目交付能力索引
fit-archive/hzg	回转柜主线	回转柜相关业务、库位映射和现场控制能力索引
fit-archive/A	项目版本线	架具能力在项目版本中的定制入口
fit-archive/B	项目版本线	架具能力在项目版本中的定制入口
fit-archive-ng	当前前端业务系统	档案总览、维护、上架、借阅审批、设备管理等页面入口
smart-doc-vault	后端主服务	档案、装具、审批、盘点、库房、架体、密集架、回转柜等 API 和业务服务
fit-denserack*	密集架终端 / 控制	密集架本地终端、开架接口、硬件控制和项目更新能力

产品边界

• 档案管理关注库区、档案、装具、生命周期、借阅、盘点和权限。
• 自定义字段只承接项目著录差异，不替代生命周期、库位、借阅审批等核心字段。
• 文件上传、文件解析、文件预览和全文搜索归入数字化。
• RFID 标签识别、门口机、手持机、盘点车归入 RFID。
• 温湿度、空调、除湿、漏水、摄像头、门禁等现场环境能力归入环境控制。
• 密集架 / 回转柜在档案管理中只描述架具、库位、状态和业务联动。
• 设备协议、服务进程、TCP / UDP / MQTT、数据库、对象存储等实现细节放到系统架构或设备接入文档。