accura/wbx-spring
1
0
포크 0
코드 이슈 풀 리퀘스트 Actions 패키지 프로젝트 릴리즈 위키 활동
파일
783865266bcaf382df0c34179b264c548c96c16d
wbx-spring/HanwhaOCN/wtmgr/11-requirements-traceability.md
accura0117 783865266b docs: 한화오션 WTM 프로젝트 계획서 추가 (00~14) 
- 00~11: WTM 시수관리 시스템 설계 문서 (아키텍처, DB스키마, API스펙 등)
- 12: BE 멀티프로젝트 플랫폼 구성 계획 (wbx-spring-core 라이브러리 전환)
- 13: FE Vue3+PrimeVue4 모듈 기반 구조 계획
- 14: 레이아웃 표준 및 디자인 시스템 (반응형, 하드코딩 제거)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 19:52:15 +09:00

41 KiB
Raw Blame 히스토리

11. 요구사항 추적표 (requierment.xlsx 기반)

원본: d:\sc\requierment.xlsx — 기능 86개 + 비기능 17개 + 확인필요사항 7건 수정일: 2026-03-25

0. 기능 요구사항 전체 매핑표

PH1 Y/N은 Excel "Phase 1 (Y/N)" 컬럼 기준

User Registration (No.1~7)

No. Category 요구사항 요약 PH1 계획서 비고
1 기준정보 SAP SF HR Master 파일 업로드 Y 08-sap PH1 수동 업로드
2 기준정보 내부 인력 필드 (사번~Part 5레벨) Read-only Y 02-db users 테이블
3 기준정보 정기 배치 자동 업데이트 N 08-sap PH2: 안정화 후
4 기준정보 외주 인력 파일 업로드 (표준 템플릿) Y 07-api 확인필요사항#1
5 기준정보 외주 인력 개별 입력창 N - PH2: 정책 미확정
6 기준정보 파일 업로드는 SA가 관리 Y 07-api SA 권한
7 기준정보 외부 사용자 최소 정보 (회사명~내부담당자) Y 02-db users 테이블 확장

Login (No.8~16)

No. Category 요구사항 요약 PH1 계획서 비고
8 로그인 내부 사용자 ID/PW 로그인 Y wbx-spring AuthController
9 로그인 외부 사용자 2Way 인증 N - PH2: 외주 포털 후
10 로그인 ID/PW 찾기 기능 Y wbx-spring PasswordPolicy
11 로그인 ID = 사번 (오션 표준) Y 02-db employee_number
12 로그인 PW 정책 (대소문자+특수문자) Y wbx-spring PasswordPolicy
13 로그인 PW 입력 시 "*" 마스킹 Y FE 기본 -
14 로그인 PW 주기적 재설정 Y wbx-spring expiryDays
15 로그인 PW 5회 실패 시 재설정 프로세스 Y wbx-spring maxFailedAttempts
16 Interface SSO (Entra ID) 적용 Y wbx-spring SsoSuccessHandler

User Home (No.17~24)

No. Category 요구사항 요약 PH1 계획서 비고
17 권한관리 권한별 홈 페이지 라우팅 Y 07-api 확인필요사항#2
18 사용자등급 6종 역할 (SA/PM/PCM/PTK/DL/User) Y 02-db roles 테이블
19 사용자등급 SA 전체 기능 컨트롤 N - PH2: 보안 감사용
20 사용자등급 PM 권한 (WBS/Member/승인) Y 05-approval
21 사용자등급 PCM/PTK 권한 (WBS Task 배정) Y 04-wbs
22 사용자등급 User 할당 Project/WBS만 조회 Y 03-timesheet
23 사용자등급 DL 결재 권한 (조직원 Timesheet) Y 05-approval DL 정책 TBD
24 사용자등급 SA 접속/Activity 로그 관리 N - PH2: 보안 감사

Project Registration (No.25~30)

No. Category 요구사항 요약 PH1 계획서 비고
25 PJT Creation 프로젝트 생성 절차 (PM/PCM→SA 승인) Y 07-api
26 PJT Creation Project Type 3종 (Non/Other/EPC) Y 02-db project_type
27 PJT Creation Canonical WBS 파일 업로드→PM 승인 Y 04-wbs
28 PJT Edit 변경 WBS 신규 파일 업로드 Y 04-wbs
29 PJT Edit WBS 버전 관리/비교 N 04-wbs PH1-2차
30 PJT Edit 기존 WBS 시수 조회 N - PH2: No.29 연계

WBS Upload (No.31~41)

No. Category 요구사항 요약 PH1 계획서 비고
31 P6 WBS WBS L5 + Activity 정보 접수 Y 04-wbs P6WbsParser
32 P6 WBS 월단위 Snapshot 비교 N - PH2: 고도화
33 Canonical WBS 표준 WBS, Project별 수정 불가 Y 04-wbs
34 Canonical WBS WBS 5레벨 구조 (L1~L5) Y 04-wbs
35 Canonical WBS WBS Upload 5단계 절차 Y 04-wbs
36 WBS Versioning Effective 날짜 기준 버전 등록 Y 04-wbs
37 WBS Versioning 종결/폐기 Mapping 사용불가 처리 Y 04-wbs
38 TEAL TEAL 선정 기준 (MH투입/관리/측정 가능) Y 04-wbs
39 TEAL TEAL 선정 및 Upload 4단계 Y 04-wbs
40 TEAL Versioning 버전 정보 (Version/Date/승인/변경Log) Y 04-wbs
41 TEAL Versioning 과거 TT는 입력 당시 버전 유지 Y 04-wbs

