chore(요구): 완료 보고 359 사용자 가이드 · PLAN 538~542 이관

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/raw/plans/2026-10-26_plan_538-542.md

@@ -0,0 +1,54 @@
+# PLAN 538~542 — 요구 359 · 360 사용자 가이드 (2026-10-26 완료 · 이관)
+
+## 538. 사용자 가이드 틀 — 한 가이드 · 바로 고침 (요구 359 · 360 · 승인 대기 · sub1 · Opus high)
+
+- 정함(브레인): 요구서 `docs/raw/요구_1025/요구서_359_사용자가이드.md` 3 · 4장 · 글 + 그림 = `A05_EduDetail/guide/<페이지>/`(resources/help git mv) · [?] = 넓은 모달에 가이드 통째 · 그 페이지 자리로 이동 · 고침 = 시스템 관리자 더블클릭 → 그 덩어리 원문 글 상자 · 바깥 누름 · Ctrl+Enter 저장 · Esc 취소 · 파일 바로 덮음(판 409) · 그림 더블클릭 = 파일 고르기 → 같은 이름 덮음(WebP · 폭 1800) · 근거 `_분석_360-A_외부조사.md` · `_분석_360-B_코드현황.md`.
+- [x] 538-1 글 자리 옮김 + 한 가이드 읽기 — git mv · 참조 고침 · `GET /api/help`(모든 페이지 · 판 · admin) · 시험 + 지금 모달 열림(540~ 창보다 먼저).
+  - 검증완료 — git mv 56 rename · GET /api/help 19 페이지 · 56 항목 · 시험 14 통과(0f32c241c)
+- [x] 538-2 모달 한 가이드 — 차례(묶음 → 페이지 → 기능) · 그 페이지로 이동 · 그림 · 주의/참고 상자 · `GET …/img/{name}`(no-cache) · B01 [?] · ORCA B05 · E02 · B01.
+  - 검증완료 — ORCA [?] 처음 제목 B05 「노선설계 설명서」 · E02 「지반 조건 설명서」 · B01 = B02(B01 글 없음 · 540-1 몫) · 변환 · 그림 404 시험 통과(02f15c3d6)
+- [x] 538-3 글 더블클릭 바로 고침 — 덩어리 원문 줄 자리 · `PUT`(줄 범위 · 판 · 409 · 403 · 원자 쓰기) · Esc 에 모달 안 닫힘 · 한글 조합 · 시험 + ORCA 한글 고침 → 되돌림.
+  - 검증완료 — ORCA E02 한글 고침 저장 → 화면 고침으로 되돌림 = 파일 같음 · Esc 취소 · 일반 사용자 더블클릭 0 · PUT 403 · 시험 줄 · 409 · 403 · 원자 쓰기 통과(73bdb9bc5)
+- [x] 538-4 그림 더블클릭 바꾸기 — `POST …/img`(png · jpg · webp · 5 MB · 그림 확인 · WebP) · `_manual.json` · 빈 그림 자리 · 시험 + ORCA 바꿈 → 되돌림.
+  - 검증완료 — ORCA 빈 그림 자리 → a 600 px → b 2400→1800 px → 백업 a 다시 올림 = sha 같음 → 정리 · 시험 확장자 · 크기 · 그림 아님 · 403 · 경로 탈출 통과(e04e88e37 · 2d3074f91)
+- [x] 538-5 싱크 — `.claude/git-sync-all.ps1` 랩탑 메인 · 데스크탑 메인 가이드 폴더만 커밋 · push · `-Check` = 브레인.
+  - 검증완료 — 파싱 오류 0 · `-Check` 끝까지 돎(점검 통과 · 표 13 폴더) · 가이드 편집 커밋 길은 화면 고침이 생긴 싱크 때 돎
+
+## 539. 캡처 도구 · 가이드 프로젝트 (요구 359 · 360 · 승인 대기 · 539-1 sub2 · 539-2~4 sub3 · Opus high)
+
+- 정함(브레인): 캡처 = Playwright 헤드리스 Edge · 2배 · 노란 테두리 + 검은 번호 원 박음 · WebP · 밝은 테마 · 스크립트 `A05_EduDetail/A05_EduDetail_Guide_Capture.py` · 장면 목록 `A05_EduDetail/guide/<페이지>/_scenes.json` · `_manual.json` 그림 건너뜀 · [저장] · [확정] · [초기화] · [적용]은 확인창까지 · 근거 `_분석_359-B_코드현황.md` ⑤.
+- [x] 539-1 캡처 스크립트 + 장면 목록 꼴 · B02 견본(통째 1 · 부분 2) · 번호 자리 · 크기 확인.
+  - 검증완료 — 시험 45 통과 · B02 셋(3200×1800 61 kB 3.1 s · 1504×1260 49 kB 2.1 s · 2012×1504 24 kB 2.5 s · 번호 4·6·2) · B04 3D 133 kB 13.8 s · B05 평면 113 kB 11.0 s · B07 CAD 81 kB 21.7 s · B08 카카오 지도 151 kB 9.7 s(헤드리스 모두 그려짐) · 위험 단추 실행 중 거절 · 쓰기 요청 끊음(eb0d48814)
+- [x] 539-2 「가이드_용화」 — `db_management/tools_clone_project.py` 로 검증_sub6 복제 · B02~B09 화면 열림.
+  - 검증완료 — c2390e1c-ee66-42ef-8cd7-253ec00bf904 · 복제 15 s · 3.1 GB · B02~B09 화면 열림 · B05 · B06 [>] 확정 12 s · B07~B09 [>] → 단계 0~6 모두 COMPLETE · 상태 DONE
+- [x] 539-3 E 가이드 프로젝트 — E01 에서 가이드_용화 원본 · E02~E07 해석 · 단계 상태 · 화면 결과.
+  - 검증완료 — 850175bf-e740-477b-b0f5-486d0fb3a6ab · 303 MB · E03 58 s(N.G 12 · O.K 45) · E04 0~100 m 110 s(Fs 1.74) · E06 절리 J1~J3(54 비탈 · 평면 9 · 쐐기 41 · 전도 1) · E07 1 s · E05 갱신 13 s · 저장 200 · 단계 5 개 NOT_STARTED(E 단계 쓰는 코드 없음 · 브레인 답 = 그대로)
+- [x] 539-4 D 가이드 프로젝트 — D01 용화 둘레 3 연도 · D02 · D03 분석 · D04 · 화면.
+  - 검증완료 — 04f77c23-9ae3-4d22-9eb5-a4fa212ba47a · 246 MB · 2027~2029 · 지점 = 가이드_용화 노선 3 등분 · 지형 25 s(도엽 12매) · 분석 15 s · 저장 영선 365.3 + 400.7 + 375.1 m · D04 업체 칸 저장 · 내보내기 zip 29 KB · 확정 안 누름 · 단계 3 개 NOT_STARTED
+
+## 540. 가이드 글 + 그림 — B 임도설계 (요구 359 · 360 · 승인 대기 · 538-1 · 539-1 · 539-2 뒤 · Opus high)
+
+- 정함(브레인): 창마다 제 페이지 폴더만 · 페이지마다 `00_설명서`(통째 그림 + 번호 표 + 작업 순서) · 기능별 `01~09`(여는 길 → 단계 표 → 그림 → 주의) · 명사형 · 확인 = 자체 점검(`tmp/` · 명사형 · 가리킨 그림 있음) + ORCA [?] 모달 한 번.
+- [x] 540-1 B01 · B02 · B03 · B04 — sub4.
+  - 검증완료 — 문서 B01 10 · B02 5 · B03 9 · B04 8 · 그림 14 · 8 · 9 · 11 = 42장 3.0 MB · 장면 목록 검사 통과 · GET /api/help 차례 · 그림 주소 200 · 명사형 0 · [?] 모달 헤드리스 B01~B04 그림 · 번호 표 보임(ORCA 탭 잠금 sub6 20 분 대기 못 얻음)
+- [x] 540-2 B05 몫 — sub5.
+  - 검증완료 — 글 22(00 + 01~09 + 구조물 12) · 그림 38(2배 WebP 3.18 MB) · 그림 줄 = 파일 = 장면 38 일치 · 명사형 흠 0(화면 글 인용 둘 뺌) · GET /api/help B05 22 항목 차례대로 · 그림 주소 38/38 200 · ORCA [?] B05 그림 38/38 보임(폭 572~900 px) · 빠진 장면 0(5b5270ddf)
+- [x] 540-2 B06 몫 — sub7.
+  - 검증완료 — 글 7(00 · 01~05 · 표준_횡단면) · 그림 16(1.15 MB) · 그림 줄 = 파일 = 장면 일치 · 명사형 0 · GET /api/help B06 7 항목 차례대로 · 그림 16 모두 200 · ORCA [?] B06 그림 16 폭 로드(커밋 아래 push).
+- [x] 540-3 B07 · B08 · B09 · 인쇄 미리보기 — sub6.
+  - 검증완료 — 글 B07 10 · B08 10 · B09 14(인쇄 4 포함) · 그림 15 · 15 · 35(2배 WebP 합 0.89 · 0.96 · 1.67 MB) · 그림 줄 = 파일 = 장면 전부 일치 · 말투 0 · GET /api/help 3 페이지 차례대로 · 그림 주소 65 전부 200 · 빠진 장면 B09 8(박스 · 호표 보기 · 팝업 · 운반 단가 · 견적서 · 인쇄 단계 줄) · 자료 부족(조합 연결 0)으로 B08 · B09 표 비어 있음
+
+## 541. 가이드 글 + 그림 — E 안정성평가 (요구 359 · 360 · 승인 대기 · 539-3 뒤 · Opus high)
+
+- 정함(브레인): 540 과 같은 꼴 · 있는 10 · 20 · 30 문서는 그대로 두고 그림만 더함.
+- [x] 541-1 E01 · E02 · E03 · E04 — sub7.
+  - 검증완료 — 글 35 · 그림 49(3.1 MB) · 명사형 0 · 그림 줄 = 파일 = 장면 · ORCA [?] E01 5 · E02 19 · E03 20 · E04 16 그림 보임(브레인 대리 체크 · sub7 폴더 PLAN 사본이었음).
+- [x] 541-2 E05 · E06 · E07 — sub8.
+  - 검증완료 — E05 문서 5 · 그림 17 · 1.81 MB / E06 문서 8 · 그림 15 · 0.77 MB / E07 문서 10 · 그림 16 · 1.38 MB · 그림 줄 = 파일 = 장면 일치 · 명사형 0 · GET /api/help 3 페이지 차례대로 · 그림 주소 48/48 200 · ORCA [?] 모달 E05 그림 폭 899 px 로드(커밋 2a1701b15 · 6cbdc73fd · 729a85ee1).
+
+## 542. 가이드 글 + 그림 — D 예정노선 · 마무리 (요구 359 · 360 · 승인 대기)
+
+- [x] 542-1 D01 · D02 · D03 · D04 — sub3(539-4 뒤 · 540 과 같은 꼴).
+  - 검증완료 — 글 D01 8 · D02 8 · D03 9 · D04 9 = 34 문서 · 그림 8 + 8 + 9 + 8 = 33 장 5.5 MB(D03 4.4 MB) · 글 그림 줄 = 파일 = 장면 일치 · 명사형 흠 0 · GET /api/help D 차례 · 그림 주소 33 모두 200 · ORCA [?] D02 그림 보임(vite 5178 이 8000 으로 가던 것 8005 로 다시 켬)
+- [x] 542-2 마무리 = 브레인 — 모든 페이지 [?] 훑어봄 · 사용자에게 고치는 법 안내.
+  - 검증완료 — 20 페이지 · 글 187 · 그림 299 · 26.2 MB · 글이 가리킨 그림 없음 0 · 안 쓰인 그림 0 · [?] 21 페이지(sub1 4f4cc22c3) · 그림 설명 대괄호 고침(96359deae) · B07 옛 이름 걷음(0e015bca3) · 완료 보고 `docs/raw/요구_1025/완료보고_359_사용자가이드.md`