feat(가이드): D01 예정노선 등록 가이드 글 8 · 그림 8 · 장면 목록(PLAN 542-1 · 요구 359 · 360)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-26 09:14:48 +09:00
parent f7b90be3e5
commit 564a522a6e
17 changed files with 220 additions and 29 deletions
@@ -1,35 +1,35 @@
-# 예정노선 등록 설명서
+# 예정노선 등록

-## 이 화면에서 하는 일
- 여러 해에 걸친 예정노선의 기본 정보(사업 연도 · 지역 · 임도 종류 · 설계속도 · 이름)를 넣고 새 예정노선 프로젝트를 만드는 첫 화면임.
- 대시보드의 [+] 에서 「예정노선」 카드를 고르면 이 화면이 열림.
- 도면 관련 칸은 없음. 노선의 실제 위치는 만든 뒤 다음 화면(1단계 기준 지정)에서 정함.
- 예정노선은 **산림청만** 만들 수 있음. 산림청 = 시스템 관리자 또는 메일 주소가 `.go.kr` 로 끝나는 사용자임.
+여러 해에 걸친 예정노선의 기본 정보(사업 연도 · 지역 · 임도 종류 · 설계속도 · 이름)를 넣고 새 예정노선 프로젝트를 만드는 첫 화면.
+
+## 여는 길
+
+- 대시보드 프로젝트 줄 위의 [+]를 누르고 「새 프로젝트」 창에서 「예정노선」 카드를 고름. [새 프로젝트 여는 길](D01/01_새_프로젝트_여는_길) 참고.
+- 예정노선은 **산림청만** 만들 수 있음. 산림청 = 시스템 관리자 또는 메일 주소가 `.go.kr` 로 끝나는 사용자.
+
+![화면 한눈에](D01_00_overview.webp)
+
+## 화면 구역
+
+| 번호 | 구역 | 하는 일 |
+| --- | --- | --- |
+| 1 | 사업 연도 시작 · 끝 | 사업 기간을 넣음. 한 해짜리면 두 칸을 같은 해로 둠 |
+| 2 | 사업 지역 | 사업이 있는 지역 이름을 적음. 꼭 넣어야 하는 칸 |
+| 3 | 임도 종류 · 설계속도 | 임도 종류를 고르면 옆 설계속도 목록이 따라 바뀜 |
+| 4 | 프로젝트명 | 위 칸을 채우면 이름이 저절로 만들어짐. 직접 고쳐도 됨 |
+| 5 | 노선 누가거리 | 노선 시작 · 종료 누가거리(m). 비워 두어도 됨 |
+| 6 | 단추 줄 | [?] 도움말 · [취소] 대시보드로 돌아감 · [등록] 프로젝트를 만듦 |

 ## 작업 순서
-1. 대시보드에서 [+] 를 누르고 「예정노선」 카드를 고름. 산림청이 아니면 카드가 흐리게 보이고 누르면 「예정노선은 산림청(시스템 관리자 · go.kr 메일)만 만들 수 있습니다.」 안내가 나옴.
-2. 「사업 연도 시작」 · 「사업 연도 끝」 에 사업 기간을 넣음. 한 해짜리면 두 칸을 같은 해로 둠.
-3. 「사업 지역」 을 적음. 필수 칸임.
-4. 「임도 종류」 를 고르고, 그에 맞춰 「설계속도」 를 고름.
-5. 「프로젝트명」 을 확인함. 위 칸을 채우면 자동으로 이름이 만들어지며, 직접 고쳐도 됨.
-6. 필요하면 「노선 시작 누가거리 (m)」 · 「노선 종료 누가거리 (m)」 를 넣음. 비워 두어도 됨.
-7. [등록] 을 누름. 칸에 문제가 있으면 해당 칸 아래에 빨간 안내가 나오고 등록되지 않음.

