박주철

Ragas 평가에서는 검증할 문장을 서버에서 고정하고, 모델이 반환한 평가 결과를 문장 ID로 대조하도록 구성했습니다. 긴 입력은 여러 묶음으로 나누고, 원문 인용·근거 일치·답변의 설명 범위를 각각 확인하도록 구성했습니다.

• 검증

  실제 문서 답변에서 추출한 25개 주장을 5개 묶음으로 나누어 끝까지 평가했습니다. ID 누락·중복과 잘못된 응답 형식을 검사해, 형식이 깨진 판정이 정상 결과로 저장되지 않도록 확인했습니다.

응답이 느린 원인을 구분하려고 모델 응답을 고정한 상태에서 내부 처리를 측정했습니다. 반복되는 토큰 수 계산을 줄이고, 같은 요청에서 이미 처리한 문서 페이지를 다시 활용했습니다.

• 검증

  워밍업 후 개선 전후 각각 20회를 측정한 결과, 내부 처리 중앙값이 2,969ms에서 672ms로 줄었습니다. 모델 호출 횟수는 유지했고, 실제 모델을 사용하는 근거 검증은 별도로 진행했습니다.

긴 답변의 평가를 완료할 수 있게 했고, 반복 계산으로 발생하던 내부 지연을 줄였습니다. 답변은 먼저 보여 주고 Ragas 평가는 비동기로 이어가도록 바꿔 평가가 끝날 때까지 사용자가 기다리지 않게 했습니다.

문서 분석 처리 시간의 중앙값

2,969ms → 672ms

같은 모델 응답을 사용하는 시험에서 애플리케이션 처리 시간을 비교했습니다. 준비 실행 후 전후 각 20회 측정했으며, 모델·네트워크 대기 시간은 제외했습니다.

입력 한도를 넘던 긴 답변 평가 개선

25개 항목 평가 완료

실제 문서에 대한 Gemma 4 답변에서 검증할 내용을 추출해 5개 묶음으로 평가했습니다. 가장 긴 요청도 8,164토큰으로, 8,192토큰의 입력 한도를 넘지 않았습니다.

품질 평가를 기다리지 않는 답변 제공

답변을 먼저 제공하고 평가는 별도로 실행

Ragas 평가가 끝나기 전에 생성된 답변을 보여 줍니다. 사용자의 새 질문을 처리하는 동안에는 다음 평가 요청을 잠시 미룹니다.

수정 버전이 오래되면 저장을 거절하되 입력값은 화면에 남겼습니다. 수정 전 값·서버의 최신 값·현재 입력값을 비교해 선택한 뒤, 별도 저장으로 변경을 확정하도록 만들었습니다.

• 검증

  개발 환경에서 별도 API 요청으로 먼저 값을 변경한 후, 브라우저의 저장 요청이 409 응답을 받아도 입력값과 DB의 최신 값이 유지되는지 확인했습니다. 이후 선택한 값을 다시 저장하고 DB와 변경 이력을 대조했습니다.

검증한 데이터를 서버에 보관하고 저장 직전에 권한과 참조 데이터를 다시 확인했습니다. 중간 오류는 전체 트랜잭션을 되돌리고, 같은 저장 요청을 다시 보내면 기존 처리 결과를 반환하도록 구성했습니다.

• 검증

  격리한 MariaDB 환경에서 중간 실패·재요청·동시 요청을 재현해 부분 저장과 중복 반영이 발생하지 않는지 확인했습니다. 검증 화면에서 통과한 데이터가 실제 저장 과정에서도 같은 기준을 따르는지 점검했습니다.

현재 배차 자료와 확정된 정산 이력을 구분하고, 수정 충돌과 일괄 저장 실패를 복구할 수 있는 흐름을 구현했습니다. 저장 성공 여부뿐 아니라 사용자의 입력과 변경 이력이 함께 유지되는지 확인했습니다.

알림 버전과 삭제 상태를 비교해 늦게 도착한 생성 알림이 삭제된 항목을 되살리지 못하게 했습니다. 읽음 정보는 별도로 관리하고, 먼저 갱신한 뒤 없으면 등록하던 처리를 한 번의 UPSERT로 바꿔 최초 확인 시각을 유지했습니다.

• 검증

  격리한 MariaDB에서 읽음 처리의 데드락을 재현한 뒤 동시 요청을 다시 실행했습니다. 알림 순서를 뒤집거나 같은 알림을 반복해서 보내도 최신 내용과 읽음 정보가 유지되는지 확인했습니다.

브라우저 안에서만 유효한 blob URL 대신 사용자가 다운로드할 때 짧게 유효한 서명 URL을 발급했습니다. 발급과 실제 다운로드 시점에 접근 권한을 확인하고, 로그인 토큰을 파일 주소에 넣지 않았습니다.

• 검증

  Chrome에서 내려받은 PDF와 원본의 해시를 비교하고 네이티브 브리지에 전달되는 값을 확인했습니다. Android 에뮬레이터에서는 알림을 누른 뒤 공지 목록을 거쳐 공지 본문을 여는 흐름을 점검했습니다.

문의 처리와 알림, PDF 다운로드를 ERP와 연결했습니다. 채팅 시스템 자체는 담당 범위에서 제외하고, 모바일 화면과 API 연계 및 데이터 처리 대부분을 개발했습니다.

