chore(plan): 321 · 322 구조물 관리 표 조사 기록 — M02 정의 칸마다 따르나 · 코드 숨김 10종 · 군 순서 안 따름 · 「안 씀」 B05 만 · 종류 이름 바꿈 = 「기타」 유령 · 바꿈 안전 표 · 그리는 쪽 부품 목록(요구 220 다시 정밀 점검)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01C6BNBFXFndbqYxu6sZuknK
2026-10-14 13:22:30 +09:00
parent f8d5e0cbe1
commit 8dac0bf3f0
1 changed files with 71 additions and 0 deletions
@@ -0,0 +1,71 @@
+# 321 · 322 구조물 관리 표 — 조사 (요구 219 · 220)
+
+기준 = sub_laptop_2 2641c15e2(요구 217 반영) · 코드 수정 없음 · 보고서 = 아티팩트 https://claude.ai/artifact/RwfpjSehc9ZdAjXxcP8DQa (판 2).
+경로 줄임 — `B05/X` = `B05_Profile/B05_Profile_X` · `B06/X` = `B06_Section/B06_Section_X` · `SO/X` = `M02_MasterTemplete/StructOptions/M02_SO_X` · `dz/X` = `A00_Common/design/design_X` · `cu/X` = `common_util/common_util_X`.
+
+## 결론 한 줄
+
+갈래마다 「가리는 쪽」(종류 키 · 군 글자 · 자리꼴 · 정본 · 시설 이름)이 흩어져 있고 「그리는 쪽」은 이미 그림 자료만 봄 → 가리는 쪽을 M02 정의 표 + 코드 부품 상자 한 줄 읽기로 바꾸면 일곱 갈래가 표 하나를 따름. 종류 이름 직접 적은 곳 279곳 · 78파일(B05 · B06 · 공용) 거의 다 가리는 쪽.
+
+## 1. 정의 파일 · 퍼짐
+
+- 정본 `resources/master_template/구조물정의.json` 판 20 · 42종 · 틀 `docs/raw/M02_구조물옵션정의/정의_틀.md`.
+- 서버 읽기 `B05/Structures_Schema.py:108-136`(파일 시각 캐시 · 바로) · 예외 `B06/Engine_Culvert.py:150-160` `_registry_defaults` lru = 서버 다시 켤 때까지 옛 값.
+- 화면 `B05/Api_Structures.ts:196-224` typesCache = 탭 동안 한 번 · M02 화면 글 「바로 적용」(`SO/Text.ts:109`)과 어긋남.
+- 쓰기 `SO/Definition.py:200-214`(판 +1 · 이력 `구조물정의_이력/판_N.json`) · 검사 `:174-197`(정의 모양만 · 프로젝트 자료 안 봄).
+- 판 = `structures.json` 에만 적음(`B05/Structures_Repository.py:132-133`) · 읽는 곳 없음 · 관 지점 · 횡단 파일엔 없음 · 프로젝트별 정의 사본 없음.
+
+## 2. M02 화면 지금
+
+- `SO/Def.ts` — 고칠 수 있는 것 = 구조물군 이름 · 순서 · 종류 이름 · 순서 · 「안 씀」 · 이름 나무(`SO/Def_Spec_Model.ts:141-157` → 종류.이름 · 옵션 label · 그룹 이름) · 옛 편집기 `OLD_EDITOR=false`(:36) · 종류 더하기 없음 · 특수 동작 = 태그 보기만.
+- 이력 — PLAN 48(10-5 · M02 에서 바꾸면 코드 고침 없이 따라감 · 사용자 답 = 시스템 관리자만 · 바꿈 드묾 · 바로 적용 · 지난 값 이력) → PLAN 52(입력 구조 = 코드 명세 `dz/structure_pipe.ts:111` STRUCTURE_SPECS · M02 = 이름만) → 52-12 옛 편집기 숨김.
+- 옛 M02 화면(`SO/Options.ts` 보이기 · `SO/Groups.ts`)은 안 붙음 · PUT structure-options · -groups 는 붙어 있으나 부르는 TS 없음.
+
+## 3. 칸마다 따르나
+
+- 따름: 군 안 종류 순서 · 구조물군 이름 · 종류.이름(명세 폼 · 선택지 글) · placement(서버 저장 검사) · phase(일반 폼) · default(관 기본값 캐시 빼고).
+- 일부: enabled — 서버 안 읽음(`B05/Structures_Repository.py:171-193`) · B05 `setTypes(전부, 켜진 것)`(`B05/UI_Page_Structures.ts:353`) · B06 `setTypes(전부)`(`B06/UI_Page_Structures_Panel.ts:380`) · B06 저장 전 덧입힘 켜진 것만(`B06/Section_Store.ts:88-114` · 쇄석 사라짐) / name — 관 지점 고정 이름 `B05/UI_Page_Helpers.ts:230-236`(배관 = 「배수관」) · 도움말 `구조물_<이름>.md`(`B05/UI_Structures_Panel.ts:246`) · 사전조합 분류 = 군 · 종류 이름(`M02_MasterTemplete_UI_Side_Precombo.ts:52-60`) · 관 이름 config 관종(이중벽관 · 삼중벽관 · 파형강관) ≠ 정의 관종(흄관 · VR관 · 파형강관) / style.color — 알약 · 유역도 띠만 / 표시 · 규칙 · 배치 — 일반 폼만(명세 폼 안 따름) · 서버는 규칙 안 지킴.
+- 안 읽음: 구조물군 순서(드롭다운 군 = types 처음 나온 차례 `B05/UI_Structures_Panel_Types.ts:82`) · 동작(`B05/UI_Structures_Define.ts:208` 싣기만) · style.abbr · drawing_views(값도 실제와 다름 — 개거 · 가드레일 「횡단」) · 판.
+- 코드가 덮음: HIDDEN_PICK_GROUPS {B, D}(`Panel_Types.ts:41`) · HIDDEN_PICK_TYPES 돌쌓기 셋(:44-48) · ROAD_DETAILS 대피소 셋(`B05/UI_Structures_Define.ts:221-229`) → 정의에선 켜진 10종 숨김 · 군 글자 규칙(측점 A · C/D 구간 · 벽 C 구간 소단 빼고 · 포장 G · 숨김 B/D) · 정본 목록(`cu/drainage_pipes.py:62-75` · `B04_PreProcess/B04_PreProcess_Api_Fetch.ts:475`).
+
+## 4. 종류 이름 바꿈 = 「기타」 유령 (코드 확인 · 재현 전)
+
+- B05 열 때(탭 · 노선마다 한 번) 비정규 측점 이름을 이관 요청 `dz/view_profile.ts:460-482` → 지금 이름 · 관 이름 꼴에 없으면 etc · 이름 = 옛 이름(`B05/Structures_Migration.py:57-79` · `:120-133` · `:186-188`) → 자리 열쇠 「종류@측점」이 달라 새로 저장(`B05/Structures_Router.py:197-239`).
+- 걸리는 것 = A 구조물 셋 · C 구간형(측점 셋 = 유령 셋) · 관 지점 BOX · 물넘이 · 세월교 · 기슭막이 · 배관은 「관 D」 꼴이라 안전.
+- 서버 측점 이름 다시 붙이기는 지금 이름만(`B05/Engine_Sections.py:238-245`) → 카드에 옛 이름 남음.
+
+## 5. 바꿈 안전
+
+| 바꿈 | 지금 | 막을 것 |
+| --- | --- | --- |
+| 종류 이름 | 유령 · 옛 이름 · 도움말 · 사전조합 분류 | 이름 되짚기 걷음 · 이름표를 종류 키로 |
+| 칸 · 선택지 이름(이름 표) | 안전 | – |
+| 선택지 값 | 저장 400(`Repository.py:210-211`) · 집계 · 형상 글자 비교 조용히 빠짐 | M02 에서 못 바꿈 |
+| 안 씀 | 대체로 안전(서버 무시) · B04 자동 추천은 무시 | – |
+| 자리꼴 | 그 종류 가진 프로젝트 저장 400(`Repository.py:188-192`) · 묶음 저장은 구조물만 빠짐(`dz/save.ts:92-96`) | 만든 뒤 고정 |
+| 종류 지움 | 저장 400(`Repository.py:180-182`) · etc · revetment · refuge 지우면 이관 오류(`Migration.py:129`) | 지우기 없음 |
+| 군 글자 | 측점 · 벽 · 포장 · 숨김이 조용히 바뀜 | 만든 뒤 고정 |
+| managed_by | 새 관 지점 종류 = 서버가 배관으로(`cu/drainage_pipes.py:357`) | 만든 뒤 고정 · 정본 목록을 표에서 |
+| 종류 더하기 | 화면 없음 · 형상 · 3D 없음 | 본보기 복사 + 부품 |
+
+- 쓰는 곳 세기 — `storage/{회사}/{사용자}/{프로젝트}/B05_Profile/route/structures.json` · `B04_PreProcess/drainage/edits/pipe_points.json`(initial_snapshot 빼고) · 초안은 서버가 못 봄.
+
+## 6. 부품 (그리는 쪽 · 지금 함수)
+
+- 횡단도 — 기준 한 장 `cu/structure_station.ts:115 · 121`(A · 관 지점) · 세 장 `:117`(C · 기슭막이 이름 직접) · 파이썬 `B05/Engine_Sections.py:257-312` · 카드 이름 관 공식 `:209`(빈칸 D800) ↔ `B06/Section_Store.ts:177-181` · `B06/Section_Drafts.ts:129-134`(빈칸 D1000).
+- 형상 — 서버 얹기 차례 `B06/Router.py:283-289` · 화면 짝 `B06/Section_Store.ts:70-184` · 그리기 `B06/UI_Cross_View.ts:421-619`(그림 자료 열쇠로) · 관 세트 `cu/culvert_sets.ts:239`(py `B06/Engine_Culvert.py:284`) · 숨은 관 흙막이 :288 · 박스 :522 · 세월교 :443 · 물넘이 :488 · 도수로 :204 · 벽 `cu/structure_walls.ts:100 · 141`(기본 형태 :67 · 소단 빼기 `Section_Store.ts:103`) · 맹암거 `cu/structure_underdrain.ts:35 · 52` · 포장층 `cu/structure_pavement.ts:58 · 87`(G 군) · 사토 `B06/Engine_SpoilFill.py:101 · 169`(저장 때만).
+- 빈칸 — 관경 · 벽 높이 · 맹암거 높이 = 안 그림 · 경고 없음 / 물넘이 높이 · 기슭막이 높이 = 경고 칩 / 박스 · 세월교 = 기본값 칩.
+- 강조 — 관 부분 키 · 벽 own · 본체 · data-structure-id(맹암거 · 물넘이) · 포장층(G 글자) · 소단 조각 · 카드 범위 띠(관 지점은 늘 점이라 물넘이 · 기슭막이 없음).
+- 알약 `B05/UI_Structures_Marks.ts:177 · 190`(띠 = 놓인 것 자리꼴) · 3D 몸체 `B05/UI_Corridor_Structures.ts:273`(관 · 박스 · 세월교 · 도수로 · 벽 · 벽은 덮는 측점마다 겹침 :285 · 358 의심) · 3D 에 없음 = 포장층 · 맹암거 몸체 · 사토.
+- 종류 전용 — 월류 높이 `dz/structure_ford_calc.ts:23 · 35` · BOX 규격 `dz/structure_box.ts:20-127` · 날개벽 `cu/culvert_sets.ts:387 · 391` · 포장 물넘이 겹침 `B05/UI_Structures_Pavement.ts:41`(콘크리트 포장 키 직접 `Panel_Commit.ts:365`) · 대피로 상세 asRoad.
+- 어긋남 — 기슭막이 최소 덮개 TS 1.5 m(`B05/UI_Profile_MinCover.ts:61`) · 파이썬 0(`cu/drainage_pipes.py:554`).
+
+## 7. 요구 219 흠 (요약)
+
+- 일반 측점 자리(No.N+0 · BP · EP)에 새로 놓은 구조물 = 저장 전 카드 이름 · 관 없음(`B06/Section_Drafts.ts:222 · 226 · 233-239`) — 코드 확인.
+- 쇄석 = 구조물 초안이 있으면 저장 전 포장 지움(`B06/Section_Store.ts:91-92`) · 서버는 G 모두 그림.
+- B06 종단 띠 = 관만(`B06/UI_Section_View_Profile.ts:92-110 · 179-193`).
+- 서버 같은 측점 이름 = 마지막 것(`B05/Engine_Sections_Core.py:338-341`) · 낡음 판정 = 자리만(`B06/Router_Stations.py:139-154`).
+- 그리기가 조정값을 세션에 적음(`B06/UI_Page_Station_Controls.ts:280-286`) — 재현 전.
+- 같은 정본 종류 바꿈은 구조물 쪽 조정값 안 버림(`B05/UI_Structures_Panel_Events.ts:136` 관만) · E · F 점형 ↔ 구간형 조용히 되돌림(`Panel_Events.ts:126-139` · `Panel_Commit.ts:287-317`).
+- 3D 해시 = 손으로 고른 칸(`B05/UI_Corridor_Structures_Hash.ts`) · B05 restoreSections 은 처음 · 노선 읽을 때만.