A103_ERD

테이블 (14)

OSM 도로 데이터 (osm_ways)

  • OSM ID (osm_id) — BIGINT — 기본 키 — NOT NULL — OSM ID (갱신 시 upsert 기준)
  • 도로의 종류와 중요도 (highway) — VARCHAR(50) — NOT NULL
  • 지물 이름 (name) — VARCHAR(255)
  • 노드 (geom) — GEOMETRY(LINESTRING, 4326) — NOT NULL
  • 보행 통행권 (foot) — VARCHAR(20)
  • 통행권한 (access) — VARCHAR(20)
  • 일방통행 도로 (oneway) — VARCHAR(10)
  • 다리 (bridge) — BOOLEAN — yes로 제공되므로 가공 필요
  • 터널 (tunnel) — BOOLEAN — yes로 제공되므로 가공 필요
  • 실내 (indoor) — BOOLEAN — yes / no
  • 높이값 (layer) — SMALLINT — 상대적 관계. 0: 지면 1,2: 지면보다 위 -1,-2: 지면보다 아래
  • 노면 상태 (surface) — VARCHAR(30)
  • 조명 여부 (lit) — BOOLEAN — yes / no
  • 인도 / 보도 (sidewalk) — VARCHAR(20)
  • 노드별 고도값 (elevation_nodes) — JSONB — [{lng, lat, elev}, ...]
  • 고도 상승량 (elevation_gain) — FLOAT8 — 오르막 구간 합산 (m)
  • 오르막 평균 경사도 (avg_uphill_grade) — FLOAT8 — 오르막 구간만 계산한 경사도 (%)
  • 등록일시 (created_at) — TIMESTAMP — NOT NULL — 등록일시

OSM 횡단보도 (osm_crossings)

  • OSM ID (osm_id) — BIGINT — 기본 키 — NOT NULL — OSM ID (갱신 시 upsert 기준)
  • 횡단보도 (crossings) — VARCHAR(30)
  • 신호등 유무 (has_signals) — BOOLEAN
  • 노드 (geom) — GEOMETRY(POINT, 4326) — NOT NULL — 횡단보도 좌표
  • 등록일시 (created_at) — TIMESTAMP — NOT NULL — 등록일시

Untitled (crosswalk)

  • id — BIGINT — 기본 키 — NOT NULL — 횡단보도 ID
  • osm_id — VARCHAR(50) — NOT NULL — OSM ID (갱신 시 upsert 기준)
  • geom — POINT — NOT NULL — 횡단보도 위치 좌표
  • cached_at — TIMESTAMP — NOT NULL — 캐시 적재일시

[Redis] 날씨 캐싱 ([Redis] weather_cache)

  • 예보 시각 (forecast_at) — TIMESTAMP — 기본 키 — NOT NULL — fcstDate + fcstTime
  • 지역 ID (district_id) — CHAR(5) — 외래 키 → 지역.지역 ID — NOT NULL — AUTO_INCREMENT
  • 기온 (temperature) — INT — NOT NULL — 기온 (℃)
  • 하늘 상태 (sky_condition) — TINYINT — NOT NULL — 1: 맑음, 3: 구름많음, 4: 흐림
  • API 호출일시 (fetched_at) — TIMESTAMP — NOT NULL — API 조회일시

osm_ways_split

  • id — BIGINT — 기본 키 — NOT NULL
  • source_osm_id — BIGINT — 외래 키 → OSM 도로 데이터.OSM ID — NOT NULL — OSM ID (갱신 시 upsert 기준)
  • geom — GEOMETRY(LINESTRING, 4326) — NOT NULL