Resource Assignment (No.42~50)

No. Category 요구사항 요약 PH1 계획서 비고
42 Availability SA가 기본 입력 기준 수정 N - PH2: 확인필요사항#4
43 Availability 1일 최소 근무시간 8시간 Y 03-timesheet RuleEngine
44 Availability Activity 최소 1개 이상 Y 03-timesheet
45 Availability 주 최대 52시간, Location별 다름 Y 03-timesheet RuleEngine
46 Availability 초과근무/휴게시간 규칙 N - PH2: 세부 규칙 UI
47 Project Assign Discipline → Project Assign Y 07-api
48 Project Assign Non-Project는 별도 Assign 없이 전체 Y 03-timesheet
49 Availability Project별 Location/Job_Role 설정 N - PH2: Unit Rate
50 WBS Assign WBS-Discipline 자동 Assign N - PH2: 방식 미확정

My Project Setup (No.51~54)

No. Category 요구사항 요약 PH1 계획서 비고
51 Assigned PJT Assign된 Project 정보 확인 Y 07-api /my-projects
52 Assigned PJT 프로젝트 상세 정보 조회 Y 07-api
53 Assigned PJT 권한별 정보 제한 Y wbx-spring RBAC
54 Activity Setup Favorite/Default 설정 N - PH2: 편의 기능

Time Sheet (No.55~69)

No. Category 요구사항 요약 PH1 계획서 비고
55 Non-Project Overhead 최소 입력 (Type/Activity/Hour) Y 03-timesheet NON_PROJECT
56 Non-Project Overhead Type 4종 (수정 가능) Y 02-db overhead_types
57 Non-Project TEAL 기반 Activity 선택 Y 03-timesheet
58 Non-Project Resource Assignment 규칙 적용 Y 03-timesheet RuleEngine
59 Non-Project WBS/Project 정보 입력 불가 Y 03-timesheet
60 Other Project Tender/Pre-FEED/FEED/Internal 포함 Y 03-timesheet OTHER_PROJECT
61 Other Project 최소 입력 (PJT/WBS L2~4/Activity/Hour) Y 03-timesheet
62 Other Project P6 연동 불필요, Canonical WBS 사용 Y 04-wbs
63 Other Project Project별 Bench Marking N - PH2: 데이터 축적 후
64 EPC Project EPC 필수 입력 (PJT/WBS L2~5/Activity/Hour) Y 03-timesheet PH1-2차: Revision
65 EPC Project Location/Role/진행률 추가 입력 N - PH2: Unit Rate
66 EPC Project P6 WBS 비노출, 할당 WBS만 선택 Y 03-timesheet
67 공통 Remark 입력 (선택) Y 03-timesheet
68 공통 Excel 템플릿 제공 + 임포트 Y 03-timesheet
69 공통 일자별 Activity별 1행, 합계 표시 Y 03-timesheet

Approval (No.70~75+)

No. Category 요구사항 요약 PH1 계획서 비고
70 Process Daily 입력, Weekly 승인, Alert Y 05-approval
71 Process User→DL→PM 3단계 승인 Y 05-approval
72 Process 승인/반려 + Comment Y 05-approval
73 Process 일괄 승인 Y 05-approval
74 Process 승인 이력 조회 Y 05-approval
75 Process 초과 기준 하이라이트 (min/max/OT) Y 05-approval PH1-2차

Reporting (No.76~86)

No. Category 요구사항 요약 PH1 계획서 비고
76 RCP연계 RCP 연계 Plan vs Actual 분석 N - PH2: RCP 시스템 미개발
77 RCP연계 RCP 연계 Capacity Gap 분석 N - PH2: RCP 미개발
78 RCP연계 RCP 연계 Productivity Trend 분석 N - PH2: RCP 미개발
79 Version WBS 버전 관리 + 이력 조회 N 04-wbs PH2: 이력 조회 UI 협의
80 Interface Cognite 연계 데이터 Export N 08-sap PH2: Extractor 서버 필요
81 WBS 검토 P6 WBS vs Canonical WBS Mis-Align 검토 N - PH2: 운영 데이터 축적 후
82 일반 보고서 Project별 투입 Manhour 분석 Y 06-report PH1 기본 리포트
83 일반 보고서 Canonical WBS Level별 Manhour 분석 Y 06-report PH1 기본 리포트
84 일반 보고서 Discipline별 생산성 분석 N - PH2: Progress Rate 필요
85 일반 보고서 Phase별 Manhour 비율 분석 N 06-report PH1-2차 또는 PH2 협의
86 일반 보고서 Non-Project Manhour 비율 분석 N 06-report PH1-2차 또는 PH2 협의

Non-Functional (NF.1~17)

NF Category 요구사항 요약 계획서
1 Cloud/Server Azure Hybrid Security Zone 09-devops
2 Cloud/Server Azure IaaS 기반 09-devops
3 Security/Server HIWARE, V3, Secuver TOS 09-devops
4 Security/DB Cubeone (TDE), Dbsafer (Proxy) 09-devops
5 Security/Cloud Defender + Analytics 09-devops
6 Security/정보보호 보안 취약점 점검 (웹/모바일/서버/소스) 09-devops
7 Security/정보보호 개인정보 보호 정책 준수 09-devops
8 Monitoring/Server onTune (SMS), MCCS (HA) 09-devops
9 Monitoring/DB Maxguage (DB 모니터링) 09-devops
10 Monitoring/App Jennifer (APM) 09-devops
11 Auth/Internal Entra ID SSO wbx-spring
12 Auth/External 2Way 인증 (외부 사용자) PH2
13 Interface/HR SAP BTP CPI (SuccessFactors) 08-sap
14 Interface/P6 P6 파일 기반 연동 (물리 I/F 없음) 04-wbs
15 Interface/Cognite Extractor 서버 필요 PH2
16 Architecture HA 구성 (Web, WAS) 09-devops
17 Architecture 백업 전략 (시스템 복구) 09-devops

