
物联网 · 智慧图书馆 · 信创适配 · 盛世宏博

图书馆古籍特藏库房、民国文献库、地方文献库房对温湿度环境的连续性、可追溯性有着严苛要求,温湿度记录是馆藏文献预防性保护的核心档案材料,也是文旅主管部门巡检、古籍保护评估、合规审计的必备资料。传统温湿度记录系统大多基于国外数据库、Windows平台开发,数据存储组件、报表引擎、对外接口存在强依赖,在信创改造项目中,往往出现服务无法启动、驱动缺失、报表导出异常、接口协议不兼容等问题。 很多图书馆在信创落地阶段容易遇到几类典型开发痛点:一是原有MySQL、SQL Server等数据库迁移至国产数据库后,SQL语法不兼容、分页函数、时间函数报错,历史时序数据迁移失败;二是报表组件依赖国外商业报表引擎,在银河麒麟、统信UOS服务器上无法正常渲染,导出PDF、Excel乱码;三是对外接口基于Windows专属组件开发,跨平台兼容性差,无法和图书馆信创OA、信创资产管理系统、业务中台对接;四是时序数据存储没有做分层设计,长期运行后单表数据量膨胀,查询曲线、历史报表时响应缓慢,同时缺少数据备份、防篡改机制,无法满足审计要求。 本项目围绕图书馆温湿度记录系统开展信创适配开发,目标是完成全栈国产化底座适配,设计适配国产时序数据库+关系型数据库的混合存储架构,开发标准化RESTful报表接口,实现温湿度原始数据、统计报表、告警记录的存储、查询、导出、对外推送能力,保证系统在鲲鹏、飞腾、海光、龙芯架构服务器,银河麒麟、统信UOS服务器操作系统上稳定运行,所有存储逻辑、接口服务、报表引擎不依赖境外闭源组件,同时满足古籍保护档案留存、等保2.0、商用密码应用的合规要求。
硬件CPU架构:鲲鹏920、飞腾2000/4、海光3/5系、龙芯3A5000/3C5000; 服务器操作系统:银河麒麟V10服务器版、统信UOS服务器20专业版; 数据库选型:国产时序数据库(存储高频温湿度采集数据)+国产关系型数据库(达梦、人大金仓、南大通用,存储点位台账、权限、告警、报表任务、审计日志); 中间件:国产应用服务器、国产消息队列,避免Tomcat以外的闭源国外中间件,优先适配国产容器底座; 客户端:国产浏览器(麒麟浏览器、奇安信可信浏览器),前端不依赖ActiveX、Flash等国外插件。
图书馆温湿度数据分为两类,一类是高频时序采集数据,数据量大、写入密集、查询以时间范围检索为主;另一类是结构化业务数据,点位信息、设备台账、用户权限、告警记录、报表任务、审计日志,数据量小、更新频次低,适合关系型数据库存储。采用“国产时序库+国产关系库”分离存储,是信创场景下兼顾性能和业务能力的最优方案。
时序库承担所有传感器原始温湿度、露点、空气质量参数写入,核心字段包含设备编号、点位ID、采集时间戳、温度、相对湿度、露点、TVOC、PM2.5、电池电压、信号强度、设备状态。 分区策略按照时间维度自动分区,按天分区,分区自动滚动,超过归档阈值的分区自动转为冷数据,冷数据可以离线归档至国产分布式存储。分区设计可以避免单分区数据过大,在国产CPU算力条件下,保障跨月、跨季度曲线查询速度。 写入策略:网关批量上报,批量写入,减少数据库连接次数;开启写入预写日志,断电不丢数据;设置数据TTL,原始数据到期自动冷归档,不直接删除,归档包带哈希值,便于校验完整性。 时序索引:以点位ID+时间作为联合索引,绝大多数查询场景都是“指定点位+起止时间”,索引命中效率最高。不建立过多冗余索引,避免高并发写入场景拖慢入库速度。
关系库承担业务主数据,核心数据表:点位配置表、设备台账表、用户权限表、告警记录表、报表任务表、接口访问审计表、数据变更日志表。 适配开发重点处理国产数据库语法差异:达梦、人大金仓、南大通用在分页语法、时间函数、字符串函数、自增主键、序列上和MySQL、SQL Server存在差异,开发阶段统一封装数据库适配层,抽象通用DAO接口,底层实现根据数据库类型动态加载驱动,上层业务代码完全不需要修改SQL。 时间字段统一使用标准timestamp类型,避免数据库自带的特殊时间函数,封装统一时间工具类,统一时间格式化、时区转换逻辑,全部采用UTC+8北京时间,规避不同数据库时区处理逻辑不一致导致报表时间错乱。 审计日志表设计为只读表,业务代码禁止直接执行DELETE、UPDATE语句,任何对原始数据的修正、补录,都新增一条修正记录,同时记录操作人、操作时间、原始值、修正值、操作IP,形成完整可追溯的变更链路,满足档案审计要求。
存量项目存在历史温湿度记录,需要从旧数据库迁移至国产信创数据库。迁移流程分为:数据全量导出、数据清洗、格式标准化、分批次导入、校验比对、增量同步。 迁移校验逻辑:按点位、按天统计总条数、温度最大值最小值、湿度最大值最小值,迁移前后比对统计值,校验数据完整性;迁移完成后自动生成迁移校验报告,作为项目交付文档。迁移过程中业务系统不停服,采用增量同步模式,先同步历史存量,再同步实时增量,切换后关停旧库写入。
自动备份分为三级:实时WAL日志备份、每日全量备份、月度归档包异地备份。备份文件生成MD5哈希值,备份系统运行在信创服务器上,备份文件存储在国产分布式存储。支持一键恢复,恢复后自动校验数据哈希,防止备份文件损坏。
报表是图书馆温湿度记录系统的核心输出载体,也是信创改造中最容易踩坑的模块。很多商用报表组件在信创环境缺少适配包,或者依赖Windows字体、专有渲染组件,导出PDF出现方框乱码、排版错乱。本方案采用开源报表引擎自研适配,不依赖国外商业报表中间件。
报表内置图书馆档案标准表头:库房名称、点位位置、传感器编号、校准证书编号、统计周期、生成时间、操作人员。报表样式固定,符合古籍保护档案归档格式,无需每次手动调整。
PDF导出乱码的根源是信创服务器缺少中文字体,开发阶段预装国产开源中文字体,报表引擎强制指定字体,代码层面硬编码字体名称,不使用系统默认字体。Excel导出采用标准OpenXML格式,不使用Windows专属组件,跨平台兼容性更好。 报表渲染逻辑拆分为数据查询层、数据组装层、模板渲染层。模板文件采用JSON模板,不使用二进制模板文件,方便版本管理,适配容器化部署。报表任务支持异步生成,大跨度(跨年度)报表提交任务后台生成,生成完成后保存文件记录,前端轮询下载,避免长时间查询导致接口超时。
月度、年度报表计算量大,每次请求实时统计会占用大量数据库算力。增加报表缓存层,缓存计算结果,缓存key为点位+时段+报表类型;缓存设置过期时间,当该时段内有新数据写入或者数据修正记录时,自动失效缓存,重新计算。缓存组件选用国产适配的Redis分支,适配鲲鹏、飞腾架构。
接口是温湿度系统和图书馆信创中台、OA、档案管理系统对接的核心通道,全部采用RESTful风格,JSON格式交互,统一接口规范,适配信创体系下的服务调用。
接口不使用简单固定密码鉴权,采用Token签名机制,Token有效期可配置,每次请求携带签名,签名算法支持SM2国密算法,适配商用密码评估要求。 请求头固定字段:appId、timestamp、sign、token。服务端校验时间戳防重放攻击,校验签名防止参数篡改。接口访问日志全部入库,记录调用方appId、调用时间、IP、接口地址、参数、返回状态,日志不可删除,用于审计追溯。 接口限流:针对每个第三方应用设置QPS上限,防止高频查询冲击数据库,保护温湿度采集主链路。
{
"code": 200,
"msg": "success",
"data": {
"pointId": "K-001-01",
"pointName": "古籍库房1-密集架上层",
"startTime": "2026-11-01 00:00:00",
"endTime": "2026-11-02 00:00:00",
"tempMax": 19.6,
"tempMin": 16.2,
"tempAvg": 17.8,
"humMax": 57.2,
"humMin": 51.3,
"humAvg": 54.1,
"overTime": 0
}
}接口增加版本号,例如/api/v1/report,后续迭代新增字段、新增能力时发布v2版本,保证原有对接的信创业务系统不需要修改代码,兼容存量第三方对接应用,避免接口升级导致业务系统对接失败。
为了避免后续更换数据库、更换中间件时大量修改代码,项目采用分层解耦架构,自上而下分为:接口层、业务服务层、数据适配层、存储驱动层。 接口层:接收HTTP请求,参数校验、签名鉴权、限流,不写业务逻辑; 业务服务层:报表计算、统计逻辑、任务调度、参数校验,完全不依赖具体数据库; 数据适配层:抽象统一查询接口,封装时序库、关系库查询方法; 存储驱动层:不同国产数据库独立驱动实现,达梦驱动、人大金仓驱动、时序库驱动,驱动层独立包管理。 这种架构的优势在于,当后续项目更换国产数据库型号,只需要新增驱动实现,上层业务、报表、接口代码无需改动,适配复用性强。 定时任务模块适配国产容器、国产操作系统,使用轻量调度框架,不依赖Windows计划任务,定时自动生成日报、月报,推送到指定文件目录,支持自动推送报表到图书馆信创OA消息。
适配测试分为功能测试、性能测试、兼容性测试、安全测试四个维度,所有测试在目标信创硬件+操作系统环境执行,不使用x86 Windows环境模拟。
交付包包含:部署手册、数据库建表脚本、接口API文档、报表模板说明、迁移工具、适配测试报告、运维排查手册。接口文档提供OpenAPI标准格式,方便图书馆开发人员对接信创中台。运维侧提供监控面板,监控数据库连接数、写入延迟、报表任务队列、接口调用成功率,异常自动告警。
本方案面向图书馆温湿度记录系统信创适配开发,同样可以迁移至档案馆、文博库房环境监控项目。方案聚焦存储、报表、接口模块,不包含前端3D可视化、设备采集网关驱动,可和原有边缘网关、3D可视化平台无缝对接。方案支持容器化部署,适配国产云平台、国产虚拟化平台。
关键词:信创、国产化、图书馆温湿度记录、时序数据库、国产数据库、报表接口开发、数据存储、防篡改、RESTful接口、国密适配、档案审计
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。