chore(plan): 10-10 조사 AG(구조물 목록 대 정의)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LLCk2y5xE8YGVgjbTntWsY

docs/raw/요구_1010_2/조사_AG_구조물목록대정의.md

@@ -0,0 +1,84 @@
+# 조사 AG — 구조물 목록 대 정의 · 3D 측점 표기 (109 · 108 뒷부분) (10-10 · 읽기 전용 조사 에이전트)
+
+약칭: DEF `resources/master_template/구조물정의.json` · TBL `docs/raw/구조물정의_표/0N_*.md` · `B05_Profile/B05_Profile_` + API `Api_Structures.ts` · PS `UI_Page_Structures.ts` · PT `UI_Structures_Panel_Types.ts` · PNL `UI_Structures_Panel.ts` · PO `UI_Structures_Panel_Options.ts` · DEFN `UI_Structures_Define.ts` · LST `UI_Structures_List.ts` · MRK `UI_Structures_Marks.ts` · STN `UI_Page_Stations.ts` · MK `UI_Markers.ts` · PR `UI_Profile_Render.ts` · PA `UI_Page_Actions.ts` · CS `UI_Corridor_Structures.ts` · SCH `Structures_Schema.py` · ES `Engine_Sections.py` · RC `Router_Confirm.py` · RL `Router_Lifecycle.py` / `B06_Section/B06_Section_` + SP `UI_Page_Structures_Panel.ts` · VP `UI_Section_View_Profile.ts` · SS `Section_Store.ts` · WL `Engine_Structures_Wall.py` · RS `Router_Stations.py` · RC6 `Router_Confirm.py` / B07P `B07_DesignDetail/B07_DesignDetail_Router_Support_Plan.py` · B07O `B07_DesignDetail/B07_DesignDetail_Cross_Overlay.ts` · B08S `B08_Quantity/B08_Quantity_Router_Summary.py` · M02D `M02_MasterTemplete/StructOptions/M02_SO_Def.ts`
+
+판정은 코드 읽기 · storage 6 프로젝트에 C군(옹벽 · 흙막이 · 소단) 자료가 없어 화면 실측은 못 함(노면공 · 위험표시만 있음).
+
+## 1. 한눈 결론
+
+1. 지금 고를 수 있는 「노면공이 아닌데 범위를 갖는 구조물」은 **옹벽 · 흙막이 · 소단(C) + 가드레일(E)** 넷뿐. 107 답의 B군 6종 · 비탈면 녹화(F)는 정의에서 꺼짐 · 대피소 · 정차·작업장은 「대피로(점형) 상세」로 흡수된 옛 자료. 소단은 길이 · 전 · 후 칸이 숨어 **기준 ±5 m(10 m) 고정**.
+2. 109 까닭: 3D 노란 띠 · 라벨은 **관 + A군만** 그림. 서버가 소단 시작 · 기준 · 종료 측점을 심어도 3D 와 종단 그래프가 서버 비정규 측점을 일부러 걷어 내고(STN:27 · PR:240), 대신 넣는 화면 목록이 A군만 담음(PS:147-151).
+3. 더 큰 구멍(코드 판정): **B05 [저장]이 「관 + A군」 목록으로 종단 비정규 측점을 통째 갈아 끼움** → 심어 둔 C군 측점 · 독립 기슭막이 시작/종료 측점이 지워짐(관이 하나라도 있을 때).
+4. 같은 누락: 옹벽 · 흙막이 · 독립 기슭막이 시작/종료 · E군 전부 · 노면공 · 기타 = 3D 측점 표기 없음. B06 종단 측점선은 관만(A군 수동 3종도 없음).
+5. 그 밖 어긋남: B06 고르기에 꺼진 F 2종 · 쇄석 포설이 보임 · M02 「안 씀」과 화면 가림(코드 상수)이 따로 놂 · B07 평면 대피소 기호가 옛 `refuge` 만 봄 · DEF comment 낡음.
+
+## 2. 지금 켜진 구성 표
+
+고르기 규칙 — B05 = 정의 켜짐 · 군 B · D 가림 · 종류 돌쌓기(찰 · 메) · 큰돌쌓기 가림 · 옛 대피 3종 뺌(PS:320-323 · PT:41-65 · 85 · DEFN:221-229). B06 = 정의 켜짐을 안 봄(SP:366-370 `setTypes(types)` · 가림 상수만). M02 = 42종 전부 + 「안 씀」 표시(M02D:137-147 · 가림 상수 모름).
+
+| 군 | type_id | 이름 | placement | 정의 enabled | B05 고름 | B06 고름 | 비고 |
+|---|---|---|---|---|---|---|---|
+| A | pipe · box_culvert · ford_pavement · ford_bridge | 배관 · BOX암거 · 물넘이포장 · 세월교 | point | 켜짐 | 있음 | 있음 | 관 정본(pipe_points) |
+| A | cross_drain_exposed · open_ditch · cross_underdrain | 노출형 횡단수로 · 개거 · 맹암거 | point | 켜짐 | 있음 | 있음 | structures.json |
+| B | ditch_side · ditch_ridge · ditch_berm · chute · slope_drain · underdrain | 측구 등 6 | interval | 꺼짐 | 없음 | 없음(군 가림) | 표 07 숨김 |
+| C | retaining_wall · soil_guard | 옹벽 · 흙막이 | interval | 켜짐 | 있음 | 있음 | 기준 + 길이 · 전 · 후 |
+| C | berm | 소단 | interval | 켜짐 | 있음 | 있음 | 길이 10 · 전 5 · 후 5 숨김(PO:162-175 · DEF 표시 3575) |
+| C | masonry_wet · masonry_dry · boulder_masonry | 돌쌓기(찰 · 메) · 큰돌쌓기 | interval | 켜짐 | 없음 | 없음 | 코드 가림(PT:44-48 · 54-31) |
+| D | erosion_check · bed_sill · check_dam_small | 골막이 · 바닥막이 · 소형사방댐 | point | 켜짐 | 없음 | 없음 | 군 가림 · bed_sill 은 comment 상 「삭제」인데 남음(DEF:2295) |
+| D | revetment | 기슭막이 | point(관 정본) | 켜짐 | 관 시설로 | 관 시설로 | 독립 기슭막이 = 시작~종료 |
+| E | evac_road | 대피로 | point | 켜짐 | 있음 | 있음 | 상세 = 대피소 · 정차/작업장 · 차돌림곳 |
+| E | refuge · work_yard · turnaround | 대피소 · 정차·작업장 · 차돌림곳 | interval · interval · site | 켜짐 | 없음 | 없음 | 옛 종류 · 고치면 대피로로 저장 |
+| E | mirror · curb · hazard_sign · position_sign · water_intake · barrier_gate · completion_sign | 반사경 등 7 | point | 켜짐 | 있음 | 있음 | |
+| E | guardrail | 가드레일 | interval | 켜짐 | 있음 | 있음 | 기준 + 길이 · 전 · 후 · 「측점 범위」 줄 보임(PNL:159) |
+| E | spoil_bank · borrow_pit | 사토장 · 토취장 | site | 켜짐 | 있음 | 있음 | 한 측점 + 부피(범위 아님 · SCH:217-226) |
+| F | wildlife_path · revegetation | 야생동물 이동통로 · 비탈면 녹화 | point · interval | 꺼짐 | 없음 | **있음** | B06 고르기에 새어 나옴 |
+| G | pavement_concrete | 콘크리트 포장 | interval | 켜짐 | 있음 | 있음 | 시작 · 종료 직접(byRange) |
+| G | gravel_surfacing | 쇄석(자갈) 포설 | interval | 꺼짐 | 없음 | **있음** | B06 고르기에 새어 나옴 |
+| 호환 | etc | 기타 | point | 켜짐 | 있음 | 있음 | 수기 이름 |
+
+- 「노면공이 아닌 범위형 · 지금 켜짐 · 고를 수 있음」 확정 = **옹벽 · 흙막이 · 소단 · 가드레일**. 돌쌓기 3종은 정의상 켜짐이나 화면에서 가림 · 옛 값만 열림.
+- TBL 01~09 대조: 표의 종류는 정의에 모두 있음. 정의에만 있는 것(B · D · F군 · 돌쌓기 3 · 옛 대피 3 · 쇄석)은 화면이 가림 — 단 B06 의 F 2 · 쇄석은 새어 나옴. 표 09 「소단 높이」는 178-2 로 숨김(깊이 칸도 194 로 숨기고 횡단도에서 측점마다 고름) — 결정된 변경이라 누락 아님.
+
+## 3. 종류별 화면 반영 대조 표
+
+| 종류 | ① 좌측 목록 | ② 종단 알약 · 측점선 | ③ 3D 띠 · 라벨 / 메쉬 | ④ B06 카드 · 측점 심음 | ⑤ B07 · B08 |
+|---|---|---|---|---|---|
+| 관 4종 | 있음(기준) | 알약 · 측점선 있음(물넘이 = 알약만) | 띠 · 라벨 있음(물넘이 없음) · 메쉬 있음 | 형상 · 심음 있음 | B07 평면 기호 · 횡단 덧그림 · B08 횡단배수 집계표 |
+| 독립 기슭막이 | 있음 | 알약 · 측점선 **기준만** | 띠 · 라벨 **기준만** · 벽 메쉬 있음 | 시작 · 기준 · 종료 심음 · 형상 | B07 횡단 · B08 흙막이 열 |
+| A 수동 3종 | 있음 | 알약 · 측점선(B05) · **B06 측점선 없음** | 띠 · 라벨 있음 · 메쉬 없음 | 심음 · 형상 없음(카드 제목만) | B08 개소 1(SIMPLE) |
+| 옹벽 · 흙막이 | 있음(시작~종료) | 알약 + 범위 띠 · **측점선 없음** | **띠 · 라벨 없음** · 벽 메쉬 있음(측점 있을 때) | 시작 · 기준 · 종료 심음 · 벽 형상 | B07 횡단 덧그림 · B08 조합 연결 때만 |
+| 소단 | 있음(시작~종료) | 알약 + 띠 · **측점선 없음** | **띠 · 라벨 없음** · 메쉬 = 비탈 계단(측점 행에서만) | 심음 · 형상(design.berm · 178-2 한 단 · 194 깊이) | B07 평탄부 판정 · 토공 면적에 섞임 · 조합 연결 때만 |
+| 가드레일 | 있음 | 알약 + 띠 | 없음 | 없음(안 심음) | 조합 연결 때만 |
+| 대피로 · E 점형 7 | 있음 | 알약 | 없음 | 없음 | **B07 평면 대피소 기호 = 옛 refuge 만** · 조합 |
+| 사토장 · 토취장 | 있음 | 알약 | 없음 | 사토 단면(가까운 측점) · 토취장 없음 | B07 평면 사토장 기호 · 조합 |
+| 콘크리트 포장 | 있음(시작~종료) | 알약 + 띠 | 없음 | 카드 포장 · 안 심음 | B07 횡단 포장 덧그림 · 조합 |
+| 기타 | 있음(이름) | 알약 | 없음 | 없음 | 조합 |
+
+근거: ① LST:54-57 · 156-243 / ② MRK:176-188 · PS:139-167 · PR:236-245 · VP:83-104 / ③ STN:22-63 · MK:334-352 · 405-464 · CS:285-289 / ④ SCH:143-157 · ES:296-311 · SS:76-101 · WL:35-41 · 123-176 · `B06_Section_Engine_SpoilFill.py`:97 / ⑤ B07P:82 · 431-434 · B07O:485-506 · B08S:79-81 · `M02_MasterTemplete/M02_Table_Fill.py`:104-108 · `B07_DesignDetail_Engine_SlopeGeometry.py`:178-180.
+
+## 4. 109 — 소단이 3D 에서 측점 표기가 안 되는 까닭
+
+- **그리는 규칙**: 3D 띠 = 종단 정본의 규칙 측점 + 화면 목록 비정규 측점. 서버 비정규 측점은 「옮기기 전 자리 남음」을 막으려 버림(STN:24-27). 화면 목록 = 관 투영 + A군 수동만(PS:147-151 · 165-167). ⇒ 소단 측점이 종단 정본에 있어도 3D 띠 · 라벨 없음. 종단 그래프 세로선도 같은 규칙(PR:236-245). 라벨은 비정규면 「측점 + 이름」(MK:345-348)이라 목록에만 들면 바로 「소단」이 붙음.
+- **측점 심기**: 178-1(24aba4008)로 C군 구간형 시작 · 기준 · 종료를 심음(SCH:143-157 · ES:296-311). 심는 때 = B06 [측점 만들기] · B06 저장 중 행 없는 측점 수정(RS:209-228 · RC6:90-103) · 전체 재생성. **B05 구조물 저장은 안 심음**.
+- **B05 [저장]이 지움**: PA:52-68 이 「관 + A군」 목록을 보냄 → RL:59-61 → RC:341-375 → RC:265-290 이 비정규 측점을 **통째 교체**. 심어 둔 소단 · 옹벽 · 흙막이 측점과 독립 기슭막이 시작/종료가 빠짐. ES:446 「단일 공급자 = resolve_extra_stations」 원칙과 어긋남(B06 재생성 RS:145-200 은 서버 목록을 씀).
+- **10 m 고정 범위와 겹침**: 소단 = 기준 ±5 m. 측점간격 20 m 면 범위 안 규칙 측점이 없을 수 있음 → 심은 측점이 없거나 지워지면 카드 · 3D 어디에도 소단 형상이 안 섬.
+- **194 측점별 깊이**: `berm_depth_{side}_m` 은 측점 patch → 측점이 지워지면 그 깊이도 받을 행 없이 떠돎. **178-2 한 단**: 각 측점 설계선에만 서므로 3D 계단도 측점 행에서만 생김(측점 사이는 로프트 보간).
+- **같은 누락**: 옹벽 · 흙막이(띠 · 라벨 없음 · 벽 메쉬는 있음) · 독립 기슭막이 시작/종료(기준만) · E군 · 노면공 · 기타(처음부터 측점 표기 대상 아님) · B06 종단 측점선(관만).
+
+## 5. 누락 목록 · 고칠 거리 (고치지 않음)
+
+| # | 누락 | 고칠 거리 | 크기 | 위험 |
+|---|---|---|---|---|
+| 1 | 3D · 종단 그래프에 C군 측점 표기 없음 | PS `crossDrainStationsOf` 를 서버 규칙 거울로(A + C · D 구간형 시작 · 기준 · 종료) · 두 파일 머리에 짝 · 거울 시험 · ▲▼ 기울기 단추는 A군만 남김 | 작음~중 | 계획고 편집 키가 새 측점에도 붙음 · 0.1 m 겹침 지움(STN:53) |
+| 2 | B05 [저장]이 C군 측점을 지움 | RC `_append_irregular_cross_sections` 도 `resolve_extra_stations`(서버 목록)로 — 화면 목록은 안 믿음 | 작음 | 관 초안이 저장 차례상 먼저 나가 서버 목록이 최신(`A00_Common/design/design_save.ts`:31-38) · 시험 test_192_1 · test_213_1 손봄 |
+| 3 | 독립 기슭막이 시작 · 종료 3D 표기 | 1 과 함께 — PS `pipesToStations` 에 시작 · 종료 | 작음 | 1 과 같음 |
+| 4 | B06 종단 측점선 = 관만 | VP `pipeStations` 를 B05 와 같은 목록으로 | 작음 | B06 카드 고름 연동 |
+| 5 | B06 고르기에 꺼진 F 2 · 쇄석 | SP:370 `setTypes(types, t => t.enabled)` | 한 줄 | 옛 값 열기는 그대로 |
+| 6 | M02 「안 씀」 ≠ 화면 가림 | 가림 상수(B · D군 · 돌쌓기 3 · 옛 대피 3)를 정의 `enabled:false` 로 옮기거나 M02 에 「화면 가림」 표시 | 중 | B06 재사용 뜻(DEF comment)과 엮임 · M02 판 올림 |
+| 7 | B07 평면 대피소 기호 = 옛 refuge 만 | B07P:431-434 에 대피로 상세 「대피소」도 셈 | 한 줄 | 없음 |
+| 8 | DEF comment 낡음(「G 꺼짐」 · 「bed_sill 삭제」) · bed_sill 남음 | comment 고침 · bed_sill 정리 여부 결정 | 작음 | M02 판 올림 |
+| 9 | E군 · 노면공 3D 표기 없음 | 필요 여부 결정 — 측점을 안 심는 종류라 띠 대신 3D 알약 · 범위 띠 같은 새 표기 | 중 | 3D 글자 겹침 |
+
+- ⬜ 3D 표기 범위: (가) C군만 / (나) C군 + 독립 기슭막이 시작 · 종료(= 서버가 실제로 심는 측점과 같게) / (다) 모든 구조물 — 추천 (나).
+- ⬜ 5번 B06 F 2 · 쇄석: (가) 가림(표 07 · 08 에 없음) / (나) 그대로 — 추천 (가).
+- 묶음 추천: 2 → 1 · 3 → 4 차례(2 가 원천 · 1 은 표기).