1. HR Master Data 필드 상세 (No.1~2)

SAP SuccessFactors에서 업로드되는 내부 인력 정보 필드. Read-only로 관리.

No.2 원문 (Eng): Employee Number, Employee Name, Business Unit (LV1), Division (LV2), Department (LV3), Discipline/Team (LV4), Part (LV5), Attendance Type, Individual Job Code

-- V1 보완: users 테이블 컬럼 (SAP SF 필드 매핑)

ALTER TABLE users ADD COLUMN employee_number    VARCHAR(20);  -- 사번 = 로그인 ID (No.11)
ALTER TABLE users ADD COLUMN business_unit      VARCHAR(100); -- LV1: Business Unit
ALTER TABLE users ADD COLUMN division           VARCHAR(100); -- LV2: Division
ALTER TABLE users ADD COLUMN department         VARCHAR(100); -- LV3: Department
ALTER TABLE users ADD COLUMN discipline_team    VARCHAR(100); -- LV4: Discipline/Team
ALTER TABLE users ADD COLUMN part               VARCHAR(100); -- LV5: Part (★ 5레벨)
ALTER TABLE users ADD COLUMN attendance_type    VARCHAR(50);  -- 근태유형 (SAP SF)
ALTER TABLE users ADD COLUMN individual_job_code VARCHAR(50); -- 개인 직무코드 (SAP SF)
ALTER TABLE users ADD COLUMN job_role           VARCHAR(100); -- Job Role
ALTER TABLE users ADD COLUMN grade              VARCHAR(50);  -- Grade/직급
ALTER TABLE users ADD COLUMN start_date         DATE;         -- 입사일
ALTER TABLE users ADD COLUMN end_date           DATE;         -- 종료일
ALTER TABLE users ADD COLUMN company_name       VARCHAR(200); -- 외주: 회사명 (No.7)
ALTER TABLE users ADD COLUMN org_unit           VARCHAR(200); -- 외주: 조직 정보 (No.7)
ALTER TABLE users ADD COLUMN internal_contact   VARCHAR(200); -- 외주: 내부 담당자 정보 (No.7)

-- 조직 계층 테이블 (HR 데이터 정규화) — 5레벨
CREATE TABLE org_hierarchy (
    id              BIGINT IDENTITY PRIMARY KEY,
    level           INT NOT NULL,          -- 1=BU, 2=Division, 3=Department, 4=Discipline/Team, 5=Part
    code            VARCHAR(50) NOT NULL,
    name            VARCHAR(200) NOT NULL,
    parent_id       BIGINT REFERENCES org_hierarchy(id),
    is_active       BIT DEFAULT 1,
    UNIQUE (level, code)
);

JPA Entity 보완

@Entity @Table(name = "users")
public class User extends BaseEntity {
    // ... 기존 필드 ...

    @Column(length = 20, unique = true)
    private String employeeNumber;  // 사번 = 로그인 ID (No.11)

    // 조직 4레벨 (SAP SF 기준)
    private String businessUnit;   // LV1
    private String division;       // LV2
    private String department;     // LV3
    private String section;        // LV4
    private String discipline;
    private String jobRole;
    private String grade;

    private LocalDate startDate;
    private LocalDate endDate;

    // 외주 전용 (No.7)
    private String companyName;
    private String internalContact;

    @Enumerated(EnumType.STRING)
    @Column(length = 20)
    private EmploymentType employmentType; // INTERNAL, SUBCONTRACTOR
}

2. Non-Project Overhead 유형 상세 (No.55~59)

요구사항 No.56에서 명시된 Overhead Type. SA가 수정 가능해야 함.

// 시스템 초기 Overhead Types (No.56 — 영문 원본 기준, 향후 수정 가능)
// ★ 기존 계획서의 9종 → 원본 4종으로 수정
public enum OverheadType {
    TRAINING("Training", "Employee education and competency development activities"),
    SYSTEM_PROCESS_DEV("System and Process Development", "System and process development and improvement activities"),
    ORG_OPERATION("Organizational Operation", "Internal organizational administrative tasks"),
    CORPORATE_INITIATIVE("Corporate Initiative or Strategy", "Executive-led corporate strategic initiatives");
    // ★ Leave, Sick Leave 등은 Non-Project TEAL Activity로 별도 관리
    // ★ SA가 추가 가능 (DB 테이블 기반)
}

보완: Overhead Type을 Enum 대신 DB 테이블로 관리 (SA 수정 가능 요건)

CREATE TABLE overhead_types (
    id          BIGINT IDENTITY PRIMARY KEY,
    code        VARCHAR(50) NOT NULL UNIQUE,
    name        VARCHAR(200) NOT NULL,
    description NVARCHAR(500),
    is_active   BIT DEFAULT 1,
    sort_order  INT DEFAULT 0,
    created_at  DATETIME2 DEFAULT GETDATE()
);

-- 초기 데이터
INSERT INTO overhead_types (code, name, description) VALUES
    ('TRAINING',            'Training',                          'Employee education and competency development'),
    ('SYS_PROC_DEV',        'System and Process Development',    'System and process development and improvement'),
    ('ORG_OPERATION',       'Organizational Operation',          'Internal organizational administrative tasks'),
    ('CORPORATE_INITIATIVE','Corporate Initiative or Strategy',  'Executive-led corporate strategic initiatives');
