docs(wiki): ingest plan evidence e f g

2026-09-10 20:46:04 +09:00
parent 610949afce
commit fb7bab52a9
16 changed files with 23546 additions and 9 deletions
@@ -3,7 +3,7 @@ type: completion-summary
 status: stable
 related_pages: ["[[B06_Section/B06_backend]]", "[[B07_DesignDetail/B07_standard_drawings_2026_09]]", "[[B08_Quantity/B08_overview_2026_09]]", "[[B08_Quantity/B08_2026_09_09_completion]]", "[[B09_Estimation/B09_overview_2026_09]]", "[[B09_Estimation/B09_2026_09_09_completion]]", "[[quantity_cost_contract]]"]
 last_updated: 2026-09-10
-source: ["docs/raw/plans/2026-09-09_plan_완료분_이관.md", "docs/raw/plans/2026-09-09b_plan_완료분_이관.md", "docs/raw/verification/2026-09-09_B06_화면검증_사토장과_V6V7.md", "docs/raw/verification/2026-09-09_완료분_확인으로_닫은것.md", "docs/raw/verification/2026-09-09b_확인으로_닫은것.md", "docs/raw/verification/2026-09-10_계획서_8_9장_완료근거_이관.md"]
+source: ["docs/raw/plans/2026-09-09_plan_완료분_이관.md", "docs/raw/plans/2026-09-09b_plan_완료분_이관.md", "docs/raw/verification/2026-09-09_B06_화면검증_사토장과_V6V7.md", "docs/raw/verification/2026-09-09_완료분_확인으로_닫은것.md", "docs/raw/verification/2026-09-09b_확인으로_닫은것.md", "docs/raw/verification/2026-09-09e_계획서_완료근거_이관.md", "docs/raw/verification/2026-09-09f_계획서_공통기반과_참고_이관.md", "docs/raw/verification/2026-09-09g_계획서_0_3_4장_완료근거_이관.md", "docs/raw/verification/2026-09-10_계획서_8_9장_완료근거_이관.md", "docs/raw/verification/2026-09-10_계획서_e_f_g_이관_교차검증.md"]
 ---

 # 2026-09-09 완료 구현·검증
