본 문서는 네프론 앱(신장 건강 관리 서비스)의 구조와 동작 원리를 정리한 기술 설명서입니다.
코드를 직접 다루는 경우 4장(폴더 구조)과 6장(기능 동작 원리)을, 화면 구성이 필요한 경우 5장(화면별 설명)을 먼저 참고하시기 바랍니다. 근로환경 유해인자 분석 대시보드(별도 저장소)는 14장에 정리하였습니다.
| 항목 | 내용 |
|---|---|
| 앱 이름 / 패키지 | 네프론 / com.nephron.app (v1.1) |
| 플랫폼 | 안드로이드 (Capacitor 기반, 웹 동작 가능) |
| 프론트엔드 | React 19 + TypeScript + Vite 7 |
| 백엔드 | Node.js + Express + TypeScript (Render 호스팅) |
| 데이터 저장 | localStorage(전체) + Firestore(로그인 시 동기화) |
| 핵심 외부 서비스 | Firebase, Google Gemini, CODEF, Kakao/Naver, Open-Meteo |
| 운영 서버 | https://app-new-n5ae.onrender.com |
| 운영 웹 | https://app-web-b0qf.onrender.com |
| 가장 중요한 파일 | src/App.tsx (화면 전환·전역 데이터·핵심 로직 집중) |
네프론은 산업 현장 근로자(건설·제조업 등)의 신장 건강을 관리하는 모바일 애플리케이션입니다. 용접·금속·화학 등의 작업은 열·중금속·유기용제·방사선과 같은 유해인자 노출을 동반하며, 이는 신장에 부담을 줄 수 있습니다. 본 앱은 해당 근로자가 신장 상태를 지속적으로 점검하고, AI 분석을 통해 현재 상태와 권장 검진 주기를 안내받을 수 있도록 지원합니다.
사용자의 주요 활동은 다음과 같습니다.
| 활동 | 방식 |
|---|---|
| 소변 검사 | 검사 키트(요스틱)에 소변을 묻혀 카메라로 촬영하면 앱이 자동 판독 |
| 건강 분석 | 문진·검사·건강검진 기록을 종합해 AI(Gemini)가 신장 건강 리포트 생성 |
| 일일 습관 관리 | 주간 건강 체크 후 맞춤 미션(산책·수분·스트레칭·퀴즈 등) 수행 및 포인트 적립 |
| 신체 상태 추적 | 부종 영상 분석, 야간뇨 자동 감지 |
| 자동 연동 | 소셜 로그인, 국가 건강검진 기록 자동 수집, 헬스 데이터·날씨 연동 |
com.nephron.app)