-- ★ 추가 유형은 SA가 화면에서 등록 (No.56: "향후 수정 가능")

Non-Project TEAL: Admin이 Non-Project 전용 TEAL을 설정 → 사용자는 이 TEAL에서만 Activity 선택 (No.57)

3. Canonical WBS 레벨 구조 상세 (No.33~34)

요구사항 No.34에서 명시된 정확한 구조:

Level 1: Project
Level 2: Phase (Engineering, Procurement, Construction, Commissioning, etc.)
Level 3: Asset or Area                          ★ 기존 계획 "Discipline/Category" → 수정
Level 4: Work or Discipline                     ★ 기존 계획 "Sub-Category/Work Package" → 수정
Level 5: Deliverable, Package, or Material      ★ Engineering and SCM only (No.34)

주의: Level 5는 Engineering/SCM Phase에서만 사용. Construction 등은 Level 4까지만.

Project Type별 WBS 적용 (No.26)

Project Type WBS Level 비고
EPC Project Level 2~5 P6 WBS 연동, Canonical 매핑
Other Project (Tender/Pre-FEED/FEED/IDD) Level 2~4 P6 연동 불필요, Canonical만 (No.62)
Non-Project (Overhead) 없음 WBS/Project 입력 불가 (No.59) 
-- Project Type Enum 보완
-- project_type: 'EPC', 'TENDER', 'PRE_FEED', 'FEED', 'INTERNAL_DESIGN', 'NON_PROJECT'

ALTER TABLE projects ADD COLUMN project_type VARCHAR(30) NOT NULL DEFAULT 'EPC';

-- Project Type별 WBS 레벨 제한
CREATE TABLE project_type_config (
    id              BIGINT IDENTITY PRIMARY KEY,
    project_type    VARCHAR(30) NOT NULL UNIQUE,
    min_wbs_level   INT DEFAULT 2,
    max_wbs_level   INT DEFAULT 5,
    requires_p6     BIT DEFAULT 0,
    requires_teal   BIT DEFAULT 1,
    description     NVARCHAR(200)
);

INSERT INTO project_type_config VALUES
    (1, 'EPC',             2, 5, 1, 1, 'EPC Project - P6 연동, Level 5까지'),
    (2, 'TENDER',          2, 4, 0, 1, 'Tender/Bidding'),
    (3, 'PRE_FEED',        2, 4, 0, 1, 'Pre-FEED'),
    (4, 'FEED',            2, 4, 0, 1, 'FEED'),
    (5, 'INTERNAL_DESIGN', 2, 4, 0, 1, 'Internal Design Development'),
    (6, 'NON_PROJECT',     0, 0, 0, 0, 'Non-Project/Overhead');

4. 권한 매트릭스 (Sheet1 기반)

요구사항 원본 Sheet1의 기능별 역할 접근 권한:

Category Sub Category SA(Admin) PM PL(LE)/GM/DL Engineer/Staff
Time Sheet Time Sheet Register O O O O
Excel Import O O O -
Project Mgmt Project Registration O O - -
Project Information O - - -
User Mgmt User Registration O O O -
User Information O O O O
ID/Password Mgmt O O O O
WBS Mgmt WBS Upload O - - -
WBS Version Mgmt O - - -
TEAL Management O - - -
Resource Assign Resource Availability O O - -
Project Assign O - - -
WBS Assign O O - -
Task(TEAL) Assign O O O -
My Project Assignment Status O O O O
Favorite Setting O O O O
Approval Approval Request O O O O
Approval Management O O O -
Approval History O O O O
Report Project MH Analysis O O O -
WBS MH Analysis O O O -
Discipline MH Analysis O O O -
Overhead MH Analysis O O O -
WBS Change Review O O O -

Spring Security 보완

// 역할 코드 보완: PL(LE)/GM = DL (Discipline Lead)
// 원본에서 Admin = SA, PL(LE)/GM = DL 매핑

// 권한 테이블 (DB 기반, SA가 수정 가능)
CREATE TABLE role_permissions (
    id          BIGINT IDENTITY PRIMARY KEY,
    role_id     BIGINT NOT NULL REFERENCES roles(id),
    module      VARCHAR(50) NOT NULL,     -- TIMESHEET, PROJECT, USER, WBS, RESOURCE, APPROVAL, REPORT
    sub_module  VARCHAR(50) NOT NULL,     -- REGISTER, IMPORT, UPLOAD, etc.
    can_access  BIT DEFAULT 0,
    UNIQUE (role_id, module, sub_module)
);

// @PreAuthorize에서 DB 기반 권한 체크
@Component("perm")
public class PermissionChecker {
    public boolean check(String module, String subModule) {
        Long userId = SecurityUtils.getCurrentUserId();
        return rolePermissionRepository.hasAccess(userId, module, subModule);
    }
}

// Controller에서 사용
@GetMapping("/api/reports/project-hours")
@PreAuthorize("@perm.check('REPORT', 'PROJECT_MH_ANALYSIS')")
public ProjectHoursReport getProjectHours(...) { ... }

5. Resource Assignment 모듈 (누락 보완)

요구사항 No.42~50: 기존 계획서에 상세 누락된 모듈.

핵심 기능

