HR 의사결정 지원 시스템 - Join Key Standard v1

작성일: 2025-01-23 | 버전: 1.0

---

1. 개요

이 문서는 시스템 간 데이터 연결을 위한 Join Key 표준을 정의합니다.

---

2. Primary Key 표준

2.1 Key 명명 규칙

2.2 Key 형식

---

3. Join Key 매핑 테이블

3.1 시스템 간 Key 매핑

3.2 Key 변환 함수

def convert_employee_id(source_id: str, source_system: str) -> str:
    """사번을 표준 형식으로 변환"""
    # 숫자만 추출
    numeric = ''.join(filter(str.isdigit, source_id))
    # 6자리 패딩
    padded = numeric.zfill(6)
    return f"EMP-{padded}"

def convert_project_id(source_id: str, year: int) -> str:
    """프로젝트 ID를 표준 형식으로 변환"""
    numeric = ''.join(filter(str.isdigit, source_id))
    padded = numeric.zfill(4)
    return f"PRJ-{year}-{padded}"

def convert_org_id(source_id: str) -> str:
    """조직 ID를 표준 형식으로 변환"""
    numeric = ''.join(filter(str.isdigit, source_id))
    padded = numeric.zfill(4)
    return f"ORG-{padded}"

---

4. 관계 (Edge) Key 매핑

4.1 주요 관계 정의

4.2 관계 속성

---

5. Cross-System Join 시나리오

5.1 직원-프로젝트-역량 연결

// 특정 프로젝트의 투입 인력과 역량 조회
MATCH (e:Employee)-[a:ASSIGNED_TO]->(p:Project {projectId: $projectId})
MATCH (e)-[:HAS_EVIDENCE]->(ev:CompetencyEvidence)-[:FOR_COMPETENCY]->(c:Competency)
RETURN e.employeeId, e.name, a.allocationFTE, c.name as competency, ev.level

Join Path:

HR Master (Employee)
    --[employeeId]--> TMS (Assignment)
    --[projectId]--> TMS (Project)

HR Master (Employee)
    --[employeeId]--> Competency (CompetencyEvidence)
    --[competencyId]--> Competency (Competency)

5.2 Opportunity-Demand-Resource 연결

// Opportunity의 리소스 수요와 가용 인력 매칭
MATCH (o:Opportunity {opportunityId: $oppId})-[:HAS_SIGNAL]->(ds:DemandSignal)
MATCH (ds)-[:IMPLIES_DEMAND]->(rd:ResourceDemand)-[:REQUIRES_ROLE]->(dr:DeliveryRole)
MATCH (e:Employee)-[:HAS_JOBROLE]->(jr:JobRole)
WHERE jr.name = dr.name
MATCH (e)-[:HAS_AVAILABILITY]->(av:Availability)
WHERE av.startDate <= rd.startDate AND av.endDate >= rd.endDate
RETURN o.name, rd.quantityFTE, dr.name, collect(e.name) as availableEmployees

Join Path:

BizForce (Opportunity)
    --[opportunityId]--> BizForce (DemandSignal)
    --[signalId]--> TMS (ResourceDemand)
    --[deliveryRoleId]--> HR Master (DeliveryRole)

HR Master (Employee)
    --[jobRoleId]--> HR Master (JobRole)
    --[employeeId]--> TMS (Availability)

5.3 조직-가동률 연결

// 조직별 주차별 가동률 계산
MATCH (ou:OrgUnit {orgUnitId: $orgUnitId})<-[:BELONGS_TO]-(e:Employee)
MATCH (e)-[a:ASSIGNED_TO]->(p:Project)
MATCH (tb:TimeBucket {granularity: 'WEEK'})
WHERE a.startDate <= tb.endDate AND a.endDate >= tb.startDate
WITH ou, tb, sum(a.allocationFTE) as totalAllocation, count(DISTINCT e) as headcount
RETURN ou.name, tb.year, tb.week, totalAllocation / headcount as utilization

---

6. Key 매칭 검증

6.1 검증 쿼리

// 고아 Employee (조직 없음) 검출
MATCH (e:Employee)
WHERE NOT (e)-[:BELONGS_TO]->(:OrgUnit)
RETURN e.employeeId, e.name

// Key 중복 검출
MATCH (e:Employee)
WITH e.employeeId as id, count(*) as cnt
WHERE cnt > 1
RETURN id, cnt

// FK 무결성 검증 (존재하지 않는 조직 참조)
MATCH (e:Employee)-[:BELONGS_TO]->(ou:OrgUnit)
WHERE ou IS NULL
RETURN e.employeeId

6.2 매칭률 KPI

---

7. 데이터 품질 규칙

7.1 Key 유효성 검사

import re

KEY_PATTERNS = {
    "employeeId": r"^EMP-\d{6}$",
    "orgUnitId": r"^ORG-\d{4}$",
    "projectId": r"^PRJ-\d{4}-\d{4}$",
    "opportunityId": r"^OPP-\d{4}-\d{4}$",
    "competencyId": r"^CMP-\d{3}$",
}

def validate_key(key_type: str, value: str) -> bool:
    """Key 형식 유효성 검사"""
    pattern = KEY_PATTERNS.get(key_type)
    if not pattern:
        return False
    return bool(re.match(pattern, value))

7.2 참조 무결성 검사

---

8. 버전 이력

---

이 문서는 PoC 진행 중 Key 표준이 변경될 수 있습니다.