KSA_MSA

Tables (29)

ksa_amana

  • amana_id — BIGSERIAL — Primary key — NOT NULL — 아마나ID
  • amana_code — VARCHAR(6) — NOT NULL — 아마나코드 (6자리, 예: 002001)
  • amana_name — VARCHAR(100) — NOT NULL — 아마나명
  • amana_name_ar — VARCHAR(100) — 아마나명(아랍어)
  • region_code — VARCHAR(3) — 광역 지역코드 (3자리, 예: 002)
  • originalla — VARCHAR(70) — ORIGINALLA 값
  • center_longitude — NUMERIC(12, 9) — 중심경도 (초기 카메라 위치)
  • center_latitude — NUMERIC(12, 9) — 중심위도 (초기 카메라 위치)
  • geom — geometry(MultiPolygon, 4326) — 아마나 경계 (MultiPolygon, EPSG:4326)
  • attrs — JSONB — 속성
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_api

  • api_id — BIGSERIAL — Primary key — NOT NULL — API ID
  • owner_menu_id — BIGINT — Foreign key → ksa_menu.menu_id — NOT NULL — 소속메뉴ID (필수). API 권한 판정의 유일한 기준 — 이 메뉴에 대한 can_<action_type> 이 곧 이 API 의 호출 권한이다. ksa_menu_api_mapping 은 정보성이라 판정에 관여하지…
  • api_name — VARCHAR(100) — NOT NULL — API명
  • api_url — VARCHAR(500) — NOT NULL — API URL
  • method — VARCHAR(10) — NOT NULL — HTTP메서드
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • action_type — VARCHAR(50) — NOT NULL — 동작유형(READ/CREATE/UPDATE/DELETE) - 권한 판정용
  • format — VARCHAR(50) — 포맷
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_common_code

  • code — VARCHAR(50) — Primary key — NOT NULL — 코드
  • group_code — VARCHAR(50) — Foreign key → ksa_common_group.group_code — NOT NULL — 그룹코드
  • code_name — VARCHAR(100) — NOT NULL — 코드명
  • code_name_kr — VARCHAR(100) — 코드명(한국어)
  • code_name_ar — VARCHAR(100) — 코드명(아랍어)
  • description — VARCHAR(500) — 설명
  • sort — INTEGER — 정렬순서
  • attrs — JSONB — 속성
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)

ksa_common_group

  • group_code — VARCHAR(50) — Primary key — NOT NULL — 그룹코드
  • group_name — VARCHAR(100) — NOT NULL — 그룹명
  • description — VARCHAR(500) — 설명
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • sort — INTEGER — 정렬순서
  • parent_group_code — VARCHAR(50) — Foreign key → ksa_common_group.group_code — 상위그룹코드
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)

ksa_email_verification

  • verification_id — BIGSERIAL — Primary key — NOT NULL
  • email — VARCHAR(255) — NOT NULL
  • code_hash — VARCHAR(255) — NOT NULL
  • status — SMALLINT — NOT NULL
  • attempt_count — SMALLINT — NOT NULL — 코드 대조 시도 횟수. 상한을 넘으면 폐기한다
  • expires_at — TIMESTAMP — NOT NULL
  • verified_at — TIMESTAMP
  • created_at — TIMESTAMP — NOT NULL
  • created_by — BIGINT
  • updated_at — TIMESTAMP
  • updated_by — BIGINT
  • del_yn — CHAR(1) — NOT NULL

