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