현장실측 (FS) — 와이어프레임 (웹)

진입 — SCR-PM-016 프로젝트 상세 [실측] 탭 / 현장실측 하위 탭 중 [현황 대시보드]가 기본 진입

1. 현장실측 하위 탭 — [현황 대시보드]/[실측 데이터 검토] 전환. 현재 프레임은 대시보드 탭이 활성 상태다.
2. 측정 진행률 KPI 타일 — 전체 진행률(%)·완료 개소·측정중·실측 대기 4개 지표. 완료/전체 개소 값에서 파생 산출한다(FR-FS-007).
3. 진행률 바 — KPI의 전체 진행률(%)을 막대로 시각화한다.
4. 완료 영역 표(섹션·동별) — 동(섹션)별 완료 개소/전체 개소/진행률/최근 측정일시. 집계 단위(동/개소)와 표·차트 형태는 §11 TODO(ui-sketch)에서 확정한다.
5. 이상 알림 — 편차 초과·재측정 필요 등 알림 목록. 판정 기준은 항목 종류별 허용오차다(DE24-1 §5.4.31). 알림이 없을 때는 「허용오차를 넘은 측정 항목이 아직 없습니다」로 적는다(#1225).

진입 — SCR-PM-016 프로젝트 상세 [실측] 탭 / 현장실측 하위 탭 [실측 데이터 검토] 전환 (또는 SCR-FS-001 대시보드에서 하위 탭 전환)

1. 검색·상태 필터 — 개소 코드·이름 검색 입력과 상태 드롭다운(전체/검토대기/승인/반려 등, 값 미확정)을 조합해 [검색] 클릭 시 master 목록을 다시 조회한다. 검색은 개소만 찾는다 — 서버 keyword 가 개소 코드·이름 부분일치라 측정자는 걸리지 않는다(2026-08-18 바로잡음, #1021).
2. 내보내기 — 필터링된 실측 데이터를 파일로 내보낸다. 대상 포맷·범위는 미확정.
3. 측정 목록(master 테이블) — 개소·측정일시·상태 컬럼. 행 클릭 시 우측 상세 패널이 갱신되고, 상태값(검토대기·승인 등)은 배지로 표시한다(미확정).
4. 측정 치수 표(detail) — 선택 개소의 라벨별 도면값·실측값·편차 3열. 편차 표시 규칙(강조·임계값)은 미확정.
5. 사진 · 메모 — 모바일에서 올라온 실측 사진 썸네일(빈 슬롯 포함)과 읽기 전용 메모 영역. 축소본은 잘라 채우지 않고 통째로 담아 보이며, 누르면 겹창에 원본이 뜬다(#1457 확정 — 좌우 넘기기·「사진 N / M」 셈·붙은 자리 캡션·[닫기], 지우기는 두지 않는다).
6. 치수 표의 「사진」 열 (#1457 신설) — 항목 한 줄마다 몇 장이 붙었는지 📷N 으로 보인다. 0장도 켜 둔다. 종전에는 이 열이 없어, 사진이 매달려 있어도 표가 아무 말을 하지 않아 검토자가 우연히 줄을 눌러야 발견했다 — 현장에서 찍는 쪽(§12 SCR-FSM-004)은 줄마다 보는데 그것을 보고 판단해야 하는 쪽이 못 보던 자리다. 값은 dims[].attachmentCount 로 이미 응답에 실려 온다(새 서버 작업 없음). 도면 위치 표식(📍)은 #947 몫이라 여기서 다루지 않는다.
7. 정합 점검 — dim_values(JSON)와 ESTIMATE_LINE.dim_values(도면값)를 대조한다. 표시·경고 방식은 §11 TODO에서 확정한다.
8. 검토 액션 — [반려]/[검증]/[승인] 버튼. 라벨·상태값(전체/검토대기/승인/반려 등)은 §11 TODO에서 확정한다. 승인 시 견적/발주 재평가로 이어지는 연동 규칙은 §11 본격 명세에서 확정한다(FR-FS-012).
9. 내측·외측 두 벌 나란히 보기 (#842) — 앱이 치수를 안쪽·바깥쪽 두 벌로 올린다. 두 쪽을 좌우 열로 갈라 놓는다 — 위아래로 늘어놓으면 검토자가 짝을 눈으로 찾아야 한다. 도면값은 안팎 구분 없이 한 벌이고 두 쪽이 그것을 나눠 쓴다. 「안팎 차」 열은 화면이 계산해 보여 주며 저장하지 않는다. 머리말에 그 개소의 재는 쪽(내측만·외측만·둘 다)을 함께 적어 「둘 다 재기로 했는데 한쪽이 아직 안 왔다」와 「애초에 한쪽만 재기로 했다」를 가른다 — 다른 상태인데 줄만 보아서는 구별되지 않는다.
10. 어느 쪽을 쓸지 채택 (#842·#843) — 채택은 [검증] 단계에서 개소 단위로 한 번 고른다(fs_measurement.adopted_side). 항목마다 다른 쪽을 고르면 한 창호의 폭은 내측·높이는 외측이 되어 제작 치수가 서로 다른 면에서 나온다. 「둘 다」로 잰 개소는 채택 없이 승인되지 않는다 — 두 값이 갈린 채 제조로 넘어가면 절단 재계산이 어느 값을 쓸지 알 수 없다. 치수 한 줄을 고르면 오른쪽에 도면 위 찍은 자리·항목 머리(쪽 배지)·값 세 줄·그 항목에 붙은 사진·반대쪽 값이 뜬다(2026-08-07 — 종전 「그림틀·부위」에서 바뀌었다). 목록에는 「사진 없는 편차 초과 항목」 필터를 둔다 — 앱이 사진을 권하기만 하고 막지 않으므로 그런 건이 생기고, 강제는 여기서 사람 판단으로 건다.
11. 특이사항 태그로 거르기 (#847) — 앱이 사진·메모에 붙인 「손상」·「불균형」·「기타」 가운데 하나를 골라 그 태그가 붙은 개소만 남긴다(fs_attachment.issue_tag, 조회 조건 attachIssueTag). 검토자가 급한 것부터 골라내는 동선이다. 태그를 응답에 담기만 하고 거르지 못하면 검토자가 사진을 하나씩 열어 보아야 해서 태그를 붙인 값어치가 사라진다. 목록 행에는 태그를 따로 그리지 않는다 — 걸러서 상세로 들어가 보는 동선이라 「사진 없는 편차 초과 항목」 필터와 같은 방식이다. 상세의 사진·메모에는 태그가 함께 실린다. 태그는 앱에서 필수가 아니라 안 붙은 사진도 있고, 그것은 거르개에 걸리지 않을 뿐 목록에 그대로 나온다.
12. 개소·기간 거르개 (#1021, 2026-08-18) — 개소 고르개는 여러 개소를 함께 고른다(두 주소가 개소를 목록으로 받는다). 기간은 시작일·종료일 두 칸이고 yyyy-MM-dd 로 보내며, 재는 기준은 측정 시각(measured_at)이고 끝 날짜는 그날을 온전히 담는다. 두 칸은 목록 조회와 내보내기에 같은 값으로 실린다 — 화면에서 본 범위가 내려받는 파일에 그대로 담겨야 하기 때문이다. 화면이 받은 결과를 다시 거르는 방식은 쓰지 않는다(목록이 쪽으로 나뉘어 와 지금 쪽만 걸러진다). 시작일이 종료일보다 뒤면 화면이 먼저 막는다. 개소 후보는 GET /api/fs/projects/{projectId}/areas(IF-FS-AREA-001 §5.4.5)에서 나눠 오므로 다 받을 때까지 이어 받아 합친다.