ksa_file

  • file_id — BIGSERIAL — Primary key — NOT NULL — 파일ID
  • file_name — VARCHAR(255) — NOT NULL — 파일명
  • original_file_name — VARCHAR(255) — 원본파일명
  • file_type — VARCHAR(100) — 파일유형
  • file_ext — VARCHAR(100) — 파일확장자
  • file_path — VARCHAR(500) — NOT NULL — 파일경로
  • file_size — INTEGER — 파일크기
  • file_label — VARCHAR(255) — 파일라벨
  • alt_text — VARCHAR(200) — 대체텍스트
  • sort_order — INTEGER — 정렬순서
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_gateway_api_log

  • gateway_log_id — BIGSERIAL — Primary key — NOT NULL — 게이트웨이로그ID
  • trace_id — VARCHAR(100) — 추적ID
  • span_id — VARCHAR(100) — 스팬ID
  • parent_span_id — VARCHAR(100) — 상위스팬ID
  • http_method — VARCHAR(10) — HTTP메서드
  • request_uri — VARCHAR(1000) — 요청URI
  • route_id — VARCHAR(100) — 라우트ID
  • target_service — VARCHAR(100) — 대상서비스
  • target_uri — VARCHAR(1000) — 대상URI
  • client_ip — VARCHAR(45) — 클라이언트IP
  • forwarded_for — VARCHAR(255) — 포워딩IP
  • user_agent — TEXT — User-Agent
  • authenticated_yn — CHAR(1) — 인증여부
  • membership_id — BIGINT — 소속ID
  • user_role — VARCHAR(50) — 사용자권한
  • auth_type — VARCHAR(30) — 인증유형
  • token_id — BIGINT — API 키 호출인 경우 사용된 토큰ID (auth.ksa_token.token_id 논리참조). 세션 호출은 NULL
  • auth_error_code — VARCHAR(50) — 인증오류코드
  • request_time — TIMESTAMP — 요청시각
  • response_time — TIMESTAMP — 응답시각
  • elapsed_ms — INTEGER — 소요시간(ms)
  • response_status — INTEGER — 응답상태코드
  • success_yn — CHAR(1) — 성공여부
  • error_type — VARCHAR(50) — 오류유형
  • error_message — TEXT — 오류메시지
  • request_size — BIGINT — 요청크기
  • response_size — BIGINT — 응답크기
  • query — TEXT — 쿼리
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • request_body — TEXT — 요청본문
  • response_body — TEXT — 응답본문

ksa_library

  • library_id — BIGSERIAL — Primary key — NOT NULL — 라이브러리ID
  • library_group_id — BIGINT — Foreign key → ksa_library_group.library_group_id — NOT NULL — 라이브러리그룹ID
  • library_name — VARCHAR(100) — NOT NULL — 라이브러리명
  • sort — INTEGER — 정렬순서
  • membership_id — BIGINT — 소속ID
  • glb_file_id — BIGINT — Foreign key → ksa_file.file_id — GLB파일ID
  • png_file_id — BIGINT — Foreign key → ksa_file.file_id — PNG파일ID
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_library_favorite

  • library_favorite_id — BIGSERIAL — Primary key — NOT NULL — 즐겨찾기ID
  • library_id — BIGINT — Foreign key → ksa_library.library_id — NOT NULL — 라이브러리ID
  • membership_id — BIGINT — NOT NULL — 소속ID
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_library_group

  • library_group_id — BIGSERIAL — Primary key — NOT NULL — 라이브러리그룹ID
  • parent_group_id — BIGINT — Foreign key → ksa_library_group.library_group_id — 상위그룹ID
  • group_name — VARCHAR(100) — NOT NULL — 그룹명
  • sort — INTEGER — 정렬순서
  • membership_id — BIGINT — 소속ID
  • private_yn — CHAR(1) — NOT NULL — 비공개여부
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_library_save

  • library_save_id — BIGSERIAL — Primary key — NOT NULL — 라이브러리저장ID
  • library_save_group_id — BIGINT — Foreign key → ksa_library_save_group.library_save_group_id — NOT NULL — 라이브러리저장그룹ID
  • library_id — BIGINT — Foreign key → ksa_library.library_id — 라이브러리ID
  • membership_id — BIGINT — 소속ID
  • glb_name — VARCHAR(255) — GLB파일명
  • glb_url — VARCHAR(500) — GLB URL
  • geom — JSONB — 공간정보
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부
  • legacy_created_by — BIGINT — 레거시 생성자ID
  • legacy_updated_by — BIGINT — 레거시 수정자ID
  • legacy_user_id — BIGINT — 레거시 사용자ID

