feat: WTM 멀티프로젝트 플랫폼 구축 (BE + FE 전체 구현)

Phase 0: wbx-spring-core 라이브러리 전환
- java-library 플러그인, WbxAutoConfiguration, Admin 조건부 활성화
- 루트 settings.gradle + build.gradle (멀티모듈)

Phase 1: wtm-api 모듈 생성
- 23개 JPA Entity, 14개 Controller, 79개 API 엔드포인트
- Flyway V100~V107 MySQL 마이그레이션
- TimesheetRuleEngine, TimesheetApprovalHandler, P6WbsParser

Phase 2: wtm-frontend (Vue 3 + PrimeVue 4)
- 10개 도메인 모듈, 17개 View, 5개 서브컴포넌트
- 반응형 레이아웃 (AppLayout, AppSidebar, AppTopbar)
- BaseCrudTable, BaseFormDialog, BasePageHeader 표준 컴포넌트
- JWT 인터셉터, 역할 기반 메뉴 필터링

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

wbx-spring-core/HanwhaOCN/wtmgr/08-sap-btp-integration.md

@@ -0,0 +1,113 @@
+# 08. SAP SuccessFactors BTP 연동
+
+## 연동 아키텍처
+
+```
+SAP SuccessFactors (HR Master)
+        │ OData API
+        ▼
+SAP BTP Integration Suite (CPI)
+        │ 필드 매핑 + 스케줄링
+        │ REST API (JSON)
+        ▼
+WTM Spring Boot
+  POST /api/wtm/integration/hr/sync
+```
+
+## 단계별 구현
+
+| Phase | 방식 | 설명 |
+|-------|------|------|
+| **PH1-1** | Excel 파일 업로드 | SA가 SF Export 파일을 수동 업로드. BTP 불필요 |
+| **PH1-2** | BTP 배치 (일 1회) | SAP BTP CPI → WTM REST API 자동 호출 |
+| **PH2** | 실시간 이벤트 | SF Employee Events → BTP → WTM Webhook |
+
+## HR Master Data 필드 매핑 (No.2)
+
+| SAP SuccessFactors | WTM 컬럼 | 설명 |
+|---------------------|----------|------|
+| personIdExternal | employee_number | 사번 (= 로그인 ID) |
+| firstName + lastName | full_name | 성명 |
+| email | email | 이메일 |
+| businessUnit | business_unit | 조직 LV1 |
+| division | division | 조직 LV2 |
+| department | department | 조직 LV3 |
+| customString1 | discipline_team | 조직 LV4 (Discipline/Team) |
+| customString2 | part | 조직 LV5 (Part) |
+| attendanceType | attendance_type | 근태 유형 |
+| jobCode | individual_job_code | 직무 코드 |
+
+## Spring Boot 수신 API
+
+```java
+@RestController
+@RequestMapping("/api/wtm/integration/hr")
+@PreAuthorize("hasRole('SYSTEM') or @wbx.check('USER', 'ADMIN')")
+public class HrIntegrationController {
+
+    /** PH1-1: SA 수동 Excel 업로드 */
+    @PostMapping("/upload")
+    public HrSyncResult uploadExcel(@RequestParam("file") MultipartFile file) {
+        return hrSyncService.uploadFromExcel(file);
+    }
+
+    /** PH1-2: SAP BTP 자동 동기화 수신 */
+    @PostMapping("/sync")
+    public HrSyncResult sync(@Valid @RequestBody HrSyncRequest request) {
+        return hrSyncService.syncAll(request.employees());
+    }
+}
+
+public record HrSyncRequest(
+    List<HrEmployeeDto> employees,
+    String syncSource,       // "SAP_BTP" | "MANUAL_UPLOAD"
+    LocalDateTime syncTime
+) {}
+
+public record HrEmployeeDto(
+    String employeeNumber, String fullName, String email,
+    String businessUnit, String division, String department,
+    String disciplineTeam, String part,
+    String attendanceType, String individualJobCode,
+    LocalDate startDate, LocalDate endDate,
+    boolean isActive
+) {}
+```
+
+## P6 연동 (NF.14)
+
+> 물리적 I/F 없음 — 파일 기반만
+
+- PM이 P6 Export Excel을 `/api/wtm/projects/{id}/wbs/upload`에 업로드
+- PCM이 `/api/wtm/projects/{id}/wbs/versions/{ver}/approve`로 승인
+- 월 1회 Snapshot 비교 (No.32)
+
+## Cognite 연동 (NF.15, PH2)
+
+```
+Export 대상 (No.80):
+- Employee Dimension
+- Project Dimension
+- Canonical WBS Dimension
+- Time Fact Table
+- Mapping Version Metadata
+```
+
+```java
+@GetMapping("/api/wtm/integration/cognite/export")
+@PreAuthorize("@wbx.check('INTEGRATION', 'EXPORT')")
+public CogniteExportData export(@RequestParam LocalDate from, @RequestParam LocalDate to) {
+    return cogniteExportService.export(from, to);
+}
+```
+
+## 사전 확보 사항
+
+| 항목 | 제공 주체 | 마감 |
+|------|----------|------|
+| BTP 테넌트 접근 권한 | 한화시스템/SAP | W2 |
+| SF OData API 엔드포인트 + 인증 정보 | 한화시스템 | W2 |
+| 필드 매핑 확정 (SF → WTM) | 한화오션 + 아큐라 | W3 |
+| BTP CPI iFlow 개발 권한 | 한화시스템 | PH1-2 |
+| P6 WBS Export 샘플 파일 | 한화오션 | W1 |
+| Cognite Extractor 서버 접근 | 한화시스템 | PH2 |