Aislo/docs/guide/B05_B06/rules.md

type, status, related_pages, last_updated, source

type	status	related_pages	last_updated	source
concept	stable	design_page/index design_page/operations_common design_page/values design_page/calculations design_data_lifecycle	2026-10-19	CLAUDE.md §5 docs/raw/조사/2026-10-19_465_요구272_값안변함.md docs/raw/조사/2026-10-19_470_B05B06_데이터흐름.md PLAN.md 466 · 467 · 468 · 472

B05 · B06 지킬 규칙

불변 규칙

규칙	지키는 자리(파일:줄)	시험
파생값 = 입력(저장 정본 + 세션 초안)만의 함수 — 보기 차례 · 접힘 · 메모리 · 새로고침 · 들어온 길로 안 갈림	logic/design_pipeline.ts:49 STAGE_DEPS · design_pipeline_page.ts:545-568 reconcile	test_272_*
상세 가게 메모리 = 페이지 수명 — 떠남 = forgetSectionMemory · [저장] · [확정] · [초기화] · 노선 저장 = invalidateSectionDetail	design_page.ts:294 · design_shared.ts:428 · 435 · design_reset.ts:41 · design_view_profile.ts:469 · B05_Profile_UI_RouteEdit_Apply.ts:171 · 211	test_272_detail_memory
[폐기] = 세션 고침 칸만 지움 · 메모리는 떠남(dispose)이 비움	design_leave.ts:85-87 · design_page.ts:286-295	test_346_4_design_leave
조용한 차례(열 때 · 노선 초안 버림) 끝 = 가게 측점 · 종단 = 지금 상세 측점 · 저장 기준 · 같은 목록은 다시 안 냄	design_pipeline_page_publish.ts shown · opened · design_pipeline_page.ts:392-393 · 530	test_272_drop_store_stations
노선 초안 없는 차례 = 서버 정본 측점 기하 · 표본을 브라우저 값으로 안 덮음(같은 자리 0.01 m · 축 1e-3 → 앞 횡단 → 그 자리 옛 횡단 → 저장 정본) · 지금 상세에 없던 측점이 정본 자리로 돌아옴(관 지움 ↶) = 정본 설계	logic/B06_Section_Station_Swap.ts:171-182 · 241-249 · 304-315 · B06_Section_Section_Store.ts:241-248	test_272_swap_keeps_canon
노선 초안 차례 = 새 · 옮긴 측점만 브라우저 지반 표본	logic/B06_Section_Station_Swap.ts:249-251	test_346_2_station_swap
다시 셈 입력 물러섬 = 세션 고름 → 저장 정본 설계 → config 기본값 · 고름 단추는 메모리 상세 설계를 안 덮음	B06_Section_Cross_Refresh.ts:402-408 · B06_Section_UI_Page_Design_Sync.ts:59-104	test_272_choice_undo
소단 사본 쓰는 자리 = 시설 줄 하나(B05 만 열어도) · 같으면 안 씀 · 사본 없으면 저장분 design.berm	design_facility_lane.ts:151-166 · B06_Section_Cross_Refresh.ts:362-368	test_272_berm_source
두 보기가 보는 파생값은 페이지 한 벌이 숨은 동안도 셈 · 보기는 그리기만 · 접힘 = 그리기만 건너뜀	design_facility_lane.ts:1-12 · B05_Profile_UI_Profile_Render.ts:211-226	test_272_hidden_summary · test_271_facility_lane
되돌리기 걸음 = 사용자 조작으로 값이 실제로 바뀐 때만 · 빈 칸(「""」「{}」「null」) = 칸 없음 · 빈 칸 쓰기 = 칸 지움	B05_Profile_UI_Profile_History.ts:50 · 235-236 · B06_Section_Session_Cells.ts	test_272_history_empty_cells
시설 줄 측점 = 종류 표 · 구조물 · 관 알림이 다 온 뒤만 심음 · 그 전 종단도 = 저장 측점 · 저장 기준 그대로(모름 ≠ 빈 목록)	design_facility_lane.ts known · design_profile.ts planted · design_profile_base.ts listedBase · design_view_profile_sections.ts stationsReady · B05_Profile_UI_Profile_Render.ts deriveProfile	test_473_lane_ready
짝 없는 새 측점(구조물 · 추가 측점 · 새 관) = 계획선 꼭짓점 안 세움 · 짝 있는 옮긴 측점 = 꼭짓점 따라감	common_util_structure_station.ts:356 · B05_Profile_Router_Confirm.py:306-400	test_427_1_follow_seat · test_459_route_seat_mirror
구조물 측점 다시 뜸([저장] 상단측 차례 · 측점 맞춤) = 같은 자리 옛 줄의 상단측 출처(user 면 값도) · 포장 제안 표기 들고 감 · 새 자리 포장 표기 = 지금 계획선	B05_Profile_Router_Confirm.py:426-465	test_472_station_user_fields
[저장] · [확정] = 서버가 입력만으로 정본 다시 셈 · 브라우저 결과(면적 · 표본 · 측점) 받아 적지 않음	design_save.ts:58-68 · B06_Section_Router_Confirm.py:203-215	test_b06_save_recompute
자동저장(디바운스 PUT) 없음 · 화면 잠금 = [저장] · [확정] · [초기화] · 추천 [적용]만	design_save.ts:249	—
측점 열쇠 = common_util_station_key 한 벌 · 노선 바뀜 = 관 · 구조물 좌표(x · y) 따라감 · 누가거리 다시 매김	common_util_station_key.ts:32 · common_util_route_follow.ts:291	test_344_3_station_key_mirror · test_410_follow_xy
노선 바뀜 넘김 = 열쇠마다 지반 · 측구 종류 · 측구 선택 · 사면 쉬프트 · 소단 · 소단 깊이 · 자리 칸(SEAT_KEYS = 암 경계 · 암 절토 경사 · 2단 경사 · 손 상단측 = 단면 유형 · 측구 방향)은 같은 자리(sameSeat · 중심 0.01 m · 축 1e-3) 측점만 · 새 자리 = 기본값 · 세션 값은 쓴 때 자리(@seat)로 판정(↶ ↷ 유지) · 끌기 갈아끼움 · 미리보기 · Node 넘김 · 서버 노선 저장 한 규칙	logic/B06_Section_Station_Swap.ts SEAT_KEYS · unseated · logic/B06_Section_Route_Carry.ts carryKeyedStates · B05_Profile/logic/B05_Profile_Pipeline_Detail.ts crossAtSeat · B05_Profile_Route_Save_Parts.py carry_cross_inputs	test_475_3_seat_carry
노선 초안 ↶(버림) = 차례 하나 · 버림 동안 종단도 그리기 멈춤 · 낡음 다시 셈 미룸 → 되돌림 · 저장 기준 맞춤 · 뒤 차례 끝에 한 번 그림(사이 섞인 유토곡선 없음)	design_pipeline_page.ts:642 · 403 · B06_Section_Section_Store.ts:316	test_472_5c_drop_once
추천 [적용] = 새 노선 기준 초기화 — 종단 = 새 규칙 초기 종단(끔 · 균형 셈 실패 = 1차 계획선 438 · L 20 · 켬 = 균형 종단을 꼭짓점에 얹음) · 옛 계획고 · 편집 · L · 횡단 손 입력 안 넘김(요구 277 · 측점마다 기본 설계) · 손 노선 저장만 옮김 · 넘김	B05_Profile_Route_Save.py run_route_save_chain initial · carries_cross_inputs · 미리 보기 = B05_Profile_Engine_InitialProfile(같은 조각)	test_476_1_apply_initial · test_476_1_recommend_initial
B05 · B06 캐시 = 한 벌 · [저장] 한 번에 함께 나감	design_shared.ts:395-448 · design_save.ts:237	—
관 · 구조물 주인 = 가게 칸 하나 — 화면 사본은 가게 알림으로 맞춤(제 쓰기는 같은 값 · 남 고침은 다시 실음)	design_view_profile.ts 가게 구독 · design_view_cross.ts onShop · B06_Section_UI_Page_Structures_Panel.ts seen	test_472_5_shop_owner
정본 자리 = 값을 낳은 주인 — 노선 시설 = pipe_points.json · structures.json · 횡단 값 = 횡단 패치	B05_Profile_Api_Pipes_Draft.ts:30-37 · B05_Profile_Structures_Router.py:386-405 · B06_Section_Section_Store.ts:449	—
열기만 = 초안 칸 없음 — 값이 저장분과 같으면 칸 없음(표준 횡단 = 결과 칸 section-context 에서 읽음) · 카드 고름 = 바꾼 칸만 · 소단 사본 = 떠남 확인 밖	B06_Section_UI_Standard_Panel.ts effectiveStandardCross · persist · B06_Section_UI_Cross_Design.ts emit · B06_Section_UI_Page_Design_Sync.ts handleDesignChange · design_leave.ts NOT_EDITS	test_472_open_no_draft
관 자리 읽기 한 벌 = 지금 노선에 얹은 관 지점(측점 계획 · 관 지점 GET · 서버 상세 형상 얹기 · 카드 이름 · 세월교 노면 하강 · 물넘이포장 구간 · B07 관 글 · 화면) — 지문 어긋난 옛 저장분도 같은 자리 · 관 파일 누가거리를 그대로 읽지 않음	B05_Profile_Engine_Sections.py:249 route_pipe_points	test_472_d_pipe_route_attach · test_472_d_route_pipe_readers