@@ -16,6 +16,9 @@ source: ["docs/raw/plans/2026-09-09_plan_완료분_이관.md", "docs/raw/plans/2
 - 사토장은 별도 면적·용량·말풍선으로 표시되고 삭제 시 토량이 복구된다. 화면 검증에서 잔상과 0에 가까운 가짜 경고를 수정했다.
 - B05 흙막이 폼에는 B05 단계 입력만 표시한다. 상세 제원은 B06·B07 책임이다.
 - B06 설계 엔진의 기하 계산을 별도 모듈로 분리했으며 계산식은 바꾸지 않았다.
+- 측구 선택은 캐시·저장 스키마까지 연결했고, 저장·확정 직전 전 측점을 다시 계산해 옛 표준단면 면적과 새 옵션이 섞이지 않게 했다.
+- 약 92초의 재설계 중간 취소는 관 지점 삭제 뒤 반쪽 상태를 만들 수 있어 만들지 않았다. 3분 초과 또는 단계별 롤백이 가능해질 때 재검토한다.
+- B03 업로드 잠금은 시작 사용자 이름과 사유를 화면에 표시한다. 이름이 없는 옛 작업도 잠금 자체는 유지한다.

 ## B07 표준도

@@ -24,6 +27,7 @@ source: ["docs/raw/plans/2026-09-09_plan_완료분_이관.md", "docs/raw/plans/2
 - 실무 구조도 53개 탭 대조에서 찰쌓기 11줄·메쌓기 8줄, 고임돌 0.15, 채움콘크리트 0.20, 모르터 0.009를 확인했다.
 - 틈메우기돌은 실무 구조도에서 확인되지 않아 넣지 않았다. 버림 콘크리트는 실무와 도로기준의 100 mm 근거가 일치한다.
 - 개거 2규격과 떼흙막이 원단위를 구현했다. 근거가 없는 형식은 미확보 사유를 유지한다.
+- 돌쌓기 상·하부 두께는 사용자 입력을 우선하고 빈칸이면 뒷길이·높이 식으로 계산한다. 날개벽 다섯 형식은 실무 탭 소계를 보존한다.

 ## B08 수량산출

@@ -0,0 +1,32 @@
+---
+type: concept
+status: stable
+related_pages: ["[[B03_FileInput/B03_backend]]", "[[B05_Profile/B05_backend]]", "[[B06_Section/B06_backend]]", "[[workflow_state]]", "[[multi_environment_safety]]"]
+last_updated: 2026-09-10
+source: ["docs/raw/verification/2026-09-09f_계획서_공통기반과_참고_이관.md", "docs/raw/verification/2026-09-10_계획서_e_f_g_이관_교차검증.md"]
+---
+
+# 설계 데이터 생명주기
+
+## 정본 세 벌
+
+| 구분 | 위치 | 쓰는 시점 |
+|---|---|---|
+| 초기값 | `initial_snapshot/` 파일과 DB 행 덤프 | 업로드 직후 자동설계 체인이 한 번 생성; 초기화만 읽음 |
+| 작업본 | DB와 `route/`·`longitudinal/`·`cross_sections/`·`drainage/` 정본 파일 | 사용자가 저장·확정을 누를 때만 갱신 |
+| 브라우저 캐시 | `sessionStorage`, `A00_Common/b_page_state.ts` 등록표 | 화면 조작 중 사용; 저장·확정 때 작업본으로 전달 |
+
+초기값에는 다시 쓰지 않는다. B05·B06 화면은 작업본을 한 번 읽은 뒤 캐시에서 계산하며, 파일·DB·래스터나 3D 코리도처럼 서버 자원이 필요한 계산만 서버를 거친다.
+
+## 계획노선 규칙
+
+- 예상노선은 자동 체인의 불변 원본이고 계획노선은 사용자가 편집하는 복사본이다.
+- 노선 확인 때만 계획노선 기준으로 배수유역부터 재설계한다.
+- 횡단배수 지점은 새로 계산하고, 그 밖의 구조물은 사용자가 편집한 누가거리 값을 이어받는다.
+- 초기화는 예상노선을 계획노선으로 복사하며 재계산하지 않는다.
+
+## 계산 구현 원칙
+
+- 새 계획 계산은 TypeScript 한 벌을 기본으로 두고 브라우저와 서버 Node 진입점이 공유한다.
+- 파일·DB·래스터를 직접 다루는 계산만 Python에 둔다.
+- Python·TypeScript 거울 구현이 필요한 읽기 경로는 거울 시험으로 값의 일치를 지킨다.
@@ -1,9 +1,9 @@
 ---
 type: concept
 status: stable
-related_pages: ["[[architecture/shared_resources]]", "[[storage_paths]]", "[[workflow_state]]"]
-last_updated: 2026-09-09
-source: ["docs/raw/verification/2026-09-09d_OWNERS_이력.md"]
+related_pages: ["[[architecture/shared_resources]]", "[[storage_paths]]", "[[workflow_state]]", "[[design_data_lifecycle]]"]
+last_updated: 2026-09-10
+source: ["docs/raw/verification/2026-09-09d_OWNERS_이력.md", "docs/raw/verification/2026-09-09e_계획서_완료근거_이관.md", "docs/raw/verification/2026-09-09f_계획서_공통기반과_참고_이관.md"]
 ---

 # 다중 환경 저장소·공용 DB 안전
@@ -24,6 +24,7 @@ source: ["docs/raw/verification/2026-09-09d_OWNERS_이력.md"]
 5. 저장·확정·노선 확인 전에 영향을 받을 작업자에게 알린다.
 6. 수량 대조 전후 스냅숏에는 자료 시각과 `/api/health`의 `code_mtime`을 함께 기록한다.
 7. `tmp/`는 PC 사이 동기화를 보장하지 않으므로 검증 도구 존재 여부를 환경별로 확인한다.
+8. 검증 프로젝트는 `OWNERS.md`에 배정된 환경별 프로젝트만 사용하며 복제하지 않는다. 단면 존재 여부뿐 아니라 검증할 구조물·관·수량이 실제로 서는지도 먼저 확인한다.

 ## 재계산 영향

@@ -2,8 +2,8 @@
 type: concept
 status: draft
 related_pages: ["[[standard_drawing_cost_inputs]]", "[[B07_DesignDetail/B07_standard_drawings_2026_09]]", "[[B08_Quantity/B08_overview_2026_09]]", "[[B09_Estimation/B09_overview_2026_09]]"]
-last_updated: 2026-09-09
-source: ["docs/raw/verification/2026-09-09c_근거전문.md"]
+last_updated: 2026-09-10
+source: ["docs/raw/verification/2026-09-09c_근거전문.md", "docs/raw/verification/2026-09-09e_계획서_완료근거_이관.md"]
 ---

 # 2026-09-09 표준도·수량 미결 근거