No. 기능 설명
42 기본 입력 기준 수정 SA가 Timesheet 기본 설정 변경 가능
43 1일 최소 8시간 규칙 엔진
44 Activity 최소 1개 빈 Timesheet 제출 불가
45 주 최대 52시간 Location(국가)별 다르게 지정 가능
46 초과근무/휴게시간 규칙 규칙 지정 가능
47 Project별 Assign Discipline마다 0~N개 프로젝트 배정
48 Non-Project 별도 Assign 불필요 모든 사용자 사용 가능
49 Location/Job_Role 설정 프로젝트별 사용 가능한 Location, Role 설정 (PH2)
50 WBS Discipline 자동 Assign PCM/PTK가 표준 템플릿으로 투입인력 일괄 등록 
-- 근무 규칙 설정 (SA 관리, No.42~46)
CREATE TABLE work_rules (
    id                  BIGINT IDENTITY PRIMARY KEY,
    rule_name           VARCHAR(100) NOT NULL,
    location_code       VARCHAR(50),          -- 국가/지역별 규칙 (NULL=전체 기본값)
    min_daily_hours     DECIMAL(4,2) DEFAULT 8.00,
    max_daily_hours     DECIMAL(4,2) DEFAULT 10.00,
    max_weekly_hours    DECIMAL(5,2) DEFAULT 52.00,
    overtime_threshold  DECIMAL(4,2) DEFAULT 8.00,  -- 초과근무 기준
    break_time_minutes  INT DEFAULT 60,              -- 휴게시간
    is_default          BIT DEFAULT 0,
    is_active           BIT DEFAULT 1,
    created_at          DATETIME2 DEFAULT GETDATE()
);

INSERT INTO work_rules (rule_name, location_code, min_daily_hours, max_weekly_hours, is_default) VALUES
    ('Korea Standard', 'KR', 8.00, 52.00, 1),
    ('Offshore Standard', 'OFFSHORE', 8.00, 60.00, 0);

-- 프로젝트 인력 배정 (No.47~48)
CREATE TABLE project_assignments (
    id              BIGINT IDENTITY PRIMARY KEY,
    project_id      BIGINT NOT NULL REFERENCES projects(id),
    user_id         BIGINT NOT NULL REFERENCES users(id),
    discipline      VARCHAR(100),
    assigned_by     BIGINT REFERENCES users(id),     -- PM/PCM/PTK
    start_date      DATE,
    end_date        DATE,
    is_active       BIT DEFAULT 1,
    created_at      DATETIME2 DEFAULT GETDATE(),
    UNIQUE (project_id, user_id)
);

-- WBS별 Discipline 배정 (No.50)
CREATE TABLE wbs_discipline_assignments (
    id              BIGINT IDENTITY PRIMARY KEY,
    canonical_wbs_id BIGINT NOT NULL REFERENCES canonical_wbs(id),
    discipline      VARCHAR(100) NOT NULL,
    assigned_by     BIGINT REFERENCES users(id),
    created_at      DATETIME2 DEFAULT GETDATE(),
    UNIQUE (canonical_wbs_id, discipline)
);

REST API 추가

# Resource Assignment (02-database-schema, 08-api-spec 보완)
GET    /api/work-rules                           근무 규칙 목록 (SA)
PUT    /api/work-rules/{id}                      근무 규칙 수정 (SA)
GET    /api/projects/{id}/assignments             프로젝트 인력 배정 목록
POST   /api/projects/{id}/assignments             인력 배정 (PM/PCM/PTK)
POST   /api/projects/{id}/assignments/upload      인력 배정 일괄 업로드 (No.50)
DELETE /api/projects/{id}/assignments/{userId}     인력 배정 해제
GET    /api/projects/{id}/wbs-disciplines         WBS-Discipline 배정 현황
POST   /api/projects/{id}/wbs-disciplines         WBS-Discipline 배정

6. 비기능 요구사항 — 한화오션 표준 보안 SW 상세 (NF.3~10)

서버 보안 (NF.3)

SW 용도 Azure 대응
HIWARE 서버 접근 제어 Azure Bastion + HIWARE Agent
V3 (AhnLab) 서버 백신 VM에 V3 Agent 설치
Secuver TOS 서버 보안 (파일 무결성 등) VM에 Agent 설치

DB 보안 (NF.4)

SW 용도 Azure 대응
Cubeone DB 암호화 Azure SQL TDE + Cubeone (컬럼 레벨)
Dbsafer DB 접근 제어 Dbsafer Proxy 구성

클라우드 보안 (NF.5)

SW 용도
Azure Defender 위협 탐지
Azure Log Analytics 보안 이벤트 분석

모니터링 (NF.8~10)

SW 용도 대상
onTune SMS (서버 모니터링) VM CPU/Memory/Disk
MCCS HA (Windows 클러스터) WAS 이중화 (※ Linux → N/A)
Maxguage DB 모니터링 Azure SQL 성능 분석
Jennifer WAS 모니터링 Spring Boot Tomcat APM

application-prod.yml 보완

# Jennifer APM 연동 (NF.10)
# JVM Args: -javaagent:/opt/jennifer/agent.java/jennifer.jar

# Actuator + Prometheus (Maxguage 보완/대안)
management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  health:
    db:
      enabled: true
    redis:
      enabled: true

보안성 심의 체크리스트 (NF.6~7)

□ 웹 애플리케이션 취약점 점검 (OWASP Top 10)
□ 모바일 앱 보안 점검 (해당 시 PH2)
□ 서버/네트워크 인프라 보안 점검
□ 소스코드 보안 점검 (SonarQube / Fortify)
□ 모의해킹 (Penetration Testing)
□ 개인정보 보호 관리 (개인정보보호법 준수)
□ 한화그룹 보안 표준 준수 확인

7. Timesheet 상세 보완

Remark 필드 (No.67)

