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>
2026-10-19 18:53:43 +09:00
parent bbc0f53f50
commit 2e6086c5ee
40 changed files with 1865 additions and 415 deletions
@@ -0,0 +1,218 @@
+# 문서 사이트 묶음 규칙 — 페이지 · 범위 · 로직 묶음
+# 함수 하나 = 묶음 하나 · 위에서부터 첫 맞음
+#   registry — 계산 등록부 id 무늬(그 줄의 ts · pair 함수)
+#   files    — 파일 이름 무늬(확장자 뺀 이름 · fnmatch)
+# 어디에도 안 맞음 = 「묶음 없음」
+
+pages:
+  - id: B05_B06
+    title: B05 · B06 종단 · 횡단 설계
+    guide: guide/B05_B06
+    scope:
+      - B05_Profile/
+      - B06_Section/
+      - A00_Common/design/
+      - common_util/
+    groups:
+      - id: recommend
+        title: 추천 노선
+        files:
+          - "*RouteInitial*"
+          - B05_Profile_UI_RouteEdit_Initial*
+          - B05_Profile_UI_RouteEdit_Recommend*
+          - B05_Profile_UI_Panel_Recommend
+          - B05_Profile_Engine_InitialProfile
+          - B05_Profile_Engine_RidgeValley*
+          - B05_Profile_Engine_Skeleton
+          - B05_Profile_Engine_Solver
+      - id: route_edit
+        title: 노선 편집
+        registry: ["route.*"]
+        files:
+          - B05_Profile_UI_RouteEdit*
+          - B05_Profile_RouteEdit_*
+          - B05_Profile_Route_NodeEdits
+          - B05_Profile_ContourLock
+          - design_plan_peek
+          - common_util_route_polyline
+          - common_util_route_geometry
+      - id: route_save
+        title: 노선 저장 · 시설 따라감
+        registry: ["stations.carry", "facility.follow*", "facility.plus_follow"]
+        files:
+          - B05_Profile_Route_Save*
+          - B05_Profile_Router_Replan
+          - B05_Profile_Api_Replan
+          - B06_Section_Router_DesignSave_Route
+          - B06_Section_Route_Carry*
+          - B05_Profile_Pipeline_Follow
+          - B05_Profile_Structure_Follow
+          - design_calc_node_carry
+          - design_calc_node_follow
+          - common_util_route_follow
+      - id: stations
+        title: 측점
+        registry: ["stations.*"]
+        files:
+          - B05_Profile_Sections_Stations
+          - B05_Profile_Engine_Sections*
+          - B05_Profile_UI_Page_Stations
+          - B05_Profile_UI_IrregularStations
+          - B05_Profile_Util_Station
+          - B05_Profile_Plus_Stations
+          - B05_Profile_Api_PlusStations
+          - B06_Section_Station_*
+          - B06_Section_Swap_Bus
+          - B06_Section_Router_Stations
+          - B06_Section_UI_Missing_Stations
+          - B06_Section_UI_Page_Station_Swap
+          - design_pipeline_stations
+          - design_pipeline_probe_station
+          - common_util_station_key
+      - id: ground
+        title: 지반 표본
+        registry: ["ground.*"]
+        files:
+          - B05_Profile_Api_TerrainGrid
+          - B05_Profile_Sections_Ground
+          - B05_Profile_Pipeline_RouteGround
+          - B05_Profile_Router_Terrain
+          - B06_Section_Engine_SampleExtend
+          - B06_Section_Router_Widen
+          - common_util_surface_sampler
+      - id: earthwork
+        title: 토량 · 유토 배분
+        registry: ["earth.*", "haul.*"]
+        files:
+          - "*MassHaul*"
+          - "*HaulPlan*"
+          - B05_Profile_UI_Profile_Balance
+          - common_util_mass_haul*
+      - id: profile
+        title: 종단 계획고
+        registry: ["profile.*"]
+        files:
+          - B05_Profile_UI_Profile_*
+          - B05_Profile_Profile_*
+          - B05_Profile_Grade_*
+          - B05_Profile_Engine_Grade*
+          - B05_Profile_Pipeline_Grade
+          - B05_Profile_EndOffsets
+          - B05_Profile_UI_Panel*
+          - B05_Profile_PageSettings
+          - B05_Profile_Api_PageSettings
+          - design_profile*
+      - id: cross
+        title: 횡단 설계 계산
+        registry: ["cross.*"]
+        files:
+          - B06_Section_Cross_*
+          - B06_Section_Engine_*
+          - B06_Section_Design_Keys
+          - B06_Section_Router_Design
+          - B06_Section_Router_Design_Ranges
+          - B06_Section_Router_Regenerate_Options
+          - B06_Section_Server_Calc*
+          - common_util_cross_*
+      - id: cross_view
+        title: 횡단 화면 · 조정창
+        files:
+          - B06_Section_UI_Cross_*
+          - B06_Section_UI_Standard*
+          - B06_Section_UI_Section_*
+          - B06_Section_UI_Longitudinal
+          - B06_Section_UI_Adjust_Dock
+          - B06_Section_Label_Tiers
+          - B06_Section_Display_Width
+          - B06_Section_Session_Cells
+          - B06_Section_Section_Adjusts
+          - B06_Section_UI_Page_Design_Sync
+          - B06_Section_UI_Page_Station_Controls
+          - B06_Section_UI_Page_Span_Control
+          - B06_Section_UI_Page_Ford_Controls
+          - B06_Section_UI_Page_Link_Session
+          - B06_Section_UI_Page_Pipe_Options
+          - B06_Section_UI_Page_Patches
+      - id: drainage
+        title: 관 · 배수
+        registry: ["drainage.*", "facility.pipe*"]
+        files:
+          - "*Drainage*"
+          - B05_Profile_Api_Pipes_Draft
+          - B06_Section_Api_Culvert_Options
+          - design_pipe_ids
+          - design_structure_pipe*
+          - common_util_drainage*
+          - common_util_culvert*
+      - id: structures
+        title: 구조물
+        registry: ["facility.*"]
+        files:
+          - "*Structures*"
+          - "*Structure_*"
+          - B05_Profile_UI_Structure_Pick_Session
+          - B06_Section_Structure_Layouts
+          - design_structure*
+          - design_facility_lane
+          - common_util_structure_*
+          - common_util_berm*
+          - common_util_excavation
+      - id: corridor
+        title: 3D 길 모형
+        registry: ["corridor.*", "view3d.*"]
+        files:
+          - "*Corridor*"
+          - B05_Profile_UI_Viewer*
+          - design_view_profile_3d*
+      - id: footprint
+        title: 평면 발자국
+        registry: ["plan.*", "footprint.*"]
+        files:
+          - "*Footprint*"
+      - id: pipeline
+        title: 계산 묶음 · 가게
+        files:
+          - design_pipeline*
+          - design_calc*
+          - design_store
+          - B05_Profile_Pipeline_*
+          - B06_Section_Section_*
+          - B06_Section_UI_Page_Persist
+          - common_util_calc_runner
+      - id: save
+        title: 저장 · 확정 · 초기화 · 떠남
+        files:
+          - design_save*
+          - design_reset
+          - design_leave
+          - design_shared
+          - B06_Section_Router_DesignSave
+          - B06_Section_Router_Confirm
+          - B05_Profile_Router_Confirm
+          - B05_Profile_Router_Lifecycle
+          - common_util_initial_snapshot
+          - common_util_save_guard
+      - id: screen
+        title: 페이지 틀 · 보기
+        files:
+          - design_page*
+          - design_view*
+          - design_panel
+          - design_dock
+          - design_pick*
+          - design_selection
+          - design_user_pick
+          - design_sections
+          - B05_Profile_UI*
+          - B06_Section_UI*
+      - id: server
+        title: 서버 창구 · 저장소
+        files:
+          - "*_Router*"
+          - "*_Repository*"
+          - "*_Schema"
+          - "*_Api_*"
+          - B05_Profile_Engine*
+          - B05_Profile
+          - B06_Section
+          - B05_Profile_Debug