네프론 (Nephron) - 산업 근로자 신장질환 조기 진단 및 예후 관리 서비스 모바일 앱

산업 근로자의 신장질환을 조기에 진단하고, 직업·생활습관·건강검진 데이터를 바탕으로 자가검사·미션·모니터링을 통해 예후를 관리하는 모바일 헬스케어 애플리케이션 (산학협력 프로젝트)

프로젝트 정보

📋 프로젝트 노션: https://tough-clam-43d.notion.site/38d30c204e64806c8a1cf47a01d037da

산학협력

• 기간: 2025년 12월 - 2026년 6월
• 산업체: ㈜에이치앤에스바이오랩
• 학술기관: 성균관대학교

프로젝트 목표

산업 근로자의 신장질환 조기 진단 및 예후 관리를 위한 모바일 헬스케어 서비스 개발

목표

직업·문진·건강검진 데이터를 결합한 개인 맞춤 신장 건강 위험 분석 및 지속 관리 서비스 개발

핵심 요구사항:

• 개인 맞춤 위험 분석: 직업(대·중·소분류)·문진·건강검진 데이터를 결합한 신장 건강 위험요인 도출 (Google Gemini AI)
• 산업보건 관점 반영: 직업군별 위험요인, 폭염 근로 등 작업 환경 기반 건강 코칭
• 지속적 관리 유도: 자가검사·데일리/위클리 미션·모니터링을 통한 꾸준한 신장 건강 관리
• 온디바이스 자가검사: 소변 검사 키트 촬영 기반 농도 패치 인식 (TensorFlow.js)

범위

• 온보딩·문진 및 직업군 기반 사용자 프로파일링
• 위험도 분석 리포트 생성 및 추세 추적
• 건강검진 결과 연동(CODEF) 및 수치 시각화
• 챌린지·미션 엔진 및 야간뇨(Nocturia) 모니터링
• 사용성 분석(GA4) 및 푸시 알림

연구팀

이름	소속	연락처
민채현	성균관대학교 시스템경영공학과	m040901@g.skku.edu
최지영	성균관대학교 화학공학부	wldud4216@g.skku.edu

---

주요 기능

1. 온보딩 · 인증

• 카카오 / 네이버 / 구글 / 애플 소셜 로그인 및 이메일 회원가입
• 직업(대분류·중분류·소분류) 선택 및 검색
• 성별·연령·기저질환·생활습관 문진
• 회원 탈퇴(계정 삭제)

2. 신장 건강 위험도 분석

• 직업·문진·건강검진 데이터를 결합한 위험요인 분석 (Google Gemini AI)
• 기저질환 · 증상 · 생활·환경 3개 카테고리로 부담요인 정리
• 종합/추세 분석 리포트 및 열람 기록

3. 요스틱(Kidurin) 자가 검사

• 소변 검사 키트를 카메라로 촬영해 분석 (TensorFlow.js 기반 농도 패치 인식)
• 검사 가이드 · 분석 · 결과 · 기록 화면 제공

4. 건강검진 연동

• 건강검진 결과 입력·조회 (CODEF 연동)
• 게이지·마커로 수치 시각화

5. 챌린지 · 미션

• 데일리/위클리 신장 건강 체크
• 미션 수행: 수분 섭취 인증(카메라/수동), 가벼운 운동, 신장 건강 O/X 퀴즈 등
• 연속 체크, 포인트 적립 및 내역

6. 야간뇨(Nocturia) 모니터링

• 갤럭시 워치 수면 세션·걸음 데이터 연동(헬스 플러그인)으로 새벽 활동 자동 감지
• 워치 미착용 시 새벽 시간대 fallback 스캔
• 감지 시 푸시 알림 → 사용자 확인 팝업으로 실제 야간뇨 검증

7. 수분 · 부종 · 날씨

• 수분 섭취 카메라/수동 기록
• 부종(Edema) 촬영 분석
• 날씨(기온·습도) 기반 건강 조언, 폭염 경보 배너 (Gemini AI)

8. 알림 · 분석

• 검사 일정·미션 리마인드 등 푸시 알림
• Google Analytics(GA4) 이벤트·사용자 속성 추적 및 사용성 진단(반복 방문·전역 에러 수집 등)

---

기술 스택

구분	기술
프론트엔드	React 19, TypeScript, Vite
모바일 패키징	Capacitor (Android), Awesome Cordova Health 플러그인, Pedometer
백엔드	Node.js, Express, TypeScript
인증·분석	Firebase Auth / Analytics(GA4), Firebase Admin
AI	Google Gemini API (@google/generative-ai)
이미지 분석	TensorFlow.js / tfjs-tflite
외부 연동	CODEF (건강검진), 카카오/네이버/구글/애플 소셜 로그인

---

프로젝트 구조

.
├── src/                  # 프론트엔드 (React)
│   ├── pages/            # 화면: auth, home, job, kit, hospital, challenge, myinfo, results
│   ├── components/       # 공용 컴포넌트
│   ├── services/         # 도메인 로직 (미션 엔진, 소변검사 인식, 소셜 로그인 등)
│   ├── utils/            # 유틸 (날짜, 위험점수, 직업, 저장소 등)
│   ├── analytics.ts      # GA4 트래킹
│   └── App.tsx           # 라우팅/상태 루트
└── server/               # 백엔드 (Express)
    └── src/routes/       # auth, health(날씨 조언), recommend(미션/위험분석), codef(건강검진)

---

실행 방법

사전 요구사항

• Node.js 18 이상
• npm
• 환경변수: 루트 .env (Firebase, Gemini 등), server/.env (서버 키) — 저장소에 커밋되지 않음

설치

npm install
cd server && npm install && cd ..

개발 서버 (프론트 + 백엔드 동시 실행)

npm run dev

프로덕션 빌드

npm run build                # tsc 타입체크 + vite 번들
cd server && npm run build   # 서버 TypeScript 컴파일

---

데모 영상

로컬(npm run dev) 환경에서 동작하는 주요 기능 시연 영상입니다.

전체 흐름 (앱 전체 시연)

default.mp4

부종(Edema) 촬영 분석

default.mp4

수분 섭취 기록

default.mp4

---

본 문서는 네프론 앱의 기능과 구조를 요약한 개요입니다. 세부 구현은 각 디렉터리의 소스를 참고하세요.