실측지 판독 기반 창호 가견적 앱
본 프로젝트의 요구사항(실측지 AI 판독, 판독 오류 수정, 가견적 1분 산출, 정밀실측 요청)을 기반으로 직접 구현한 프로젝트입니다.
프로젝트 개요
본 프로젝트의 요구사항(실측지 AI 판독, 판독 오류 수정, 가견적 1분 산출, 정밀실측 요청)을 기반으로 직접 구현한 프로젝트입니다. 카메라 촬영과 큰 버튼 중심의 모바일 화면으로 비개발자 사업자도 쉬운 사용 흐름으로 가견적까지 이어지도록 설계했습니다.
작업 범위
- 실측지 촬영 판독: 통일 실측지 양식을 촬영하거나 업로드하면 비전 AI가 사이즈와 사양을 읽어 실측값 입력란에 자동으로 채웁니다
- 판독 오류 수정: 읽지 못했거나 신뢰도가 낮은 항목을 색상으로 강조하고, 원본 사진을 보면서 그 자리에서 직접 고칠 수 있습니다
- 가견적 산출: 추가공사 항목을 고르면 견적 DB의 제품별·10mm 단위 단가를 기준으로 가견적을 산출하고 항목별 내역을 보여줍니다
- 정밀실측 요청: 가견적을 확인한 뒤 희망 일정과 현장 정보를 입력해 정밀실측을 요청하고 진행 상태를 확인합니다
주요 업무
- 실측지 촬영 판독 화면: 이미지 전처리 후 비전 LLM API로 표 구조를 JSON으로 추출하고, 항목별 신뢰도 값을 함께 저장하는 구조를 반영합니다
- 판독 오류 수정 화면: 신뢰도 임계값 미만 항목과 단위 규칙 위반 항목을 분류해 강조하고 수정 이력을 보관하는 구조를 반영합니다
- 가견적 산출 화면: 사이즈를 10mm 단위로 올림 처리해 단가 테이블을 복합 인덱스로 조회하고, 사용한 견적 DB 버전을 결과에 함께 기록하는 구조를 반영합니다
- 정밀실측 요청 화면: 요청 건을 상태 머신으로 관리하고 결제 승인 후 접수 상태로 전환하는 흐름을 반영합니다




프로젝트 핵심 과제
촬영 각도와 조명에 따라 손글씨 실측값 판독이 흔들릴 수
신뢰도 기반 강조와 원본 대조 수정 화면으로 대응합니다
수백만 건 단가 데이터의 형식과 제공 시점이 확정되지 않아 적재 스크립트와 검증 규칙을 먼저 설계할 계획입니다
추가공사 항목과 산식이 아직 정해지지 않았으므로 가산 규칙을 설정값으로 분리해 변경 범위를 줄일 계획입니다
비개발자 클라이언트가 직접 이해하고 이관할 수 있
기술 선택 근거와 인수인계 범위를 문서로 정리합니다
핵심 기능 상세
실측지 촬영 판독
통일 실측지 양식을 촬영하거나 업로드하면 비전 AI가 사이즈와 사양을 읽어 실측값 입력란에 자동으로 채웁니다.
- 촬영 이미지 회전 보정과 해상도 정규화를 거쳐 비전 LLM API에 전달하는 전처리 파이프라인 설계
- JSON 스키마 강제 응답과 서버 측 타입 검증으로 판독 결과를 실측 폼 필드에 매핑
- 항목별 신뢰도 점수를 함께 저장해 낮은 항목을 후속 화면에서 강조하는 구조 구현
실측지 1종 양식의 칸 위치와 단위 규칙을 프롬프트와 스키마에 고정해 판독 결과를 실측 폼 필드에 일관되게 채우는 구조를 설계합니다.


판독 오류 수정
읽지 못했거나 신뢰도가 낮은 항목을 색상으로 강조하고, 원본 사진을 보면서 그 자리에서 직접 고칠 수 있습니다.
- 신뢰도 임계값과 사이즈 범위 규칙 검증으로 의심 항목을 자동 분류하는 로직 설계
- 원본 이미지와 입력 폼을 나란히 배치하고 선택 항목 위치를 하이라이트하는 확인 화면 구현
- 수정 전후 값을 보관해 판독 정확도 점검에 활용하는 수정 이력 테이블 설계
강조된 항목만 순서대로 이동하며 확인하는 흐름으로 설계해 나이 있는 사업자도 전체 폼을 훑지 않고 수정을 마칠 수 있게 합니다.


가견적 산출
추가공사 항목을 고르면 견적 DB의 제품별·10mm 단위 단가를 기준으로 가견적을 산출하고 항목별 내역을 보여줍니다.
- 제품·폭·높이 복합 인덱스와 구간 올림 규칙으로 수백만 건 단가 테이블을 단건 조회하는 쿼리 설계
- 추가공사 항목 가산 규칙을 전략 패턴으로 분리해 산식 변경에 대응하는 계산 모듈 구현
- 가견적 결과에 견적 DB 버전 식별자를 저장해 단가 버전 관리와 연결하는 구조 설계
견적 DB 버전과 산출 근거를 결과 화면에 함께 남겨 단가 변경 이후에도 과거 가견적을 재현할 수 있는 구조를 설계합니다.


정밀실측 요청
가견적을 확인한 뒤 희망 일정과 현장 정보를 입력해 정밀실측을 요청하고 진행 상태를 확인합니다. 요청 건을 상태 머신으로 관리하고 결제 승인 후 접수 상태로 전환하는 흐름을 반영합니다.
- 요청 접수·결제 대기·실측자 배정·실측 완료로 이어지는 상태 머신과 허용 전이 규칙 설계
- 사업자 인증 외부 API 연동 인터페이스를 어댑터로 분리해 회원가입 단계에 연결
- 결제 모듈은 PG 연동 인터페이스를 추상화해 승인 결과를 요청 상태에 반영하는 구조 구현
가견적에서 정밀실측 요청, 이후 발주·시공 단계까지 하나의 요청 건 상태로 이어지도록 설계해 앱 내에서 흐름이 끊기지 않게 합니다.


프로젝트 진행 단계
실측지 양식 분석 및 판독 스키마 설계 · 2026.10
통일 실측지 양식의 칸 구조 분석, 비전 LLM 응답 JSON 스키마와 신뢰도 필드 정의
촬영·판독·수정 화면 구현 · 2026.10
촬영 업로드, 판독 결과 강조 화면, 원본 대조 수정 화면을 모바일 우선 레이아웃으로 구현
가견적 엔진 및 정밀실측 요청 흐름 구현 · 2026.10
단가 복합 인덱스 조회, 가산 규칙, 견적 DB 버전 기록, 요청 상태 머신과 PG 결제 추상화 구현
인수인계 문서 및 판독 점검 정리 · 2026.10
화면 설계서, DB 스키마, 운영 매뉴얼 정리와 샘플 실측지 판독 점검 절차 문서화
개발 결과
기술적 주안점
- 실측지 1종 양식의 칸 위치와 단위 규칙을 프롬프트와 스키마에 고정해 판독 결과를 실측 폼 필드에 일관되게 채우는 구조를 설계합니다
- 강조된 항목만 순서대로 이동하며 확인하는 흐름으로 설계해 나이 있는 사업자도 전체 폼을 훑지 않고 수정을 마칠 수 있게 합니다
- 견적 DB 버전과 산출 근거를 결과 화면에 함께 남겨 단가 변경 이후에도 과거 가견적을 재현할 수 있는 구조를 설계합니다