ksa_library_save_group

  • library_save_group_id — BIGSERIAL — Primary key — NOT NULL — 라이브러리저장그룹ID
  • membership_id — BIGINT — 소속ID
  • save_group_name — VARCHAR(100) — NOT NULL — 저장 그룹명
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부
  • legacy_created_by — BIGINT — 레거시 생성자ID
  • legacy_updated_by — BIGINT — 레거시 수정자ID
  • legacy_user_id — BIGINT — 레거시 사용자ID

ksa_member

  • member_id — BIGINT — Primary key — NOT NULL — 구성원ID. 애플리케이션 생성 난수(15자리) — 2^53 미만이라 프론트 Number 로 안전. ncdt.ksa_member.member_id 논리참조
  • workspace_id — BIGINT — Foreign key → ksa_workspace.workspace_id — NOT NULL — 워크스페이스ID → ksa_workspace (어디서 일하나). 도시는 여기서 읽는다. NULL=ADMIN(플랫폼 운영자, 워크스페이스 없음) — 이 등가는 chk_member_admin_no_workspace 가…
  • account_id — BIGINT — Foreign key → ksa_user_account.account_id — NOT NULL — 회원ID → ksa_user_account (누구인가)
  • primary_type (Field) — VARCHAR(50)
  • secondary_type — VARCHAR(50) — NOT NULL — 보조유형(MASTER/SUB/ADMIN). ADMIN 은 ADMIN 조직 전용이며 MASTER 유니크에 걸리지 않아 여러 명 가능
  • approval_state — SMALLINT — NOT NULL — 승인상태 0=대기 1=승인 2=반려. 대기 상태는 pre_approval_yn=Y 인 메뉴만 보인다
  • approved_by — BIGINT — 승인한 member_id (감사용). 관할 판정에는 쓰지 않는다 — 관할은 workspace_id 다
  • approved_at — TIMESTAMP
  • tutorial_hidden — CHAR(1) — NOT NULL
  • preview_hidden — CHAR(1) — NOT NULL
  • use_yn — CHAR(1) — NOT NULL
  • created_at — TIMESTAMP — NOT NULL
  • created_by — BIGINT
  • updated_at — TIMESTAMP
  • updated_by — BIGINT
  • del_yn — CHAR(1) — NOT NULL

ksa_membership

  • membership_id — BIGINT — Primary key — NOT NULL — 소속ID (애플리케이션 생성 난수)

ksa_menu

  • menu_id — BIGSERIAL — Primary key — NOT NULL — 메뉴ID
  • service_id — BIGINT — Foreign key → ksa_service.service_id — NOT NULL — 서비스ID
  • menu_name — VARCHAR(100) — NOT NULL — 메뉴명
  • menu_name_ar — VARCHAR(100) — 메뉴명(아랍어)
  • menu_name_kr — VARCHAR(100) — 메뉴명(한국어)
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • city — VARCHAR(6) — Foreign key → ksa_amana.amana_code — 도시 = 아마나코드 (ncdt.ksa_amana.amana_code). NULL=전 도시 공용
  • remote_path — VARCHAR(500) — 원격경로
  • sort — INTEGER — 정렬순서
  • parent_id — BIGINT — Foreign key → ksa_menu.menu_id — 상위메뉴ID
  • pre_approval_yn — CHAR(1) — NOT NULL — 승인 전 노출 여부 (Y=approval_state=0 인 소속에도 노출되는 기본 메뉴)
  • allowed_primary_type — VARCHAR(50) — 접근 허용 주유형 하드 제한 (NULL=제한없음). 역할 권한과 AND 로 판정 — 역할에 권한이 있어도 이 제한을 넘지 못한다
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_menu_access_log

  • id — BIGSERIAL — Primary key — NOT NULL — 메뉴접근로그ID
  • membership_id — BIGINT — NOT NULL — 소속ID
  • menu_id — BIGINT — 메뉴ID
  • url — VARCHAR(512) — 접근URL
  • ip — VARCHAR(64) — 접속IP
  • accessed_at — TIMESTAMP — NOT NULL — 접근일시

