조직 — 회사·단체의 프로필
상태: 공통 표준 — 2026-10-10 KST 사용자 결정
적용 대상: company-wide — 우리 시스템이 다루는 회사·단체(테넌트 조직, 고객사, 파트너 등)의 프로필, 부서, 사람과 조직의 소속
정본 분류: 공통 규칙은 공통 입력 정보를 따릅니다. 이 쪽은 조직 필드의 정본입니다. 조직·워크스페이스의 접근 역할은 접근 역할 체계가 소유합니다.
조직은 회사·단체가 우리 시스템에서 어떻게 보이고 운영되는지를 담습니다. 법적 신원은 당사자에, 세무 등록은 사업자에 있고 조직은 그것을 참조합니다. 같은 값을 세 곳에 따로 저장하지 않습니다.
조직 프로필
| 필드 | 코드 / DB | 형식 | 한국어 라벨 | 영어 라벨 | 대응 표준 |
|---|---|---|---|---|---|
| 이름 | name | 화면에 보이는 이름 | 이름 | Name | schema name |
| 다른 이름 | alternateNames (목록) | 약칭·영문명 등 | 다른 이름 | Alternate name | schema alternateName |
| 당사자 | partyId / party_id | 고유코드 | — | — | 법적 신원 참조 |
| 로고 | logo | URL | 로고 | Logo | schema logo |
| 웹사이트 | url | URL | 웹사이트주소 | Website URL | HTML url, schema url |
| 전화번호 | tel | E.164 | 전화번호 | Phone number | schema telephone |
| 대표전화 (선택) | mainTel / main_tel | E.164 | 대표전화번호 | Main phone number | — |
| 대표 이메일 | email | 이메일주소 | 대표이메일주소 | Email address | schema email |
| 종업원 수 | numberOfEmployees / number_of_employees | 정수 | 종업원 수 | Number of employees | schema numberOfEmployees |
| 상위 조직 | parentOrganizationId / parent_organization_id | 고유코드 | 상위 조직 | Parent organization | schema parentOrganization |
| 주소 | addresses (목록, 주소 종류 포함) | 주소 | — | — | schema address |
| 담당자 | contacts (목록) | 연락처 | — | — | schema contactPoint |
| SNS | socialProfiles (목록) | 연락처 | — | — | vCard SOCIALPROFILE |
- 이름은 화면에 보이는 이름입니다. 법적 이름(등기 상호·명칭)은 당사자의
name에서 가져옵니다. - 조직에 저장하지 않는 것: 법인명, 법인 형태, 법인등록번호, LEI, 법적 대표자, 설립일, 사업자등록번호. 모두 당사자나 사업자 등록에서 조회합니다.
- 조직의 당사자는 개인·법인·법인 아닌 단체일 수 있습니다. 개인사업자는 개인 당사자와 사업자등록으로 표현합니다.
- 당사자의 사업자등록은 0개 이상일 수 있으며 등록이 있고 해당되는 경우 계약·청구에 적용할 등록을 명시적으로 선택합니다. 등록 없이도 가입·계약할 수 있습니다. 사업자등록번호를 조직 식별자나 당사자 참조로 쓰지 않습니다.
- 조직은 운영·접근 범위입니다. 계약의 당사자 참조는 조직 프로필의 당사자를 기본값으로 하되 계약마다 명시합니다. 가입 주체·청구 역할·현장과의 관계는 사용자·조직·현장과 계약·결제를 따릅니다.
- 종업원 수: schema.org는 숫자 범위 객체(
QuantitativeValue)이므로 내보낼 때 바꿉니다. - 상위 조직: 지주회사·계열사처럼 조직 사이의 관계입니다. 참조는 고유코드(
id)로 합니다.
부서
부서는 목록 departments입니다.
| 필드 | 코드 / DB | 한국어 라벨 | 영어 라벨 |
|---|---|---|---|
| 부서 이름 | name | 부서 | Department |
| 상위 부서 | parentDepartmentId / parent_department_id | 상위 부서 | Parent department |
- schema.org의
department는 하위 조직(Organization)이어서, 부서를 조직처럼 다룰 때만 대응합니다.
소속 — 사람과 조직의 관계
사람이 조직에 속한 정보(직함·부서)는 사람이나 조직 한쪽이 아니라 둘 사이의 소속 affiliations에 둡니다.
| 필드 | autocomplete | 코드 / DB | 한국어 라벨 | 영어 라벨 | 대응 표준 |
|---|---|---|---|---|---|
| 조직 | organization(본인 입력 화면) | organizationId / organization_id | 조직 | Organization | schema worksFor |
| 직함 | organization-title | organizationTitle / organization_title | 직함 | Job title | schema jobTitle, vCard TITLE |
| 부서 | — | departmentId 또는 departmentName | 부서 | Department | — |
- 조직도의 부서를 가리키면
departmentId, 글자만 남기면departmentName입니다. - 직함·부서는 접근 역할이 아닙니다. 권한은 접근 역할 체계의 역할과 권한 키로 정합니다.
- 본인이 자기 회사명을 입력하는 화면(가입 등)은
autocomplete="organization"을 씁니다. 그 값은 소속의 조직 이름이고 당사자의 법적 이름이 아닙니다.
다루지 않는 것
- 조직 자체의 창립일처럼 법인 설립일과 다른 날짜: 필요해지면 따로 정합니다.
- 조직 브랜드 자산(색·글꼴 등): 디자인 시스템의 프리셋과 각 제품이 소유합니다.