← 포트폴리오 목록
산업안전 현장점검 ERP
산업안전 점검 대행 업체가 현장 방문 일정 배정부터 보고서 작성·전자서명·승인·PDF 보관까지 이어지는 업무 전체를 관리하는 ERP를 구현합니다.
GPS 방문 검증 로직 구현HTML5 Geolocation과 오차 반경 계산으로 방문 완료 처리 시 위치를 자동 검증하는 로직을 구현합니다.
보고서 상태 머신 설계임시저장→제출→검토중→반려→승인 5단계 상태 전이를 트랜잭션으로 보장하는 상태 머신을 설계합니다.
전자서명·PDF 파이프라인 구축signature_pad 캡처부터 PDF-lib 문서 생성까지 이어지는 서명-문서화 파이프라인을 구축합니다.
Overview
프로젝트 개요
산업안전 점검 대행 업체가 현장 방문 일정 배정부터 보고서 작성·전자서명·승인·PDF 보관까지 이어지는 업무 전체를 관리하는 ERP를 구현합니다. React와 Node.js 기반으로 산업재해예방 현장 점검 프로세스를 반영한 맞춤 데모를 제공합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
현장 모바일 환경의 불안정한 네트워크에서도 보고서 임시저장 데이터가 유실되지 않는 동기화 전략 설계가 필요합니다
GPS 오차 반경과 실내 사업장 환경에서의 위치 정확도 저하를 함께 고려한 방문 검증 기준 설계가 필요합니다
보고서 승인·반려 전이 중 동시 접근으로 인한 상태 불일치를 막는 트랜잭션 격리 수준 설계가 필요합니다
카메라 업로드 이미지 용량과 PDF 문서 크기를 함께 관리하는 저장소 최적화 전략 설계가 필요합니다
구현 내용
핵심 기능 상세
핵심 기능 1
현장 방문 일정 배정 캘린더
관리자가 사업장별 현장 방문 일정을 월/주 캘린더 뷰에서 배정하고, 배정 즉시 현장 모바일 앱으로 통지되는 산업안전 ERP의 핵심 스케줄링 화면을 구현합니다
핵심 기능 2
현장 보고서 작성 및 전자서명
정기진단·위험성평가 고정 템플릿 기반 보고서 작성 폼에 마스터데이터 자동완성과 현장 모바일 카메라 업로드, 터치 기반 전자서명을 통합해 하나의 업무 자동화 흐름으로 구현합니다
핵심 기능 3
보고서 승인 워크플로우 및 PDF 발급
제출된 보고서를 관리자가 확인·반려·승인하는 워크플로우를 구현하고, 최종 승인된 보고서는 서명·사진을 포함한 PDF로 자동 변환되어 시스템에 보관됩니다
핵심 기능 4
권한 및 마스터데이터 관리
관리자·현장직원·고객사 3단계 권한을 분리하고, 고객사·사업장·직원·공통코드·점검항목 템플릿 등 ERP 마스터데이터를 한 화면에서 관리합니다
구현 과정
프로젝트 진행 단계
STEP 1
업무 프로세스 분석 및 ERD 설계
현장 방문·보고서·승인 프로세스를 분석해 PostgreSQL 테이블 24개를 정의하고 권한·마스터데이터 관계를 매핑합니다.
STEP 2
일정·현장 데이터 API 개발
Express 기반 일정 배정, GPS 검증, 보고서 작성 API 30~35개 엔드포인트를 구현합니다.
STEP 3
보고서 작성·전자서명 UI 개발
React 기반 보고서 폼, 카메라 업로드, signature_pad 전자서명 화면을 구현합니다.
STEP 4
승인 워크플로우 및 PDF 발급 구현
상태 머신 기반 승인·반려 로직과 PDF 자동 생성 파이프라인을 구현합니다.
STEP 5
권한관리 통합 테스트
3단계 권한 시나리오 및 API 통합 테스트 케이스를 작성해 검증합니다.
프로젝트 성과
주요 성과
GPS 방문 검증 로직 구현HTML5 Geolocation과 오차 반경 계산으로 방문 완료 처리 시 위치를 자동 검증하는 로직을 구현합니다.
보고서 상태 머신 설계임시저장→제출→검토중→반려→승인 5단계 상태 전이를 트랜잭션으로 보장하는 상태 머신을 설계합니다.
전자서명·PDF 파이프라인 구축signature_pad 캡처부터 PDF-lib 문서 생성까지 이어지는 서명-문서화 파이프라인을 구축합니다.
3단계 권한 체계 구현관리자·현장직원·고객사 역할별 라우트·API·UI 3중 권한 검증 체계를 구현합니다.
Review
기술적 주안점
- 일정 배정과 GPS 방문 검증을 하나의 캘린더 화면에서 관리해 현장 모바일과 관리자 웹을 하나의 데이터 흐름으로 연결하는 구조를 설계합니다
- 임시저장 동기화와 전자서명 캡처를 결합해 오프라인에 가까운 현장 환경에서도 데이터 유실 없는 보고서 작성 구조를 설계합니다
- 상태 머신 기반 승인 워크플로우와 PDF 자동 생성을 트랜잭션으로 묶어 승인과 문서 보관 사이의 정합성을 보장하는 구조를 구현합니다