ksa_menu_api_mapping

  • menu_id — BIGINT — Foreign key → ksa_menu.menu_id — NOT NULL — 메뉴ID
  • api_id — BIGINT — Foreign key → ksa_api.api_id — NOT NULL — API ID

ksa_menu_preview

  • preview_id — BIGSERIAL — Primary key — NOT NULL — 프리뷰ID
  • menu_id — BIGINT — Foreign key → ksa_menu.menu_id — NOT NULL — 메뉴ID
  • description — VARCHAR(500) — 설명
  • description_ar — VARCHAR(500) — 설명(아랍어)
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_menu_preview_file_mapping

  • preview_id — BIGINT — Foreign key → ksa_menu_preview.preview_id — NOT NULL — 프리뷰ID
  • file_id — BIGINT — Foreign key → ksa_file.file_id — NOT NULL — 파일ID
  • sort — INTEGER — 정렬순서

ksa_role

  • role_id — BIGSERIAL — Primary key — NOT NULL — 역할ID
  • role_name — VARCHAR(100) — NOT NULL — 역할명
  • role_type — VARCHAR(50) — NOT NULL — 역할유형(MANAGER/OPERATOR/VIEWER/DEVELOPER/CUSTOM). 표준=seed, CUSTOM=master 생성
  • description — VARCHAR(500) — 설명
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자 membership_id (커스텀역할 소유 MASTER 소속. 표준역할은 NULL)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)

ksa_role_membership_mapping

  • membership_id — BIGINT — Foreign key → ksa_membership.membership_id — NOT NULL — 소속ID
  • role_id — BIGINT — Foreign key → ksa_role.role_id — NOT NULL — 역할ID

ksa_role_menu_mapping

  • role_id — BIGINT — Foreign key → ksa_role.role_id — NOT NULL — 역할ID
  • menu_id — BIGINT — Foreign key → ksa_menu.menu_id — NOT NULL — 메뉴ID
  • can_read — CHAR(1) — NOT NULL — 조회 권한
  • can_create — CHAR(1) — NOT NULL — 등록 권한
  • can_update — CHAR(1) — NOT NULL — 수정 권한
  • can_delete — CHAR(1) — NOT NULL — 삭제 권한

ksa_service

  • service_id — BIGSERIAL — Primary key — NOT NULL — 서비스ID
  • system_id — BIGINT — Foreign key → ksa_system.system_id — NOT NULL — 시스템ID
  • service_name — VARCHAR(100) — NOT NULL — 서비스명
  • service_name_ar — VARCHAR(100) — 서비스명(아랍어)
  • remote_url — VARCHAR(500) — 원격URL
  • remote_name — VARCHAR(255) — 원격명
  • remote_module — VARCHAR(255) — 원격모듈
  • default_yn — CHAR(1) — NOT NULL — Twin Studio 배치 위치 (Y=하단 Analysis 바, N=좌상단 Service 런처). usecase 로 추가되는 서비스는 N. 권한이 아니라 레이아웃 속성이며, 노출 여부는 하위 메뉴 권한에서 역산한다
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_system

  • system_id — BIGSERIAL — Primary key — NOT NULL — 시스템ID
  • system_name — VARCHAR(100) — NOT NULL — 시스템명
  • system_url — VARCHAR(500) — 시스템URL
  • use_yn — CHAR(1) — NOT NULL — 사용여부
  • system_name_ar — VARCHAR(100) — 시스템명(아랍어)
  • system_type — VARCHAR(50) — 시스템유형
  • created_at — TIMESTAMP — NOT NULL — 생성일시
  • created_by — BIGINT — 생성자(membership_id)
  • updated_at — TIMESTAMP — 수정일시
  • updated_by — BIGINT — 수정자(membership_id)
  • del_yn — CHAR(1) — NOT NULL — 삭제여부

