- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록) - `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록 — 창끼리 공유하되 저장소에는 안 올리는 장부 - 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠) - graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
4.3 KiB
4.3 KiB
type, status, related_pages, last_updated, source
| type | status | related_pages | last_updated | source | |||
|---|---|---|---|---|---|---|---|
| concept | stable |
|
2026-07-19 | docs/raw/verification/2026-07-19_verify_종횡단_생성_B05_이관.md |
DB: 경로/종횡단 테이블
routes (노선 경로)
사용처: B05_Profile/B05_db
| 컬럼 | 타입 | Null | Key | Default / Extra |
|---|---|---|---|---|
id |
int(11) |
NO | PRI | auto_increment |
project_id |
char(36) |
NO | MUL | FK→projects.id |
surface_model_id |
int(11) |
YES | MUL | FK→surface_models.id |
status |
varchar(50) |
YES | DRAFT ➡️ CONFIRMED ➡️ ARCHIVED |
|
start_chainage_m / end_chainage_m |
float |
YES | 시작 시점 / 끝 시점 연장(m) | |
total_length_m |
float |
YES | 총 연장(m) | |
grade_percent |
longtext |
YES | 경사도 정보 JSON | |
constraints / algorithm_params |
longtext |
YES | 회피 구역 JSON / 알고리즘 가중치 파라미터 JSON | |
route_data_path |
varchar(500) |
YES | 노선 데이터 (GeoJSON) 파일 경로 | |
computed_at / created_at |
- | - | 연산 완료 일시 / 생성 일시 |
route_points (경로 좌표점)
사용처: B05_Profile/B05_db
| 컬럼 | 타입 | Null | Key | Default / Extra |
|---|---|---|---|---|
id |
int(11) |
NO | PRI | auto_increment |
route_id |
int(11) |
NO | MUL | FK→routes.id |
chainage_m |
float |
YES | 시점 거리(m) | |
elevation_m / slope_percent |
float |
YES | 표고(m) / 종단 경사율(%) | |
sequence_num |
int(11) |
YES | 점 순서 |
route_statistics (노선 통계)
사용처: B05_Profile/B05_db
| 컬럼 | 타입 | Null | Key | Default / Extra |
|---|---|---|---|---|
id |
int(11) |
NO | PRI | auto_increment |
route_id |
int(11) |
NO | MUL | FK→routes.id |
min_slope / max_slope / mean_slope |
float |
YES | 최저 / 최고 / 평균 경사(%) | |
cut_volume_m3 / fill_volume_m3 |
float |
YES | 절토량(㎥) / 성토량(㎥) | |
tree_cutting_volume / cost_score |
float |
YES | 벌채량 / 평점 비용 스코어 |
longitudinal_sections (종단면 설계)
사용처: B05_Profile/B05_db (생성/저장), B06_Section/B06_db (조회/확정)
| 컬럼 | 타입 | Null | Key | Default / Extra |
|---|---|---|---|---|
id |
int(11) |
NO | PRI | auto_increment |
project_id / route_id |
char(36) / int |
NO | MUL | FK→projects / routes |
computed_at |
timestamp |
YES | 종단 계산 일시 | |
data |
longtext |
YES | 지반고/계획고/구배 등 설계 데이터 JSON | |
longitudinal_file_path |
varchar(500) |
YES | 종단도면 캐드 파일 경로 | |
status |
varchar(50) |
YES | DRAFT / CONFIRMED |
data 컬럼 내 options 스냅샷 구조 (2026-07-19 도입)
종횡단 계산(solve_route) 완료 시, longitudinal_sections.data 필드의 최상위 키 "options" 하위에 당시 적용한 측점/횡단 생성 파라미터가 JSON 구조로 영구 보존됩니다.
data 컬럼 내 profile_alignment 구조 (2026-07-23 도입)
사용자가 직접 편집 및 확정한 종단 계획고 선형 기하 데이터(PVI 목록, 곡선 제원, 절성토 균형 지표, 규정 위반 목록 등)가 "profile_alignment" 키 하위에 저장됩니다. 상세한 스펙 및 JSON 예시는 db_schema/route_profile/longitudinal_alignment 문서를 참조하십시오.
cross_sections (횡단면 설계)
사용처: B05_Profile/B05_db (생성/저장), B06_Section/B06_db (조회/확정)
| 컬럼 | 타입 | Null | Key | Default / Extra |
|---|---|---|---|---|
id |
int(11) |
NO | PRI | auto_increment |
project_id / route_id |
char(36) / int |
NO | MUL | FK→projects / routes |
chainage_m / sequence_num |
- | YES | 측정 체인 거리(m) / 단면 순서 | |
data |
longtext |
YES | 좌우 사면 경사, 폭, 절성토 단면적 JSON | |
cross_section_file_path |
varchar(500) |
YES | 횡단도면 캐드 파일 경로 | |
status |
varchar(50) |
YES | DRAFT / CONFIRMED |
routes.status 흐름
DRAFT → CONFIRMED → ARCHIVED
cross_sections.data.structures
횡단면 하나에 배치된 구조물 ID 배열 → db_schema/structure_output#structures 참조