-## 단추
-| 단추 | 하는 일 |
-| --- | --- |
-| [?] | 이 도움말을 엶 |
-| [취소] | 등록하지 않고 대시보드로 돌아감 |
-| [등록] | 입력한 값으로 예정노선 프로젝트를 만들고 곧바로 D02 「기준 지정」 화면으로 감 |
+1. 대시보드 [+] → 「예정노선」 카드. [새 프로젝트 여는 길](D01/01_새_프로젝트_여는_길) 참고.
+2. 사업 연도 시작 · 끝과 사업 지역을 넣음. [사업 연도 · 지역](D01/02_사업연도_지역) 참고.
+3. 임도 종류와 설계속도를 고름. [임도 종류 · 설계속도](D01/03_임도종류_설계속도) 참고.
+4. 프로젝트명을 확인함. [프로젝트명](D01/04_프로젝트명) 참고.
+5. 필요하면 노선 시작 · 종료 누가거리를 넣음. [노선 누가거리](D01/05_누가거리) 참고.
+6. [등록]을 누름. 문제가 있는 칸은 아래에 빨간 안내가 나옴. [입력 오류와 등록](D01/06_입력오류와_등록) 참고.
+7. 등록되면 바로 다음 화면인 [기준 지정](D02/00_설명서)이 열림.

-## 결과 읽는 법
- 등록에 성공하면 「프로젝트를 만들었습니다.」 알림이 뜨고, 만든 프로젝트가 현재 프로젝트가 되어 「기준 지정」 화면(지도 화면)이 열림.
- 대시보드 프로젝트 표에도 종류 「예정노선」 으로 올라감. 표의 단계 막대(기준 지정 · 노선 분석 · 확정 · 내보내기)를 누르면 그 단계 화면으로 감.
- 실패하면 서버가 알려 준 까닭이 알림으로 뜨고 이 화면에 머묾.
+> 주의: 등록 직후에는 노선 위치가 비어 있음. 지점을 정하고 저장해야 분석 단계로 갈 수 있음.

