JKTAC

项目简介

上海建科检验检测 - 浦东国际机场四期扩建工程第三方检测 LIMS 系统

说明

上海建科 · 机场四期工程检测 LIMS 系统

面向上海建科检验检测认证有限公司在浦东国际机场四期扩建工程中的第三方工程检测业务，构建一套生产级实验室信息管理系统（LIMS），覆盖材料/岩土/场道三大业务板块，满足 CMA / CNAS 与民航机场工程档案双重合规要求。

技术栈

层次	技术
Monorepo	pnpm workspaces
后端	NestJS 10 + TypeScript + Prisma + PostgreSQL
前端	React 18 + Vite + Ant Design 5 + Zustand + React Query
缓存/队列	Redis 7 + BullMQ（仪器采集、异步任务）
对象存储	MinIO（S3 兼容），支持本地文件系统降级
PDF/签章	pdf-lib + qrcode + 自研 `@lims/ca`（软证书签章，可扩展真实 CA/UKey）
容器化	Docker + docker-compose（postgres / redis / minio / api / web / worker / nginx）

代码结构

已交付模块

核心业务：客户/工程、委托受理（受理/退回/下达）、样品（登记/接收/留样/处置）、任务派发、结构化原始记录、报告三级审核（检测→审核→批准）与签发、更正单。 质量体系：设备台账/校准/期间核查/使用记录、耗材与标准物质出入库、质控计划/批次/质控图、人员上岗证资质卡控、受控文件版本与查新、不符合工作、客户投诉。 检测能力：模板版本化判定引擎（数值修约、安全公式求值、多条件判定、结论生成），内置 13 个真实检测模板（混凝土抗压/抗折、钢筋拉伸、水泥胶砂、颗粒级配、击实/压实度、平板载荷、马歇尔、铺砂构造深度等）。 集成自动化：条码标签与扫码、仪器采集（CSV/TCP/串口占位驱动 + Worker）、报告/记录 PDF 生成、CA 软签章验签、建设方/监理平台出站推送与入站 webhook（HMAC）、工程档案组卷导出。 系统与交付：组织/用户/角色/权限（RBAC）、数据字典、业务编号、审计日志、真实统计看板、历史数据导入、安全加固、Swagger 接口文档。

环境要求

Node.js >= 20
pnpm >= 9
Docker & Docker Compose（一键启动依赖与整体环境）

快速开始

1. 初始化

2. 启动依赖服务

3. 迁移与种子

4. 本地开发

5. Docker 一键启动全部服务

前端：http://localhost/
API：http://localhost/api，Swagger：http://localhost/api/docs
MinIO 控制台：http://localhost:9001

默认账号

用户名	密码	角色
admin	admin123	超级管理员（首次登录后请立即修改为强口令）

文档

架构说明
CMA/CNAS 条款—功能映射
等保与安全加固清单
部署运维手册
用户操作手册
数据导入模板：docs/import-template/
变更记录：CHANGELOG.md

编码规范

单函数有效行（除空行/注释）不超过 40 行
单文件有效行不超过 800 行
每个文件、每个对外函数均含中文注释

机场四期 LIMS 系统