프로젝트 소개
신청부터 서류 검토까지,
하나의 업무 흐름으로.
마음이음은 전자정부프레임워크와 KRDS를 활용해 만든 지원사업 신청·서류 검토 포트폴리오입니다.
실제 정부기관의 접수 창구가 아니며 지원금은 지급하지 않습니다. 공개 계정을 함께 사용하므로 실제 개인정보나 민감한 정보를 입력·업로드하지 마세요.
어떤 문제를 다루나요?
신청 내용과 여러 증빙을 따로 확인하다 보면 서류 누락, 입력값 불일치, 보완 과정에서의 버전 혼동이 생깁니다. 신청자가 작성한 통합 PDF를 올려 문서를 나누고, 원본·추출값·사진을 대조한 뒤 신청서에 반영하도록 구성했습니다.
직접 입력하는 방식도 제공합니다. 제출 이후에는 관리자의 담당자 배정, 담당자의 검토·보완 요청, 신청자의 수정·재제출과 결과 확인으로 이어집니다.
두 가지 문서 검토 방식
| 방식 | 처리 내용 | 안내 |
|---|---|---|
| OCR 검토 데모 | 실제 OCR을 실행하지 않고, 미리 인식한 결과를 이용해 문서 검토 과정을 보여줍니다. 진행 표시는 약 12초 동안 단계별로 보여줍니다. | 이번 요청에서 새로 OCR을 실행하는 과정은 아닙니다. 파일 내용이 일치하는 제공 문서에서만 사용할 수 있습니다. |
| OCR 실제 검토 | 업로드한 문서를 서버에서 직접 인식합니다. 서버 사양에 따라 10분 이상 걸릴 수 있습니다. 기존 결과 캐시를 건너뜁니다. | 작은 무료 서버를 사용하므로 오래 걸립니다. 6쪽 스캔 PDF에 약 14분이 걸린 사례가 있으며, 시간 안내를 확인한 뒤 요청할 수 있습니다. |
어느 방식을 선택하든 추출값 확인·수정, 신청서 반영, 제출과 검토 이력은 실제 Java 백엔드와 데이터베이스에서 처리합니다. 인식 결과가 승인이나 자격 판단을 대신하지 않습니다.
기술 구성과 책임 분리
- 서비스 서버
- Java 21 · 공식 eGovFrame 5.0.2 · Spring MVC · JSP · Tomcat
- 데이터 접근
- MyBatis Mapper XML · MariaDB · Flyway 스키마 변경 관리
- 화면
- KRDS 1.1.0 기반 공통 화면·입력·안내 구성, 서비스별 CSS와 JavaScript
- 문서 처리
- Apache PDFBox Java 모듈 · PaddleOCR · Gemma 4 · OpenCV · Python 내부 API
- 운영
- Oracle Cloud 무료 서버 · Docker Compose · Caddy HTTPS · Cloudflare 프록시 · Fail2ban SSH 보호
HTTP 요청은 Controller, 권한·업무·트랜잭션은 Service와 Policy, SQL은 Mapper XML에 둡니다. OCR 원문, 사용자가 확인한 값, 실제 신청 내용은 구분해 관리합니다.
AI는 어디에 쓰나요?
Apache PDFBox가 PDF의 원문·페이지·이미지 영역을 분리하고, PaddleOCR가 스캔 속 글자를 읽습니다. Gemma 4는 인식한 원문을 바탕으로 문서 종류와 신청 항목을 해석합니다. 원문에서 확인한 누락값만 보완하며 기존 값과 다른 후보는 직접 확인하도록 남깁니다.
AI가 지원 자격이나 선정 여부를 판단하지 않습니다. 최종 반영과 제출은 사용자가 확인한 뒤 진행합니다.
구현하며 선택한 것들
- 업로드와 검토 시작을 분리했습니다. 다음 화면에서 원본을 확인하고 요청하기 전에는 OCR을 시작하지 않습니다.
- 제출본과 첨부 버전을 보존해, 보완 후에도 당시 제출 내용을 확인할 수 있도록 했습니다.
- 서버에서 역할·소유권·상태를 검사하고, 행 잠금·버전·멱등 키로 중복 제출과 상태 충돌에 대응했습니다.
- 같은 내용의 파일은 해시로 공유합니다. 공개 계정 자료는 매일 오전 4시를 기준으로 초기화하고 진행 중 문서는 완료 후 정리합니다.
- 첫 인식에 시간이 오래 걸리는 서버 제약을 확인한 뒤, OCR 검토 데모와 OCR 실제 검토을 명확히 구분해 제공합니다.
살펴보는 순서
- 공개 계정 안내를 확인하고 로그인합니다.
- 지원사업에서 ‘작성 문서 업로드’를 선택해 제공된 신청서를 올립니다.
- 원본을 확인하고 ‘OCR 검토 데모’를 요청합니다.
- 문서 분할, 신청 항목과 사진을 살펴보고 필요한 내용을 수정해 반영합니다.
- 최종 제출 후 나의 신청에서 접수번호와 진행 이력을 확인합니다.
실제 인식 실행을 확인하려면 검토 방식에서 ‘OCR 실제 검토’를 선택할 수 있습니다. 공개 계정의 신청 자료는 여러 방문자에게 공유됩니다.