Vali15189

NGS 分析性能评价报告生成工具 —— 面向分子诊断实验室，依据 ISO 15189:2022 / CAP / CNAS-GL039 标准，生成分析方法学性能评价（确认/验证）报告。

技术栈

• Next.js 16 (App Router)
• React 19 + TypeScript 5.7
• shadcn/ui (Radix UI + Tailwind)
• Tailwind CSS 4
• Recharts (Probit 曲线图)
• React Context (状态管理)
• sonner (Toast 通知)

功能

• 8 个评价模块，完整覆盖 ISO 15189 方法学验证要求：
  1. 检测系统概述 — 测序仪、试剂盒、生信流程、标本类型
  2. 实验质控 — 文库制备 QC 指标，可配置阈值
  3. 数据质控 — 测序数据 QC 指标（比对率、深度、覆盖度等）
  4. 符合率评价 — 参考方法 vs 检测方法比对，自动统计 TPR/TNR/PPV/NPV
  5. 精密度评价 — 5 天 × 3 重复方案，批内/批间 CV 自动计算
  6. 检出限评价 — 梯度稀释法 + Probit 分析，LOD95 线性插值估算
  7. 分析特异性 — 交叉反应 + 干扰实验，分类统计
  8. 可报告范围 — 变异类型覆盖、检测限、局限性定义
• Excel 粘贴支持：所有表格均支持从 Excel 复制 TSV 数据后 Ctrl+V 填入
• 实时进度追踪、JSON 导入/导出、报告预览与打印

本地运行

pnpm install
pnpm dev        # http://localhost:3000
pnpm build      # 生产构建

目录结构

├── app/
│   ├── page.tsx              # 主页面布局（Sidebar + 模块区域 + 报告预览）
│   ├── layout.tsx            # 根布局（元数据、字体、Toaster）
│   └── globals.css           # Tailwind 全局样式
├── components/
│   ├── modules/              # 8 个评价模块组件
│   │   ├── overview-module.tsx
│   │   ├── qc-module.tsx           # 实验质控 & 数据质控（复用）
│   │   ├── accuracy-module.tsx
│   │   ├── precision-module.tsx
│   │   ├── lod-module.tsx
│   │   ├── specificity-module.tsx
│   │   └── reportable-range-module.tsx
│   ├── ui/                   # shadcn/ui 组件（按需引入）
│   ├── sidebar.tsx           # 侧边栏导航
│   ├── module-header.tsx     # 模块标题栏（状态徽章 + 标记完成按钮）
│   └── report-preview.tsx    # 报告预览对话框
├── lib/
│   ├── types.ts              # 核心类型定义 & 默认数据
│   ├── report-context.tsx    # 报告数据 Context + 导入导出
│   ├── preview-context.tsx   # 预览对话框状态
│   └── utils.ts              # cn() 工具函数
└── public/
    └── sample-data.json      # 示例数据，可直接导入体验

数据流

• 所有报告数据存储在 ReportContext 中（React Context + useState）
• 每个模块通过 useReport() hook 读写数据
• JSON 导入/导出使用 exportJSON() / importJSON() 方法
• 报告预览通过 PreviewContext 控制 Dialog 显示
• 无外部数据库依赖，纯前端应用