플러스프로젝트 배경
1) 문제점 - 건강검진 항목마다 정상 범위 기준값이 연령·성별에 따라 달라 단일 기준 테이블로 관리하기 어려웠던 문제 — SQLAlchemy에 연령대·성별 복합 조건 기준값 마스터 테이블을 설계하고, FastAPI 의존성 주입으로 조회 시 자동 필터링 적용 - 엑셀 파일의 검진 항목 컬럼명이 기관마다 다른 형식(영문/한글/약어)으로 되어 있어 자동 매핑 실패 — 컬럼 매핑 Dropdown UI를 제공하여
프로젝트 성과
엑셀 데이터 입력 → 검증 → 저장 원스톱 파이프라인 구현
SheetJS 파싱 + 컬럼 매핑 UI + Zod 스키마 검증을 연결하여, 엑셀 업로드부터 DB 저장까지 수작업 없는 데이터 입력 파이프라인 구축, 매핑 프리셋으로 반복 업로드 효율화
연령대별 t-test 통계 분석 자동화 구현
jStat으로 연령대 그룹 간 독립표본 t-test를 자동 수행하여 t값·p값·Cohen's d를 카드 UI로 표시, 항목별 정상 범위 ReferenceArea를 히스토그램에 오버레이하는 분석 시각화 설계
8축 건강 지표 레이더 차트 리포트 설계
Recharts RadarChart로 혈압/혈당/콜레스테롤/간기능 등 8개 검진 항목 프로파일을 시각화, 정상 범위 기준선 오버레이로 수검자 결과의 정상/이상 판별이 직관적인 리포트 UI 구현
Puppeteer PDF 일괄 생성 큐 시스템 구축
FastAPI에서 Puppeteer subprocess를 호출하여 HTML 리포트 템플릿을 A4 PDF로 변환, 수백 명 일괄 생성 시 동시 실행 수 제한 + 큐 순차 처리로 서버 리소스 안정적 관리
검진 항목별 정상/경계/이상 조건부 시각화 적용
Recharts BarChart Cell fill을 정상(초록)/경계(노랑)/이상(빨강)으로 조건부 색상 처리하고, PieChart로 항목별 판정 분포를 비율%와 함께 시각화하는 다층 차트 구조 설계
핵심 기능
검진 대시보드
히어로 배너에 오늘 검진 건수·정상률·이상 소견 수 KPI를 표시하고, 항목별 이상률 차트를 제공하는 메인 화면. 히어로 배너 KPI + 항목별 이상률 BarChart + 최근 검진 완료 목록
진행 단계
건강검진 도메인 모델링 및 FastAPI 프로젝트 구조 수립
2025.08.
검진항목·수검자·결과·리포트 4개 도메인 SQLAlchemy 모델 설계, FastAPI 라우터·Pydantic 스키마·의존성 주입 레이어 구조 수립, 검진 항목별 정상 범위 기준값 마스터 테이블 정의
프로젝트 상세
1) 포트폴리오 소개 건강검진 센터의 수검자 검진 결과를 엑셀에서 자동 파싱하여 항목별 통계 분석(정상/경계/이상 분포, 연령대별 t-test)을 수행하고, 수검자별 건강 리포트를 PDF로 생성·발송하는 플랫폼을 Python + FastAPI + PostgreSQL 기반으로 설계·구현했습니다. 히어로 배너 기반 대시보드, 수검자 결과 입력·조회, 통계 분석 차트, PDF 리포트 생성 기능을 구축했습니다.