바꿀 때 할 일

경우	할 일
새 계산	CLAUDE.md §5 ① 짝 · ② TS → 서버 Node · ③ 서버 단독 중 먼저 고름 · design_page/calculations 한 줄
① 짝	두 파일 머리에 짝 · 거울 시험 이름 · resources/tester 거울 시험
② TS → Node	끌려가는 파일 모듈 맨 위 DOM · window · sessionStorage 금지 · 묶음 다시 지음
조작 · 흐름 바꿈	같은 커밋에 design_page/operations_b05 · design_page/operations_b06 · design_page/operations_common · design_page/values 고침
새 세션 칸	b_page_state.ts 등록부 · 저장 타입 · design_page/session_keys
새 메모리 사본	비우는 때(떠남 · [폐기] · [저장] · [확정] · [초기화])를 정하고 design_page/values 사본 칸에 적음
줄 번호	고친 함수의 줄이 바뀌면 이 폴더 줄 번호도 고침

예외 · 남은 틈

내용	자리(파일:줄)	상태
저장 밖 정본 쓰기 셋 — 넓힘 /regenerate · [측점 만들기] · 추천 [적용](즉시 저장 · [저장]과 같은 프로젝트 잠금 · 떠 두고 실패면 되돌림 · 476 ④)	B06_Section_Router.py:378-388 · B06_Section_Router_Stations.py:236-296 · B05_Profile_UI_RouteEdit_Apply.ts:220-245 · B05_Profile_Router_Replan.py replan_route	사용자 확정(요구 275 ②) · 확인창
pipe_points.json 한 [저장]에 두 번 PUT(관 · 관 옵션)	B06_Section_Api_Culvert_Options.ts:67-95	코드 확인
노선 바뀐 [저장]의 관 옵션 차례 = 옛 노선 열쇠(누가거리 · 관이 따라 옮긴 새 자리와 안 맞으면 안 얹힘)	design_save.ts:145 · B06_Section_Router_DesignSave.py _patched_points	추정 · 옛 길과 같음
↶ ↷ 가 세션을 직접 되씀 — 관 · 구조물 · 추가 측점은 되쓴 뒤 가게 듣는 쪽을 부름(announceDesignStore · 472-5) · B06 조정창 = 세션 칸이 주인(사본 없음) · 칸이 바뀐 걸음만 상세 얹기 · 카드 · 면적 다시(472-5 5-D) · 암선 · 암 경사 · 상단측 = 세션 칸이 주인(사본 없음 · 472-5)	B05_Profile_UI_Profile_History.ts apply · design_store.ts announceDesignStore · B06_Section_UI_Page_Station_Controls.ts onRestore · B06_Section_UI_Page_Persist.ts readCells	관 · 구조물 = test_472_5_shop_owner · 관 초안 없는 걸음 = 저장분 · ↶ 켜짐 = test_472_d_b05_pipe_undo · 조정창 = test_472_5d_adjust_owner · 암선 · 암 경사 = test_472_5r_rock_owner
스냅 켬 · 간격 = 되돌리기 밖	B05_Profile_UI_RouteEdit_SnapStep.ts:74-78	추정
flushDesignStore 부름 없음 — 멈춘 뒤 1 s 안 새로고침 = 가게 세션 사본 잃음(다시 셈)	design_store.ts:179	코드 확인
「[]」 — 되돌리기 = 값 · 떠남 확인 = 빈 칸	B05_Profile_UI_Profile_History.ts:50 · design_leave.ts:41-42	코드 확인
단면 모양 기본값 짝 다름(X1)	B06_Section_Cross_Refresh.ts:438 · B06_Section_Router_Design.py:402	사용자 협의