CSV · 엑셀 · 폴더 입력
CSV 여러 개, 시트당 테이블 하나인 엑셀 한 파일, 또는 파일이 든 폴더를 끌어다 놓습니다. EUC-KR 은 자동 변환하고 엑셀 날짜 셀은 YYYY-MM-DD 로 바꿉니다.
Windows · macOS · 오프라인 · Apache-2.0
코호트 데이터,
병원 안에서 먼저 검증합니다.
폐암·유방암·대장암·대사이상지방간·당뇨병·림프종 6개 K-AI 코호트의 테이블 파일(질환 본표와 OMOP 형식 공통 표)을 넣고 실행하면, 명세 적합성·완전성·타당성 규칙 389개를 검사해 보고서와 중앙 제출용 집계를 만듭니다. 병원 DB 에 접속하지 않고 네트워크 통신도 없습니다.
✓ CSV(UTF-8·EUC-KR) · 엑셀 · 폴더
✓ 환자 단위 정보는 밖으로 나가지 않음
✓ 코드 서명 · 공증
Quality Validator
K-AI 코호트 데이터 품질검증
▶ 검증 실행
▤ 결과 보고서
⌕ 오류 현황 조회
⌂ 대시보드
▥ 통계 모니터링
☰ 검증 규칙 관리
v3 · 규칙 389개 · 코호트 6개
v0.3.0
v0.3.0
검증 실행 · 폐암 (LUNG_CANCER)
1코호트와 파일
2대응 · 사전 점검
3검증 실행
4결과와 출력물
389규칙
구조 규칙 367개는 명세에서 자동 생성, 교차 테이블 SQL 규칙 22개는 임상 논리로 작성. 코호트마다 247~287개가 적용됩니다.
6코호트
질환 본표 하나와 OMOP 형식 공통 표로 표 17개, 169개 필드 명세(v3). 서식 변환 없이 병원이 표를 직접 채웁니다.
0네트워크
DB 접속 없음, 통신 없음. 중앙에 보내는 것은 환자 정보가 없는 집계 파일 하나.
기능
파일을 넣고, 실행하고,
고칠 곳을 바로 찾습니다.
병원 담당자가 DB 권한 없이 내보낸 파일만으로 제출 전 자가 점검을 마칠 수 있도록 만들었습니다.
테이블 자동 대응
파일·시트 이름이 테이블 이름과 달라도 이름 포함 여부와 헤더 유사도(명세 컬럼 60% 이상)로 대응하고, 틀리면 대응표에서 직접 고릅니다.
실행 전 사전 점검
기본키·person_id 누락은 오류로 실행을 막고, 명세와 다른 컬럼과 날짜 형식 표본은 주의로 알려 줍니다. 실행 후에 헤매지 않도록 먼저 잡습니다.
Kahn 세 축 규칙 389개
적합성(형식·코드·관계), 완전성(필수값·기준일), 타당성(범위·논리)으로 분류합니다. 구조 규칙은 명세에서 자동 생성되고, 교차 테이블 규칙은 DuckDB SQL 로 실행됩니다. 이전 판 v2·v1 은 설정에서 고를 수 있습니다.
임상 논리 교차 검증
사망 이후 이벤트, 이벤트-방문 환자 일치, 약물 종료일 계산, 항종양제 투여의 sact_id 필수, 항암요법 기간과 line 번호, AJCC 판수와 병기, ICD-O-3 코드와 조직형, DLBCL 의 cell_of_origin 처럼 테이블을 넘나드는 22개 규칙을 실행합니다.
출력물 5종, 제출은 1종
보고서, 위반 행 목록, 규칙별 결과, 실행 요약, 그리고 중앙 제출용 집계. 환자 단위 정보가 든 위반 행 목록은 병원 안에서만 쓰고, 중앙에는 집계 파일 하나만 보냅니다.
오류 현황 조회
위반 행을 규칙·테이블·심각도·검색어로 걸러 보고 CSV 로 내보냅니다. 행 키와 환자 ID, 상세 설명이 있어 원천 데이터에서 바로 찾아 고칩니다.
대시보드 · 실행 이력
오류 유형별 통계, 질환별 최신 결과와 오류율 신호등, 실행 이력 추이를 봅니다. 데이터를 고치고 다시 실행하면 위반 건수 변화가 추이로 남습니다.
Python 과 동등한 엔진
앱의 TypeScript 엔진은 Python 참조 구현과 6개 코호트 clean·dirty 12회 실행에서 위반 행과 보고서가 바이트 단위로 일치하며(v1·v2·v3), 회귀 시험이 이를 고정합니다. v3 가상데이터에서 6개 코호트 모두 clean 위반 0, 주입 오류 1,497건 전부 검출.
사용 흐름
네 단계면
제출 준비가 끝납니다.
- 1
코호트와 파일
코호트를 고르고 채운 테이블 파일(CSV·엑셀·폴더)을 넣습니다. 입력 양식과 견본 데이터는 앱에서 내려받습니다.
- 2
테이블 대응과 사전 점검
자동 대응표를 확인하고, 오류가 있으면 먼저 해결합니다. 미리보기로 앞부분 몇 줄을 봅니다.
- 3
검증 실행
진행률이 표시되고 화면은 계속 쓸 수 있습니다. 질환당 100명 규모는 수 초, 큰 데이터는 수 분.
- 4
결과와 출력물
요약을 보고 다섯 파일을 열거나 결과 폴더로 내보냅니다. 중앙에는 submission.json 만 보냅니다.
화면
가상데이터로 실행한 실제 화면
아래는 100명 가상 코호트로 자동 실행한 캡처입니다. 실제 환자 데이터는 개발 과정 어디에도 쓰이지 않았습니다.
환자 데이터는 병원을 떠나지 않습니다.
로컬 데스크톱 앱입니다. 내보낸 파일만 읽고 결과를 사용자 컴퓨터에 저장할 뿐, 검증에 어떤 서버나 클라우드도 필요하지 않습니다. 중앙에 보내는 파일은 규칙별 건수와 테이블 행 수만 담은 집계 하나입니다.
0DB 접속 · 네트워크 통신
submission.json병원 밖으로 보내는 유일한 파일. 환자 단위 정보 없음
코드 서명 · 공증Windows 는 EV 인증서, macOS 는 Developer ID 와 Apple 공증
다운로드
Quality Validator v0.3.1
운영체제와 아키텍처에 맞는 파일을 받으세요. 명세와 검증 규칙, 견본 데이터가 설치 파일에 들어 있어 따로 받을 것이 없습니다.
Windows x64대부분의 PC
Intel · AMD 64비트 Windows 10/11. 병원 업무용 PC 는 대부분 여기에 해당합니다.
QualityValidator-0.3.1-win-x64.exe
Windows ARM64ARM PC
Snapdragon 등 ARM 기반 Windows 11. Surface Pro X · Copilot+ PC.
QualityValidator-0.3.1-win-arm64.exe
macOSApple Silicon
M1 이후 Mac. Developer ID 서명과 Apple 공증을 거쳐 경고 없이 열립니다.
QualityValidator-0.3.1-mac-arm64.dmg
견본 데이터가상데이터 · 실제 환자 무관
v3 명세의 6개 질환 × clean/dirty(각 100명, 규칙 시험용) / Good Sample(각 가상 환자 1명의 연결된 표) 18개 폴더입니다. CSV·엑셀과 사용법·기대 결과를 담았습니다. Good Sample은 데이터 연결 구조의 예시이며 실제 임상자료나 임상의 감수 결과가 아닙니다.
SampleData-0.3.1-all.zip
Windows 설치 파일은 GlobalSign EV 인증서로, macOS 는 Apple Developer ID 로 서명하고 공증했습니다. 32비트 Windows 와 Intel Mac 은 제공하지 않습니다.
SHA256SUMS.txt 로 파일을 대조할 수 있습니다. · 모든 릴리스 보기
문서
설명서와 설계 문서
자료실 · 양식과 규칙코호트별 입력 양식(엑셀·CSV), 컬럼 명세서, 검증 규칙 389개 검색, 견본 데이터 기대 결과. 앱 명세에서 자동 생성.
사용자 설명서설치, 입력 파일 준비, 검증 실행, 출력물 읽기와 제출, 자주 묻는 질문.
개요와 설계 원칙배경, 코호트 DB 구조, 규칙은 사전에서 나온다는 원칙, 5단계 계획.
명세와 규칙 카탈로그명세 속성, 이벤트 그룹 행 단위, 규칙의 구성. v3 가 기본이고 v2·v1 은 이전 판으로 설명합니다.
가상데이터질환별 환자 여정 시나리오, 오류 주입과 정답 manifest.
엔진과 검출 성능Python 참조 구현, TypeScript 엔진, 앱 구조, 재현율과 해석의 한계.
v3 명세 (기본 판)9/30 매뉴얼과 10/1 검토 결정(14건 채택): 표 17개, 필드 169개, 규칙 389개, 알려진 한계.
검토 웹서비스매뉴얼 수정 제안과 의뢰사 확인 질문을 결정하는 로컬 서비스. 결과가 v3 에 반영됩니다.
재현과 빌드파이프라인 재현, 앱 개발·빌드, 서명 릴리스 절차.