필수 입력 아님. 필요 시 아래 내용 입력:
- Change Order Number
- Deliverable Number
- 기타 참고 사항

보완: Change Order 관련 MH 관리를 위해 별도 Activity 분리 입력 방안 검토 필요

Timesheet 행 구조 (No.69)

1행 = 1일자 × 1 Activity
------------------------------------------------------
번호 | 날짜 | WBS L1~5 | Activity | Manhour | Remark
------------------------------------------------------
1    | 4/7  | E.01.03  | Detail   | 4.0     |
2    | 4/7  | E.01.04  | Review   | 4.0     |  ← 동일 날짜, 다른 Activity
------------------------------------------------------
                           일 합계:  8.0h
                        전체 합계:  Summary Row 표시

Excel Import 정확한 컬럼 (No.68)

표준 템플릿 컬럼:
| Date | Project Code | WBS L2 | WBS L3 | WBS L4 | WBS L5 | Activity | Hours | Remark |

8. 확인필요사항 (7건) 추적

원본 Excel 하단의 "확인필요사항" — 프로젝트 착수 전 고객 확정 필요.

# 영역 내용 현재 상태 계획 반영
1 User Registration 파트너사 및 외주 인력 관리 정책 — 파트너 마스터 연계 여부 별도 파트너 마스터 연계 미고려. 전사 데이터 표준화 후 검토 PH1-1: 파일 업로드만
2 User Home 사용자 관리규정 및 권한관리 정책 — User Type별 업무범위 No.18 참조 (기능 기반 역할 정의 확정) plans/wbx-spring/02-auth-jwt-sso.md 반영
3 WBS Upload WBS별 Resource Plan 방식 — TT에서 투입시수 규모 세팅 여부 TT에서 WBS별 투입시수 규모 세팅 05-wbs-teal.md 반영
4 Resource Assignment PM 인력 배치 시 해당 인력 스케줄 확인 및 참여 확인 절차 PM/PCM/PTK가 WBS별 Discipline 선정 → 각 Discipline별 투입인력 선정 후 리스트 제출 Resource Assignment 모듈
5 Time Sheet (EPC) C단계(Construction) 시수 입력 및 관리 방안 C단계 시수관리 대상 제외. EPU 담당자의 C단계 관리업무만 TT에 등록 04-timesheet.md 주석
6 Approval 각 업무요건별 승인 절차 — 대상 Action 도출, 프로세스 설계 User → DL → PM 3단계 확정 06-approval.md 반영
7 Resource Assignment Project Assignment 프로세스 상세 SA가 Project 생성 → PM/PCM이 인력 배정 → 확정 Resource Assignment 모듈

9. 외부 시스템 인터페이스 상세 (NF.13~15)

인터페이스 전체 맵

┌──────────────────┐     ┌─────────────┐     ┌────────────────┐
│ SAP              │     │             │     │                │
│ SuccessFactors   │────▶│  SAP BTP    │────▶│   WTMgr        │
│ (HR Master)      │     │ (NF.13)     │     │   Spring Boot  │
└──────────────────┘     └─────────────┘     │                │
                                              │   ┌──────────┐│
┌──────────────────┐     File Upload          │   │ REST API ││
│ Primavera P6     │─────────────────────────▶│   │          ││
│ (WBS/Schedule)   │  (NF.14, 물리적 I/F 없음) │   └──────────┘│
└──────────────────┘                          │                │
                                              │   ┌──────────┐│
┌──────────────────┐     Extractor            │   │ Export   ││
│ Cognite          │◀────────────────────────│   │ API      ││
│ (Data Platform)  │     (NF.15)             │   └──────────┘│
└──────────────────┘                          └────────────────┘

9-1. SAP SuccessFactors 연동 (NF.13) — SAP BTP 필수

NF.13 원문: "In the case of direct integration with SuccessFactors, SAP BTP must be applied."

연동 아키텍처

SAP SuccessFactors
        │
        │ OData API (Employee Central)
        ▼
┌─────────────────────────┐
│      SAP BTP            │
│  (Business Technology   │
│   Platform)             │
│                         │
│  ┌───────────────────┐  │
│  │ Integration Suite │  │
│  │ (CPI/CI)          │  │
│  │                   │  │
│  │ ● OData → REST    │  │
│  │ ● 필드 매핑        │  │
│  │ ● 스케줄링 (배치)   │  │
│  └───────┬───────────┘  │
└──────────┼──────────────┘
           │ REST API (JSON)
           ▼
┌─────────────────────────┐
│     WTMgr               │
│  POST /api/integration  │
│       /hr/sync          │
└─────────────────────────┘

단계별 구현

Phase 방식 설명
PH1-1 파일 업로드 (No.1) SA가 SF에서 Export한 Excel/CSV를 수동 업로드. BTP 불필요
PH1-2 배치 자동화 (No.3) SAP BTP Integration Suite → 정기 Batch (일 1회) → WTMgr REST API
PH2 실시간 이벤트 SF Employee Events → BTP → WTMgr Webhook (입/퇴사 즉시 반영)

SAP BTP Integration Suite 설정

# BTP CPI iFlow 설정 예시
Source:
  System: SAP SuccessFactors
  API: /odata/v2/PerPersonal, /odata/v2/EmpJob, /odata/v2/FODepartment
  Auth: OAuth2 (SAP Trust)

