Project brief
프로젝트 내용
[프로젝트 개요]
- 유전자검사 플랫폼 유젠스의 기존 3개 서비스 개편·증설 사업입니다(신규 구축 아님).
- 4개 서비스(기존 3종 + 신규 건강유형도측정)를 한 화면에서 관리하는 통합관리페이지 신설
- 1회 서명으로 여러 검사 동의서를 처리하는 통합 서명·통합 알림톡 도입
- 건강유형도측정을 4번째 검사 서비스 라인으로 신규 추가
- 엑셀 업로드로 서비스별 예약을 자동 등록하는 데스크탑 통합관리툴(단일 실행파일) 개발 포함
[비즈니스 목표/배경]
- 서비스별로 흩어진 고객 조회·서명요청·결과 다운로드 업무를 통합관리페이지로 일원화
- 다중 서비스 신청 고객의 개별 서명 반복 부담을 통합 서명 1회로 해소
- 건강유형도측정으로 검사 상품 라인업 확장
[기대 효과]
- 어드민 업무 처리 시간 단축, 고객 서명 이탈률 감소
- 신규 매출원 확보(건강유형도측정), 현장 인력은 엑셀 업로드만으로 예약 일괄 등록
[요구사항]
1. 어드민 - 신청 서비스 수정
- 고객상세 서비스타입 수정 팝업(선택 가능 서비스 나열·기선택 표시)
- 수정 가능 조건: 유젠스/Etc 검체바코드 등록 전, 안리스크 검사결과 없음, 건강유형도 결과 전달 전
- 진행된 서비스는 잠금, 1개 이상 선택 필수
- 서명 완료 건은 수정 반영한 병원용 의뢰서 PDF 재생성
2. 어드민 - 마크로젠 담당자 정보 자동화
- 담당자 정보 수신·저장, 결과지 생성 시 동적 적용(기존 고정값 수동 수정 폐지)
- 담당자 관리 화면, 변경 이력 보존
3. 고객 - 통합 서명·통합 메시지
- 신청한 모든 검사 동의서 노출, 동의서별 동의여부 체크(기본값 동의), 미동의 서명 시 안내 후 차단
- 통합 서명요청 DB·API 신설, 1회 서명으로 다건 완료 처리 + 서비스별 동의서 PDF 각각 생성
- 통합 알림톡(예약 서비스 나열 + 서비스별 동의 안내 조립), 신규 템플릿 등록·심사
- 기존 서비스별 개별 서명요청은 유지
4. 어드민 - 통합 서비스 관리 페이지
- 통합 고객 리스트(17컬럼 + 필터 8종: 라이프코드·병원명·생년월일·이름·전화번호·검사예약일·검체채취일·바코드번호)
- 통합 서명요청 카톡 발송·재발송, 동의서·결과지 일괄 다운로드, RawData 다운로드
- 안리스크 결과 업로드 연결(기존 기능 재사용)
- 검사 예약: 개별 예약 팝업(부모/자식 서비스 다중 선택), 엑셀 업로드 예약(앱과 동일 API)
- 계정별 권한 설정, 민감정보 접근·다운로드 감사 로그·조회 화면
5. 건강유형도측정 신규 서비스
- 데이터 모델·예약·상태관리(안리스크 유사, 바코드 미사용), 통합관리페이지 내 운영
- 동의서·의뢰서 양식·PDF 생성(통합 서명 흐름 편입)
- 공급업체 전송, 결과지 수신·저장·등록, 고객 결과 확인(URL→PDF), 결과지 알림톡
6. 데스크탑 통합관리툴
- 로그인(+아이디/비밀번호 찾기, 기존 API 연동), 병원 담당자/어드민 분기, 어드민은 병원 선택 화면
- 엑셀 업로드 화면(드롭박스로 통합/전체/개별 서비스 선택, 버튼명·워터마크 반영)
- 파싱 엔진(예약 항목 추출, 실패 시 행 단위 사유), 서비스별 매핑 규칙 4종
- 전용 서버 API(신규 회원 등록/기존 회원은 라이프코드+생년월일+이름 일치 시 예약 추가, 웹과 공용)
- 단일 실행파일 패키징(Electron/PyInstaller), 자동업데이트 불필요, 경량 디자인
7. 공통
- 기존 시스템 분석·역설계(코드·DB·API 파악, 코드베이스 미제공 전제)
- 기존 3개 서비스 무중단 배포·회귀 없는 개편
[사용자 스토리]
- 어드민은 고객 서비스 구성을 수정한다
수용 기준: 수정 가능 조건을 충족하면 팝업에서 변경할 수 있고, 진행된 서비스는 잠겨 선택되지 않는다
- 고객은 여러 검사를 한 번의 서명으로 동의 처리한다
수용 기준: 통합 서명 페이지에서 서명하면 신청한 모든 검사의 동의서가 각각 PDF로 생성되고 완료 처리된다
- 어드민은 4개 서비스 고객을 한 화면에서 관리한다
수용 기준: 통합 리스트에서 8종 필터로 검색하면 4개 서비스 데이터가 한 라인에 통합 표시된다
- 고객은 건강유형도측정을 신청하고 결과를 확인한다
수용 기준: 공급업체 결과 수신이 완료되면 결과 URL에서 PDF를 확인할 수 있다
- 현장 담당자는 데스크탑 앱으로 예약을 일괄 등록한다
수용 기준: 엑셀 업로드 시 항목이 서비스별로 매핑되어 등록되고, 오류 행은 사유와 함께 실패 처리된다
[핵심 시나리오]
- 다중 서비스 신청 - 통합 서명요청 카톡 발송 - 통합 서명 1회 서명 - 서비스별 동의서 PDF 생성 - 검사 진행 - 결과지·의뢰서 발급
- 건강유형도 예약 - 동의서 서명 - 공급업체 전송 - 결과 수신 - 통합관리페이지 등록 - 고객 결과 URL 확인 - 알림톡 발송
- 데스크탑 앱 로그인 - 엑셀 업로드 - 항목 추출·매핑 - 신규/기존 회원 판정 - 서비스별 예약 자동 등록
[상태 흐름]
- 서비스 신청: 수정 가능 - (조건 충족 시) 수정 - 진행(잠금)
- 통합 서명: 요청 발송 - 서명 대기 - 완료(동의서별 PDF 생성) 또는 미동의 차단
- 건강유형도: 예약 - 서명 완료 - 공급업체 전송 - 결과 수신 - 결과 등록 - 고객 확인 - 알림톡 발송
- 데스크탑 업로드: 파일 선택 - 파싱 - 성공(예약 등록) 또는 실패(행 단위 사유 반환)
[화면 목록]
- 서비스 수정 팝업(고객 상세)
- 통합 동의서 서명 페이지
- 통합관리 고객 리스트
- 개별 예약 팝업
- 엑셀 업로드 팝업(웹)
- 권한 설정 화면
- 안리스크 업로드 연결 화면
- 건강유형도 결과 등록 화면
- 고객 결과 확인 페이지
- 마크로젠 담당자 관리 화면
- 감사 로그 조회 화면
- (데스크탑 앱) 로그인/비밀번호 찾기·병원 선택·엑셀 업로드 및 추출 리스트
[외부 연동]
- 마크로젠: 담당자 정보 수신, 검사결과 전송·수신
- 카카오 알림톡: 통합 서명요청·결과지 알림 발송, 신규 템플릿 등록·심사
- AWS S3: 기존 파일 저장소 재사용
- PDF 생성: 동의서·의뢰서·결과지(기존 파이프라인 재사용)
[비기능 요구]
- 기존 3개 서비스 기능·데이터 무중단 유지, 회귀 없는 배포
- 민감정보(유전자·건강정보) 보호, 접근통제·암호화 기존 체계 준용, 다운로드 이력 추적
- 통합 리스트 조회는 4개 서비스 데이터를 필터·페이징과 함께 응답
- 데스크탑 앱은 자동 업데이트 불필요(수동 재배포 전제)
[스코프 밖]
- 기존 유젠스·ETC·안리스크 서비스 화면·로직 자체 변경(유지만)
- 데스크탑 앱 자동 업데이트 기능
- 서명 문서 사후 수정에 따른 재서명 절차 설계(정책 확정 후 별도 협의)
[기술 스택]
- Next.js 13.5.4 · Pages Router, TypeScript (strict)
- Node.js 18 · TypeScript, NestJS 10 · Express
- AWS RDS for PostgreSQL, Prisma
[제약 사항 및 확인 필요]
임의로 정하지 않고 착수 전 발주처와 확정합니다(데이터 구조 포함).
- 기존 개발사 유지보수 계약 유무·병행 배포 조율 주체
- 마크로젠 담당자 정보 전달 방식(API/파일/수동 입력)
- 건강유형도 공급업체 확정·전송수신 방식(API/파일)
- 결과지 수신 포맷(완성 PDF vs raw data 수령 후 자체 생성)
- 통합관리 권한 범위(on/off 또는 기능별 세분 권한)
- 의뢰서 PDF 재생성 시 재서명 필요 여부(법적 정책)
[제안 요청 사항]
- 기존 시스템 파악(역설계) 방법론과 예상 소요
- 통합 서명·통합 알림톡 아키텍처 설계안
- 데스크탑 앱 프레임워크 제안(Electron/PyInstaller 등)과 근거
- 민감정보 접근통제·감사 로그 설계 방안
- 무중단 배포·회귀 테스트 계획
- 의료·헬스케어·민감정보 취급 개발 실적(우대)
[산출물]
- 통합관리페이지·통합 서명·건강유형도측정 서비스·데스크탑 통합관리툴 소스 및 실행파일
- 역설계 문서, 배포·운영 가이드, 테스트·인수인계 문서
[계약 특이사항]
- 기획/디자인/백엔드/프런트엔드/QA 포함 소규모 팀 구성 기대
[예산]
- 2,000만원 내외 (부가세 별도)
[개발 기간]
- 약 3개월