-## 알아 둘 것
- 칸마다 뜻과 기본값은 「칸 뜻」 문서에 있음.
- 임도 종류 · 설계속도는 임도설계(B 그룹)와 같은 기준을 씀. 등록 뒤 이 화면에서 고치는 방법은 코드에서 확인하지 못함.
- 누가거리(노선을 따라 잰 거리) 두 칸은 저장만 되며, 다음 화면들에서 쓰이는 곳은 확인하지 못함. 「분석 뒤 실제 누가와 다르면 차이 표시」 는 준비 중으로 봄.
- 등록 직후에는 노선 위치가 비어 있음. 지점을 정하고 저장해야 분석 단계로 갈 수 있음.
- 지정받은 다른 회사 구성원은 예정노선을 보기만 할 수 있고 만들거나 고칠 수 없음.
+> 참고: 칸마다 뜻과 기본값은 [칸 뜻](D01/10_칸_뜻)에 있음.
@@ -0,0 +1,26 @@
+# 새 프로젝트 여는 길
+
+대시보드 [+]에서 「예정노선」 카드를 골라 등록 화면으로 들어가는 길.
+
+## 여는 길
+
+- 로그인 뒤 대시보드(프로젝트 목록 화면)에서 프로젝트 줄 위의 [+]를 누름.
+
+## 단계
+
+| 단계 | 할 일 |
+| --- | --- |
+| 1 | [+]를 누름. 「새 프로젝트」 창이 열림. |
+| 2 | 카드 넷 가운데 「예정노선」을 누름. 창이 닫히고 예정노선 등록 화면이 열림. |
+| 3 | 취소하려면 창 오른쪽 위 [닫기]를 누름. |
+
+![새 프로젝트 창](D01_01_dashboard_new.webp)
+
+그림 번호 — 1 「예정노선」 카드
+
+## 보이는 것
+
+- 카드 넷 = 예정노선 · 임도설계 · 사방설계 · 안정성평가. 사방설계는 「준비 중」 표시가 붙어 눌러도 열리지 않음.
+- 산림청이 아닌 계정은 「예정노선」 카드가 흐리게 보임. 마우스를 올리면 까닭이 말풍선으로 보이고, 눌러도 「예정노선은 산림청(시스템 관리자 · go.kr 메일)만 만들 수 있습니다.」 안내만 나옴.
+
+> 참고: 이미 만든 예정노선은 대시보드 프로젝트 표에 「예정노선」 종류로 나옴. 표의 단계 막대(기준 지정 · 노선 분석 · 확정 · 내보내기)를 누르면 그 단계 화면으로 감.
@@ -0,0 +1,28 @@
+# 사업 연도 · 지역
+
+사업 기간(시작 · 끝 연도)과 사업 지역을 넣는 칸.
+
+## 여는 길
+
+- 예정노선 등록 화면 맨 위 줄 두 칸과 그 아래 「사업 지역」 칸.
+
+## 단계
+
+| 단계 | 할 일 |
+| --- | --- |
+| 1 | 「사업 연도 시작」에 첫 해를 넣음. 처음에는 올해가 들어 있음. |
+| 2 | 「사업 연도 끝」에 마지막 해를 넣음. 한 해짜리 사업이면 시작과 같은 해. |
+| 3 | 「사업 지역」에 지역 이름을 적음(예: 울진군 금강송면). 100 글자까지. |
+| 4 | 「종류」 칸은 「노선 계획」으로 고정이라 고칠 수 없음. |
+
+![사업 연도와 지역 입력](D01_02_year_region.webp)
+
+그림 번호 — 1 사업 연도 시작 · 2 사업 연도 끝 · 3 사업 지역 · 4 종류(고정)
+
+## 보이는 것
+
+- 연도를 바꾸면 아래 「프로젝트명」이 바로 따라 바뀜(예: 2027~2029 울진군 금강송면 간선임도).
+- 연도는 2000 ~ 2100 안의 정수만 받음. 끝 연도가 시작 연도보다 앞이면 [등록] 때 안내가 나옴. [입력 오류와 등록](D01/06_입력오류와_등록) 참고.
+- 연도 수 + 1 개의 지점이 다음 화면에서 필요함. 2027 ~ 2029 세 해면 지점 네 개.
+
+> 주의: 사업 연도는 등록 뒤에 [기준 지정](D02/00_설명서) 화면에서 바꿀 수 없음. 등록 전에 확인.
@@ -0,0 +1,32 @@
+# 임도 종류 · 설계속도
+
+노선을 설계하는 기준이 되는 임도 종류와 속도를 고르는 칸.
+
+## 여는 길
+
+- 예정노선 등록 화면 가운데 줄의 「임도 종류」 · 「설계속도」.
+
+## 단계
+
+| 단계 | 할 일 |
+| --- | --- |
+| 1 | 「임도 종류」에서 간선임도 · 산불진화임도 · 작업임도 중 하나를 고름. |
+| 2 | 옆 「설계속도」 목록이 종류에 맞게 바뀜. 원하는 속도를 고름. |
+
+![임도 종류와 설계속도](D01_03_type_speed.webp)
+
+그림 번호 — 1 임도 종류 · 2 설계속도(간선임도에서 40 km/h 를 고른 모습)
+
+## 보이는 것
+
+| 임도 종류 | 고를 수 있는 설계속도 |
+| --- | --- |
+| 간선임도 | 20 · 30 · 40 km/h |
+| 산불진화임도 | 20 · 30 · 40 km/h |
+| 작업임도 | 20 km/h 만 |
+
+- 임도 종류를 바꾸면 설계속도가 가장 낮은 값(20 km/h)으로 돌아감. 종류를 먼저 정하고 속도를 고름.
+- 임도 종류는 프로젝트명에도 들어감.
+- 같은 기준을 임도설계(B 그룹)도 씀. 종류와 속도에 따라 분석 단계의 기울기 · 곡선 기준이 자동으로 정해짐.
+
+> 참고: 이 화면에서 기울기 상한 · 최소 곡선 반지름 같은 기준값을 따로 넣는 칸은 없음.
@@ -0,0 +1,26 @@
+# 프로젝트명
+
+대시보드와 표에 보이는 프로젝트 이름. 칸을 채우면 저절로 만들어짐.
+
+## 여는 길
+
+- 예정노선 등록 화면 왼쪽 아래 「프로젝트명」 칸.
+
+## 단계
+
+| 단계 | 할 일 |
+| --- | --- |
+| 1 | 사업 연도 · 사업 지역 · 임도 종류를 넣으면 이름이 저절로 채워짐. |
+| 2 | 다른 이름을 쓰고 싶으면 칸을 눌러 직접 고침. 255 글자까지, 비워 둘 수 없음. |
+
+![프로젝트명 자동 채움](D01_04_name.webp)
+
+그림 번호 — 1 프로젝트명(사업 지역을 넣자 이름에 지역이 들어간 모습)
+
+## 보이는 것
+
+- 이름 = 「사업 연도」 + 「사업 지역」 + 「임도 종류」를 띄어 이은 글. 연도가 여러 해이면 「2027~2029」 꼴, 한 해이면 해 하나만 들어감.
+- 이름을 직접 고치기 전에는 위 칸을 바꿀 때마다 통째로 다시 만들어짐.
+- 직접 고친 뒤에는 위 칸을 바꿔도 자동으로 만든 조각만 새 값으로 바뀌고, 직접 넣은 글은 그대로 남음. 직접 지운 조각은 되살아나지 않음.
+
+> 참고: 같은 이름 규칙을 임도설계 등록 화면도 씀.
@@ -0,0 +1,27 @@
+# 노선 누가거리
+
+노선 시작과 끝의 측점 값(누가거리, m)을 미리 정해 두는 칸. 비워 두어도 등록됨.
+
+## 여는 길
+
+- 예정노선 등록 화면 맨 아래 「노선 시작 누가거리 (m)」 · 「노선 종료 누가거리 (m)」.
+
+## 단계
+
+| 단계 | 할 일 |
+| --- | --- |
+| 1 | 노선 첫 지점의 측점 값을 「노선 시작 누가거리」에 넣음. 0 이상의 수. |
+| 2 | 노선 끝에서 목표로 하는 거리를 「노선 종료 누가거리」에 넣음. 시작 값보다 커야 함. |
+| 3 | 모르면 두 칸 모두 비워 둠. |
+
+![누가거리 입력](D01_05_chainage.webp)
+
+그림 번호 — 1 노선 시작 누가거리 · 2 노선 종료 누가거리
+
+## 보이는 것
+
+- 시작 값은 [노선 분석](D03/00_설명서) 화면의 측점 번호가 어디서부터 세는지를 정함. 비우면 0 부터.
+- 종료 값은 분석을 마친 뒤 실제 이은 끝 누가와 비교해 「목표 · 차이」로 보임.
+- 종료 값이 시작 값 이하이면 [등록] 때 「종료 누가거리는 시작보다 커야 합니다.」 안내가 나옴.
+
+> 참고: 누가거리 = 노선을 따라 잰 거리.
@@ -0,0 +1,38 @@
+# 입력 오류와 등록
+
+[등록]을 눌렀을 때의 검사와 등록 뒤 이어지는 화면.
+
+## 여는 길
+
+- 예정노선 등록 화면 맨 아래 단추 줄([?] · [취소] · [등록]).
+
+## 단계
+
+| 단계 | 할 일 |
+| --- | --- |
+| 1 | 칸을 모두 채운 뒤 [등록]을 누름. |
+| 2 | 문제가 있으면 그 칸 아래에 빨간 안내가 나오고 등록되지 않음. 고친 뒤 다시 [등록]. |
+| 3 | 문제가 없으면 프로젝트가 만들어지고 「프로젝트를 만들었습니다.」 알림과 함께 [기준 지정](D02/00_설명서) 화면이 열림. |
+| 4 | 등록하지 않고 나가려면 [취소]를 누름. 대시보드로 돌아감. |
+
+![입력 오류 안내](D01_06_errors.webp)
+
+그림 번호 — 1 끝 연도가 시작 연도보다 앞 · 2 사업 지역 비어 있음 · 3 종료 누가거리가 시작 이하
+
+![단추 줄](D01_07_buttons.webp)
+
+그림 번호 — 1 [?] 도움말 · 2 [취소] · 3 [등록]
+
+## 보이는 것
+
+| 안내 | 뜻 |
+| --- | --- |
+| 숫자 범위 안내 | 시작 연도가 2000 ~ 2100 밖 |
+| 「끝 연도는 시작 연도와 같거나 뒤여야 합니다.」 | 끝 연도가 시작 연도보다 앞 |
+| 「필수 항목을 입력하세요.」 | 사업 지역 또는 프로젝트명이 빔 |
+| 「종료 누가거리는 시작보다 커야 합니다.」 | 종료 값이 시작 값 이하 |
+
+- 산림청이 아닌 계정이거나 회사에 연결되지 않은 계정이면 서버가 「예정노선은 산림청만 만들 수 있습니다.」로 막고, 이 화면에 머묾.
+- 등록에 실패하면 서버가 알려 준 까닭이 알림으로 뜸.
+
+> 주의: 등록한 프로젝트는 곧바로 현재 프로젝트가 됨. 대시보드 프로젝트 표에도 「예정노선」 종류로 올라감.
@@ -1,5 +1,9 @@
 # 칸 뜻