번들 분석으로 첫 화면에서 쓰지 않는 코드의 비중을 확인했습니다. 페이지 코드는 해당 화면에 들어갈 때, Excel 라이브러리는 업로드·다운로드를 실행할 때 불러오도록 변경했습니다.

• 검증

  일반 프로덕션 빌드에서 초기 JavaScript가 2,405.50kB에서 616.60kB로, gzip 기준 815.10kB에서 204.38kB로 줄어든 것을 확인했습니다. 변경 후에도 페이지 이동·데이터 조회·Excel 처리·PC 라벨 출력이 이어지는지 확인했습니다.

화면에서 보이는 배치만으로 인쇄 품질을 판단하지 않았습니다. 긴 주소를 실제 폭에 맞춰 나누고 글자 크기와 간격을 조절했습니다.

• 검증

  실제 용지에 출력해 긴 주소가 잘리거나 다른 항목과 겹치는 부분을 확인하고 보정했습니다.

첫 진입에 필요한 코드의 크기를 줄이고, 운영 화면에서 선택한 데이터를 실제 라벨로 출력하는 흐름을 정비했습니다.

초기 JavaScript 파일 크기

2,405.50 → 616.60 kB

2026.05 빌드 산출물 기준 약 74% 감소

gzip 압축 크기

815.10 → 204.38 kB

초기 JavaScript 파일의 압축 크기 약 75% 감소

실기기 로그를 따라가 연결 과정에서 SDK가 기기 검색을 중단하는 동작을 확인했습니다. 이 동작에도 검색 권한이 필요해, 연결 권한뿐 아니라 검색 권한까지 점검하도록 수정했습니다.

• 검증

  Android 16 실기기에서 권한 요청, 프린터 연결, 실제 라벨 출력을 차례로 확인했습니다.

SDK의 성공 응답은 요청 접수로 해석하고 화면에 “출력 요청 전송”으로 표시했습니다. 실제 용지가 나왔는지 확인할 수 없는 상태에서 인쇄 완료로 단정하지 않았습니다.

• 검증

  SDK 응답과 실물 출력 결과를 각각 확인해 앱이 표시하는 상태의 의미를 맞췄습니다.

React Native 화면에서 Android 네이티브 SDK를 호출해 라벨을 출력하고, 권한과 연결 실패를 구분해 처리했습니다.

선택 중인 계좌·종목과 목록 조회에 적용한 조건을 따로 관리했습니다. 필터를 바꾸는 중에는 기존 목록을 유지하고, 조회 버튼을 누르면 제출한 조건으로 TanStack Query의 조회 키를 갱신하도록 구현했습니다.

• 같은 조건으로 다시 조회

  기존 조회를 초기화해 첫 페이지부터 다시 불러오도록 처리.

• 더보기 요청 중복 방지

  다음 페이지가 없거나 이미 요청 중일 때 추가 요청을 보내지 않도록 처리.

• 조회한 지역의 정보 재사용

  같은 지역의 정보를 반복해서 요청하지 않도록 서버 응답을 지역과 정보 종류별로 캐시했습니다. 각 정보의 갱신 주기에 맞춰 보관 시간을 정했습니다.

• 동시에 들어온 요청 묶기

  같은 지역·정보를 조회하는 요청이 동시에 들어오면 진행 중인 요청의 결과를 함께 사용하도록 했습니다. 외부 API에 같은 요청을 중복해서 보내지 않도록 처리했습니다.

현재 날씨와 핵심 예보를 먼저 표시하고, 대기질·특보 등 부가 정보는 응답이 도착하면 채우도록 나눴습니다. 부가 정보가 늦거나 조회에 실패해도 이미 받은 날씨 정보는 볼 수 있습니다.

외부 조회가 실패하면 허용 범위 안에서 이전 값을 표시했습니다. 다만 만료된 ‘특보 없음’은 현재도 특보가 없다는 뜻이 아니므로 조회 불가로 구분하고, 이전에 조회한 특보에는 최근 조회 기준임을 표시했습니다.

• 입력 검사와 미리보기

  선택한 이미지의 파일 형식·용량·해상도를 검사하고, 전송 전에 이미지를 확인할 수 있도록 미리보기를 구현했습니다.

• Android 파일 선택 연결

  WebView에서 이미지나 파일 선택을 요청하면 Android 선택 창을 열고, 선택한 파일을 다시 WebView로 전달하도록 연결했습니다.

파일을 읽는 도중 다른 이미지를 선택하면 이전 작업이 더 늦게 끝날 수 있습니다. 파일 읽기마다 구분 값을 두고 완료 시 현재 선택과 비교해, 이전 이미지의 결과가 새 미리보기를 덮지 않도록 처리했습니다.

• 시트별 문서 편집

  요구사항·기능 정의서·화면 설계서를 시트별 표에서 검토하고 수정할 수 있도록 했습니다. 내보내기 파일에도 사용자가 수정한 표의 내용을 반영했습니다.

• 선택한 내용의 AI 수정

  수정할 시트·셀과 주변 내용을 AI에 함께 전달했습니다. 수정할 범위와 유지할 내용을 구분해, 문서 전체를 다시 생성하지 않고 선택한 부분을 고칠 수 있도록 했습니다.

문서별 생성 상태를 구분해 일부 작업이 실패해도 성공한 문서는 검토할 수 있도록 했습니다. 전체를 다시 생성하지 않고 필요한 문서를 선택해 다시 작성하고 내보내도록 구성했습니다.