33 KiB
33 KiB
대시보드 작업가이드
A. 바이브코딩 발표용 요약(초심자용)
0) 이 대시보드에서 내가 기획한 것(표출 의도 분석)
- 핵심 목적:
사업관리 + 전표 + MH 근무기록을 한 화면에서 연결해 프로젝트 단위 의사결정을 빠르게 하도록 설계 - 보고 싶은 질문:
- 어떤 프로젝트가 수입/지출/인건비 구조상 건강한가?
- 지출은 인건비/출장비/복리후생비/구매비/외주비 중 어디에 집중되는가?
- 인력은 어떤 직급이 얼마나(명, 시간, 비율) 투입됐는가?
- Activity(서브코드) 기준으로 시간과 투입자가 어떻게 분포되는가?
- 결과적으로 만든 화면 흐름:
- 상단 KPI: 필터 기준 현재 합계 + 전체 합계 비교
- 분야별 프로젝트 상세분석: D1/D2/D3, 프로젝트별 수입/지출/지출구성/인력
- 지출구성 상세: 그래프+범례+상세내역 연동
- 직급별 인원투입 상세: 직급별 시간/인원/비율
- 프로젝트별 Activity 분석: 프로젝트별 Activity 시간/인원/투입자
1) 기존 업무 방식과 바이브코딩 방식의 차이
- 기존 방식:
- 엑셀 피벗테이블로 각각 데이터 분석
- 2개 이상 데이터(전표, MH)를 사람 손으로 조합
- 결과를 한글문서로 옮기며 반복 편집/정렬/서식 작업 수행
- 바이브코딩 방식:
- 규칙을 코드로 고정해 매번 같은 방식으로 자동 집계
- 여러 데이터 소스를 한 번에 매칭해 같은 기준으로 즉시 재계산
- 화면에서 바로 필터/탭/상세 확인 가능(문서 재작성 최소화)
- 피벗 대비 장점:
- 동일 로직 반복 재사용(사람마다 다른 해석/클릭 실수 감소)
- UI에서 즉시 drill-down 가능(추가 시트/피벗 재구성 불필요)
- 집계 단위(D1/D2/D3, 직급, Activity)를 한번 정의하면 계속 재사용
- 한글문서 반복작업 축소:
- 숫자/표/구조를 코드가 생성하므로 복붙·서식맞춤 반복 감소
- 데이터 업데이트 시 문서를 새로 만들기보다 대시보드 재실행으로 대체
2) 코딩 시 주의사항(실제 반복됐던 문제 중심)
- 가장 자주 반복된 문제:
- 열 순서 변경(K/O/P/Q/X/Y/AA/U 등)로 잘못된 컬럼 매핑
- 프로젝트명 매칭 실패(공백/특수문자/표기 차이/유사명)
- 인코딩(euc-kr, utf-8) 불일치로 한글 깨짐
- 필터 상태별 소계/합계 행에서 컬럼 밀림
- 0원 표기 규칙 불일치(
₩0,0원,-) - 브라우저/로컬 환경에 따라 자동 로드 실패
- 2개 이상 데이터 매칭 시 주의점:
- 공통 키를 먼저 고정:
프로젝트명 정규화,날짜 형식,분류(D1/D2/D3) - 원본 키 + 정규화 키를 함께 보관(추적 가능성 확보)
- 매칭 실패 목록을 별도 로그로 남겨서 눈으로 검증
- 우선순위 규칙을 명시(예: 전표 우선 / MH 우선 / 표출순서 CSV 보정)
- 샘플 프로젝트 3~5개를 정해 매 수정마다 회귀검증
- 공통 키를 먼저 고정:
3) 효율적으로 작업하기 위한 실전 방법
- 기능 정의를 먼저 고정:
- 입력/출력/성공기준을 1문장씩 작성 후 개발 시작
- 아이디어 요청 방식:
- “무엇을 왜 보여줄지”를 먼저 정리하고, 화면 예시를 함께 전달
- 한 번에 큰 요구보다 작은 단위(레이아웃 → 집계 → 디테일)로 분할 요청
- 과다 요청 방지:
- 한 턴에 1~3개 변경만 요청하고 즉시 검증
- 디자인 참고 제공:
- 원하는 레퍼런스(스크린샷, 사이트)를 주면 시행착오 크게 감소
- 데이터 에러는 전제:
- “에러는 난다”를 기본 가정으로 매핑 로그/검증표를 반드시 확인
- 기존 코드 참고:
- 이미 잘 동작한 버전을 기준 파일로 고정하고 파생본에서 수정
- 변경 시 타임스탬프 파일 생성 + 기존 파일 보관
발표 마무리 문장(바로 사용 가능)
- “이번 바이브코딩의 핵심 성과는 데이터 분석 자체보다, 분석 로직을 재사용 가능한 시스템으로 만든 것입니다.”
- “즉, 엑셀·문서 반복 작업을 줄이고, 데이터가 바뀌어도 같은 기준으로 빠르게 의사결정할 수 있게 만들었습니다.”
1. 목적
이 가이드는 대시보드 수정 업무에서 시행착오를 줄이고, 작업자가 심리적으로 편안하게 일할 수 있도록 돕기 위한 표준 절차입니다. 핵심은 "크게 한 번에"가 아니라 "작게 나누고 빠르게 검증"입니다.
2. 실제 작업 이력에서 확인된 패턴
- 2026-03-04: 단일 파일 기반 시작 (
total_share_3.html) - 2026-03-05: 짧은 간격의 복제본 수정 반복 (
...1725,...1740,...1744,...1750) - 2026-03-06: 데이터 처리/임베드 구조 확장 (
total_share_4.html) - 2026-03-10: 목적 분리형으로 발전
사업관리_대시보드(K)_v260310.html: 통합 허브형(탭, iframe, postMessage)사업관리_대시보드(H)_v260310.html: 편집 UX 특화형(모달, 토스트, 상세편집)
해석:
- 좋은 점: 빠른 실험, 즉시 피드백 반영
- 어려웠던 점: 파일이 늘수록 최종본 혼선, 중복 수정 가능성 증가
3. 시행착오를 줄이는 표준 작업 방식 (SOP)
- 시작 전에 5분 정리
- 이번 작업 목표를 1문장으로 적는다.
- 예: "사업관리 업로드 후 합계 카드 계산 오류 수정"
- 기준 파일 1개 고정
- "이번 작업의 기준 파일"을 명시한다.
- 파생본을 만들더라도 기준 파일을 잃지 않는다.
- 변경 단위 분리
- UI 변경
- 데이터 파싱/집계 변경
- 탭/메시지(postMessage) 변경
- 위 3가지를 한 번에 섞지 않는다.
- 저장 규칙 통일
- 파일명 규칙:
이름_YYMMDD_HHMM_변경요약.html - 예:
사업관리_대시보드_K_260320_1530_합계카드수정.html
- 매 수정마다 스모크 테스트
- 업로드 정상 동작
- 탭 전환 정상 동작
- 합계/수금률 계산 정상
- 상세 모달/팝업 표시 정상
- 종료 시 3줄 기록
- 무엇을 바꿨는가
- 왜 바꿨는가
- 어떻게 검증했는가
4. 작업자가 편안해지는 운영 원칙
- 완벽한 설계보다 작은 성공 1개를 먼저 만든다.
- "문제 분석"과 "수정 구현"을 분리해 생각한다.
- 매 단계 완료 기준을 눈으로 확인 가능한 문장으로 둔다.
- 모호한 요구는 즉시 질문 1개로 좁힌다.
- 최종 결과물은 1개(
latest)로 명확히 유지한다.
5. 권장 파일 구조
사업관리_대시보드_latest.html(실사용)archive/(시간별 스냅샷)docs/변경기록.md(간단 로그)
6. 변경 요청을 받을 때 체크리스트
- 목표가 1문장으로 말해지는가?
- 수정 범위(허용/금지 파일)가 정해졌는가?
- 입력 데이터 샘플이 있는가?
- 성공 기준이 3개 이상 정의됐는가?
- 완료 후 검증 방법이 정해졌는가?
7. 재작업 방지 체크리스트
- 한글 인코딩(UTF-8) 확인
- 숫자 파싱 규칙 확인(콤마, 공백, 빈값)
- 탭 전환 시 상태 유지 확인
- iframe 통신 실패 시 fallback 처리 확인
- 오류 메시지(사용자 친화 문구) 확인
8. 보고 템플릿 (짧게)
- 작업 목표: [한 문장]
- 수정 파일: [파일명]
- 핵심 변경: [3줄 이내]
- 검증 결과: [PASS/FAIL + 근거]
- 잔여 이슈: [있으면 1~2개]
9. 이슈 라벨 규칙
- 기본 라벨:
MH대시보드 - 대시보드 관련 이슈는 모두
MH대시보드라벨로 발행/관리한다.
10. QuickOSM LinkData 컬럼 설명
QuickOSM으로 추출한 OpenStreetMap 데이터는 OSM 태그명이 그대로 컬럼명으로 들어오는 경우가 많다. 컬럼 해석 시 아래 규칙을 먼저 보면 이해가 쉬워진다.
:가 들어간 컬럼은 세부 태그다. 예:maxspeed:bus= 버스에 적용되는 제한속도planned:construction:proposed:는 현재 상태가 아니라 계획/공사/제안 상태다:forward:backward는 선 방향 기준 정방향/역방향이다:left:right:both는 도로 좌측/우측/양측을 뜻한다conditional은 시간대, 차량종류 등 조건부 적용이다
10.1 분류별 요약표
| 구분 | 대표 컬럼 | 뜻 |
|---|---|---|
| 기본 식별 | full_id, osm_id, osm_type |
OSM 객체의 고유 ID, 숫자 ID, 객체 타입(way/node/relation) |
| 도로 분류 | highway, planned:highway, designation, not:designation |
도로 등급, 계획 도로 여부, 법적/행정적 지정 |
| 이름 | name, short_name, official_name, alt_name, old_name, name:en, name:abbr, nat_name |
도로명과 각종 대체/공식/과거/언어별 이름 |
| 이름 유래 | name:etymology, name:etymology:description, name:etymology:wikipedia, old_name:etymology |
이름의 유래, 설명, 관련 위키 정보 |
| 도로 번호 | ref, int_ref, old_ref, bridge:ref, destination:ref:forward |
노선번호, 국제노선번호, 옛 번호, 교량번호, 목적지 표지 번호 |
| 통행 방향 | oneway, oneway:bicycle, oneway:motorcycle, planned:oneway, fine:oneway |
일방통행 여부와 수단별/계획 상태 |
| 차로 수 | lanes, lanes:forward, lanes:backward, lanes:both_ways, planned:lanes, construction:lanes |
전체 및 방향별 차로 수, 계획/공사 상태 |
| 차로 운영 | turn, turn:lanes, turn:lanes:forward, change:lanes, change:lanes:forward |
차로별 회전 가능 방향, 차로 변경 가능 여부 |
| 속도 제한 | maxspeed, maxspeed:bus, maxspeed:hgv, maxspeed:advisory, source:maxspeed |
제한속도, 차종별 제한속도, 권고속도, 출처 |
| 중량/크기 제한 | maxweight, maxweight:hgv, maxaxleload, maxwidth, maxheight |
중량, 축중, 폭, 높이 제한 |
| 조건부 제한 | access:conditional, vehicle:conditional, maxweight:conditional, hgv:conditional |
시간대/조건에 따라 달라지는 통행 및 제한 |
| 차량 종류별 접근 | vehicle, motorcar, motorcycle, bicycle, foot, bus, truck, goods, hgv, psv, horse |
교통수단별 통행 허용/제한 여부 |
| 노면/물리 특성 | surface, planned:surface, construction:surface, width, est_width, smoothness, tracktype |
포장 재질, 폭, 노면 상태, 비포장 등급 |
| 입체 구조 | bridge, bridge:name, bridge:structure, bridge:alt_name, tunnel, tunnel:name, covered, layer |
교량/터널 여부와 이름, 구조형식, 레벨 |
| 보도 | sidewalk, sidewalk:left, sidewalk:right, sidewalk:both, planned:sidewalk, construction:sidewalk |
보도 존재 여부와 위치, 계획/공사 상태 |
| 자전거 시설 | cycleway, cycleway:left, cycleway:lane, cycleway:both, cycleway:right:oneway, cycleway:right:segregated |
자전거도로 존재 여부, 위치, 분리 여부, 일방 여부 |
| 갓길 | shoulder, shoulder:right, shoulder:both, shoulder:surface, shoulder:line |
갓길 존재 여부, 포장, 선표시 |
| 교차로/우선권 | junction, priority_road, restriction, passing, overtaking |
로터리 등 교차로 유형, 우선도로, 회전/추월 제한 |
| 주차 | parking:left, parking:right, parking:both, parking:both:orientation, parking:both:restriction |
도로변 주차 가능 여부, 주차 방식, 제한 |
| 상태/위험 | damage:type, damage:date, flood_prone, hazard, wheelchair, incline, tree_lined |
손상, 침수위험, 위험요소, 접근성, 경사, 가로수 |
| 계획/제안/공사 | planned:*, proposed, construction, construction:*, from |
앞으로 계획된 속성, 제안 상태, 공사 중 속성 |
| 위치/주소 | addr:city, addr2:street, postal_code, loc_name |
주소와 지역명 보조 정보 |
| 외부 참조 | wikipedia, wikidata, name:wikidata, mapillary, source:url, source_ref |
외부 링크, 출처, 참조 ID |
| 분석용 계산값 | length |
길이 값. QGIS/QuickOSM에서 계산 또는 표시용으로 추가된 값일 수 있음 |
| 비표준/커스텀 | arivac_ID_ROA_BAS_, todo, contributor, description, isced:level |
지역/기관별 임의 태그 또는 설명성 태그 |
10.2 컬럼명 패턴 해석표
| 패턴 | 의미 | 예시 |
|---|---|---|
:forward, :backward |
선 방향 기준 정/역방향 | lanes:forward |
:left, :right, :both |
도로 좌/우/양쪽 | sidewalk:right |
planned:* |
계획 단계 | planned:bridge |
construction:* |
공사 중 | construction:surface |
*:conditional |
조건부 적용 | vehicle:conditional |
name:* |
이름 관련 세부 속성 | name:en |
max* |
최대 제한값 | maxspeed, maxheight |
10.3 LinkData 컬럼별 상세표
| 컬럼명 | 구분 | 뜻 |
|---|---|---|
full_id |
기본식별 | 객체 고유 ID. 타입 정보가 포함된 OSM 식별자 |
osm_id |
기본식별 | OSM 숫자 ID |
osm_type |
기본식별 | 객체 타입. way, node, relation 등 |
highway |
도로분류 | 도로 등급 또는 도로 유형 |
planned:bridge |
계획/공사 | 계획된 교량 여부 |
sidewalk:right |
보도 | 도로 우측 보도 존재 여부 |
short_name |
이름 | 축약 도로명 |
name:etymology:description |
이름유래 | 이름 유래에 대한 설명 |
destination:forward |
도로번호/표지 | 선 방향 기준 진행방향 목적지 표지명 |
destination:backward |
도로번호/표지 | 선 방향 기준 역방향 목적지 표지명 |
turn:lanes:forward |
차로운영 | 정방향 차로별 회전 가능 방향 |
nat_name |
이름 | 현지어 또는 국가 언어 이름 |
int_ref |
도로번호 | 국제 노선 번호 |
bicycle |
차량접근 | 자전거 통행 가능 여부 |
turn:lanes |
차로운영 | 차로별 회전 가능 방향 |
oneway:motorcycle |
통행방향 | 오토바이 기준 일방통행 여부 |
oneway:bicycle |
통행방향 | 자전거 기준 일방통행 여부 |
covered |
입체구조 | 덮개 구조물 아래를 지나는 구간 여부 |
lanes:forward |
차로수 | 정방향 차로 수 |
lanes:backward |
차로수 | 역방향 차로 수 |
start_date |
상태/이력 | 사용 시작일 또는 개통/설치 시점 |
foot |
차량접근 | 보행자 통행 가능 여부 |
junction |
교차로/우선권 | 교차로 유형. 로터리 등 |
cycleway:lane |
자전거시설 | 자전거 차로 형태의 시설 여부 |
cycleway |
자전거시설 | 자전거도로 또는 자전거 통행 시설 유형 |
bridge:name |
입체구조 | 교량 이름 |
bridge:structure |
입체구조 | 교량 구조 형식 |
ref |
도로번호 | 도로 또는 노선 번호 |
access |
차량접근 | 일반 접근 가능 여부 |
turn:lanes:backward |
차로운영 | 역방향 차로별 회전 가능 방향 |
hgv |
차량접근 | 대형화물차 통행 가능 여부 |
smoothness |
노면/물리 | 노면 상태 또는 주행 품질 |
maxspeed:hgv |
속도제한 | 대형화물차 제한속도 |
maxspeed:bus |
속도제한 | 버스 제한속도 |
designation |
도로분류 | 법적/행정적 지정 분류 |
width |
노면/물리 | 도로 폭 |
loc_name |
이름 | 지역에서 통용되는 이름 |
maxweight |
중량/크기제한 | 총중량 제한 |
layer |
입체구조 | 입체교차 시 상대 레벨 |
bridge |
입체구조 | 교량 여부 |
alt_name |
이름 | 다른 이름 또는 대체 이름 |
oneway |
통행방향 | 일방통행 여부 |
noname |
이름 | 공식 이름이 없음을 표시 |
lane_markings |
차로운영 | 차선 표시 존재 여부 |
source:maxspeed |
속도제한 | 제한속도 정보 출처 |
old_name:etymology:wikipedia |
이름유래 | 옛 이름 유래 관련 위키피디아 링크 |
old_name:etymology:wikidata |
이름유래 | 옛 이름 유래 관련 위키데이터 ID |
old_name:etymology |
이름유래 | 옛 이름의 유래 |
name:etymology:wikipedia |
이름유래 | 이름 유래 관련 위키피디아 링크 |
name:etymology:wikidata |
이름유래 | 이름 유래 관련 위키데이터 ID |
name:etymology |
이름유래 | 이름의 유래 |
sidewalk |
보도 | 보도 존재 여부 |
official_name |
이름 | 공식 명칭 |
lit |
노면/물리 | 가로등 또는 야간 조명 여부 |
old_name |
이름 | 과거 이름 |
surface |
노면/물리 | 포장 재질 또는 노면 종류 |
name |
이름 | 대표 도로명 |
maxspeed |
속도제한 | 제한속도 |
lanes |
차로수 | 전체 차로 수 |
tree_lined |
상태/환경 | 가로수길 여부 |
damage:type |
상태/위험 | 손상 유형 |
damage:date |
상태/위험 | 손상 발생일 또는 확인일 |
waterway |
기타공간속성 | 수로 관련 태그가 함께 기록된 값 |
maxaxleload |
중량/크기제한 | 축중 제한 |
cycleway:left:oneway |
자전거시설 | 좌측 자전거시설의 일방통행 여부 |
motorcycle |
차량접근 | 오토바이 통행 가능 여부 |
motorcar |
차량접근 | 승용차 통행 가능 여부 |
construction:sidewalk:right |
계획/공사 | 우측 보도 공사 상태 |
construction:cycleway:right |
계획/공사 | 우측 자전거시설 공사 상태 |
isced:level |
비표준/커스텀 | 교육 단계 분류가 붙은 비표준성 태그 |
from |
계획/공사 | 변경/제안/제한의 시작 상태 또는 출발 쪽 정보 |
planned:surface |
계획/공사 | 계획된 포장 재질 |
construction:surface |
계획/공사 | 공사 중 노면 재질 |
vehicle |
차량접근 | 일반 차량 통행 가능 여부 |
planned:oneway |
계획/공사 | 계획된 일방통행 상태 |
tunnel:name |
입체구조 | 터널 이름 |
placement:backward |
차로운영 | 역방향 차로 배치 또는 중심선 위치 정보 |
hgv:forward |
차량접근 | 정방향에서 대형화물차 허용 여부 |
turn |
차로운영 | 회전 가능 방향 또는 회전 규제 |
planned:sidewalk |
계획/공사 | 계획된 보도 |
proposed |
계획/공사 | 제안 단계의 시설 또는 속성 |
goods |
차량접근 | 화물차 통행 가능 여부 |
maxspeed:advisory |
속도제한 | 권고속도 |
planned:lanes |
계획/공사 | 계획된 차로 수 |
maxweight:conditional |
중량/크기제한 | 조건부 중량 제한 |
surface:lanes |
노면/물리 | 차로별 노면 재질 |
bus_bay |
대중교통 | 버스 정차대 존재 여부 |
not:designation |
도로분류 | 특정 지정 분류가 아님을 나타내는 값 |
tracktype |
노면/물리 | 비포장도로/트랙의 등급 |
planned:designation |
계획/공사 | 계획된 도로 지정 분류 |
narrow |
노면/물리 | 협소 도로 여부 |
psv |
차량접근 | 대중교통 차량 통행 가능 여부 |
auto_rickshaw |
차량접근 | 오토릭샤 통행 가능 여부 |
capacity |
비표준/커스텀 | 수용능력 또는 처리용량 |
ford |
입체구조 | 여울 통과 지점 여부 |
shoulder:right |
갓길 | 우측 갓길 존재 여부 |
name:en |
이름 | 영어 이름 |
tunnel |
입체구조 | 터널 여부 |
cycleway:separation:left |
자전거시설 | 좌측 자전거공간의 분리시설 정보 |
priority_road |
교차로/우선권 | 우선도로 여부 |
level |
입체구조 | 내부 층 또는 레벨 값 |
lanes:both_ways |
차로수 | 중앙 양방향 공유 차로 수 |
cycleway:right:segregated |
자전거시설 | 우측 자전거시설의 물리적 분리 여부 |
cycleway:right:oneway |
자전거시설 | 우측 자전거시설의 일방통행 여부 |
todo |
비표준/커스텀 | 미정리 메모성 태그 |
wheelchair |
상태/위험 | 휠체어 접근 가능 여부 |
maxweight:signed |
중량/크기제한 | 표지판에 표시된 중량 제한 |
minspeed:lanes:forward |
속도제한 | 정방향 차로별 최소속도 |
minspeed:lanes:backward |
속도제한 | 역방향 차로별 최소속도 |
hazard |
상태/위험 | 위험 요소 존재 여부 또는 종류 |
change:lanes:forward |
차로운영 | 정방향 차로 변경 허용 여부 |
change:lanes:backward |
차로운영 | 역방향 차로 변경 허용 여부 |
flood_prone |
상태/위험 | 침수 취약 여부 |
placement |
차로운영 | 차로 배치 또는 중심선 위치 정보 |
access:conditional |
차량접근 | 조건부 접근 허용 여부 |
maxweight:hgv_articulated |
중량/크기제한 | 굴절형 대형차 중량 제한 |
maxweight:hgv |
중량/크기제한 | 대형화물차 중량 제한 |
change:lanes |
차로운영 | 차로 변경 허용 여부 |
hgv:lanes |
차로운영 | 대형화물차 허용 차로 정보 |
goods:lanes |
차로운영 | 화물차 허용 차로 정보 |
bus:lanes |
차로운영 | 버스 허용 차로 정보 |
hgv:conditional |
차량접근 | 대형화물차 조건부 통행 허용 여부 |
bridge:alt_name |
입체구조 | 교량의 다른 이름 |
fine:oneway |
비표준/커스텀 | 일방통행 위반 과태료 등 지역성 태그 |
source:feature |
외부참조 | 객체 정보 출처 |
name:abbr |
이름 | 이름의 약어 |
passing |
교차로/우선권 | 통과 또는 추월 허용 여부 |
parking:both:restriction:reason |
주차 | 양측 주차 제한 사유 |
length |
분석용계산값 | 길이 값. QGIS/QuickOSM 계산값일 수 있음 |
addr2:street |
위치/주소 | 보조 주소 도로명 |
maxwidth |
중량/크기제한 | 최대 허용 폭 |
maxheight |
중량/크기제한 | 최대 허용 높이 |
boundary |
기타공간속성 | 경계 객체 관련 속성 |
admin_level |
기타공간속성 | 행정경계 레벨 |
addr:city |
위치/주소 | 도시명 |
construction:sidewalk |
계획/공사 | 보도 공사 상태 |
incline |
상태/위험 | 경사도 |
old_ref |
도로번호 | 옛 도로 번호 |
maxheight:signed |
중량/크기제한 | 표지판 기준 높이 제한 |
cycleway:both:lane |
자전거시설 | 양측 자전거 차로 형태 여부 |
parking:lane:both |
주차 | 양측 차로형 주차 여부 |
destination:ref:forward |
도로번호/표지 | 정방향 목적지 표지의 노선 번호 |
destination:ref:backward |
도로번호/표지 | 역방향 목적지 표지의 노선 번호 |
parking:left:orientation |
주차 | 좌측 주차 방향 또는 배치 방식 |
restriction |
교차로/우선권 | 진입 또는 회전 제한 정보 |
truck |
차량접근 | 트럭 통행 가능 여부 |
bridge:ref |
도로번호 | 교량 번호 |
maxweight:hgv:conditional |
중량/크기제한 | 대형화물차 조건부 중량 제한 |
hgv:lanes:forward |
차로운영 | 정방향 대형화물차 허용 차로 |
hgv:lanes:backward |
차로운영 | 역방향 대형화물차 허용 차로 |
goods:lanes:forward |
차로운영 | 정방향 화물차 허용 차로 |
goods:lanes:backward |
차로운영 | 역방향 화물차 허용 차로 |
bus:lanes:forward |
차로운영 | 정방향 버스 허용 차로 |
bus:lanes:backward |
차로운영 | 역방향 버스 허용 차로 |
noref |
도로번호 | 노선 번호가 없음을 표시 |
planned:highway |
계획/공사 | 계획된 도로 등급 |
alt_name:tl |
이름 | 타갈로그어 대체 이름 |
parking:right:orientation |
주차 | 우측 주차 방향 또는 배치 방식 |
parking:right |
주차 | 우측 주차 가능 여부 |
parking:left |
주차 | 좌측 주차 가능 여부 |
placement:forward |
차로운영 | 정방향 차로 배치 또는 중심선 위치 정보 |
shoulder:line |
갓길 | 갓길 경계선 표시 여부 |
shoulder:bicycle |
갓길 | 갓길의 자전거 이용 가능 여부 |
source:url |
외부참조 | 정보 출처 URL |
arivac_ID_ROA_BAS_ |
비표준/커스텀 | 외부 시스템 또는 기관의 내부 식별자 |
source:bridge:name |
외부참조 | 교량명 정보의 출처 |
overtaking |
교차로/우선권 | 추월 허용 여부 |
parking:both:orientation |
주차 | 양측 주차 방향 또는 배치 방식 |
parking:both |
주차 | 양측 주차 가능 여부 |
sidewalk:left |
보도 | 도로 좌측 보도 존재 여부 |
shoulder:both:surface |
갓길 | 양측 갓길 포장 재질 |
shoulder:both:marking |
갓길 | 양측 갓길 표시선 정보 |
shoulder:both |
갓길 | 양측 갓길 존재 여부 |
est_width |
노면/물리 | 추정 폭 |
mapillary |
외부참조 | Mapillary 참조 ID 또는 링크 |
name:wikidata |
외부참조 | 이름 관련 위키데이터 ID |
not:name |
이름 | 특정 이름이 아님을 나타내는 예외 태그 |
source_ref |
외부참조 | 출처 참조 코드 |
parking:both:restriction |
주차 | 양측 주차 제한 여부 |
shoulder:surface |
갓길 | 갓길 포장 재질 |
shoulder |
갓길 | 갓길 존재 여부 |
wikipedia |
외부참조 | 위키피디아 링크 |
wikidata |
외부참조 | 위키데이터 ID |
nat_name:tl |
이름 | 타갈로그어 현지 이름 |
horse |
차량접근 | 말 통행 가능 여부 |
postal_code |
위치/주소 | 우편번호 |
disused:oneway |
상태/이력 | 더 이상 사용되지 않는 일방통행 정보 |
maxweightrating |
중량/크기제한 | 구조 등급 또는 허용 중량 등급 |
vehicle:conditional |
차량접근 | 조건부 차량 통행 허용 여부 |
cycleway:left |
자전거시설 | 좌측 자전거시설 존재 여부 |
sidewalk:both |
보도 | 양측 보도 존재 여부 |
construction:sidewalk:both |
계획/공사 | 양측 보도 공사 상태 |
construction:lanes |
계획/공사 | 공사 중 차로 수 정보 |
construction:cycleway:both |
계획/공사 | 양측 자전거시설 공사 상태 |
construction |
계획/공사 | 공사 중 시설 또는 공사 유형 |
cycleway:both |
자전거시설 | 양측 자전거시설 존재 여부 |
bus |
차량접근 | 버스 통행 가능 여부 |
description |
비표준/커스텀 | 자유 설명 |
contributor |
외부참조 | 작성자 또는 기여자 정보 |
embankment |
노면/물리 | 성토 구간 여부 |
source:name |
외부참조 | 이름 정보의 출처 |
sidewalk:both:surface |
보도 | 양측 보도의 포장 재질 |
oneway:conditional |
통행방향 | 조건부 일방통행 여부 |
motor_vehicle |
차량접근 | 일반 동력차 통행 가능 여부 |
identifier |
기본식별 | 외부 시스템 또는 별도 식별자 |
cycleway:right:lane |
자전거시설 | 우측 자전거 차로 형태 여부 |
destination:street |
도로번호/표지 | 목적지 표지에 표시되는 도로명 |
cycleway:right |
자전거시설 | 우측 자전거시설 존재 여부 |
nat_name:en |
이름 | 현지명 또는 국가명칭의 영어 표기 |
destination:lanes |
차로운영 | 차로별 목적지 안내 정보 |
destination |
도로번호/표지 | 목적지 표지에 표시되는 목적지명 |
destination:ref |
도로번호/표지 | 목적지 표지에 표시되는 노선 번호 |
check_date |
상태/이력 | 현장 확인 또는 데이터 점검 날짜 |
dual_carriageway |
도로분류 | 중앙분리대가 있는 왕복 분리도로 여부 |
related_law |
비표준/커스텀 | 관련 법령 또는 제도 참조 정보 |
dpwh:section_id |
비표준/커스텀 | 필리핀 DPWH 도로 구간 식별자 |
dpwh:road_id |
비표준/커스텀 | 필리핀 DPWH 도로 식별자 |
name:es |
이름 | 스페인어 이름 |
short_name:en |
이름 | 영어 축약 이름 |
source:nat_name |
외부참조 | 현지명 정보의 출처 |
source:ref |
외부참조 | 노선 번호 또는 참조 정보의 출처 |
reg_name |
이름 | 등록명 또는 행정상 등록된 이름 |
maxspeed:goods |
속도제한 | 화물차 제한속도 |
int_name |
이름 | 국제적으로 통용되는 이름 |
alt_name:en |
이름 | 영어 대체 이름 |
path |
도로분류 | 보행로나 통로 계열의 경로 유형 |
10.4 교통수요예측용 중요도 기준
교통수요예측용 링크 데이터 구축 기준에서는 컬럼의 중요도를 아래처럼 해석한다.
상: 링크 생성, 네트워크 연결, 통행 방향, 용량/속도 설정에 직접 필요중: 차로 운영, 차종 규제, 보행/자전거/구조물 등 상세 네트워크 보정에 유용하: 이름 보조, 이력, 출처, 지역 커스텀, 참고용제외 후보: 현재 수요예측 링크 구축 목적에는 활용 가능성이 낮고 NULL 비율이 높은 항목
10.5 교통수요예측 기준 우선 구축 컬럼
| 컬럼명 | 중요도 | 이유 |
|---|---|---|
full_id |
상 | 링크 고유 식별자 관리에 필요 |
osm_id |
상 | OSM 원본 추적 및 중복 점검에 필요 |
osm_type |
중 | 객체 유형 확인용 |
name |
중 | 도로명 확인 및 검수에 유용 |
highway |
상 | 도로 기능등급 분류의 기본값 |
oneway |
상 | 방향성 네트워크 구축의 핵심값 |
lanes |
상 | 용량 산정의 기본 입력값 |
lanes:forward |
상 | 방향별 차로수 분리에 필요 |
lanes:backward |
상 | 방향별 차로수 분리에 필요 |
lanes:both_ways |
중 | 중앙 공유차로 해석 시 필요 |
maxspeed |
상 | 링크 자유속도 또는 초기 속도 설정에 유용 |
maxspeed:bus |
중 | 대중교통 분석 시 활용 가능 |
maxspeed:hgv |
중 | 화물차 네트워크 차등 설정에 유용 |
maxspeed:goods |
중 | 화물차 속도 보정에 유용 |
surface |
상 | 비포장/포장 여부에 따른 속도/용량 보정 가능 |
width |
중 | 차로수 검증 및 도로 규모 판단에 도움 |
est_width |
중 | 실제 폭이 없을 때 보조 판단값 |
access |
상 | 일반 통행 가능 여부 판단에 필요 |
vehicle |
상 | 차량 통행 가능 여부 판단에 필요 |
motor_vehicle |
상 | 동력차 통행 가능 여부 판단에 필요 |
motorcar |
중 | 승용차 통행 허용 여부 확인용 |
goods |
중 | 화물차 접근 가능 여부 확인용 |
hgv |
중 | 대형차 접근 가능 여부 확인용 |
bus |
중 | 버스 접근 여부 확인용 |
psv |
중 | 대중교통 차량 접근 여부 확인용 |
bicycle |
하 | 자전거 네트워크 분석이 아니면 우선도 낮음 |
foot |
하 | 보행 네트워크 분석이 아니면 우선도 낮음 |
junction |
상 | 교차로/회전교차로 처리에 중요 |
turn:lanes |
중 | 차로 운영 세부 보정에 유용 |
turn:lanes:forward |
중 | 방향별 회전 운영 반영 가능 |
turn:lanes:backward |
중 | 방향별 회전 운영 반영 가능 |
change:lanes |
하 | 세부 운영 분석에서만 유용 |
bridge |
중 | 입체교차 판독에 도움 |
tunnel |
중 | 입체교차 및 연결 검수에 도움 |
layer |
중 | 상하 레벨 분리 및 오접속 방지에 중요 |
ref |
중 | 간선도로/국도 식별에 유용 |
int_ref |
하 | 국제노선이 아니면 활용도 낮음 |
length |
상 | 링크 길이 산정의 핵심값 |
source:maxspeed |
하 | 속도값의 신뢰성 검토용 |
maxweight |
중 | 화물차 네트워크 제약 반영 가능 |
maxaxleload |
하 | 일반 수요예측보다는 화물 상세분석에 적합 |
maxheight |
하 | 특수차량 경로 분석이 아니면 우선도 낮음 |
maxwidth |
하 | 특수차량 경로 분석이 아니면 우선도 낮음 |
priority_road |
중 | 교차로 우선권 설정 참고 가능 |
restriction |
중 | 회전 제한 관계 해석 시 참고 가능 |
dual_carriageway |
중 | 상하행 분리 여부 판정에 도움 |
10.6 일반적으로 제외 후보인 컬럼
아래 계열은 교통수요예측용 링크 구축에서는 우선순위가 낮다.
- 이름 유래 계열:
name:etymology*,old_name:etymology* - 외부 링크 계열:
wikipedia,wikidata,name:wikidata,mapillary - 출처 계열:
source:*,source_ref - 메모/커스텀 계열:
todo,description,contributor,identifier,arivac_ID_ROA_BAS_ - 계획/제안 계열:
planned:*,proposed,construction* - 보행/자전거 상세 계열:
sidewalk*,cycleway*,shoulder*단, 보행/자전거 수요나 Complete Streets 분석이 목적이면 제외하지 않는다.
10.7 교통수요예측용 권장 최소 컬럼 세트
최소한 아래 정도는 남겨서 링크 테이블을 만드는 것을 권장한다.
full_idosm_idnamehighwayonewaylaneslanes:forwardlanes:backwardmaxspeedsurfaceaccessvehiclejunctionbridgetunnellayerreflength
가능하면 계산 필드도 함께 구축한다.
start_xstart_yend_xend_y