+![등록 화면의 칸](D01_00_overview.webp)
+
+그림 번호는 [화면 한눈에](D01/00_설명서)의 번호 표와 같음.
+
 | 칸 | 뜻 | 기본값 | 범위 · 규칙 |
 | --- | --- | --- | --- |
 | 사업 연도 시작 | 사업 첫 해 | 올해 | 2000 ~ 2100 의 정수 |
@@ -0,0 +1,10 @@
+[
+  {"name":"D01_00_overview","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__grid"},{"wait_ms":600}],"clip":null,"callouts":[{"n":1,"sel":".b02-proj__grid > .ui-field:nth-child(1)"},{"n":2,"sel":".b02-proj__grid > .ui-field:nth-child(3)"},{"n":3,"sel":".b02-proj__grid > .ui-field:nth-child(5)"},{"n":4,"sel":".b02-proj__grid > .ui-field:nth-child(7)"},{"n":5,"sel":".b02-proj__grid > .ui-field:nth-child(8)"},{"n":6,"sel":".b02-proj__actions","pos":"br"}]},
+  {"name":"D01_01_dashboard_new","route":"#/b01-account","project":"none","before":[{"wait_ms":2500},{"eval":"[...document.querySelectorAll('button')].find(x=>x.textContent.trim()==='+'&&x.offsetParent).click()"},{"wait":".b01-new-project__grid"},{"wait_ms":600}],"clip":".b01-new-project","callouts":[{"n":1,"sel":"[data-new-project=\"plan\"]"}]},
+  {"name":"D01_02_year_region","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__grid"},{"fill":".b02-proj__grid > .ui-field:nth-child(1) input","value":"2027"},{"fill":".b02-proj__grid > .ui-field:nth-child(2) input","value":"2029"},{"fill":".b02-proj__grid > .ui-field:nth-child(3) input","value":"울진군 금강송면"},{"wait_ms":400}],"clip":".b02-proj__grid","callouts":[{"n":1,"sel":".b02-proj__grid > .ui-field:nth-child(1)"},{"n":2,"sel":".b02-proj__grid > .ui-field:nth-child(2)"},{"n":3,"sel":".b02-proj__grid > .ui-field:nth-child(3)"},{"n":4,"sel":".b02-proj__grid > .ui-field:nth-child(4)"}]},
+  {"name":"D01_03_type_speed","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__grid"},{"select":".b02-proj__grid > .ui-field:nth-child(6) select","value":"40"},{"wait_ms":400}],"clip":".b02-proj__grid","callouts":[{"n":1,"sel":".b02-proj__grid > .ui-field:nth-child(5)"},{"n":2,"sel":".b02-proj__grid > .ui-field:nth-child(6)"}]},
+  {"name":"D01_04_name","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__grid"},{"fill":".b02-proj__grid > .ui-field:nth-child(3) input","value":"울진군 금강송면"},{"wait_ms":400}],"clip":".b02-proj__grid","callouts":[{"n":1,"sel":".b02-proj__grid > .ui-field:nth-child(7)"}]},
+  {"name":"D01_05_chainage","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__grid"},{"fill":".b02-proj__grid > .ui-field:nth-child(8) input","value":"0"},{"fill":".b02-proj__grid > .ui-field:nth-child(9) input","value":"1100"},{"wait_ms":400}],"clip":".b02-proj__grid","callouts":[{"n":1,"sel":".b02-proj__grid > .ui-field:nth-child(8)"},{"n":2,"sel":".b02-proj__grid > .ui-field:nth-child(9)"}]},
+  {"name":"D01_06_errors","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__grid"},{"fill":".b02-proj__grid > .ui-field:nth-child(1) input","value":"2029"},{"fill":".b02-proj__grid > .ui-field:nth-child(2) input","value":"2027"},{"fill":".b02-proj__grid > .ui-field:nth-child(8) input","value":"500"},{"fill":".b02-proj__grid > .ui-field:nth-child(9) input","value":"100"},{"click":".b02-proj__actions button:last-child"},{"wait":".ui-field__error.is-visible"},{"wait_ms":400}],"clip":".b02-proj__grid","callouts":[{"n":1,"sel":".b02-proj__grid > .ui-field:nth-child(2)"},{"n":2,"sel":".b02-proj__grid > .ui-field:nth-child(3)"},{"n":3,"sel":".b02-proj__grid > .ui-field:nth-child(9)"}]},
+  {"name":"D01_07_buttons","route":"#/d01-plan-register","project":"none","before":[{"wait":".b02-proj__actions"}],"clip":".b02-proj__actions","callouts":[{"n":1,"sel":".b02-proj__actions button:nth-child(1)"},{"n":2,"sel":".b02-proj__actions button:nth-child(2)"},{"n":3,"sel":".b02-proj__actions button:nth-child(3)"}]}
+]