FS(현장실측) 앱 와이어프레임로우파이 · 8화면 내용

진입점 · 인증(첫 로그인 또는 PIN 잠금) → 프로젝트 목록·선택 → 도면·개소·섹션 다운로드·오프라인 캐싱(홈 요약 포함)

1. 로그인 폼 — Phase 1 공통 인증 IF-CM-AUTH-001(POST /api/auth/login)을 그대로 쓴다. 기기에 저장된 로그인 정보가 있으면 이 폼을 건너뛰고 PIN 잠금부터 연다 — 앱을 완전히 껐다 켜도 로그인이 풀리지 않는다 (②·③·⑦)
2. PIN 잠금 (pin-lock 상태) — 저장된 로그인 정보가 있으면 프로젝트 목록보다 먼저 PIN 숫자 4~6자리를 받는다. NFR-SC-FS-003 「앱 시작 시 매번 인증」을 이 관문이 받는다. 기기 안에서만 확인하고 서버로 보내지 않는다. 5회 틀리면 30초 잠금 (②·③·⑤)
3. PIN 설정 (최초 1회) — 아이디·비밀번호로 로그인한 직후 그 자리에서 PIN 을 두 번 받아 저장한다. 건너뛰지 못한다 (③·⑤)
4. 다른 계정으로 로그인 — PIN 을 잊었을 때의 유일한 길이다. 저장된 로그인 정보를 지우고 로그인 폼으로 되돌린다. PIN 만 따로 되찾는 길은 두지 않는다 (③·⑤)
5. 프로젝트 카드 목록 — Project.project_id·Project.name 바인딩. 카드를 탭하면 도면·개소·섹션을 다운로드한 뒤 SCR-FSM-007-2 도면 뷰어(평면도)를 곧장 연다 — 여는 도면은 단축 단추와 같은 규칙(#1341)이고, 측정대상 도면이 없을 때만 도면 목록을 연다 (#3995 ②) (③·⑤)
6. 캐시 상태 배지 — Drawing.cached_path 유무. 도면 본문을 받아 두었는지 보여준다 — 받아 둔 도면만 오프라인에서 열린다 (③)
7. 최근 동기화 표시 — Project.last_sync_at (③)
8. 로컬 저장 용량 표시 — "로컬 저장된 데이터 크기 표시"(FR-FS-006) 요구는 있으나 구체 필드는 소스에 없어 미확정이다 (③)
9. 로그아웃 — 프로젝트 목록 머리에 [동기화 현황]과 나란히 둔다. 누르면 확인 창이 뜨고(logout-confirm 상태 — default 에서는 닫혀 있다, #4033 ④), 못 보낸 실측이 있으면 몇 건인지 알리되 로그아웃을 막지는 않는다. 생김새는 시안(#882)·구현(#892)이 정하고 여기서는 자리만 잡는다 (③·⑤)
10. 이 기기 자료 전부 지우기 (#2414 확정) — 로그아웃 확인 창의 두 단추 아래에 따로 떼어 둔다. 누르면 한 번 더 묻고, 앱을 처음 깐 상태로 되돌린다 — 실측값·메모·사진·도면 사본·프로젝트 목록·측정 초안·로그인 증표·PIN·기억한 측정기 주소를 모두 지운다. 서버에 보낸 자료는 서버에 남는다. 못 보낸 실측이 있어도 막지 않고, 건수를 알리며 확인 단추 이름을 「못 보낸 N건까지 지우기」로 바꾼다. PIN 잠금 화면에는 두지 않는다 (②·③·④·⑤)

전역(프로젝트 무관) · 측정기 찾기·연결·자동 재연결(3회) · 측정기 Bluetooth 켜기 안내 · 권한 거절 안내 · 모든 화면 상태바의 BLE 칩에서 진입. 측정기 배터리는 표시하지 않는다(기기가 잔량을 재지 않는다, #2277)

1. 상태바 BLE 칩(현재) — 프로젝트 진입 전후 어디서나 하단(상태바) 칩으로 접근하는 전역 화면이다 (①)
2. BLE 스캔 목록 — 서비스 번호로 걸러 보쉬 측정기만, 신호 강도 -80 dBm 이상만 센 차례로 보인다. 행 이름은 시리얼 뒤 네 자리(「측정기 3812」). 한 대만 잡혀도 저절로 붙지 않고 사람이 고른다 (③·⑤, FR-FS-001, #2277)
3. 연결 상태 카드(device_id) — 연결됨·끊김·약함과 기기 이름(GLM 100-25 C x3812). 앱을 다시 켜면 기억한 측정기에만 저절로 다시 붙는다. 측정기에서 Bluetooth 가 켜져 있어야 붙는다. 카드 아래 글 「측정기에서 Bluetooth를 켜 두면, 앱을 다시 켤 때 이 측정기에만 연결합니다」가 이 조건과 요점을 함께 담는다 (③·④·⑤, #2311)
4. 측정기 Bluetooth 켜기 안내(meter-not-found) — 스캔 6초 안에 측정기가 없거나 재연결 3회가 모두 실패하면 뜬다. 뜬 뒤에도 계속 찾아 보이면 저절로 붙는다 (④·⑤, #2277)
5. 권한 거절 안내(permission-denied) — 처음 들어와 권한 대화상자에서 [허용 안 함] 을 누르거나 이미 거절된 채로 들어오면 뜬다. 빈 목록과 [다시 검색] 은 보이지 않는다(두 번 거절하면 안드로이드가 다시 묻지 않아 그 단추가 먹통이 된다). [설정에서 허용] 은 늘 이 앱의 설정(권한) 화면을 연다 — bluetooth-off 의 [설정에서 켜기] 가 단말 Bluetooth 설정을 여는 것과 다르다. 돌아와 권한이 있으면 곧바로 다시 찾는다 (④·⑤, #2289)
6. 다른 화면에 있을 때 — 이 안내 화면을 띄우지 않는다. 그 화면에 토스트 「측정기를 찾지 못했습니다. 측정기에서 Bluetooth를 켜 주세요」를 한 번 띄우고, 하단 전역 칩을 「측정기 못 찾음」으로 바꾼다. 칩을 누르면 이 화면으로 온다. 상단 토글에서 meter-not-found 를 누르면 SCR-FSM-004 에서 볼 수 있다 (⑤, FR-FS-009, #2277)

프로젝트 하위 · 개소별 업무상태 리스트 — SCR-FSM-007 도면 뷰어의 리스트형 대체 진입(fallback)

1. 필터 칩(부호별) — Section.section_code 기준 부호별 필터, 다중 선택 가능, 기본값 "전체". 칩 줄 이름표는 「부호」다 — 동·층은 태그가 맡는다(#3604, 앱 반영 #3622) (③·⑤, FR-FS-003)
2. 개소 리스트 행 — Area.label. 행을 한 번 탭하면 곧장 SCR-FSM-004로 이동한다. 목적지는 SCR-FSM-007 마커 탭과 같으나 걸음 수가 다르다 — 도면 뷰어는 두 걸음이고 이 목록은 한 걸음이다. 목록에는 겹쳐 눌릴 마커가 없어 헛짚을 자리가 없기 때문이다(#1370) (③·⑤)
3. 업무상태 배지 — Area.biz_status. 배색은 SCR-FSM-007이 정한 규칙을 재인용한다 — 업무상태 여섯을 색 셋으로 옮긴다. 🔄 2026-10-28 #4082 결정: 실측대기·재측정은 빨간색 X, 완료·검증완료·승인완료는 초록색 O, 측정중은 파란색 그대로다. 실측대기와 재측정은 딱지 글자로 가른다(⏳ 시안·앱 반영 전). 재측정은 빨강이 아니라 회색(2026-08-14 · #1361) 은 뒤집혔다 (⑤)
4. 정렬 옵션 — 개소명·진행 상태·측정 시간순 정렬을 제공한다 (③, FR-FS-003)
5. 진행률 바 자리 — 프로젝트별·동별 진행률(파생 표시) — "진행률 바 표시" 요구만 있고 구체 필드는 소스에 없다. 거르개를 고르면 거른 결과로 센다(#3604) (③, FR-FS-003)
6. 묶음 칩·태그 칩 — 개소 행에 묶음 차수(「1차」, 응답 batchSeq)를 테두리 칩으로 달고, 둘째 줄에 태그(응답 tags[])를 두 개까지 보인 뒤 「+N」으로 줄인다. 묶음 거르개는 차수가 둘 이상일 때만, 태그 거르개는 태그가 있을 때만 둔다. 태그를 여럿 고르면 모두 가진 개소만 남는다(#3604 결정, 서버 반영 #3621·앱 반영 #3622). 거르개 줄 차례는 업무상태 · 태그 · 부호 · 차수다(#3704) (③·⑤)
7. 더 거르기 줄 — 거르개 접기 (#3752 결정, 앱 반영 #3754) — 업무상태 줄은 늘 펼쳐 둔다. 거르개 줄이 셋 이상이면(태그 줄이나 차수 줄이 생기면) 태그 · 부호 · 차수 줄을 「더 거르기」 한 줄로 접고, 처음 열 때 접힌 채 보인다. 접힌 줄에는 걸어 둔 조건 수(「더 거르기 2」)와 조건마다 요약 칩(「태그 101동」 ×)을 보인다 — ×는 그 조건 하나만 푼다. 걸어 둔 조건이 없으면 「태그 · 부호 · 차수 — 전체」를 흐린 글자로 적는다. 이름표는 칩 줄 맨 앞에 두어 한 줄이 칩 하나 높이다. 접힌 때 거르개 자리는 칩 두 줄 높이를 넘지 않는다. 펼친 모습은 상태 토글 filters-open 에서 본다 (③·⑤)
8. 상태 — 번호 미정 (blocked · #4000 · 앱 반영 #4031) — 개소 받기가 409 AREA_SERIAL_UNASSIGNED 로 막히면 위쪽에 띠 「번호 미정 N개 — 사무실(제작도팀)이 평면도 대조 검증에서 번호를 채우면 받을 수 있습니다」를 둔다. 받아 둔 목록·실측·보내기는 그대로다. 이 두 줄짜리 띠는 이 목록에만 둔다 — 도면 뷰어에는 알림 줄 한 줄만 둔다(#4054 결정) (④)

개소 하위 · 재는 쪽(내측만·외측만·둘 다) 먼저 고르기 + W·H 기본 + 보조 라벨 자유 추가, 선택→측정→자동입력(BLE) 순차, 수동 입력 상시 병행, 실측 허용치(mm, 시스템 설정 FS — 개구부 기본 5mm · 대각 기본 10mm) 검증(도면값 있는 항목 · 종전 ±10%, ✅ 앱 반영 #2845), 재측정 · 미서기 개소는 환풍구 유무·위치(모듈→코너) 지정 + 환풍구 가로·세로 자동 항목 · 항목마다 사진·도면 위치 남기기(선택)

1. 재는 쪽 고르기 (#842) — 측정 항목 목록보다 먼저 「내측만·외측만·둘 다」를 고른다(fs_measurement.side_mode). 고른 값에 따라 항목 목록이 만들어진다 — 「둘 다」면 W·H·보조 항목이 두 벌로 늘고 환풍구 가로·세로는 한 벌 그대로다. 개소 단위로 남기는 까닭은 「둘 다 재기로 했는데 한쪽이 아직 안 왔다」와 「애초에 한쪽만 재기로 했다」를 사무실이 가를 수 있어야 해서다 (③·⑤)
2. 항목별 쪽 배지 (#842) — 항목 줄마다 내측·외측 배지가 붙는다(fs_meas_dim.dim_side). 도면값은 안팎 구분 없이 한 벌이고 두 줄이 그것을 나눠 쓴다 — 도면값은 「만들 창호의 치수」라 개구부를 어느 면에서 쟀느냐와 축이 다르기 때문이다. 편차는 두 줄에서 각각 계산돼 각각 편차 경고를 받는다. 내측값과 외측값이 다른 것 자체는 경고가 아니다 — 어느 쪽을 쓸지는 사무실 검토(SCR-FS-002)가 정한다 (③·⑤)
3. 사진·위치 열 — 항목 줄마다 붙은 사진·메모 수와 도면 위치 표시 여부를 한 자리에서 보인다. 붙은 것이 없으면 📷0, 위치를 안 찍었으면 ○ 다. 둘 다 선택이다 — 없어도 저장·전송된다 (③·⑤)
4. 도면 위치 찍기 (2026-08-07 결정) — 📍 를 누르면 도면 태깅 전용 화면(SCR-FSM-009)이 전체화면으로 열린다. 개소에 달린 도면 가운데 하나를 골라 원도면 그대로 위에 찍는다. 저장 전에도 찍을 수 있고 로컬에 쌓였다가 측정과 함께 올라간다. ⛔ 종전 「그림틀」(앱이 그리는 창호 사각형에서 상·중앙·하를 고르던 방식, #843)은 폐기했다 — 그 그림은 미서기 연창 격자로만 그려져 커튼월 같은 다른 구조에서 쓸 수 없다 (③·⑤)
5. 측정 항목 리스트 — W(폭)·H(높이) 기본 상시 + 보조 라벨(사용자 추가). 데이터 바인딩 MEAS_DIM.dim_type을 사용자 정의 라벨로 확장(기존 W/H/대각선 고정 라벨에서 확장 — 구조설계 반영 후속 필요) (③)
6. 항목 선택(arming) — 행을 탭하면 그 항목이 "측정 대기"로 하이라이트된다(한 번에 하나만 선택) (③·⑤)
7. 측정 버튼 — 선택된(armed) 항목에 대해 BLE 측정을 트리거하고, 수신값(StandardMeasurement{dimType,value_mm,ts})이 그 항목에 자동 입력된다. 다음 항목을 다시 선택→측정→자동입력하는 순차 흐름이다 (⑤, FR-FS-002)
8. 수동 입력 필드 — 어느 항목이든 BLE 연결 여부와 무관하게 키보드 또는 음성으로 항상 입력할 수 있다(BLE는 보조 수단) (③·⑤, FR-FS-002)
9. 측정 카드 · [음성 입력] 자리 (📌 #4044 결정 · ⏳ 시안·앱 반영 전) — 측정기가 붙어 있을 때만 「재는 쪽」 아래에 측정 카드를 둔다. 고른 항목 이름·도면값과 잰 값을 큰 숫자로 보이고, 그 아래 한 줄에 [측정기로 재기](넓은 쪽) · [음성 입력](좁은 쪽)을 나란히 둔다. 들은 값은 고른 항목에 들어가 큰 숫자가 바로 바뀐다. 측정기가 없으면 카드가 없고 [음성 입력] 은 표 아래 직접 입력칸 옆이다 — 한 화면에 하나만 둔다. 인식은 지금처럼 안드로이드 말 알아듣기 창이다. 앱 안에서 듣고 입력칸 아래 한 줄에 「듣는 중…」·「들은 말 → 숫자」(#3995 ③) ⛔ 뒤집힘(#4044). 메모 음성(SCR-FSM-005)은 그대로다 (③·⑤ 「#4044 결정」)
10. 알림 두 줄로 줄이기 (📌 #4044 결정) — 측정기 미연결이면 노란 상자를 두지 않고 직접 입력칸 이름표 옆에 작은 글 「측정기 없이도 저장됩니다」만 둔다(연결 상태는 상태막대 「미연결」 칩). 기준값이 없으면 「기준값 없음 — 부호 설계 미확정」 제목 한 줄만 둔다(상태 no-baseline). 목표는 측정기 미연결 · 기준값 없음일 때 처음 화면에 표의 항목 세 줄 이상이다 (④·⑤ 「#4044 결정」)
11. + 보조 수치 추가 — 사용자가 라벨을 직접 입력해 행을 늘리거나 삭제한다(예: 대각선·W1·W2·H1·H2). 도면 기준값이 없는 보조 항목은 편차를 표시하지 않는다(도면값을 별도 입력하면 계산 — 확정 필요) (③·⑤)
12. 측정 내역 (회차별, 📌 #4083 결정 · ⏳ 서버·시안·앱 반영 전) — 동일 개소 재측정 시 새 측정 세션으로 이력이 누적된다 — 덮어쓰기가 아니다. 표 아래 [저장] 위에 접힌 한 줄 「측정 내역 N회 ⌄」을 두고, 펼치면 회차를 최근 것부터 한 줄씩(회차 「1회차 · 최초」·「2회차 · 재측정」 · 일시 · 잰 사람 · 폭·높이 · 상태) 보인다. 회차 줄을 누르면 항목별 값과 반려 사유를 연다. 다른 폰·앞사람 회차는 서버(IF-FS-MEAS-002 목록 areaIds·상세)에서 받고, 신호가 없으면 이 폰에 남은 회차와 받아 둔 회차만 보이며 「일부만 보임」을 단다. 머리 줄 아래 「최초 측정」/「재측정 · N회차」 딱지, 앞 회차 값을 되채웠으면 표 위 알림 한 줄과 회색 글자. 이 폰에 남은 회차만 「재측정 이력 N회 · 시각…」 한 줄 ⛔ 뒤집힘(#4083) (③·④·⑤ 「#4083 결정」)
13. 되돌아온 개소 띠와 반려 사유 (#1449 신설) — returned 갈래다. Area.biz_status = 재측정 인 개소로 들어오면 3열 표 위에 되돌아온 건임을 알리는 띠를 두고 사무실이 적은 반려 사유를 그대로 보인다. 현장에서 다시 잴 때 읽어야 하는 글이라 동기화 현황(SCR-FSM-008)에만 두지 않는다 — 두 화면을 오가며 외우게 하지 않으려는 것이다. 낫표로 묶어 그대로, 석 줄까지 보이고 넘치면 그 줄을 눌러 편다. 사유가 없으면 띠는 그대로 두고 사유 줄만 비운다. 입력도 저장도 막지 않는다 (③·④·⑤)
14. 환풍구 유무 토글 — 개소 제품이 미서기창일 때만 노출. 기본 꺼짐, 켜면 아래 위치 지정 2단계가 열리고 측정 항목에 환풍구 가로·세로가 자동 추가된다 (③·⑤)
15. 옆 칸 폭(자동 항목, #2295) — 부호 기준값에 LEAF_WIDTH 가 오면(3편창·편 제품) 「옆 칸 폭」 줄이 스스로 선다. 도면값이 있어 다른 정형 항목처럼 편차 경고를 받고(개구부 허용치), 재는 쪽이 「둘 다」여도 한 벌이다(칸 나눔은 창 안의 치수). 줄 이름 옆에 도면·원장 표기 W1 을 작게 붙인다. 보조 항목 「W1」 을 따로 만들지 않는다 — 보조 항목은 절단 재계산에 들어가지 않는다. 서버 반영 전 (③·⑤)
16. 커튼월 부호의 도면값(#2969) — 부호 기준값 출처가 FRAME 이면 도면값은 커튼월 틀 폭·높이다. 측정 표 위에 「도면값: 커튼월 틀 치수」를 작게 적고 다른 부호처럼 편차를 낸다. 같은 부호의 칸 안 미서기 개소도 틀과 견주어 경고가 뜰 수 있다(알려진 한계 — 앱은 개소가 이은 라인을 모른다). 서버·앱 반영 전 (⑤)
17. 환풍구 위치 1단계(모듈) — 미서기 연창 격자(OPT-LAY, 제품 설계정보)를 그리드로 보여주고 환풍구가 들어갈 모듈을 고른다 (③·⑤)
18. 환풍구 위치 2단계(귀퉁이) — 선택 모듈의 편창 칸(좌창/우창, 3편창이면 좌·중·우)별 4코너(좌상·좌하·우상·우하)를 체크박스로 지정한다. 여러 곳 동시 가능, 2편창=8·3편창=12 선택지. 편창 칸 수·격자는 제품 설계정보에서 온다 — 스키마 확정 후속 갭 (③·⑤)
19. 실측일 (#3203 ④ · ⏳ 앱 반영 전) — 날짜 고르개 한 칸. 기본값은 오늘이고 그대로 두면 저장 순간의 시각이 실측일시다. 날짜를 고치면 고른 날짜에 저장 순간의 시:분:초를 붙여 measuredAt 으로, 저장 순간은 recordedAt 으로 따로 보낸다. 오늘 뒤 날짜는 막고 지난 날짜에는 한도가 없다. 고쳤으면 칸 옆에 「오늘과 다름」을 작게 적는다 (③)
20. 편차 초과 팝업과 「그대로 저장」 안내 (#1598 · 안내 📌 #3603 결정 2026-10-19 · ✅ 앱 반영 #3624) — 진입: 이 화면에서 편차가 허용치를 넘은 줄이 있는 채 [저장] 을 누른 순간 화면 아래에 한 번 뜬다(잴 동안에는 뜨지 않는다). 머리 글 「편차 ±{N}mm 를 넘었습니다」(N 은 그 줄에 쓴 허용치) + 넘은 줄 목록, 그 아래·두 갈래 단추 위에 안내 「현장이 실제로 다르면 그대로 저장하세요. 저장한 값으로 바로 제작에 들어갑니다. 다시 재면 새 값이 반영됩니다.」(📌 사용자 결정 2026-10-20 (#3704 후속, #3624) — 「현장이 실제로 다르면 그대로 저장하세요. 저장하면 바로 확정되고, 제작팀이 표시를 보고 연락합니다.」 ⛔ 뒤집힘 · 📌 2026-10-20 #3705 · 10-20 회의 「확인 절차 없음」에 맞춤, ✅ 앱 반영 #3624 — 「… 사무실이 확인하고 승인합니다.」 ⛔ 뒤집힘), 단추 [다시 측정]·[그대로 저장] 과 [이 항목 사진 남기기]. 편차를 넘은 개소는 대개 위치마다 실제로 크기가 다른 곳이라 측정자가 같은 곳을 거듭 다시 재지 않게 하려는 안내다 — 현장담당이 올린 회차는 저장 때 곧바로 승인완료가 되고, 웹 실측 검토 목록(SCR-FS-002, fs-web.html)에 편차 표시만 남는다. 사무실은 같은 부호끼리 공통 사유로 승인한다. ⛔ 뒤집힘 (#3705). 표 아래 판은 편차가 넘어 있는 동안 늘 알리고 확인은 받지 않는다. 저장은 막지 않는다 (⑤)
21. 일람표 칸 그림 (#3979 결정 · ✅ 서버·앱 반영 #3989·#3990 · 📌 자리는 #4044) — 머리 줄(개소 이름 · 부호) 오른쪽에 그 부호의 창호일람표 칸을 높이 48dp 로 작게 그린다. 화면 맨 위 한 줄, 높이 96dp 뒤집힘(#4044). 누르면 큰 화면(상태 schedule-full)이 이 화면 위에 겹쳐 뜬다 — 머리 「{부호} 일람표」 + [닫기], 두 손가락으로 키우고(1배~12배) 한 손가락으로 옮기며 두 번 누르면 처음 크기, 아래 안내 「두 손가락으로 키우고 옮길 수 있습니다」. 그림은 서버 그림이 아니라 받아 둔 일람표 선 도면에서 그 부호 칸(canvasCropRect ÷ 일람표 축척)만 다시 그린 것이라 키워도 뭉개지지 않는다. 위치를 모르거나 일람표 본문이 없으면 자리를 아예 두지 않는다 (③·⑤ 「#3979 결정」)

측정 하위 · 개소·측정 부속정보(선택) · 개소 완료(들어온 자리로 되돌림)·뒤로(실측 입력)

1. 사진 썸네일 슬롯 — PHOTO. 최대 5장, 업로드 전 최대 2MB/장으로 자동 압축한다. 썸네일을 누르면 크게 보기 겹창이 뜬다 (#1417 신설) — 어두운 전체 바탕에 사진 한 장(긴 변 1440화소)과 [지우기]·[닫기] 를 두고, 사진 바깥을 눌러도 닫힌다. ➕ 캡션 줄 아래·단추 줄 위에 「무엇이 문제인가」 칩 넷과 「한 줄 설명」 입력칸(최대 500자)을 둔다 (#1517 확정) — 지금 보는 사진의 값을 보이고, 고치면 그 사진에만 담기며, 좌우로 넘기면 두 칸도 그 사진의 값으로 바뀐다. 화면 번호를 따로 주지 않고 이 화면의 상태(photo-viewer)로 둔다. 지우기는 크게 보기 안에만 있고 한 번 되묻는다 — 목록 칸에는 지우기를 두지 않는다(장갑 낀 손으로 잘못 눌러 사진을 잃는 것을 막는다) (③·④·⑤, FR-FS-010)
2. 개소 완료·뒤로 버튼 (#1417 확정) — [개소 완료](종전 「저장」)는 이 개소를 마치고 들어온 자리로 되돌린다 — 개소 목록(SCR-FSM-003)에서 들어왔으면 목록으로, 도면 뷰어(SCR-FSM-007)에서 들어왔으면 뷰어로 간다. [← 뒤로]는 측정값을 고치러 실측 입력(SCR-FSM-004)으로 돌아간다. 이 화면에는 저장할 것이 남아 있지 않아 「저장」이라는 이름을 걷었다 — 측정값은 SCR-FSM-004 가 이미 저장했고, 사진은 붙일 때마다 곧바로 담기며, 메모는 어느 쪽으로 나가도 담긴다. 부속정보는 선택이라 사진·메모 없이 눌러도 된다 (③·⑤)
3. 카메라·갤러리 버튼 — 촬영 또는 갤러리에서 선택한다 (③, FR-FS-010)
4. 메모 입력 — MEMO. 최대 500자, 텍스트 또는 음성→텍스트 변환을 지원한다(장갑 착용 대응) (③·⑤, FR-FS-011)
5. 무엇이 문제인가 — 태그 고르기 (#847) — 「손상」·「불균형」·「기타」 셋 가운데 하나를 고른다(fs_attachment.issue_tag, 저장 값은 DAMAGE·IMBALANCE·OTHER). 비워 둘 수 있다 — 기본값이 「없음」이라 안 골라도 저장·전송된다. ➕ 사진 크게 보기에도 같은 칩을 그대로 둔다 — 이름을 나누지 않는다 (#1517 확정). 찍기 전(이 자리)과 찍은 뒤(크게 보기) 어느 쪽에서도 값을 보고 바꿀 수 있고 두 자리가 같은 값을 함께 쓴다. 셋을 고정하고 늘리지 않으며, 안 맞는 것은 「기타」가 받는다. 둘이 함께 보이면 사진을 한 장 더 붙인다 — 여러 개를 받으려면 중간 표가 필요한데 검토자가 「무엇이 문제인가」를 아는 데는 하나로 충분하다. 사진과 메모가 같은 칸을 쓴다. 사무실 검토(SCR-FS-002)가 이 태그로 목록을 거른다 (③·⑤, FR-FS-011)
6. 촬영 시간 메타 자리 — 사진 메타정보로 촬영 시간을 자동 기록한다(fs_attachment.taken_at, 단말 로컬 시각). 서버가 받은 시각은 created_at 에 따로 남는다 (③)
7. 사진 한 줄 설명 (#847 · #1417 확정 · #1517 로 자리 옮김) — 사진마다 한 줄 적는 칸을 둔다. 자리는 이 화면 아래 입력 칸이 아니라 사진 크게 보기(photo-viewer) 안이다 (#1517 확정) — 아래 칸에 두면 [촬영]을 누르는 그 순간의 값만 붙어 찍은 뒤에 적은 글이 사라진다. 크게 보기 안의 칸은 지금 보는 사진의 값을 보이고 좌우로 넘기면 그 사진의 값으로 바뀐다. 칸은 태그와 상관없이 늘 보인다 — 태그가 「기타」일 때만 「무엇인지 한 줄 적어 주세요」 안내 문구가 더 붙는다. 갈리는 것은 안내이지 칸이 아니다(#1417). 「기타」일 때만 칸을 보이면 「손상」·「불균형」을 고른 사진에 설명을 붙일 자리가 없어진다. 비어 있어도 저장된다 — 사진 자체가 이미 무엇을 찍었는지 보여 준다. 새 칸을 만들지 않고 메모가 쓰던 fs_attachment.memo_text 를 사진 행에서도 쓴다 — 2000자 칸이 이미 있고 검사 제약이 사진 행의 메모 글을 막지 않는다. 글자 수 제한은 메모와 같은 500자다 (③·⑤)
8. 무엇을 찍었나 — 측정 항목 잇기 (#843) — 사진·메모 하나에 측정 항목 하나를 잇는다(fs_attachment.meas_dim_id). 고르개에는 그 개소의 측정 항목이 화면에 보이는 그대로(항목 이름 + 쪽 배지) 나열되고 맨 위에 「개소 전체(항목 없음)」가 있다. 기본값이 「개소 전체」라 아무것도 고르지 않아도 종전과 똑같이 저장된다. 사진 한 장은 항목 하나만 가리키고, 한 항목에 사진 여러 장은 된다. 사진 위에 화살표·동그라미를 찍지 않는다 — 좌표 칸을 새로 만들어야 하고 장갑 낀 손으로 사진 위 한 점을 찍는 것이 느리다. SCR-FSM-004 의 편차 초과 줄에서 [사진]을 눌러 들어오면 그 항목이 미리 골라진 채 열린다 — 강제가 아니라 권함이다 (③·⑤)
9. 동기화 대기열 등록 — 네트워크가 연결되면 사진·메모가 측정 자료와 함께 자동으로 동기화 대기열에 들어간다 (⑤)
10. 항목별 모아보기 (2026-08-07 신설) — 개소 전체 사진 묶음 위에 그 개소의 측정 항목(fs_meas_dim)을 줄줄이 늘어놓고 줄마다 📷 붙은 사진·메모 수와 📍 도면 위 위치 여부를 붙인다. 비어 있는 줄은 「비었음」으로 눈에 띄게 한다 — 어느 항목이 비었는지 현장을 뜨기 전에 채우라고 두는 자리다(사무실에서 되묻는 것을 줄이는 것이 이 요구의 목적이다). 줄을 누르면 그 항목이 「무엇을 찍었나」 고르개에 골라진 채로 사진을 붙일 수 있다. 강제는 아니다 — 비어 있어도 저장·전송된다(「저장을 막지 않는다」 원칙). 측정 항목이 하나도 없으면 상태 empty 로 「아직 잰 항목이 없습니다」를 적고 개소 전체 사진 묶음만 보인다 (③·④·⑤)

단말 설정 · 로컬 저장·배치 push 동작·정책 · SCR-FSM-008 동기화 현황의 [저장·동기화 설정] 에서 진입 (#881 4단계 결정)

1. 동기화 상태 표시 — MEASUREMENT.sync_status(draft/pending/synced/failed) (③)
2. 로컬 저장 건수 표시 자리 — 최소 500건 이상 보관 — 구체 표시 필드는 소스에 없어 미확정이다 (③, FR-FS-004)
3. 로컬 저장 항목 리스트 — 전송완료 항목을 보여준다 (③)
4. 일괄 전송 버튼(배치 push) — 네트워크 복구 시 백그라운드에서 자동 동기화하며, gzip 압축 배치 최대 500건을 30초 이내 완료 목표로 한다 (⑤, NFR-PF-FS-003)
5. [보낸 자료 정리] (#1436 확정) — 손으로 지우는 자리를 이 화면에 둔다. 누르면 전송이 끝난 건의 사진만 지우고 측정값·메모는 남긴다. 지우기 전에 한 번 되묻고, 그 창에 「사진 N장을 지웁니다 · 측정값과 메모는 그대로 둡니다」를 적는다. 시안 f006 의 「더보기에서 고릅니다」는 따르지 않는다 — 이 화면 위 막대에 더보기 단추가 없다 (③·⑤)
6. 저절로 지우기 (#1436 확정) — 사진은 전송이 끝나고 30일이 지나면 저절로 지운다. 측정값과 메모는 저절로 지우지 않는다 — 지우면 앞 회차 값 되살리기와 재측정 이력이 함께 없어진다. 이쪽은 되묻지 않고 규칙을 이 화면에 글로 적어 둔다 (③·⑤)
7. 지워진 사진 자리 (#1436 확정) — 사진을 지운 자리는 비우지 않고 「기기에서 지웠습니다 — 사무실에서 볼 수 있습니다」로 적는다. 빈 자리로 두면 「사진을 안 찍었다」로 읽힌다 (③)
8. 재시도 정책 — 전송이 실패하면 간격을 늘려 가며(지수 백오프, 첫 대기 30초) 처음 보내기를 포함해 자동 5회까지 보낸다. 5회째도 실패하면 멈추고 「전송 실패 — 다시 보내기」로 안내한다 (⑤, NFR-RL-FS-003 · #4114)

측정 항목 하위 · 2026-08-07 신설 — 측정 항목 하나가 원도면 어디를 잰 값인지 도면 위에 직접 찍는 전체화면. SCR-FSM-004 항목 줄의 📍 로 들어와 찍거나 그만두면 그 자리로 되돌아온다 · 개소에 달린 도면 가운데 하나를 골라 길게 눌러 한 점 · 찍은 자리는 도면 mm 로 보인다

1. 머리말 — 무엇을 찍는 중인가 — SCR-FSM-004 가 넘긴 항목 이름과 쪽 배지를 그대로 잇는다(예 「내측 W(폭)」). 어느 줄에서 눌러 들어왔는지 잊지 않게 하는 자리다 (③)
2. 도면 고르개 — Drawing.drawing_id·Drawing.file_name. 개소에 달린 도면에서 한 장을 고르고 그것이 fs_meas_dim.tag_drawing_id 가 된다. SCR-FSM-007 도면 목록이 쓰는 그 목록을 그대로 쓴다 — 이 화면 전용 조회를 새로 만들지 않는다. 처음 열 때는 그 개소 마커가 찍혀 있는 도면을 미리 골라 둔다 (③·⑦)
3. 도면 캔버스(전체화면) — Drawing.cached_path(받아 둔 선 도면 본문)·Drawing.bounds_*(도면 범위 mm). 원도면 그대로 그리고 개소 마커를 함께 얹어 「이 개소가 어디인가」를 잃지 않게 한다 — 앱이 선 도면을 직접 그리는 것이고 서버가 미리 그려 둔 그림을 얹는 것이 아니다. 손가락 두 개로 확대·축소, 더블탭으로 기본 배율 — SCR-FSM-007 도면 뷰어와 같은 조작이다 (③·⑤)
4. 찍은 점 — 길게 눌러 찍는다 — fs_meas_dim.tag_x_mm·tag_y_mm. 짧게 누르기와 끌기는 팬·줌이 이미 쓰고 있어 길게 누르기 하나만 찍기에 배정한다. 한 항목에 한 점이고 다시 찍으면 앞의 점이 옮겨 간다 — 여러 자리를 남기려면 측정 항목을 줄로 늘려 각각 찍는다 (③·⑤)
5. 찍은 자리 좌표 — 도면 mm — X 12,340 Y 8,720 처럼 도면 mm 로만 적는다. 화면 픽셀은 사용자에게 보이지 않는다 — 확대 배율에 매달린 값이라 적어 두면 뜻이 없다. ⚠️ 좌표계는 도면좌표이고 개소 마커·부호 배치와 같은 축이다. 견적설계가 영속 저장에 쓰는 배치 좌표(ESTIMATE_LINE.canvas_x_mm)도 같은 도면좌표라 섞어도 밀리지 않는다(#962 결정). 섞지 말아야 할 상대는 화면 픽셀(캔버스좌표) 이다 — 줌·팬에 매달린 값이라 도면 mm 로 환산하지 않고 쓰면 줌 배율만큼 어긋난 자리에 찍힌다. 다만 눈금자 section_dimension.offset_mm 는 섹션좌표로 영속하는 예외다 (③·⑤)
6. [지우기]·[확인] — [지우기]는 도면 번호·X·Y 셋을 함께 지운다. [확인]은 찍은 자리를 그 항목 줄에 붙이고 004 로 돌아가며, 점을 안 찍었으면 잠근다 — 도면만 고른 상태는 찍은 자리가 없는 것과 같다 (③·⑤)
7. [✕ 닫기] — 아무것도 바꾸지 않고 004 로 돌아간다. 찍다 만 점은 버린다. 이 화면은 저장하지 않는다 — 좌표는 로컬에 쌓였다가 004 의 저장·전송 때 측정과 한 요청으로 함께 올라간다 (②·⑤)
8. 왜 전용 전체화면인가 — 폰에서 측정 표와 도면을 함께 띄우면 창 한 짝이 점 하나만 하게 그려져 장갑 낀 손으로 못 찍는다. 전체화면이면 크게 확대해 찍을 수 있어 터치 대상 최소 48dp 요구(NFR-US-FS-001)를 지킨다 — 그것이 이 화면을 따로 세운 유일한 까닭이다 (①)
9. 상태 — loading — 고른 도면의 본문을 아직 받는 중. 「도면 받는 중…」 (④)
10. 상태 — offline — 네트워크 단절(NFR-RL-FS-001, 5초 내 자동 감지). 캐시된 도면만 고르개에 남기고 안 받아 둔 도면은 「내려받지 않음」으로 잠근다. 캐시된 도면에서는 찍기가 그대로 된다 (④)
11. 상태 — empty — 이 개소에 딸린 도면이 0건. 찍을 자리가 없으므로 캔버스를 그리지 않고 [✕ 닫기]만 둔다 (④)
12. 상태 — error(도면 범위 없음) — 받아 둔 본문에 도면 범위(bounds)가 없거나 무한대라 mm 를 낼 수 없다. 찍기를 잠근다 — 그럴듯한 엉뚱한 mm 를 내놓는 것보다 못 찍는 편이 낫다. 절취 사각형·배율 메타는 어느 응답에도 오지 않아 막는 조건이 아니다(2026-08-14 실측) (④·⑤)

전역 · pending/failed 목록·수동 재시도 · 모든 화면 상태바의 동기화 칩에서 진입

1. 상태바 동기화 칩(현재) — 모든 화면 상태바의 동기화 칩에서 진입하는 전역 화면이다 (①)
2. pending 목록 — MEASUREMENT.sync_status=pending. 서버에 아직 전송되지 않은 대기 중 실측 건을 보여준다 (③)
3. failed 목록 + 재시도 버튼 — sync_status=failed(자동 5회 시도 후 실패). 버튼을 누르면 해당 건을 즉시 재전송한다 (③·⑤, NFR-RL-FS-003)
4. 재측정 배지 자리 — Area.biz_status=재측정. 서버 검증 실패·거절(FCM 수신) 시 완료→재측정으로 역행한다. 배지는 빨간색 X 다(🔄 2026-10-28 #4082 — 종전 회색 #9E9E9E 를 뒤집었다) — 「다시 재야 하는 개소」는 아직 안 잰 실측대기와 할 일이 같아 같은 색으로 두고 글자로 가른다(SCR-FSM-003 ⑤ 「뒤집힘 2026-10-28」 상자 · SCR-FSM-007 ⑤ 마커 색 표) (③·⑤, FR-FS-008)
5. 되돌아온 건 카드 (#1449 신설) — Area.biz_status = 재측정 인 개소를 카드로 보인다. 줄 차례는 ① 개소 이름과 「재측정」 딱지 ② 「사무실이 반려했습니다 · 다시 재 주세요」 ③ 마지막 회차의 편차 ④ 반려 사유 다. 사유는 GET /api/fs/measurements/{measurementId} 의 rejectReason 이고 낫표로 묶어 그대로 보인다 — 앱이 줄이거나 바꿔 적지 않는다. 사유가 없으면 그 줄을 비운다(「사유 없음」을 넣지 않는다). 카드를 누르면 그 개소의 실측 입력(SCR-FSM-004)으로 가고 그 화면이 returned 갈래로 열린다 — 화면이 「다시 재 주세요」라고 하면서 그리로 가는 길을 주지 않던 자리다 (②·③·⑤)
6. 위쪽 요약 카드 (#881 3단계 신설) — 아래 두 목록의 건수를 위쪽에 모아 보인다(전송 대기 N건 · 전송 실패 N건). 목록을 끝까지 내리지 않고도 「얼마나 남았나」를 읽는 자리다. 새로 세는 값이 아니라 두 목록의 길이를 그대로 보인다 (③)
7. [모두 다시 보내기] (#881 3단계 신설) — 대기와 실패를 함께 보낸다. 실패만 보내면 대기 건이 남아 사람이 두 번 눌러야 하고, 이 화면의 이름이 이미 「모두」다. 자동 5회 시도로 실패한 건도 사람이 손으로 누른 것이므로 다시 보낸다. 누르는 동안 이 단추와 각 줄의 [재시도] 를 함께 잠근다 (③·⑤)
8. 묶음 전송 진행 막대 (#881 3단계 신설) — [모두 다시 보내기] 를 누른 동안에만 보인다. 세는 것은 건수(보낸 건수 / 보낼 건수)이지 바이트가 아니다 — 사진이 섞여 크기가 들쭉날쭉해 바이트로 세면 막대가 멈춘 것처럼 보인다 (③·⑤)
9. [저장·동기화 설정] (#881 4단계 신설) — 탭하면 SCR-FSM-006 오프라인 저장·동기화로 들어간다. 이 화면은 「지금 무엇이 안 갔나」(건별 목록·재시도)를 보이고, 그쪽은 「이 단말이 어떻게 담고 보내나」(동기화 단계·로컬 저장 용량·동기화 뒤 로컬 삭제)를 보인다. 동기화에 관한 문을 하나로 둔다 — 전역 칩 → 008 → 006 한 길이다 (②·③)