Engineering/2026.03.04/8 min read

리포트 랩으로 분석 품질을 점검하기

피부 분석 결과가 안정적으로 생성되는지 확인하기 위해 리포트 랩과 통계 화면을 만든 기록입니다.

ReportQualityAI

Code notes

코드에서 확인한 구현 포인트

배포 기준 2026.03.04

관련 파일

apps/web/app/admin/report-lab/page.tsxapps/web/app/api/admin/report-lab/runs/route.tsapps/web/app/api/admin/report-lab/stats/route.tsapps/web/lib/report-stability.ts

구현 메모

리포트 랩은 분석 결과를 운영자가 확인할 수 있게 만든 내부 품질 관리 화면이다.

runs, stats, photos, labels처럼 확인 목적별 API를 나눠 한 화면에서 분석 케이스를 추적한다.

민감한 원본 데이터 자체를 설명하기보다, 상태와 품질 흐름을 관찰하는 도구로 기록했다.

분석 기능은 결과 품질이 곧 제품이다

Tangly의 핵심 경험 중 하나는 피부 분석과 리포트다. 사용자는 결과를 보고 루틴이나 제품 선택을 판단하기 때문에, 결과가 흔들리면 제품 전체에 대한 신뢰가 낮아진다.

리포트 랩은 이런 품질을 운영자가 직접 확인하기 위한 내부 도구다. 어떤 분석이 생성되었고, 어떤 상태인지, 사진과 결과가 어떻게 연결되는지를 살펴볼 수 있게 했다.

운영자 관점의 디버깅

개발자는 로그를 볼 수 있지만 운영자는 화면으로 확인해야 한다. 그래서 리포트 랩은 기술적인 세부 로그보다 상태, 사용자 흐름, 결과 확인에 초점을 맞췄다.

문제가 생겼을 때 바로 원인을 단정하기보다, 어떤 케이스에서 결과가 흔들렸는지 찾을 수 있는 관찰 창을 만든 셈이다.

민감한 정보는 남기지 않기

분석 도구는 사용자 데이터와 가까이 있다. 그래서 블로그나 외부 문서에는 내부 식별자, 저장 경로, 접근 방식 같은 세부 정보는 남기지 않는다.

대신 어떤 기준으로 품질을 확인하고, 어떤 운영 흐름을 만들었는지를 기록하는 것이 나중에 다시 보기에도 더 안전하고 유용하다.