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`

docs/raw/요구_1025/완료보고_359_사용자가이드.md

@@ -0,0 +1,38 @@
+# 완료 보고 — 요구 359 · 360 · 361 사용자 가이드 (10-26)
+
+요구서 = `요구서_359_사용자가이드.md` · 계획 = PLAN 538 ~ 542(완료 절은 `docs/raw/plans/2026-10-26_plan_538-542.md`) · 근거 = `_분석_359-A` · `359-B` · `360-A` · `360-B`.
+
+## 1. 만든 것
+
+| 부분 | 한 줄 |
+| --- | --- |
+| 가이드 한 벌 | 글 · 그림 = `A05_EduDetail/guide/<페이지>/` · 20 페이지(B01~B09 · D01~D04 · E01~E07) · 글 187 · 그림 299(2배 WebP · 26 MB) · 글이 가리킨 그림 없음 0 |
+| [?] = 그 페이지 링크 | 21 페이지 좌측 패널 아래 [?](대시보드는 머리) → 넓은 창에 가이드 통째 · 지금 페이지 자리부터 · 왼쪽 차례 = 임도설계 → 안정성평가 → 예정노선 → 페이지 → 기능 · 단계 페이지 15 = [<] [>] |
+| 글 꼴(Altair Flux 참고) | 페이지마다 「화면 한눈에」(통째 그림 + 노란 테두리 · 번호 원 + 번호 표 + 작업 순서) · 기능별 문서(여는 길 → 단계 표 → 그림 → 주의 · 참고) · 있던 칸 뜻 · 근거 · 확정 전 값 문서는 그대로 + 그림 |
+| 시스템 관리자 바로 고침 | 글 더블클릭 → 그 자리 글 칸 → 바깥 누름 · Ctrl+Enter = 바로 저장 · Esc = 취소 · 남이 먼저 고쳤으면 「먼저 바뀜」 · 그림 더블클릭 → 내 PC 파일 고르기 → 바로 바뀜(WebP · 폭 1800) · 일반 사용자 = 읽기만 |
+| 따로 저장 없음 | 고친 것이 곧 가이드 파일 · 깃 싱크가 「사용자 편집」 커밋으로 올림(데스크탑 임시 배포에서 고친 것은 전역 깃 싱크 때) · 손으로 바꾼 그림은 자동 캡처가 안 덮음 |
+| 그림 자동 캡처 | `A05_EduDetail/A05_EduDetail_Guide_Capture.py` · 장면 목록(`_scenes.json`)대로 헤드리스로 찍어 번호를 박음 · 역할별 계정 · 화면이 바뀌면 다시 돌리면 끝 · 저장 · 확정 · 초기화 · 메일은 안 누름 · 서버 쓰기 막음 |
+| 그림용 프로젝트 셋 | 가이드_용화(임도설계 · 검증_sub6 복제 · 3.1 GB) · 가이드_용화 안정성평가 · 가이드_용화 예정노선 — 지우지 않음(다시 찍을 원본) |
+
+라이브러리 = 새로 들인 것 0(이미 깔린 Playwright · Pillow · python-multipart).
+
+## 2. 같이 고친 것
+
+- B09 [인쇄 미리보기] 도면 PDF 「plan_terrain 을 읽지 못했습니다」 400 고침(B07 평면도 저장본 꼴을 못 읽음 · 사용자 화면에도 있던 흠) — B 그룹 고침.
+- E03 · E04 · E06 · E07 좌측 [?] [<] [>] 빠짐 고침(늦게 붙는 단추 줄).
+- 권한 시험 하나(test_302_2) 실패 = 시험 가짜 DB 탓 · 진짜 서버는 남 회사 막힘 확인.
+- 랩탑 메인 5173 화면 서버가 E05~E07 「준비 중」 → 화면 서버만 다시 켬.
+
+## 3. 사용자 확인 · 몫
+
+- 가이드 글 말투 · 그림 — [?] 창에서 더블클릭으로 바로 고침(시스템 관리자 계정).
+- 마스터 자료 빈틈(B08 · B09 그림을 채우다 찾음): 자재 대비표에 대형브레이커 치즐 · 모르타르 · 찰쌓기 자재 없음 · 서고 구조물 조합들 일위대가 수량 빈칸 · 관 본체에 맞는 조합 없음 · B08 자재 단위수량 빈칸.
+- 가이드_용화 연도기번 = 2026-001 로 정함(B01 프로젝트 정보에서 바꿀 수 있음).
+- 가이드 파일이 겹칠 때(사용자 고침 ↔ Claude 고침) 우선 = 답 없어 자동으로 안 덮음 · 겹치면 싱크가 멈추고 보고.
+- 창들의 초안 단계 확인 스크립트가 시스템 관리자 화면 설정(패널 접힘)을 바꿨을 수 있음 — 평소와 다르면 다시 펼침(정식 캡처는 서버 쓰기 막음).
+
+## 4. 남은 것 · 다음 후보
+
+- 화면 흠(가이드 그림을 찍다 찾음 · 안 고침): 대시보드 프로젝트 수정 창 임도 종류 「main」 날 값 · B05 누가토량 표시가 종단 도구 줄 가림 · B05 노선 추천 「초기 종단을 셈하지 못했습니다」 · B08 [수리집수면적표] 빈 카드 · B09 안내 글 [저장](단추 없음) · E02 칸 글자 잘림 · E03 낮은 화면에서 위험 띠 겹침 · E03 위험 띠와 횡단 사이 빈 칸 · E04 3D 나침반 안 보임 · E05 시트 탭 오른쪽 누름 메뉴 가림 · E · D 단계 「완료」 안 바뀜.
+- 자료가 없어 그림 없는 화면: 받은 예정노선 · 예정노선 가져오기 · 임시 보관함 목록(빈 화면 + 글).
+- 깃 싱크 안 함(폴더 11 곳 판이 다름) · 데스크탑 임시 배포 반영 = 전역 깃 싱크 때(그 뒤 화면 서버 다시 켜기).