feat(478-2 문서 사이트): 묶음 규칙 · 원고 생성 · mkdocs 설정 · 손글 옮김 · 검사 시험(가짜 추출)

- docs/tools/groups.yml · group.py — 함수를 로직 묶음에 자동 배정(계산 등록부 id · 파일 이름 무늬 · 안 맞음 = 묶음 없음 · 함수 목록 지문)
- docs/tools/build.py — 추출 JSON + 손글로 페이지 · 묶음 화면 · 함수 칸 · mermaid 흐름 · 세션 칸 · 서버 주소 · 설명 확인 필요 표시 · 함수 화면은 TypeDoc(markdown) · mkdocstrings(griffe)
- docs/mkdocs.yml · nav_hook.py — Material · 한국어 · 검색 · mermaid · 왼쪽 메뉴 페이지 → 묶음 → 함수
- docs/guide/B05_B06 — 8 파일을 page.md(개요 · 규칙 · 사용자 결정) + groups/*.md 17 개로 줄여 옮김
- resources/tester/test_478_docs.py · fixtures/478_docs — 가짜 추출로 배정 · 사이트 strict · 도구 대 추출 · 진짜 추출은 있을 때만

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

docs/guide/B05_B06/groups/corridor.md

@@ -0,0 +1,3 @@
+3D 길 모형 — 종단 · 횡단으로 길 몸체를 지음.
+
+- 노선 초안 · 종단 고침 동안 낡음 표시 · [저장] 뒤 서버 Node 가 다시 지음.

docs/guide/B05_B06/groups/cross.md

@@ -0,0 +1,5 @@
+횡단 설계선 · 면적 계산 — 브라우저 즉시 · [저장] 때 서버 Node 정본.
+
+- 설계선 = [[computeCrossDesign]] ↔ 파이썬 짝 · 단면적은 표준 · 구조물 측점 모두 Node.
+- 다시 셈 입력 물러섬 = 세션 고름 → 저장 정본 설계 → config 기본값.
+- 소단 구간 = 구조물에서 [[bermSpansFromStructures]] ↔ 서버 [[load_berm_spans]].

docs/guide/B05_B06/groups/cross_view.md

@@ -0,0 +1,5 @@
+횡단 화면 — 카드 단추 · 조정창 · 반폭 · 표준횡단 · 상세 표.
+
+- 카드 단추 = 세션 `crossdesign` 의 바꾼 칸만 · 메모리 상세 설계를 안 덮음.
+- 조정창 칸 · 암선 · 암 경사 = 세션 칸이 값 주인(메모리 사본 없음) · 빈 칸 = 칸 지움.
+- 표준횡단 = 저장분 · config 와 다를 때만 칸([[effectiveStandardCross]]).

docs/guide/B05_B06/groups/drainage.md

@@ -0,0 +1,5 @@
+관 · 배수 — 배수판 관 편집 · 배수유역 · 관 옵션.
+
+- 관 주인 = 가게 `pipes` · 배수 편집기는 숨어도 가게를 따름.
+- 관 자리 읽기 = 지금 노선에 얹은 관 지점 한 벌([[route_pipe_points]]) · 관 파일 누가거리를 그대로 읽지 않음.
+- [저장] = 관 차례 `pipe_points` PUT · 관 옵션 예약 있으면 같은 파일 한 번 더.

docs/guide/B05_B06/groups/earthwork.md

@@ -0,0 +1,4 @@
+누가토량 · 유토 배분 · 운반거리.
+
+- 누가토량 = TS 한 벌(브라우저 · Node) · 그릴 때 셈(접혀도 셈).
+- 유토 배분 = 서버 Node(`/haul-plan`) · 저장본 `_derived/haul` · 입력 지문 다를 때만 다시 셈.

docs/guide/B05_B06/groups/footprint.md

@@ -0,0 +1,3 @@
+평면 발자국 — 횡단 결과로 평면에 깎기 · 쌓기 테두리.
+
+- 묶음 마지막 단계 · B07 은 따로(파이썬) · 거울 시험.

docs/guide/B05_B06/groups/ground.md

@@ -0,0 +1,4 @@
+측점마다 원지반 표본 — 브라우저 지형 격자 · 서버 npz.
+
+- 표본 짝 = 브라우저 격자 ↔ 서버 `sample_xy`(거울 시험) · 입력 선이 달라 mm 차.
+- 노선 초안 없는 차례 = 정본 표본 유지 · 넓힘(표본 폭 넘음) = 저장 밖 서버.

docs/guide/B05_B06/groups/pipeline.md

@@ -0,0 +1,6 @@
+계산 묶음 · 설계 가게 · 상세 가게 — 입력 → 파생 한 방향.
+
+- 묶음 단계 = 노선 → 따라감 → 측점 → 지반 → 첫 계획선 → 종단 → 횡단 → 발자국 · 차례 번호 · 옛 차례 버림.
+- 묶음 결과 내보냄 = [[publishPagePipeline]] · 조용한 차례 끝 = 가게 측점 = 지금 상세 측점.
+- 설계 가게 = [[useDesignStore]] · 멈춘 뒤 1 s 세션 · 상세 가게 = [[loadSectionDetail]] · 새로고침 = [[checkSessionCanon]].
+- 서버 Node 입구 = 계산 등록부 id → 함수 · 파이썬은 [[run_calc]].

docs/guide/B05_B06/groups/profile.md

@@ -0,0 +1,6 @@
+종단 계획고 — ▲▼ · 직선화 · 자유지정 · 쉬프트 · 종단 R · 시종점 · 페이지 설정.
+
+- 편집값 주인 = 가게 `alignmentDraft`(세션 `alignment-draft`) · 지금 값 = 초안 ?? 서버 저장분.
+- 계획선 짓기 [[buildAlignment]] ↔ 파이썬 짝(거울 시험).
+- 짝 있는 옮긴 측점 = 꼭짓점 따라감([[followMovedNodes]]) · 짝 없는 새 측점 = 꼭짓점 안 세움.
+- [저장] = 편집 델타만 보내고 서버가 종단 다시 셈.

docs/guide/B05_B06/groups/recommend.md

@@ -0,0 +1,4 @@
+추천 노선 후보를 서버가 찾고 화면이 보여 줌 · 고른 후보를 [적용].
+
+- 후보 초기 종단 = [적용] 체인과 같은 조각을 메모리에서 셈 · 저장본 `route_recommend/initial`.
+- [적용] = 저장 밖 · 즉시 [[replan_route]] · 종단 = 새 규칙 초기 종단 · 옛 손 입력 안 넘김 · 초기값 다시 뜸 · 초안 전부 지움.

docs/guide/B05_B06/groups/route_edit.md

@@ -0,0 +1,5 @@
+평면 노선 편집기 — 교점 끌기 · 방향키 · 교점 추가 · 삭제 · 곡선 R · L · 스냅.
+
+- 조작은 편집기 메모리 → 놓을 때 세션 `route-draft` · 첫 초안이면 초안 전 상세를 hold.
+- 곡선 선 = [[buildEditedPolyline]] ↔ 파이썬 짝 [[build_planned_polyline]] · 선 자리 x · y 4자리 한 벌.
+- 노선 초안 차례 = 새 · 옮긴 측점만 브라우저 지반 표본.

docs/guide/B05_B06/groups/route_save.md

@@ -0,0 +1,5 @@
+노선이 바뀐 [저장] — 새 노선 짜기 · 관 · 구조물 · 추가 측점 따라감 · 횡단 고침 넘김.
+
+- 서버 [[run_route_save_chain]] = 노선 · 측점 · 표본 · 횡단을 처음부터 · 전부 아니면 없음.
+- 관 · 구조물 초안 다시 얹기 = [[rebasePipeDraft]] · [[rebaseStructureDraft]](좌표 따라감).
+- 횡단 고침 넘김 = [[carryKeyedStates]] ↔ 서버 [[carry_cross_inputs]] · 자리 칸은 같은 자리([[sameSeat]]) 측점만.

docs/guide/B05_B06/groups/save.md

@@ -0,0 +1,5 @@
+[저장] · [확정] · [초기화] · 떠남.
+
+- [저장] · [확정] = 한 본문 한 요청 · 서버가 차례(노선 → 설정 → 관 → 구조물 → 추가 측점 → 종단 → 관 옵션 → 상단측 → 횡단)로 · 하나라도 실패 = 되돌림.
+- 횡단 패치 = [[crossPatchesFromCache]] · 노선 바뀐 [저장] = [[routeCarryInputs]] 를 같은 본문에.
+- [폐기] = 세션 고침 칸만 지움 · 메모리는 떠남이 비움 · [초기화] = DB 노선 행 지우고 초기값으로.

docs/guide/B05_B06/groups/screen.md

@@ -0,0 +1,4 @@
+페이지 틀 · 보기 전환 · 패널 · 고름.
+
+- B05 ↔ B06 전환 = 보기 숨김 · 보임만 · 보인 보기가 가게 · 세션을 다시 읽음 · 묶음은 숨은 동안도 셈.
+- 접기 = 그리기만 건너뜀 · 팝아웃 = 같은 함수 · 같은 가게.

docs/guide/B05_B06/groups/server.md

@@ -0,0 +1,3 @@
+서버 창구 · 저장소 · 스키마 — 브라우저 요청을 받아 DB · 정본 파일을 읽고 씀.
+
+- 정본 쓰기 = [저장] · [확정] · [초기화] · 저장 밖 셋만.

docs/guide/B05_B06/groups/stations.md

@@ -0,0 +1,5 @@
+측점 목록 · 열쇠 · 갈아끼움 — 노선 · 시설이 바뀌면 측점을 다시 세움.
+
+- 열쇠 = [[common_util_station_key#stationKey]] 한 벌(파이썬 짝 · 거울 시험).
+- 갈아끼움 [[swapSectionStations]] — 노선 초안 없는 차례 = 서버 정본 측점 기하 · 표본 유지(같은 자리 0.01 m · 축 1e-3).
+- 지금 상세에 없던 측점이 정본 자리로 돌아옴(관 지움 ↶) = 정본 설계.

docs/guide/B05_B06/groups/structures.md

@@ -0,0 +1,5 @@
+구조물 — 추가 · 옮김 · 지움 · 형상 · 소단 · 시설 줄.
+
+- 주인 = 가게 `structures` · 화면 사본은 가게 알림으로 맞춤([[announceDesignStore]]).
+- 시설 줄 측점 = 종류 표 · 구조물 · 관 알림이 다 온 뒤만 심음(모름 ≠ 빈 목록).
+- 소단 사본 쓰는 자리 = 시설 줄 하나 · 같으면 안 씀.