feat(345-도움말): D · E 페이지 11 개 [?] 도움말 문서 — 설명서 · 칸 뜻 · 쓰인 방법과 근거 · 사용자 확정 전 값 · 도움말 서버 페이지 E06 · E07 등록 · 지킴 시험

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-26 00:32:22 +09:00
parent 54bc1e369e
commit fd963fd7a7
34 changed files with 1805 additions and 3 deletions
@@ -0,0 +1,81 @@
+# 예정노선 확정 · 업체 · 내보내기 설명서
+
+## 이 화면에서 하는 일
+
+- 2단계(분석)에서 저장한 연도별 노선을 한눈에 확인함(연장 · 시점 · 종점 · 누가 · 확정 여부).
+- 연도마다 일을 맡길 업체를 지정함. 아이슬로에 등록된 회사를 고르거나, 업체명과 메일 주소를 직접 적는 수기 지정 중 선택. 한 연도에 업체 여럿 지정 가능.
+- [확정] 으로 연도 노선을 확정하고, 지정 업체에 노선 파일이 든 압축 파일(zip)을 메일로 보냄.
+- [내보내기] 로 노선 파일 묶음을 내려받음.
+- 업체 쪽에서는 받은 예정노선을 자기 임도 프로젝트로 연결해 설계를 이어 감(아래 「받은 업체의 임도 연결」 참고).
+
+## 화면 구성
+
+- 가운데 = 연도 표. 프로젝트 이름이 위에 크게 나오고, 표 열은 연도 · 연장(m) · 시점(위도, 경도) · 종점(위도, 경도) · 누가(m) · 확정 · 지정 업체.
+- 왼쪽 위 = 「확정할 연도」 카드. 분석 [저장] 이 된 연도마다 선택 상자가 있음. 아직 확정하지 않은 연도는 처음부터 선택되어 있음.
+- 왼쪽 아래 = 단추 [내보내기] [확정] [저장].
+
+## 작업 순서
+
+1. 연도 표에서 연도마다 연장과 누가를 확인함. 분석을 저장하지 않은 연도는 누가 칸에 「노선 분석 [저장] 전」 이 나오며, 확정할 연도 목록에도 나타나지 않음.
+2. 지정 업체 칸에서 업체를 추가함.
+   - 등록 회사: 「업체(등록 회사 찾기 또는 이름)」 칸에 글자를 입력하면 가입된 회사 이름이 목록으로 뜸. 목록에서 고르면 등록 회사로 지정됨. 메일 칸을 비우면 그 회사의 대표 메일이 쓰임.
+   - 수기 지정: 업체명과 메일 주소(@ 포함)를 둘 다 적음. 없으면 「등록 회사가 아니면 업체명과 메일이 필요합니다.」 안내가 나오고 추가되지 않음.
+   - [추가] 를 누르면 그 연도 칸에 업체 이름 + 메일이 표시됨. 같은 업체를 두 번 넣어도 한 번만 들어감.
+   - 잘못 넣은 업체는 업체 옆 [×] 로 뺌.
+3. [저장] 을 누르면 지정 업체가 서버에 저장됨(「지정 업체를 저장했습니다.」). 저장 전에는 표 위에 「저장 안 된 변경이 있습니다.」 가 표시됨.
+4. 「확정할 연도」 에서 확정할 연도를 고르고 [확정] 을 누름. 확인 창(「고른 연도를 확정하고 지정 업체에 노선 묶음을 메일로 보냅니다. 진행할까요?」)에서 진행을 누르면 확정과 메일 발송이 이뤄짐. 저장하지 않은 업체 변경이 있으면 자동으로 먼저 저장됨.
+5. 필요하면 [내보내기] 로 파일을 내려받아 보관함.
+
+## 단추
+
+| 단추 | 하는 일 |
+| --- | --- |
+| 내보내기 | 「프로젝트이름_예정노선.zip」 을 내려받음. 산림청은 모든 연도와 전체 노선을 받음. 지정받은 회사는 확정된 자기 연도만 받음 |
+| 확정 | 고른 연도를 확정 처리하고 지정 업체에 메일을 보냄. 고른 연도가 없으면 「확정할 연도를 고르세요.」 안내 |
+| 저장 | 연도별 지정 업체 목록을 서버에 저장함 |
+
+- 업체 추가와 삭제는 [저장] 을 누르기 전까지 이 브라우저 탭에만 임시로 남음. 탭을 닫으면 사라지므로 [저장] 을 누를 것.
+- [저장] [확정] 은 산림청 소속 사용자만 가능. 그 밖의 사용자가 누르면 「산림청만 예정노선을 확정 · 지정할 수 있습니다.」 안내가 나옴.
+
+## 결과 읽는 법
+
+- **확정 열** = 확정한 날짜와 시각(한국 시간). 비어 있으면 아직 확정 전.
+- **지정 업체 열의 표시**
+  - 「Aislo」 = 아이슬로 등록 회사로 지정된 업체.
+  - 「메일 보냄」 = 확정 때 메일이 나갔다는 표시. 같은 업체에는 다시 확정해도 중복 발송하지 않음.
+  - 「연결됨」 = 그 업체가 이 연도 노선을 자기 임도 프로젝트로 가져가 연결했다는 표시.
+- **[확정] 후 안내 문구** = 「확정 — 메일 sent 2 · already_sent 1」 꼴로 업체별 처리 결과를 개수로 보여 줌.
+
+| 결과 이름 | 뜻 |
+| --- | --- |
+| sent | 메일 발송 성공 |
+| already_sent | 이미 보낸 업체여서 다시 보내지 않음 |
+| no_email | 메일 주소가 없어 보내지 못함(등록 회사의 대표 메일이 비어 있는 경우 등) |
+| failed | 메일 발송 실패 |
+
+## 보내지는 메일
+
+- 제목: 「[예정노선 확정] 프로젝트이름 N년」.
+- 본문: 프로젝트 · 사업 지역 · 연도 · 연장(km 와 m) 요약과 첨부 파일 목록, 압축을 풀면 노선 입력에 바로 올릴 수 있다는 안내 문구.
+- 첨부: 그 업체의 연도 한 해 분량 zip 1개(파일 이름 「프로젝트이름_예정노선_연도.zip」). 내용은 「10_내보내기_파일_구성」 참고.
+
+## 받은 업체의 임도 연결
+
+- 지정받은 등록 회사는 대시보드의 「받은 예정노선」 구역에서 확정된 연도를 봄. 열은 예정노선 · 연도 · 확정 · 연결 상태(연결됨 / 미연결 / 업데이트 있음) · 작업.
+- [보기] = 예정노선 화면을 보기만 가능한 상태로 엶.
+- [연결] = 모달에서 두 가지 중 선택.
+  - 「새 임도 프로젝트로」: 예정노선 이름 + 연도로 임도 프로젝트를 새로 만들고 노선 입력 단계(B03)로 이동. 예정노선의 설계속도(20 · 30 · 40 km/h)가 새 프로젝트의 설계속도 기본값으로 들어감.
+  - 「기존 프로젝트에 연결」: 우리 회사의 임도 프로젝트를 골라 그 프로젝트에 연결. 임도 프로젝트가 없으면 「우리 회사 임도 프로젝트가 없습니다.」 표시.
+- 연결하면 그 연도 노선(shapefile 한 벌)이 노선 입력 단계의 입력 파일로 들어감. 파일을 직접 올린 것과 같은 길이라 이후 처리도 같음. 지형 자료는 업체가 따로 올려야 함.
+- 이미 분석 결과가 있는 임도 프로젝트에 연결하면 기존 결과를 지워도 되는지 묻는 확인 창이 먼저 나옴. 취소하면 아무것도 바뀌지 않음.
+- 임도 프로젝트 노선 입력 화면의 [예정노선에서 가져오기] 단추로도 같은 일을 할 수 있음. 지정받은 연도를 고르면 노선이 입력됨.
+- 연결 시점의 노선이 복사되므로, 산림청이 뒤에 노선을 바꿔도 임도 프로젝트는 자동으로 바뀌지 않음. 대신 「업데이트 있음」 표시가 뜨며, 노선 입력 화면 위쪽 띠에서 [다시 가져오기] 로 직접 반영 여부를 결정함.
+- 한 임도 프로젝트는 한 연도에만 연결됨. 다른 연도로 다시 연결하면 앞의 연결은 풀림.
+
+## 알아 둘 것
+
+- 확정 시각은 [확정] 을 누를 때마다 새로 기록됨. 이미 메일을 보낸 업체에는 다시 보내지 않음(다시 보내는 단추는 화면에 없음).
+- 확정은 분석 [저장] 이 된 연도만 가능. 저장하지 않은 연도를 억지로 확정하려 하면 「분석 [저장]이 안 된 연도입니다」 오류가 나옴.
+- [저장] 은 표에 있는 모든 연도의 지정 업체를 화면 내용대로 맞춤. 업체를 모두 뺀 연도는 지정이 비워짐.
+- 같은 업체 판정: 등록 회사는 회사 번호, 수기 업체는 메일 주소(대소문자 구분 없음).
+- 내보내기는 서버에 저장된 노선만 사용함. 2단계에서 [저장] 하지 않은 변경은 반영되지 않음.
@@ -0,0 +1,64 @@
+# 내보내기 파일 구성
+
+## 한눈에
+
+- 내려받는 파일 이름 = 「프로젝트이름_예정노선.zip」. 이름에 쓸 수 없는 글자는 밑줄(_)로 바뀜.
+- 압축 안에 연도 이름의 폴더가 연도마다 하나, 그리고 「전체」 폴더가 하나 들어 있음(전체 폴더는 산림청만 받음).
+- 업체에 보내는 메일 첨부 zip 은 한 연도 분량이며, 폴더 없이 그 연도 파일들이 바로 들어 있음.
+
+| 위치 | 내용 |
+| --- | --- |
+| 연도 폴더(예: 2026) | 그해 시점에서 종점까지 중심선 한 줄(shapefile 한 벌) + 좌표표 엑셀 |
+| 전체 폴더 | 모든 연도를 이은 한 줄(shapefile 한 벌, 발주처 보관용) + 모든 연도가 담긴 좌표표 엑셀 |
+
+## shapefile 한 벌
+
+- 확장자 다섯 가지가 한 벌임: .shp(선 모양) · .shx(색인) · .dbf(속성 표) · .prj(좌표계 정의) · .cpg(글자 코드). 하나라도 빠지면 안 되므로 같이 보관할 것.
+- 파일 이름 = 「대상지_지역.연장km_연도」. 예: 연장이 2.2 km 이면 「대상지_지역.2.2_2026」. 전체 노선은 연도 자리에 「전체」.
+- 좌표계 = UTM-K(EPSG:5179). 프로젝트가 다른 좌표계로 작업했더라도 내보낼 때 5179 로 바뀜.
+- 글자 코드 = cp949(한글 윈도우 표준). 엑셀 · 지리정보 프로그램에서 한글 칸 이름이 깨지지 않음.
+- 선 모양 = 평면 중심선 한 줄(높이 값 없음), 기록 한 건.
+- 양식은 2026년 임도 용화 예정노선 파일(대상지_일월.용화.2.2)과 같은 꼴임. 좌표계 정의(.prj)는 그 파일 원문을 그대로 씀.
+
+### 속성 표 칸
+
+| 칸 이름 | 뜻 | 형식 |
+| --- | --- | --- |
+| 대상지 | 「사업지역.연장km」 글자(예: 지역.2.2). 20바이트(한글 10자 안팎)를 넘으면 뒤가 잘림 | 글자 20 |
+| 길이 | 노선 연장, 단위 km(소수 셋째 자리) | 숫자 11.3 |
+| 연도 | 사업 연도. 전체 노선은 비어 있음 | 정수 4 |
+| 시점누가 | 그 선이 시작하는 측점 값(m) | 숫자 11.2 |
+| 종점누가 | 그 선이 끝나는 측점 값(m) | 숫자 11.2 |
+
+- 대상지 · 길이 두 칸은 용화 양식과 같고, 연도 · 시점누가 · 종점누가 는 이 프로그램이 덧붙인 칸임.
+- 누가 값은 2단계에서 이어 셈한 값 그대로임. 앞 연도 종점 누가 = 다음 연도 시점 누가.
+
+## 좌표표 엑셀
+
+- 파일 이름 = 「좌표표_프로젝트이름.xlsx」, 시트 이름 「좌표표」.
+- 첫 줄에 「프로젝트이름 예정노선 좌표표 (UTM-K EPSG:5179)」 제목, 둘째 줄이 열 이름, 이후 연도마다 한 줄.
+- 연도 폴더의 좌표표는 그 연도 한 줄, 전체 폴더의 좌표표는 모든 연도가 줄마다 들어 있음.
+
+| 열 | 뜻 |
+| --- | --- |
+| 연도 | 사업 연도 |
+| 시점 X · 시점 Y | 시작점 UTM-K 좌표(m) |
+| 종점 X · 종점 Y | 끝점 UTM-K 좌표(m) |
+| 시점 경도 · 시점 위도 | 시작점 위경도(도) |
+| 종점 경도 · 종점 위도 | 끝점 위경도(도) |
+| 시점누가(m) · 종점누가(m) | 이어 셈한 측점 값 |
+| 연장(m) | 그 연도 노선 길이 |
+
+## 보는 사람에 따른 차이
+
+| 사용자 | 받는 범위 |
+| --- | --- |
+| 산림청 | 분석이 저장된 모든 연도 폴더 + 전체 폴더 |
+| 지정받은 등록 회사 | 확정되었고 자기 회사가 지정된 연도 폴더만. 전체 폴더 없음. 받을 연도가 없으면 「받을 수 있는 연도가 없습니다」 로 거절됨 |
+| 저장된 분석이 전혀 없을 때 | 「분석 [저장]이 된 연도가 없습니다.」 로 거절됨 |
+
+## 알아 둘 것
+
+- 파일은 서버에 저장된 노선으로만 만들며, 화면에서 아직 저장하지 않은 노선은 반영되지 않음.
+- 전체 노선은 앞 연도 끝점과 다음 연도 시작점이 겹치므로 겹치는 한 점을 빼고 이어 붙임.
+- 임도 프로젝트로 연결할 때는 좌표표 없이 shapefile 한 벌만 노선 입력에 들어감.
@@ -0,0 +1,18 @@
+# 사용자 확정 전 값
+
+아래 항목은 코드의 현재 동작이며, 바꾸려면 개발 담당에게 요청.
+
+| 값 | 지금 기본값 | 출처 | 상태 |
+| --- | --- | --- | --- |
+| 내보내기 좌표계 | UTM-K(EPSG:5179) 고정 | 용화 예정노선 양식 | 양식 따름 |
+| 글자 코드 | cp949 | 용화 예정노선 양식 | 양식 따름 |
+| 덧붙은 속성 칸 | 연도 · 시점누가 · 종점누가 | 이 프로그램에서 추가 | 업체 쪽 요청 시 조정 가능 |
+| 좌표표 엑셀 | 연도 폴더 · 전체 폴더에 포함, 선택 기능은 아님 | 요구서는 「선택」 으로 적었으나 실제로는 항상 만듦 | 확정 전 |
+| 메일 재발송 | 이미 보낸 업체에는 다시 보내지 않음, 화면에 재발송 단추 없음 | 서버에 재발송 옵션은 있으나 화면에 연결되지 않음 | 준비 중 |
+| 연결 시 연도 측점 | 연결한 임도 프로젝트에서 측점이 처음부터 다시 시작할지 | 이어 받기 기능이 필요해 뒤로 미룬 항목 | 준비 중 |
+| 설계속도 전달 | 새 임도 프로젝트로 연결할 때 예정노선 설계속도가 노선 단계(B05) 설정에도 들어감. 기존 프로젝트는 프로젝트 설계속도 칸이 비어 있을 때만 채움 | 임도설계 설정과 같은 값 범위 | 동작 중 |
+
+## 준비 중
+
+- 지정받은 업체에 확정 메일 외 별도 알림을 보내는 기능은 없음.
+- 업체 지정 이력(누가 언제 바꿨는지)을 보여 주는 화면은 없음.