ksa_token

  • token_id — BIGSERIAL — Primary key — NOT NULL
  • member_id — BIGINT — Foreign key → ksa_member.member_id — NOT NULL — 발급 구성원 → ksa_member
  • token_name — VARCHAR(100)
  • key_prefix — VARCHAR(16) — NOT NULL — 키 앞 16자. 원문을 다시 볼 수 없으므로 목록에서 토큰을 구분하는 유일한 단서다
  • key_hash — VARCHAR(255) — NOT NULL — 키 해시. 원문은 발급 시 1회만 노출하고 저장하지 않는다
  • expires_at — TIMESTAMP
  • last_used_at — TIMESTAMP
  • use_yn — CHAR(1) — NOT NULL
  • created_at — TIMESTAMP — NOT NULL
  • created_by — BIGINT
  • updated_at — TIMESTAMP
  • updated_by — BIGINT
  • del_yn — CHAR(1) — NOT NULL

ksa_token_api_mapping

  • api_id — BIGINT — Primary key — NOT NULL — API ID. ncdt.ksa_api.api_id 논리참조 — 물리적으로 다른 DB라 FK 를 걸 수 없다
  • token_id — BIGINT — Foreign key → ksa_token.token_id — NOT NULL

ksa_user_account

  • account_id — BIGSERIAL — Primary key — NOT NULL — 회원ID
  • account — VARCHAR(255) — NOT NULL — 계정(이메일). 회원당 1개
  • password — VARCHAR(255) — 이 회원의 모든 구성원이 공유하는 비밀번호
  • name — VARCHAR(100) — 이름 (사람 속성)
  • phone — VARCHAR(30) — 연락처 (사람 속성)
  • use_yn — CHAR(1) — NOT NULL — 회원 사용여부. N 이면 이 사람의 모든 구성원이 로그인 불가
  • created_at — TIMESTAMP — NOT NULL
  • created_by — BIGINT
  • updated_at — TIMESTAMP
  • updated_by — BIGINT
  • del_yn — CHAR(1) — NOT NULL

ksa_user_invitation

  • invitation_id — BIGSERIAL — Primary key — NOT NULL
  • email — VARCHAR(255) — NOT NULL
  • workspace_id — BIGINT — Foreign key → ksa_workspace.workspace_id — NOT NULL — 초대한 워크스페이스 → ksa_workspace. 구 master_user_id — master 가 교체돼도 초대가 유효하도록 공간에 건다
  • token_hash — VARCHAR(255) — NOT NULL
  • status — SMALLINT — NOT NULL
  • attempt_count — SMALLINT — NOT NULL
  • expires_at — TIMESTAMP — NOT NULL
  • verified_at — TIMESTAMP
  • created_at — TIMESTAMP — NOT NULL
  • created_by — BIGINT — 초대를 보낸 member_id (감사)
  • updated_at — TIMESTAMP
  • updated_by — BIGINT
  • del_yn — CHAR(1) — NOT NULL

ksa_workspace

  • workspace_id — BIGSERIAL — Primary key — NOT NULL — 워크스페이스ID
  • workspace_name — VARCHAR(100) — NOT NULL — 공간 이름. 유일하지 않다. 가입 시 "{account} 의 workspace" 로 자동 생성하고 이후 수정 가능
  • department_name — VARCHAR(100) — 조직명(회사·부서). 선택값 — 구 ksa_user_account.user_group 이 비어 있는 계정이 있다. 유일하지 않다
  • city — VARCHAR(6) — NOT NULL — 아마나코드 6자리. ncdt.ksa_amana.amana_code 논리참조(별도 DB라 FK 불가). 가입 시 필수
  • created_at — TIMESTAMP — NOT NULL
  • created_by — BIGINT — 만든 구성원 member_id (감사). 워크스페이스가 구성원보다 먼저 생기므로 MASTER 생성 후 채운다
  • updated_at — TIMESTAMP
  • updated_by — BIGINT
  • use_yn — CHAR(1) — NOT NULL
  • del_yn — CHAR(1) — NOT NULL