Mapping:
  SF.personIdExternal  → WTMgr.employeeNumber
  SF.firstName + lastName → WTMgr.fullName
  SF.email             → WTMgr.email
  SF.businessUnit      → WTMgr.businessUnit (LV1)
  SF.division          → WTMgr.division (LV2)
  SF.department        → WTMgr.department (LV3)
  SF.customString1     → WTMgr.disciplineTeam (LV4)  # Discipline/Team
  SF.customString2     → WTMgr.part (LV5)            # Part
  SF.attendanceType    → WTMgr.attendanceType
  SF.jobCode           → WTMgr.individualJobCode

Target:
  System: WTMgr
  Endpoint: POST /api/integration/hr/sync
  Auth: Service Account JWT (M2M)
  Schedule: Daily 02:00 KST

Spring Boot 수신 API

@RestController
@RequestMapping("/api/integration/hr")
@PreAuthorize("hasRole('SYSTEM') or hasRole('SA')")  // M2M 또는 SA만
public class HrIntegrationController {

    private final HrSyncService hrSyncService;

    /**
     * SAP BTP → WTMgr HR 데이터 동기화
     * PH1-1: SA 수동 파일 업로드 대안
     * PH1-2: BTP CPI 자동 호출
     */
    @PostMapping("/sync")
    public HrSyncResult syncEmployees(@Valid @RequestBody HrSyncRequest request) {
        return hrSyncService.syncAll(request.getEmployees());
    }

    /**
     * SA 수동 업로드 (PH1-1: BTP 없이 Excel 업로드)
     */
    @PostMapping("/upload")
    public HrSyncResult uploadExcel(@RequestParam("file") MultipartFile file) {
        return hrSyncService.uploadFromExcel(file);
    }
}

// 동기화 요청 DTO
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,      // LV1
    String division,          // LV2
    String department,        // LV3
    String disciplineTeam,    // LV4
    String part,              // LV5
    String attendanceType,
    String individualJobCode,
    String jobRole,
    LocalDate startDate,
    LocalDate endDate,
    boolean isActive
) {}

SAP BTP 사전 확보 사항

항목 제공 주체 마감
BTP 테넌트 접근 권한 한화시스템/SAP W2
SF OData API 엔드포인트 및 인증 정보 한화시스템 W2
필드 매핑 확정 (SF → WTMgr) 한화오션 + 아큐라 W3
BTP CPI iFlow 개발/배포 권한 한화시스템 PH1-2

9-2. P6 연동 (NF.14) — 파일 기반만

NF.14 원문: "Since there is no physical interface with P6, data integration must be implemented using exported files."

항목 내용
연동 방식 P6 Export → Excel/CSV → WTMgr Upload
물리적 I/F 없음 (API 연동 불가)
업로드 주체 PM (No.27), PCM이 승인 (No.35)
필수 필드 WBS Level 1~5, P6 Activity ID, P6 Activity Name, Version Number, Effective Date, Approval Reference (No.31)
빈도 WBS 변경 시 수시 + 월 1회 Snapshot 비교 (No.32)

9-3. Cognite 연동 (NF.15) — PH2

NF.15 원문: "An extractor server is required to support interface integration with Cognite."

Export 대상 Dimension/Fact (No.80):
- Employee Dimension (사번, 이름, 부서, Discipline)
- Project Dimension (프로젝트코드, 이름, Type)
- Canonical WBS Dimension (WBS 코드, Level, 이름)
- Time Fact Table (날짜, 시수, Activity, 승인상태)
- Mapping Version Metadata (★ 기존 계획 누락 → 추가)

// Cognite Export REST API (PH2)
@GetMapping("/api/integration/cognite/export")
@PreAuthorize("hasRole('SA')")
public CogniteExportData exportForCognite(
    @RequestParam @DateTimeFormat(iso = DATE) LocalDate from,
    @RequestParam @DateTimeFormat(iso = DATE) LocalDate to) {

    return CogniteExportData.builder()
        .employees(employeeDimensionService.export())
        .projects(projectDimensionService.export())
        .canonicalWbs(wbsDimensionService.export())
        .timeFacts(timesheetFactService.export(from, to))
        .mappingVersions(wbsVersionService.exportMetadata())  // ★ 추가
        .exportedAt(LocalDateTime.now())
        .build();
}

10. 최종 점검 — 기존 계획서 오류 정정

정정 사항 요약

# 기존 계획서 수정 내용 근거
1 조직 4레벨 (BU/Division/Dept/Section) 5레벨: BU/Division/Dept/Discipline·Team/Part + Attendance Type, Individual Job Code No.2 (Eng)
2 Canonical WBS L3 = "Discipline/Category" L3 = Asset or Area No.34 (Eng)
3 Canonical WBS L4 = "Sub-Category/Work Package" L4 = Work or Discipline No.34 (Eng)
4 Canonical WBS L5 = "Deliverable/Activity" L5 = Deliverable, Package, or Material (Engineering & SCM only) No.34 (Eng)
5 Overhead 9종 (Leave, Sick Leave 등 포함) 4종: Training, Sys&Proc Dev, Org Operation, Corporate Initiative No.56 (Eng)
6 WBS 업로드 주체 = PCM/PTK PM이 업로드, PCM이 승인 No.27, No.35
7 No.49 Location/Role = PH2 Phase 미지정 (메인 요구사항), 설계 시 고려 필요 No.49
8 EPC 추가 필드 미반영 Location, Role/Position, Earned Value(진행률) 검토 No.65
9 Cognite Export 4개 Dimension 5개: + Mapping Version Metadata No.80 (Eng)
10 미완료 Timesheet 알림 미반영 필수: 담당자에게 미완료 Timesheet alert 전송 No.70
11 Project 생성 = PM 직접 PM/PCM 정보 입력 → SA 승인 후 등록 No.25
12 Non-Project TEAL = 기본 내장 Admin이 설정한 Non-Project TEAL에서만 Activity 선택 No.57
13 SAP BTP 연동 = 간략 설명만 상세 아키텍처 추가 (BTP CPI iFlow, OData → REST 매핑) NF.13