기록 (records)

  • 기록 ID (record_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 회원 ID (member_id) — INT — 외래 키 → 회원.회원 ID — NOT NULL
  • 코스 ID (course_id) — INT — 외래 키 → 코스(공유된 코스).코스 ID
  • 임시 코스 ID (course_draft_id) — INT — 외래 키 → 임시 코스(에디터로 만든).임시 코스 ID — NULL이면 에디터 러닝 아님
  • 트랙 ID (track_id) — INT — 외래 키 → 트랙 (좌표).트랙 ID — NOT NULL — AUTO_INCREMENT
  • 소요 시간 (running_time) — INT — NOT NULL — 총 소요 시간 (초)
  • 평균 페이스 (avg_pace) — FLOAT8 — NOT NULL — 평균 페이스 (min/km). 초 단위에서 반올림
  • 소모 칼로리 (calories) — INT — NOT NULL — 소모 칼로리 (kcal)
  • 케이던스 (cadence) — INT — NOT NULL — 케이던스 (steps/min) 반올림.
  • 완주 여부 (is_completed) — BOOLEAN — NOT NULL — 자유 러닝은 항상 TRUE
  • 안전 경로 검증 결과 (is_safe) — BOOLEAN — NOT NULL
  • 기록 제목 (title) — VARCHAR(20) — NOT NULL
  • 시작 시각 (started_at) — TIMESTAMP — NOT NULL
  • 종료 시각 (ended_at) — TIMESTAMP — NOT NULL
  • 생성일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL

임시 코스(에디터로 만든) (course_drafts)

  • 임시 코스 ID (course_draft_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 회원 ID (member_id) — INT — 외래 키 → 회원.회원 ID — NOT NULL
  • 트랙 ID (track_id) — INT — 외래 키 → 트랙 (좌표).트랙 ID — NOT NULL — AUTO_INCREMENT
  • 난이도 (difficulty) — ENUM — NOT NULL — BEGINNER/EASY/NORMAL/HARD
  • 상태 (status) — ENUM — NOT NULL — READY/DONE
  • 생성일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL
  • 임시 코스 제목 (title) — VARCHAR(20) — NOT NULL

지역 (districts)

  • 지역 ID (district_id) — CHAR(5) — 기본 키 — NOT NULL — 법정 행정구 코드
  • 지역 시/도 (sido) — VARCHAR(50) — NOT NULL
  • 지역 구 (gu) — VARCHAR(50) — NOT NULL
  • 지역 중심 좌표 (center_point) — POINT — NOT NULL — PostGIS 내장 Type
  • 지역 경계 (boundary) — POLYGON — NOT NULL — 행정구역 경계

코스 - 북마크 (course_bookmark)

  • 북마크 ID (bookmark_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 회원 ID (member_id) — INT — 외래 키 → 회원.회원 ID — NOT NULL
  • 코스 ID (course_id) — INT — 외래 키 → 코스(공유된 코스).코스 ID — NOT NULL
  • 생성일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL

코스 - 지역 (course_district)

  • 코스 ID (course_id) — INT — 외래 키 → 코스(공유된 코스).코스 ID — NOT NULL
  • 지역 ID (district_id) — CHAR(5) — 외래 키 → 지역.지역 ID — NOT NULL

코스(공유된 코스) (courses)

  • 코스 ID (course_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 회원 ID (member_id) — INT — 외래 키 → 회원.회원 ID — NOT NULL
  • 코스 제목 (title) — VARCHAR(20) — NOT NULL — 처음에는 기록 제목 가져옴
  • 난이도 (difficulty) — ENUM — NOT NULL — BEGINNER/EASY/NORMAL/HARD
  • 완주 점수 (completion_score) — INT — NOT NULL — 0~100 사이
  • 생성일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL
  • 삭제일시 (deleted_at) — TIMESTAMP — NULL이면 정상
  • 원천 기록 Id (source_record_id) — INT — NOT NULL — UNIQUE제약

트랙 (좌표) (tracks)

  • 트랙 ID (track_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 원본 경로 (geom) — MULTILINESTRING — NOT NULL — 경로 좌표
  • 거리 (distance) — FLOAT8 — NOT NULL — 달린 거리 (km)
  • 트랙 이미지 (track_image_url) — VARCHAR(500) — 러닝 트랙 시각화 이미지 UUID
  • 생성일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL

회원 (members)

  • 회원 ID (member_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 로그인 ID (login_id) — VARCHAR(20) — NOT NULL
  • 이메일 (email) — VARCHAR(255) — NOT NULL — 글자수 제한은 서비스 로직에서
  • 비밀번호 (password) — VARCHAR(255) — NOT NULL — 비밀번호 해시
  • 닉네임 (nickname) — VARCHAR(20) — NOT NULL
  • 생년월일 (birth_date) — DATE — NOT NULL — YYYY-MM-DD
  • 성별 (gender) — ENUM — NOT NULL — MALE/FEMALE
  • 가입일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL
  • 탈퇴일시 (deleted_at) — TIMESTAMP — NULL이면 정상 계정(소프트 삭제용)

회원 기록 통계 (member_record_stats)

  • 통계 ID (stats_id) — INT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 회원 ID (member_id) — INT — 외래 키 → 회원.회원 ID — NOT NULL — AUTO_INCREMENT
  • 기간 타입 (period_type) — VARCHAR(20) — NOT NULL — DAY,MONTH,YEAR,ALL
  • 기간 키 (period_key) — VARCHAR(20) — NOT NULL — 기간을 구분하는 키 연도, 월, 일 형태
  • 거리 총합 (total_distance) — FLOAT8 — NOT NULL
  • 횟수 총합 (total_count) — INT — NOT NULL
  • 달린 시간 총합 (total_running_time) — INT — NOT NULL
  • 생성일시 (created_at) — TIMESTAMP — NOT NULL
  • 수정일시 (updated_at) — TIMESTAMP — NOT NULL