04-timesheet-module.md 보완 필요

// No.65: EPC Timesheet 추가 필드 (PH2 후보, 설계 시 확장 고려)
@Entity @Table(name = "timesheet_entries")
public class TimesheetEntry extends BaseEntity {
    // ... 기존 필드 ...

    // ★ No.65 추가 필드 (nullable, PH2에서 활성화)
    private String location;        // Onshore/Offshore/국가코드
    private String rolePosition;    // Job Role (동일 사용자 복수 Role 가능)
    private BigDecimal earnedValue; // 진행률 (%) — Earned Value
}
// ★ 주의: "동일 사용자가 복수 Role → Unit Rate 변경", "Location 변경 → Unit Rate 변경" (No.65 Remark)

06-approval-workflow.md 보완 필요

// No.70: 미완료 Timesheet 알림 (★ 기존 계획 누락)
@Component
public class TimesheetReminderScheduler {

    /**
     * 매일 오후 5시: 당일 미작성 Timesheet 알림 (No.70)
     * "The system must send alerts to responsible users
     *  for incomplete timesheets to ensure timely submission"
     */
    @Scheduled(cron = "0 0 17 * * MON-FRI")
    public void sendDailyReminder() {
        List<User> usersWithoutEntry = timesheetService
            .findUsersWithoutEntryForDate(LocalDate.now());

        for (User user : usersWithoutEntry) {
            notificationService.sendTimesheetReminder(user, LocalDate.now());
        }
    }

    /**
     * 매주 금요일 오전 10시: 주간 미제출 Timesheet 알림
     */
    @Scheduled(cron = "0 0 10 * * FRI")
    public void sendWeeklySubmitReminder() {
        LocalDate weekStart = LocalDate.now().with(DayOfWeek.MONDAY);
        List<User> unsubmitted = timesheetService
            .findUsersWithUnsubmittedWeek(weekStart);

        for (User user : unsubmitted) {
            notificationService.sendWeeklySubmitReminder(user, weekStart);
        }
    }
}

05-wbs-teal-module.md 보완 필요

// No.27: WBS 업로드 주체 수정
// 기존: PCM/PTK 업로드
// 수정: PM이 업로드 → PCM이 승인 (No.35)

@PostMapping("/api/projects/{projectId}/wbs/upload")
@PreAuthorize("hasAnyRole('SA', 'PM')")  // ★ PM 권한 (기존 PCM → PM)
public WbsVersionDto uploadP6Wbs(...) { ... }

@PostMapping("/api/projects/{projectId}/wbs/versions/{verId}/approve")
@PreAuthorize("hasAnyRole('SA', 'PCM')")  // ★ PCM 승인
public WbsVersionDto approveWbs(...) { ... }

11. API 스펙 보완 (07-api-spec.md 추가분)

추가 필요 API (기존 57개 → 최종 78개)

Method Path 설명 Phase
GET /api/overhead-types Overhead Type 목록 PH1-1
POST /api/overhead-types Overhead Type 추가 (SA) PH1-1
PUT /api/overhead-types/{id} Overhead Type 수정 (SA) PH1-1
GET /api/work-rules 근무 규칙 목록 PH1-1
PUT /api/work-rules/{id} 근무 규칙 수정 (SA) PH1-1
GET /api/projects/{id}/assignments 프로젝트 인력 배정 목록 PH1-1
POST /api/projects/{id}/assignments 인력 배정 PH1-1
POST /api/projects/{id}/assignments/upload 인력 일괄 업로드 PH1-1
DELETE /api/projects/{id}/assignments/{userId} 인력 배정 해제 PH1-1
GET /api/projects/{id}/wbs-disciplines WBS-Discipline 현황 PH1-1
POST /api/projects/{id}/wbs-disciplines WBS-Discipline 배정 PH1-1
POST /api/projects/{id}/wbs/versions/{id}/approve WBS 버전 승인 (PCM) ★ 추가 PH1-1
GET /api/role-permissions 역할별 권한 매트릭스 (SA) PH1-1
POST /api/integration/hr/sync SAP BTP HR 동기화 수신 ★ 추가 PH1-2
POST /api/integration/hr/upload SA 수동 HR 파일 업로드 ★ 추가 PH1-1
GET /api/notifications/pending 미완료 Timesheet 알림 목록 ★ 추가 PH1-1
GET /api/users/me/favorites 내 Favorite 설정 PH2
PUT /api/users/me/favorites Favorite 저장 PH2
GET /api/integration/cognite/export Cognite Export ★ 추가 PH2
GET /api/reports/wbs-misalign WBS Mis-Align 검토 (No.81) ★ 추가 PH2
GET /api/reports/discipline-productivity Discipline 생산성 (No.84) ★ 추가 PH2

최종 API 수

모듈 PH1-1차 PH1-2차 PH2 합계
Auth 8 0 0 8
Users 7 1 2 10
Projects 7 0 0 7
WBS 6 1 0 7
TEAL 4 0 0 4
Timesheets 8 0 0 8
Approvals 7 1 0 8
Reports 4 2 3 9
Home/Notification 3 0 0 3
Resource Assign 8 0 0 8
Config (규칙/Type) 4 0 0 4
Integration (SAP/Cognite) 1 1 1 3
합계 67 6 6 79
새 Issue에서 참조 Git Blame 보기 고유 링크 복사