dtos) {
+ return workRuleService.saveAll(dtos);
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/api/WtmAuthController.java b/wtm-api/src/main/java/kr/co/accura/wtm/api/WtmAuthController.java
new file mode 100644
index 0000000..efd1371
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/api/WtmAuthController.java
@@ -0,0 +1,52 @@
+package kr.co.accura.wtm.api;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Map;
+
+/**
+ * WTM-specific auth endpoints that supplement wbx-spring-core's AuthController.
+ *
+ * wbx-spring-core already provides: /api/wtm/auth/login, /me, /refresh, /logout, /password/change.
+ * This controller adds only the MISSING endpoints: SSO and password-reset.
+ */
+@RestController
+@RequiredArgsConstructor
+public class WtmAuthController {
+
+ /**
+ * SSO initiation — redirects to OAuth2 authorization endpoint.
+ * Requires Azure Entra ID configuration.
+ */
+ @GetMapping("/api/wtm/auth/sso")
+ public ResponseEntity> ssoInitiate() {
+ // TODO: Redirect to OAuth2 authorization URI once Azure Entra ID is configured
+ return ResponseEntity.status(501)
+ .body(Map.of("message", "SSO not yet configured. Azure Entra ID integration pending."));
+ }
+
+ /**
+ * SSO callback — handled by Spring Security OAuth2 filter chain.
+ * This endpoint exists for documentation; actual handling is done by SsoSuccessHandler.
+ */
+ @GetMapping("/api/wtm/auth/sso/callback")
+ public ResponseEntity> ssoCallback() {
+ return ResponseEntity.status(501)
+ .body(Map.of("message", "SSO callback handled by Spring Security OAuth2."));
+ }
+
+ /**
+ * Password reset request — sends reset link to email.
+ */
+ @PostMapping("/api/wtm/auth/password/reset")
+ public ResponseEntity> resetPassword(@RequestBody Map request) {
+ // TODO: Implement password reset email flow
+ String email = request.get("email");
+ return ResponseEntity.ok(Map.of(
+ "message", "비밀번호 재설정 링크가 이메일로 전송되었습니다.",
+ "email", email != null ? email : ""
+ ));
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/config/WtmConfig.java b/wtm-api/src/main/java/kr/co/accura/wtm/config/WtmConfig.java
new file mode 100644
index 0000000..8141254
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/config/WtmConfig.java
@@ -0,0 +1,11 @@
+package kr.co.accura.wtm.config;
+
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * WTM 전용 설정 클래스.
+ * WTM 프로젝트에 특화된 Bean 및 설정을 여기에 추가.
+ */
+@Configuration
+public class WtmConfig {
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalActionRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalActionRequest.java
new file mode 100644
index 0000000..abbc08c
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalActionRequest.java
@@ -0,0 +1,5 @@
+package kr.co.accura.wtm.domain.approval.dto;
+
+public record ApprovalActionRequest(
+ String comment
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalCommentDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalCommentDto.java
new file mode 100644
index 0000000..48518ac
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalCommentDto.java
@@ -0,0 +1,11 @@
+package kr.co.accura.wtm.domain.approval.dto;
+
+import java.time.LocalDateTime;
+
+public record ApprovalCommentDto(
+ Long id,
+ Long userId,
+ String comment,
+ String action,
+ LocalDateTime createdAt
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalDto.java
new file mode 100644
index 0000000..e95ba2e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalDto.java
@@ -0,0 +1,16 @@
+package kr.co.accura.wtm.domain.approval.dto;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+public record ApprovalDto(
+ Long id,
+ Long timesheetId,
+ Long requesterId,
+ Long projectId,
+ String status,
+ LocalDateTime submittedAt,
+ LocalDateTime completedAt,
+ List lines,
+ List comments
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalLineItemDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalLineItemDto.java
new file mode 100644
index 0000000..e15952c
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/ApprovalLineItemDto.java
@@ -0,0 +1,12 @@
+package kr.co.accura.wtm.domain.approval.dto;
+
+import java.time.LocalDateTime;
+
+public record ApprovalLineItemDto(
+ Long id,
+ Long approverId,
+ int approvalOrder,
+ String roleCode,
+ String status,
+ LocalDateTime actedAt
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/BatchApproveRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/BatchApproveRequest.java
new file mode 100644
index 0000000..b5afe55
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/dto/BatchApproveRequest.java
@@ -0,0 +1,8 @@
+package kr.co.accura.wtm.domain.approval.dto;
+
+import java.util.List;
+
+public record BatchApproveRequest(
+ List lineIds,
+ String comment
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApproval.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApproval.java
new file mode 100644
index 0000000..eee536b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApproval.java
@@ -0,0 +1,61 @@
+package kr.co.accura.wtm.domain.approval.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "approvals", uniqueConstraints = {
+ @UniqueConstraint(columnNames = {"timesheet_id"})
+})
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TtApproval extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "timesheet_id", nullable = false)
+ private Long timesheetId;
+
+ @Column(name = "requester_id", nullable = false)
+ private Long requesterId;
+
+ @Column(name = "project_id")
+ private Long projectId;
+
+ @Column(length = 20)
+ @Builder.Default
+ private String status = "PENDING";
+
+ @Column(name = "submitted_at")
+ private LocalDateTime submittedAt;
+
+ @Column(name = "completed_at")
+ private LocalDateTime completedAt;
+
+ @OneToMany(mappedBy = "approval", cascade = CascadeType.ALL, orphanRemoval = true)
+ @Builder.Default
+ private List lines = new ArrayList<>();
+
+ @OneToMany(mappedBy = "approval", cascade = CascadeType.ALL, orphanRemoval = true)
+ @Builder.Default
+ private List comments = new ArrayList<>();
+
+ public void complete() {
+ this.status = "APPROVED";
+ this.completedAt = LocalDateTime.now();
+ }
+
+ public void reject() {
+ this.status = "REJECTED";
+ this.completedAt = LocalDateTime.now();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApprovalComment.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApprovalComment.java
new file mode 100644
index 0000000..f74ed4e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApprovalComment.java
@@ -0,0 +1,33 @@
+package kr.co.accura.wtm.domain.approval.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "approval_comments")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TtApprovalComment extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "approval_id", nullable = false)
+ private TtApproval approval;
+
+ @Column(name = "user_id", nullable = false)
+ private Long userId;
+
+ @Column(length = 2000)
+ private String comment;
+
+ @Column(length = 20)
+ private String action;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApprovalLine.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApprovalLine.java
new file mode 100644
index 0000000..68b9592
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/entity/TtApprovalLine.java
@@ -0,0 +1,50 @@
+package kr.co.accura.wtm.domain.approval.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "approval_lines")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TtApprovalLine extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "approval_id", nullable = false)
+ private TtApproval approval;
+
+ @Column(name = "approver_id", nullable = false)
+ private Long approverId;
+
+ @Column(name = "approval_order", nullable = false)
+ private int approvalOrder;
+
+ @Column(name = "role_code", length = 20)
+ private String roleCode;
+
+ @Column(length = 20)
+ @Builder.Default
+ private String status = "PENDING";
+
+ @Column(name = "acted_at")
+ private LocalDateTime actedAt;
+
+ public void approve() {
+ this.status = "APPROVED";
+ this.actedAt = LocalDateTime.now();
+ }
+
+ public void reject() {
+ this.status = "REJECTED";
+ this.actedAt = LocalDateTime.now();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/handler/TimesheetApprovalHandler.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/handler/TimesheetApprovalHandler.java
new file mode 100644
index 0000000..594e9dc
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/handler/TimesheetApprovalHandler.java
@@ -0,0 +1,117 @@
+package kr.co.accura.wtm.domain.approval.handler;
+
+import kr.co.accura.wbx.spring.approval.*;
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.approval.entity.TtApproval;
+import kr.co.accura.wtm.domain.approval.entity.TtApprovalLine;
+import kr.co.accura.wtm.domain.approval.repository.TtApprovalLineRepository;
+import kr.co.accura.wtm.domain.approval.repository.TtApprovalRepository;
+import kr.co.accura.wtm.domain.timesheet.TimesheetStatus;
+import kr.co.accura.wtm.domain.timesheet.entity.Timesheet;
+import kr.co.accura.wtm.domain.timesheet.repository.TimesheetRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.context.ApplicationEventPublisher;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+import java.util.Optional;
+
+@Component
+@RequiredArgsConstructor
+public class TimesheetApprovalHandler implements ApprovalHandler {
+
+ private final TtApprovalRepository approvalRepository;
+ private final TtApprovalLineRepository lineRepository;
+ private final TimesheetRepository timesheetRepository;
+ private final ApplicationEventPublisher eventPublisher;
+
+ @Override
+ public String getTypeKey() {
+ return "timesheet";
+ }
+
+ @Override
+ public String getTypeDisplay() {
+ return "시수 결재";
+ }
+
+ @Override
+ @Transactional
+ public ApprovalResult approve(Long lineId, Long approverId, String comment) {
+ TtApprovalLine line = lineRepository.findById(lineId)
+ .orElseThrow(() -> new NotFoundException("결재 라인을 찾을 수 없습니다."));
+ line.approve();
+ lineRepository.save(line);
+
+ TtApproval approval = line.getApproval();
+ Timesheet ts = timesheetRepository.findById(approval.getTimesheetId())
+ .orElseThrow(() -> new NotFoundException("Timesheet not found"));
+
+ Optional next = lineRepository.findNextPending(
+ approval.getId(), line.getApprovalOrder());
+
+ if (next.isPresent()) {
+ ts.setStatus(TimesheetStatus.DL_APPROVED);
+ } else {
+ ts.setStatus(TimesheetStatus.APPROVED);
+ approval.complete();
+ approvalRepository.save(approval);
+ eventPublisher.publishEvent(new ApprovalCompletedEvent(
+ "timesheet", ts.getId(), approverId, approval));
+ }
+ timesheetRepository.save(ts);
+
+ return ApprovalResult.success("승인 완료");
+ }
+
+ @Override
+ @Transactional
+ public ApprovalResult reject(Long lineId, Long approverId, String comment) {
+ TtApprovalLine line = lineRepository.findById(lineId)
+ .orElseThrow(() -> new NotFoundException("결재 라인을 찾을 수 없습니다."));
+ line.reject();
+ lineRepository.save(line);
+
+ TtApproval approval = line.getApproval();
+ approval.reject();
+ approvalRepository.save(approval);
+
+ Timesheet ts = timesheetRepository.findById(approval.getTimesheetId())
+ .orElseThrow(() -> new NotFoundException("Timesheet not found"));
+ ts.setStatus(TimesheetStatus.REJECTED);
+ timesheetRepository.save(ts);
+
+ return ApprovalResult.success("반려 완료");
+ }
+
+ @Override
+ @Transactional(readOnly = true)
+ public ApprovalHistoryDto getApprovalHistory(Long timesheetId) {
+ TtApproval approval = approvalRepository.findByTimesheetId(timesheetId)
+ .orElseThrow(() -> new NotFoundException("결재 정보를 찾을 수 없습니다."));
+
+ List lineDtos = approval.getLines().stream()
+ .map(l -> new ApprovalLineDto(
+ l.getId(), l.getApproverId(), null,
+ l.getApprovalOrder(), l.getRoleCode(), l.getStatus(),
+ null, l.getActedAt()))
+ .toList();
+
+ return new ApprovalHistoryDto(
+ timesheetId, "timesheet", approval.getStatus(),
+ null, approval.getSubmittedAt(), lineDtos);
+ }
+
+ @Override
+ @Transactional(readOnly = true)
+ public Page getPending(Long approverId, Pageable pageable) {
+ return lineRepository.findPendingByApproverId(approverId, pageable)
+ .map(line -> new ApprovalPendingDto(
+ line.getId(), "timesheet",
+ "시수 결재 #" + line.getApproval().getTimesheetId(),
+ null, line.getApproval().getSubmittedAt()));
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalCommentRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalCommentRepository.java
new file mode 100644
index 0000000..b1f7357
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalCommentRepository.java
@@ -0,0 +1,11 @@
+package kr.co.accura.wtm.domain.approval.repository;
+
+import kr.co.accura.wtm.domain.approval.entity.TtApprovalComment;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface TtApprovalCommentRepository extends JpaRepository {
+
+ List findByApproval_IdOrderByCreatedAtAsc(Long approvalId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalLineRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalLineRepository.java
new file mode 100644
index 0000000..4979a4a
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalLineRepository.java
@@ -0,0 +1,29 @@
+package kr.co.accura.wtm.domain.approval.repository;
+
+import kr.co.accura.wtm.domain.approval.entity.TtApprovalLine;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.util.List;
+import java.util.Optional;
+
+public interface TtApprovalLineRepository extends JpaRepository {
+
+ List findByApproval_IdOrderByApprovalOrder(Long approvalId);
+
+ @Query("SELECT l FROM TtApprovalLine l WHERE l.approval.id = :approvalId " +
+ "AND l.approvalOrder > :currentOrder AND l.status = 'PENDING' " +
+ "ORDER BY l.approvalOrder ASC")
+ Optional findNextPending(
+ @Param("approvalId") Long approvalId,
+ @Param("currentOrder") int currentOrder);
+
+ @Query("SELECT l FROM TtApprovalLine l WHERE l.approverId = :approverId AND l.status = 'PENDING'")
+ Page findPendingByApproverId(@Param("approverId") Long approverId, Pageable pageable);
+
+ @Query("SELECT l FROM TtApprovalLine l WHERE l.approverId = :approverId AND l.status <> 'PENDING'")
+ Page findHistoryByApproverId(@Param("approverId") Long approverId, Pageable pageable);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalRepository.java
new file mode 100644
index 0000000..425ed3c
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/repository/TtApprovalRepository.java
@@ -0,0 +1,11 @@
+package kr.co.accura.wtm.domain.approval.repository;
+
+import kr.co.accura.wtm.domain.approval.entity.TtApproval;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.Optional;
+
+public interface TtApprovalRepository extends JpaRepository {
+
+ Optional findByTimesheetId(Long timesheetId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/service/ApprovalService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/service/ApprovalService.java
new file mode 100644
index 0000000..435f132
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/approval/service/ApprovalService.java
@@ -0,0 +1,145 @@
+package kr.co.accura.wtm.domain.approval.service;
+
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.approval.dto.*;
+import kr.co.accura.wtm.domain.approval.entity.TtApproval;
+import kr.co.accura.wtm.domain.approval.entity.TtApprovalComment;
+import kr.co.accura.wtm.domain.approval.entity.TtApprovalLine;
+import kr.co.accura.wtm.domain.approval.repository.TtApprovalCommentRepository;
+import kr.co.accura.wtm.domain.approval.repository.TtApprovalLineRepository;
+import kr.co.accura.wtm.domain.approval.repository.TtApprovalRepository;
+import kr.co.accura.wtm.domain.timesheet.TimesheetStatus;
+import kr.co.accura.wtm.domain.timesheet.entity.Timesheet;
+import kr.co.accura.wtm.domain.timesheet.repository.TimesheetRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class ApprovalService {
+
+ private final TtApprovalRepository approvalRepository;
+ private final TtApprovalLineRepository lineRepository;
+ private final TtApprovalCommentRepository commentRepository;
+ private final TimesheetRepository timesheetRepository;
+
+ @Transactional(readOnly = true)
+ public Page getPending(Long approverId, Pageable pageable) {
+ return lineRepository.findPendingByApproverId(approverId, pageable)
+ .map(this::toLineDto);
+ }
+
+ public void approve(Long lineId, Long approverId, String comment) {
+ TtApprovalLine line = lineRepository.findById(lineId)
+ .orElseThrow(() -> new NotFoundException("결재 라인을 찾을 수 없습니다."));
+ line.approve();
+ lineRepository.save(line);
+
+ TtApproval approval = line.getApproval();
+ Timesheet ts = timesheetRepository.findById(approval.getTimesheetId())
+ .orElseThrow(() -> new NotFoundException("Timesheet not found"));
+
+ // Check for next pending approver
+ var next = lineRepository.findNextPending(approval.getId(), line.getApprovalOrder());
+ if (next.isPresent()) {
+ ts.setStatus(TimesheetStatus.DL_APPROVED);
+ } else {
+ ts.setStatus(TimesheetStatus.APPROVED);
+ approval.complete();
+ approvalRepository.save(approval);
+ }
+ timesheetRepository.save(ts);
+
+ if (comment != null && !comment.isBlank()) {
+ addComment(approval, approverId, comment, "APPROVE");
+ }
+ }
+
+ public void reject(Long lineId, Long approverId, String comment) {
+ TtApprovalLine line = lineRepository.findById(lineId)
+ .orElseThrow(() -> new NotFoundException("결재 라인을 찾을 수 없습니다."));
+ line.reject();
+ lineRepository.save(line);
+
+ TtApproval approval = line.getApproval();
+ approval.reject();
+ approvalRepository.save(approval);
+
+ Timesheet ts = timesheetRepository.findById(approval.getTimesheetId())
+ .orElseThrow(() -> new NotFoundException("Timesheet not found"));
+ ts.setStatus(TimesheetStatus.REJECTED);
+ timesheetRepository.save(ts);
+
+ if (comment != null && !comment.isBlank()) {
+ addComment(approval, approverId, comment, "REJECT");
+ }
+ }
+
+ public void batchApprove(List lineIds, Long approverId, String comment) {
+ for (Long lineId : lineIds) {
+ approve(lineId, approverId, comment);
+ }
+ }
+
+ public void addComment(Long approvalId, Long userId, String comment) {
+ TtApproval approval = approvalRepository.findById(approvalId)
+ .orElseThrow(() -> new NotFoundException("결재를 찾을 수 없습니다."));
+ addComment(approval, userId, comment, "COMMENT");
+ }
+
+ @Transactional(readOnly = true)
+ public ApprovalDto getApprovalDetail(Long approvalId) {
+ TtApproval approval = approvalRepository.findById(approvalId)
+ .orElseThrow(() -> new NotFoundException("결재를 찾을 수 없습니다."));
+ return toDto(approval);
+ }
+
+ @Transactional(readOnly = true)
+ public Page getHistory(Long approverId, Pageable pageable) {
+ return lineRepository.findHistoryByApproverId(approverId, pageable)
+ .map(this::toLineDto);
+ }
+
+ @Transactional(readOnly = true)
+ public List getComments(Long approvalId) {
+ return commentRepository.findByApproval_IdOrderByCreatedAtAsc(approvalId).stream()
+ .map(this::toCommentDto)
+ .toList();
+ }
+
+ // --- Helper methods ---
+
+ private void addComment(TtApproval approval, Long userId, String comment, String action) {
+ TtApprovalComment c = TtApprovalComment.builder()
+ .approval(approval)
+ .userId(userId)
+ .comment(comment)
+ .action(action)
+ .build();
+ commentRepository.save(c);
+ }
+
+ private ApprovalDto toDto(TtApproval a) {
+ List lines = a.getLines().stream().map(this::toLineDto).toList();
+ List comments = a.getComments().stream().map(this::toCommentDto).toList();
+ return new ApprovalDto(a.getId(), a.getTimesheetId(), a.getRequesterId(),
+ a.getProjectId(), a.getStatus(), a.getSubmittedAt(), a.getCompletedAt(),
+ lines, comments);
+ }
+
+ private ApprovalLineItemDto toLineDto(TtApprovalLine l) {
+ return new ApprovalLineItemDto(l.getId(), l.getApproverId(),
+ l.getApprovalOrder(), l.getRoleCode(), l.getStatus(), l.getActedAt());
+ }
+
+ private ApprovalCommentDto toCommentDto(TtApprovalComment c) {
+ return new ApprovalCommentDto(c.getId(), c.getUserId(),
+ c.getComment(), c.getAction(), c.getCreatedAt());
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/audit/entity/SaAccessLog.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/audit/entity/SaAccessLog.java
new file mode 100644
index 0000000..6875be6
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/audit/entity/SaAccessLog.java
@@ -0,0 +1,39 @@
+package kr.co.accura.wtm.domain.audit.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+@Entity
+@Table(name = "sa_access_logs")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class SaAccessLog extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "user_id", nullable = false)
+ private Long userId;
+
+ @Column(nullable = false, length = 50)
+ private String action;
+
+ @Column(length = 100)
+ private String resource;
+
+ @Column(name = "resource_id")
+ private Long resourceId;
+
+ @Column(name = "ip_address", length = 50)
+ private String ipAddress;
+
+ @Column(name = "user_agent", length = 500)
+ private String userAgent;
+
+ @Column(length = 2000)
+ private String detail;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/audit/repository/SaAccessLogRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/audit/repository/SaAccessLogRepository.java
new file mode 100644
index 0000000..b7c7880
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/audit/repository/SaAccessLogRepository.java
@@ -0,0 +1,13 @@
+package kr.co.accura.wtm.domain.audit.repository;
+
+import kr.co.accura.wtm.domain.audit.entity.SaAccessLog;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface SaAccessLogRepository extends JpaRepository {
+
+ Page findByUserIdOrderByCreatedAtDesc(Long userId, Pageable pageable);
+
+ Page findAllByOrderByCreatedAtDesc(Pageable pageable);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/dto/OverheadTypeDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/dto/OverheadTypeDto.java
new file mode 100644
index 0000000..07a9463
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/dto/OverheadTypeDto.java
@@ -0,0 +1,10 @@
+package kr.co.accura.wtm.domain.config.dto;
+
+public record OverheadTypeDto(
+ Long id,
+ String code,
+ String name,
+ String category,
+ Boolean isActive,
+ Integer sortOrder
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/dto/WorkRuleDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/dto/WorkRuleDto.java
new file mode 100644
index 0000000..991c62b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/dto/WorkRuleDto.java
@@ -0,0 +1,12 @@
+package kr.co.accura.wtm.domain.config.dto;
+
+import java.math.BigDecimal;
+
+public record WorkRuleDto(
+ Long id,
+ String location,
+ BigDecimal minDailyHours,
+ BigDecimal maxDailyHours,
+ BigDecimal maxWeeklyHours,
+ Boolean isActive
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/entity/OverheadType.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/entity/OverheadType.java
new file mode 100644
index 0000000..0c1485b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/entity/OverheadType.java
@@ -0,0 +1,35 @@
+package kr.co.accura.wtm.domain.config.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+@Entity
+@Table(name = "overhead_types")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class OverheadType extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false, unique = true, length = 50)
+ private String code;
+
+ @Column(nullable = false, length = 200)
+ private String name;
+
+ @Column(length = 50)
+ private String category;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+
+ @Column(name = "sort_order")
+ @Builder.Default
+ private Integer sortOrder = 0;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/entity/WorkRule.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/entity/WorkRule.java
new file mode 100644
index 0000000..827c8e8
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/entity/WorkRule.java
@@ -0,0 +1,39 @@
+package kr.co.accura.wtm.domain.config.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Entity
+@Table(name = "work_rules")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class WorkRule extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(length = 50)
+ private String location;
+
+ @Column(name = "min_daily_hours", precision = 4, scale = 2)
+ @Builder.Default
+ private BigDecimal minDailyHours = new BigDecimal("8.00");
+
+ @Column(name = "max_daily_hours", precision = 4, scale = 2)
+ @Builder.Default
+ private BigDecimal maxDailyHours = new BigDecimal("12.00");
+
+ @Column(name = "max_weekly_hours", precision = 5, scale = 2)
+ @Builder.Default
+ private BigDecimal maxWeeklyHours = new BigDecimal("52.00");
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/repository/OverheadTypeRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/repository/OverheadTypeRepository.java
new file mode 100644
index 0000000..44a903c
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/repository/OverheadTypeRepository.java
@@ -0,0 +1,11 @@
+package kr.co.accura.wtm.domain.config.repository;
+
+import kr.co.accura.wtm.domain.config.entity.OverheadType;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface OverheadTypeRepository extends JpaRepository {
+
+ List findByIsActiveTrueOrderBySortOrderAsc();
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/repository/WorkRuleRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/repository/WorkRuleRepository.java
new file mode 100644
index 0000000..8319d5e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/repository/WorkRuleRepository.java
@@ -0,0 +1,14 @@
+package kr.co.accura.wtm.domain.config.repository;
+
+import kr.co.accura.wtm.domain.config.entity.WorkRule;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+import java.util.Optional;
+
+public interface WorkRuleRepository extends JpaRepository {
+
+ Optional findByLocation(String location);
+
+ List findByIsActiveTrue();
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/service/OverheadTypeService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/service/OverheadTypeService.java
new file mode 100644
index 0000000..d662080
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/service/OverheadTypeService.java
@@ -0,0 +1,53 @@
+package kr.co.accura.wtm.domain.config.service;
+
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.config.dto.OverheadTypeDto;
+import kr.co.accura.wtm.domain.config.entity.OverheadType;
+import kr.co.accura.wtm.domain.config.repository.OverheadTypeRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class OverheadTypeService {
+
+ private final OverheadTypeRepository repository;
+
+ @Transactional(readOnly = true)
+ public List getAll() {
+ return repository.findByIsActiveTrueOrderBySortOrderAsc().stream()
+ .map(this::toDto)
+ .toList();
+ }
+
+ public OverheadTypeDto create(OverheadTypeDto dto) {
+ OverheadType entity = OverheadType.builder()
+ .code(dto.code())
+ .name(dto.name())
+ .category(dto.category())
+ .isActive(dto.isActive() != null ? dto.isActive() : true)
+ .sortOrder(dto.sortOrder() != null ? dto.sortOrder() : 0)
+ .build();
+ return toDto(repository.save(entity));
+ }
+
+ public OverheadTypeDto update(Long id, OverheadTypeDto dto) {
+ OverheadType entity = repository.findById(id)
+ .orElseThrow(() -> new NotFoundException("Overhead type not found: " + id));
+ entity.setCode(dto.code());
+ entity.setName(dto.name());
+ entity.setCategory(dto.category());
+ if (dto.isActive() != null) entity.setIsActive(dto.isActive());
+ if (dto.sortOrder() != null) entity.setSortOrder(dto.sortOrder());
+ return toDto(repository.save(entity));
+ }
+
+ private OverheadTypeDto toDto(OverheadType e) {
+ return new OverheadTypeDto(e.getId(), e.getCode(), e.getName(),
+ e.getCategory(), e.getIsActive(), e.getSortOrder());
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/service/WorkRuleService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/service/WorkRuleService.java
new file mode 100644
index 0000000..18ae0c9
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/config/service/WorkRuleService.java
@@ -0,0 +1,54 @@
+package kr.co.accura.wtm.domain.config.service;
+
+import kr.co.accura.wtm.domain.config.dto.WorkRuleDto;
+import kr.co.accura.wtm.domain.config.entity.WorkRule;
+import kr.co.accura.wtm.domain.config.repository.WorkRuleRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class WorkRuleService {
+
+ private final WorkRuleRepository repository;
+
+ @Transactional(readOnly = true)
+ public List getAll() {
+ return repository.findByIsActiveTrue().stream()
+ .map(this::toDto)
+ .toList();
+ }
+
+ public List saveAll(List dtos) {
+ List rules = dtos.stream().map(dto -> {
+ WorkRule rule;
+ if (dto.id() != null) {
+ rule = repository.findById(dto.id()).orElse(new WorkRule());
+ } else if (dto.location() != null) {
+ rule = repository.findByLocation(dto.location()).orElse(new WorkRule());
+ } else {
+ rule = new WorkRule();
+ }
+ rule.setLocation(dto.location());
+ if (dto.minDailyHours() != null) rule.setMinDailyHours(dto.minDailyHours());
+ if (dto.maxDailyHours() != null) rule.setMaxDailyHours(dto.maxDailyHours());
+ if (dto.maxWeeklyHours() != null) rule.setMaxWeeklyHours(dto.maxWeeklyHours());
+ if (dto.isActive() != null) rule.setIsActive(dto.isActive());
+ return rule;
+ }).toList();
+
+ return repository.saveAll(rules).stream()
+ .map(this::toDto)
+ .toList();
+ }
+
+ private WorkRuleDto toDto(WorkRule e) {
+ return new WorkRuleDto(e.getId(), e.getLocation(),
+ e.getMinDailyHours(), e.getMaxDailyHours(),
+ e.getMaxWeeklyHours(), e.getIsActive());
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/ProjectStatus.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/ProjectStatus.java
new file mode 100644
index 0000000..267d0f3
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/ProjectStatus.java
@@ -0,0 +1,7 @@
+package kr.co.accura.wtm.domain.project;
+
+public enum ProjectStatus {
+ ACTIVE,
+ CLOSED,
+ HOLD
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/ProjectType.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/ProjectType.java
new file mode 100644
index 0000000..b4339a1
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/ProjectType.java
@@ -0,0 +1,7 @@
+package kr.co.accura.wtm.domain.project;
+
+public enum ProjectType {
+ EPC,
+ NON_PROJECT,
+ OTHER
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/AssignmentCreateRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/AssignmentCreateRequest.java
new file mode 100644
index 0000000..d40ae2d
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/AssignmentCreateRequest.java
@@ -0,0 +1,9 @@
+package kr.co.accura.wtm.domain.project.dto;
+
+import jakarta.validation.constraints.NotNull;
+
+public record AssignmentCreateRequest(
+ @NotNull Long userId,
+ String role
+) {
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectAssignmentDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectAssignmentDto.java
new file mode 100644
index 0000000..bbd746c
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectAssignmentDto.java
@@ -0,0 +1,27 @@
+package kr.co.accura.wtm.domain.project.dto;
+
+import kr.co.accura.wtm.domain.project.entity.ProjectAssignment;
+
+import java.time.LocalDateTime;
+
+public record ProjectAssignmentDto(
+ Long id,
+ Long projectId,
+ Long userId,
+ String userName,
+ String userEmail,
+ String role,
+ LocalDateTime assignedAt
+) {
+ public static ProjectAssignmentDto from(ProjectAssignment assignment) {
+ return new ProjectAssignmentDto(
+ assignment.getId(),
+ assignment.getProject().getId(),
+ assignment.getUser().getId(),
+ assignment.getUser().getFullName(),
+ assignment.getUser().getEmail(),
+ assignment.getRole(),
+ assignment.getAssignedAt()
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectCreateRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectCreateRequest.java
new file mode 100644
index 0000000..2196e42
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectCreateRequest.java
@@ -0,0 +1,16 @@
+package kr.co.accura.wtm.domain.project.dto;
+
+import jakarta.validation.constraints.NotBlank;
+
+import java.time.LocalDate;
+
+public record ProjectCreateRequest(
+ @NotBlank String projectCode,
+ @NotBlank String name,
+ String description,
+ @NotBlank String projectType,
+ LocalDate startDate,
+ LocalDate endDate,
+ Long pmUserId
+) {
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectDto.java
new file mode 100644
index 0000000..06f59cb
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/dto/ProjectDto.java
@@ -0,0 +1,33 @@
+package kr.co.accura.wtm.domain.project.dto;
+
+import kr.co.accura.wtm.domain.project.entity.Project;
+
+import java.time.LocalDate;
+
+public record ProjectDto(
+ Long id,
+ String projectCode,
+ String name,
+ String description,
+ String projectType,
+ String status,
+ LocalDate startDate,
+ LocalDate endDate,
+ Long pmUserId,
+ String pmUserName
+) {
+ public static ProjectDto from(Project project) {
+ return new ProjectDto(
+ project.getId(),
+ project.getProjectCode(),
+ project.getName(),
+ project.getDescription(),
+ project.getProjectType() != null ? project.getProjectType().name() : null,
+ project.getStatus() != null ? project.getStatus().name() : null,
+ project.getStartDate(),
+ project.getEndDate(),
+ project.getPmUser() != null ? project.getPmUser().getId() : null,
+ project.getPmUser() != null ? project.getPmUser().getFullName() : null
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/Project.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/Project.java
new file mode 100644
index 0000000..fdfcc88
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/Project.java
@@ -0,0 +1,52 @@
+package kr.co.accura.wtm.domain.project.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import kr.co.accura.wtm.domain.project.ProjectStatus;
+import kr.co.accura.wtm.domain.project.ProjectType;
+import kr.co.accura.wtm.domain.user.entity.User;
+import lombok.*;
+
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "projects")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Project extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "project_code", unique = true, nullable = false, length = 50)
+ private String projectCode;
+
+ @Column(nullable = false, length = 255)
+ private String name;
+
+ @Column(length = 1000)
+ private String description;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "project_type", nullable = false, length = 20)
+ private ProjectType projectType;
+
+ @Enumerated(EnumType.STRING)
+ @Column(length = 20)
+ @Builder.Default
+ private ProjectStatus status = ProjectStatus.ACTIVE;
+
+ @Column(name = "start_date")
+ private LocalDate startDate;
+
+ @Column(name = "end_date")
+ private LocalDate endDate;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "pm_user_id")
+ private User pmUser;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/ProjectAssignment.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/ProjectAssignment.java
new file mode 100644
index 0000000..ddcd248
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/ProjectAssignment.java
@@ -0,0 +1,39 @@
+package kr.co.accura.wtm.domain.project.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wtm.domain.user.entity.User;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "project_assignments")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class ProjectAssignment {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "project_id", nullable = false)
+ private Project project;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "user_id", nullable = false)
+ private User user;
+
+ @Column(length = 50)
+ private String role;
+
+ @Column(name = "assigned_at")
+ @Builder.Default
+ private LocalDateTime assignedAt = LocalDateTime.now();
+
+ @Column(name = "assigned_by")
+ private Long assignedBy;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/ProjectTypeConfig.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/ProjectTypeConfig.java
new file mode 100644
index 0000000..e870029
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/entity/ProjectTypeConfig.java
@@ -0,0 +1,44 @@
+package kr.co.accura.wtm.domain.project.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "project_type_config",
+ uniqueConstraints = @UniqueConstraint(columnNames = {"project_type", "config_key"}))
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class ProjectTypeConfig {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "project_type", nullable = false, length = 20)
+ private String projectType;
+
+ @Column(name = "config_key", nullable = false, length = 100)
+ private String configKey;
+
+ @Column(name = "config_value", length = 500)
+ private String configValue;
+
+ @Column(length = 500)
+ private String description;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+
+ @Column(name = "created_at")
+ @Builder.Default
+ private LocalDateTime createdAt = LocalDateTime.now();
+
+ @Column(name = "updated_at")
+ private LocalDateTime updatedAt;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectAssignmentRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectAssignmentRepository.java
new file mode 100644
index 0000000..bf44af4
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectAssignmentRepository.java
@@ -0,0 +1,17 @@
+package kr.co.accura.wtm.domain.project.repository;
+
+import kr.co.accura.wtm.domain.project.entity.ProjectAssignment;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface ProjectAssignmentRepository extends JpaRepository {
+
+ List findByProject_Id(Long projectId);
+
+ List findByUser_Id(Long userId);
+
+ boolean existsByProject_IdAndUser_Id(Long projectId, Long userId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectRepository.java
new file mode 100644
index 0000000..5e19674
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectRepository.java
@@ -0,0 +1,15 @@
+package kr.co.accura.wtm.domain.project.repository;
+
+import kr.co.accura.wtm.domain.project.entity.Project;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface ProjectRepository extends JpaRepository {
+
+ Optional findByProjectCode(String projectCode);
+
+ boolean existsByProjectCode(String projectCode);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectTypeConfigRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectTypeConfigRepository.java
new file mode 100644
index 0000000..b5fb30e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/repository/ProjectTypeConfigRepository.java
@@ -0,0 +1,16 @@
+package kr.co.accura.wtm.domain.project.repository;
+
+import kr.co.accura.wtm.domain.project.entity.ProjectTypeConfig;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface ProjectTypeConfigRepository extends JpaRepository {
+
+ List findByProjectTypeAndIsActiveTrue(String projectType);
+
+ Optional findByProjectTypeAndConfigKey(String projectType, String configKey);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/service/ProjectService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/service/ProjectService.java
new file mode 100644
index 0000000..8ffab98
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/project/service/ProjectService.java
@@ -0,0 +1,144 @@
+package kr.co.accura.wtm.domain.project.service;
+
+import kr.co.accura.wbx.spring.common.BusinessException;
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.project.ProjectStatus;
+import kr.co.accura.wtm.domain.project.ProjectType;
+import kr.co.accura.wtm.domain.project.dto.*;
+import kr.co.accura.wtm.domain.project.entity.Project;
+import kr.co.accura.wtm.domain.project.entity.ProjectAssignment;
+import kr.co.accura.wtm.domain.project.repository.ProjectAssignmentRepository;
+import kr.co.accura.wtm.domain.project.repository.ProjectRepository;
+import kr.co.accura.wtm.domain.user.entity.User;
+import kr.co.accura.wtm.domain.user.repository.UserRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class ProjectService {
+
+ private final ProjectRepository projectRepository;
+ private final ProjectAssignmentRepository assignmentRepository;
+ private final UserRepository userRepository;
+
+ @Transactional(readOnly = true)
+ public Page findAll(Pageable pageable) {
+ return projectRepository.findAll(pageable).map(ProjectDto::from);
+ }
+
+ @Transactional(readOnly = true)
+ public ProjectDto findById(Long id) {
+ Project project = projectRepository.findById(id)
+ .orElseThrow(() -> new NotFoundException("Project not found: " + id));
+ return ProjectDto.from(project);
+ }
+
+ public ProjectDto create(ProjectCreateRequest request) {
+ if (projectRepository.existsByProjectCode(request.projectCode())) {
+ throw new BusinessException("Project code already exists: " + request.projectCode());
+ }
+
+ Project project = Project.builder()
+ .projectCode(request.projectCode())
+ .name(request.name())
+ .description(request.description())
+ .projectType(ProjectType.valueOf(request.projectType()))
+ .startDate(request.startDate())
+ .endDate(request.endDate())
+ .build();
+
+ if (request.pmUserId() != null) {
+ User pmUser = userRepository.findById(request.pmUserId())
+ .orElseThrow(() -> new NotFoundException("PM user not found: " + request.pmUserId()));
+ project.setPmUser(pmUser);
+ }
+
+ projectRepository.save(project);
+ return ProjectDto.from(project);
+ }
+
+ public ProjectDto update(Long id, ProjectCreateRequest request) {
+ Project project = projectRepository.findById(id)
+ .orElseThrow(() -> new NotFoundException("Project not found: " + id));
+
+ if (request.name() != null) project.setName(request.name());
+ if (request.description() != null) project.setDescription(request.description());
+ if (request.projectType() != null) project.setProjectType(ProjectType.valueOf(request.projectType()));
+ if (request.startDate() != null) project.setStartDate(request.startDate());
+ if (request.endDate() != null) project.setEndDate(request.endDate());
+ if (request.pmUserId() != null) {
+ User pmUser = userRepository.findById(request.pmUserId())
+ .orElseThrow(() -> new NotFoundException("PM user not found: " + request.pmUserId()));
+ project.setPmUser(pmUser);
+ }
+
+ projectRepository.save(project);
+ return ProjectDto.from(project);
+ }
+
+ @Transactional(readOnly = true)
+ public List findMyProjects(Long userId) {
+ List assignments = assignmentRepository.findByUser_Id(userId);
+ return assignments.stream()
+ .map(a -> ProjectDto.from(a.getProject()))
+ .toList();
+ }
+
+ // --- Assignment methods ---
+
+ @Transactional(readOnly = true)
+ public List getAssignments(Long projectId) {
+ return assignmentRepository.findByProject_Id(projectId).stream()
+ .map(ProjectAssignmentDto::from)
+ .toList();
+ }
+
+ public ProjectAssignmentDto createAssignment(Long projectId, AssignmentCreateRequest request) {
+ Project project = projectRepository.findById(projectId)
+ .orElseThrow(() -> new NotFoundException("Project not found: " + projectId));
+ User user = userRepository.findById(request.userId())
+ .orElseThrow(() -> new NotFoundException("User not found: " + request.userId()));
+
+ if (assignmentRepository.existsByProject_IdAndUser_Id(projectId, request.userId())) {
+ throw new BusinessException("User already assigned to this project");
+ }
+
+ ProjectAssignment assignment = ProjectAssignment.builder()
+ .project(project)
+ .user(user)
+ .role(request.role())
+ .build();
+
+ assignmentRepository.save(assignment);
+ return ProjectAssignmentDto.from(assignment);
+ }
+
+ public ProjectAssignmentDto updateAssignment(Long projectId, Long assignId, AssignmentCreateRequest request) {
+ ProjectAssignment assignment = assignmentRepository.findById(assignId)
+ .orElseThrow(() -> new NotFoundException("Assignment not found: " + assignId));
+
+ if (request.role() != null) assignment.setRole(request.role());
+
+ assignmentRepository.save(assignment);
+ return ProjectAssignmentDto.from(assignment);
+ }
+
+ public void deleteAssignment(Long projectId, Long assignId) {
+ ProjectAssignment assignment = assignmentRepository.findById(assignId)
+ .orElseThrow(() -> new NotFoundException("Assignment not found: " + assignId));
+ assignmentRepository.delete(assignment);
+ }
+
+ @Transactional(readOnly = true)
+ public Page getAvailableUsers(Long projectId, Pageable pageable) {
+ // Returns all active users; filtering out already-assigned users can be refined later
+ return userRepository.findAll(pageable);
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/ProjectHoursReport.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/ProjectHoursReport.java
new file mode 100644
index 0000000..68a99f4
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/ProjectHoursReport.java
@@ -0,0 +1,22 @@
+package kr.co.accura.wtm.domain.report.dto;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+public record ProjectHoursReport(
+ ReportFilter filter,
+ List rows,
+ BigDecimal totalHours,
+ LocalDateTime generatedAt
+) {
+ public record ProjectHoursRow(
+ Long projectId,
+ String projectCode,
+ String projectName,
+ String discipline,
+ LocalDate entryDate,
+ BigDecimal hours
+ ) {}
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/ReportFilter.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/ReportFilter.java
new file mode 100644
index 0000000..734938a
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/ReportFilter.java
@@ -0,0 +1,12 @@
+package kr.co.accura.wtm.domain.report.dto;
+
+import java.time.LocalDate;
+
+public record ReportFilter(
+ Long projectId,
+ LocalDate from,
+ LocalDate to,
+ String groupBy,
+ Integer wbsLevel,
+ String department
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/WbsHoursReport.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/WbsHoursReport.java
new file mode 100644
index 0000000..0434600
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/dto/WbsHoursReport.java
@@ -0,0 +1,20 @@
+package kr.co.accura.wtm.domain.report.dto;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+public record WbsHoursReport(
+ ReportFilter filter,
+ List rows,
+ LocalDateTime generatedAt
+) {
+ public record WbsHoursRow(
+ String wbsCode,
+ String wbsName,
+ int wbsLevel,
+ String discipline,
+ BigDecimal totalHours,
+ long userCount
+ ) {}
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/service/ReportService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/service/ReportService.java
new file mode 100644
index 0000000..e45acad
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/report/service/ReportService.java
@@ -0,0 +1,119 @@
+package kr.co.accura.wtm.domain.report.service;
+
+import kr.co.accura.wtm.domain.report.dto.ProjectHoursReport;
+import kr.co.accura.wtm.domain.report.dto.ReportFilter;
+import kr.co.accura.wtm.domain.report.dto.WbsHoursReport;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import jakarta.persistence.EntityManager;
+import jakarta.persistence.Query;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Service
+@Transactional(readOnly = true)
+@RequiredArgsConstructor
+public class ReportService {
+
+ private final EntityManager em;
+
+ public ProjectHoursReport getProjectHoursReport(ReportFilter filter) {
+ StringBuilder sql = new StringBuilder(
+ "SELECT te.epc_project_id, p.project_code, p.name, '' as discipline, " +
+ "te.entry_date, SUM(te.hours) " +
+ "FROM timesheet_entries te " +
+ "JOIN timesheets ts ON te.timesheet_id = ts.id " +
+ "LEFT JOIN projects p ON te.epc_project_id = p.id " +
+ "WHERE ts.status = 'APPROVED' ");
+
+ if (filter.projectId() != null) {
+ sql.append("AND te.epc_project_id = :projectId ");
+ }
+ if (filter.from() != null) {
+ sql.append("AND te.entry_date >= :fromDate ");
+ }
+ if (filter.to() != null) {
+ sql.append("AND te.entry_date <= :toDate ");
+ }
+ sql.append("GROUP BY te.epc_project_id, p.project_code, p.name, te.entry_date ");
+ sql.append("ORDER BY te.entry_date");
+
+ Query query = em.createNativeQuery(sql.toString());
+ if (filter.projectId() != null) query.setParameter("projectId", filter.projectId());
+ if (filter.from() != null) query.setParameter("fromDate", filter.from());
+ if (filter.to() != null) query.setParameter("toDate", filter.to());
+
+ @SuppressWarnings("unchecked")
+ List results = query.getResultList();
+
+ List rows = new ArrayList<>();
+ BigDecimal totalHours = BigDecimal.ZERO;
+
+ for (Object[] row : results) {
+ BigDecimal hours = row[5] != null ? new BigDecimal(row[5].toString()) : BigDecimal.ZERO;
+ rows.add(new ProjectHoursReport.ProjectHoursRow(
+ row[0] != null ? ((Number) row[0]).longValue() : null,
+ row[1] != null ? row[1].toString() : null,
+ row[2] != null ? row[2].toString() : null,
+ row[3] != null ? row[3].toString() : null,
+ row[4] != null ? java.time.LocalDate.parse(row[4].toString()) : null,
+ hours
+ ));
+ totalHours = totalHours.add(hours);
+ }
+
+ return new ProjectHoursReport(filter, rows, totalHours, LocalDateTime.now());
+ }
+
+ public WbsHoursReport getWbsHoursReport(ReportFilter filter) {
+ StringBuilder sql = new StringBuilder(
+ "SELECT cw.wbs_code, cw.name, cw.level, cw.discipline, " +
+ "SUM(te.hours), COUNT(DISTINCT ts.user_id) " +
+ "FROM timesheet_entries te " +
+ "JOIN timesheets ts ON te.timesheet_id = ts.id " +
+ "JOIN canonical_wbs cw ON te.canonical_wbs_id = cw.id " +
+ "WHERE ts.status = 'APPROVED' ");
+
+ if (filter.projectId() != null) {
+ sql.append("AND cw.project_id = :projectId ");
+ }
+ if (filter.wbsLevel() != null) {
+ sql.append("AND cw.level = :wbsLevel ");
+ }
+ if (filter.from() != null) {
+ sql.append("AND te.entry_date >= :fromDate ");
+ }
+ if (filter.to() != null) {
+ sql.append("AND te.entry_date <= :toDate ");
+ }
+ sql.append("GROUP BY cw.wbs_code, cw.name, cw.level, cw.discipline ");
+ sql.append("ORDER BY cw.wbs_code");
+
+ Query query = em.createNativeQuery(sql.toString());
+ if (filter.projectId() != null) query.setParameter("projectId", filter.projectId());
+ if (filter.wbsLevel() != null) query.setParameter("wbsLevel", filter.wbsLevel());
+ if (filter.from() != null) query.setParameter("fromDate", filter.from());
+ if (filter.to() != null) query.setParameter("toDate", filter.to());
+
+ @SuppressWarnings("unchecked")
+ List results = query.getResultList();
+
+ List rows = new ArrayList<>();
+ for (Object[] row : results) {
+ rows.add(new WbsHoursReport.WbsHoursRow(
+ row[0] != null ? row[0].toString() : null,
+ row[1] != null ? row[1].toString() : null,
+ row[2] != null ? ((Number) row[2]).intValue() : 0,
+ row[3] != null ? row[3].toString() : null,
+ row[4] != null ? new BigDecimal(row[4].toString()) : BigDecimal.ZERO,
+ row[5] != null ? ((Number) row[5]).longValue() : 0
+ ));
+ }
+
+ return new WbsHoursReport(filter, rows, LocalDateTime.now());
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/dto/TealEntryDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/dto/TealEntryDto.java
new file mode 100644
index 0000000..fa08472
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/dto/TealEntryDto.java
@@ -0,0 +1,32 @@
+package kr.co.accura.wtm.domain.teal.dto;
+
+import kr.co.accura.wtm.domain.teal.entity.TealEntry;
+import lombok.*;
+
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TealEntryDto {
+
+ private Long id;
+ private String wbsCode;
+ private Long canonicalWbsId;
+ private String activityCode;
+ private String activityName;
+ private String discipline;
+ private Boolean isActive;
+
+ public static TealEntryDto from(TealEntry entry) {
+ return TealEntryDto.builder()
+ .id(entry.getId())
+ .wbsCode(entry.getCanonicalWbs() != null ? entry.getCanonicalWbs().getWbsCode() : null)
+ .canonicalWbsId(entry.getCanonicalWbs() != null ? entry.getCanonicalWbs().getId() : null)
+ .activityCode(entry.getActivityCode())
+ .activityName(entry.getActivityName())
+ .discipline(entry.getDiscipline())
+ .isActive(entry.getIsActive())
+ .build();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/dto/TealVersionDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/dto/TealVersionDto.java
new file mode 100644
index 0000000..4993d29
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/dto/TealVersionDto.java
@@ -0,0 +1,32 @@
+package kr.co.accura.wtm.domain.teal.dto;
+
+import kr.co.accura.wtm.domain.teal.entity.TealVersion;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+public record TealVersionDto(
+ Long id,
+ Long projectId,
+ Integer versionNumber,
+ LocalDate effectiveDate,
+ String description,
+ String status,
+ Long uploadedBy,
+ LocalDateTime createdAt,
+ int entryCount
+) {
+ public static TealVersionDto from(TealVersion version, int entryCount) {
+ return new TealVersionDto(
+ version.getId(),
+ version.getProjectId(),
+ version.getVersionNumber(),
+ version.getEffectiveDate(),
+ version.getDescription(),
+ version.getStatus(),
+ version.getUploadedBy(),
+ version.getCreatedAt(),
+ entryCount
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/entity/TealEntry.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/entity/TealEntry.java
new file mode 100644
index 0000000..701aca1
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/entity/TealEntry.java
@@ -0,0 +1,40 @@
+package kr.co.accura.wtm.domain.teal.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wtm.domain.wbs.entity.CanonicalWbs;
+import lombok.*;
+
+@Entity
+@Table(name = "teal_entries")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TealEntry {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "teal_version_id", nullable = false)
+ private TealVersion tealVersion;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "canonical_wbs_id")
+ private CanonicalWbs canonicalWbs;
+
+ @Column(name = "activity_code", nullable = false, length = 100)
+ private String activityCode;
+
+ @Column(name = "activity_name", length = 500)
+ private String activityName;
+
+ @Column(length = 50)
+ private String discipline;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/entity/TealVersion.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/entity/TealVersion.java
new file mode 100644
index 0000000..569c5ec
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/entity/TealVersion.java
@@ -0,0 +1,64 @@
+package kr.co.accura.wtm.domain.teal.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wtm.domain.project.entity.Project;
+import lombok.*;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "teal_versions",
+ uniqueConstraints = @UniqueConstraint(columnNames = {"project_id", "version_number"}))
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TealVersion {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "project_id", nullable = false)
+ private Project project;
+
+ @Column(name = "version_number", nullable = false)
+ private Integer versionNumber;
+
+ @Column(name = "effective_date", nullable = false)
+ private LocalDate effectiveDate;
+
+ @Column(length = 500)
+ private String description;
+
+ @Column(length = 20)
+ @Builder.Default
+ private String status = "DRAFT";
+
+ @Column(name = "uploaded_by")
+ private Long uploadedBy;
+
+ @Column(name = "created_at")
+ @Builder.Default
+ private LocalDateTime createdAt = LocalDateTime.now();
+
+ public void activate() {
+ this.status = "ACTIVE";
+ }
+
+ public Long getProjectId() {
+ return project != null ? project.getId() : null;
+ }
+
+ public static TealVersion create(Project project, LocalDate effectiveDate, int versionNumber) {
+ return TealVersion.builder()
+ .project(project)
+ .versionNumber(versionNumber)
+ .effectiveDate(effectiveDate)
+ .status("DRAFT")
+ .build();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/repository/TealEntryRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/repository/TealEntryRepository.java
new file mode 100644
index 0000000..c320053
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/repository/TealEntryRepository.java
@@ -0,0 +1,17 @@
+package kr.co.accura.wtm.domain.teal.repository;
+
+import kr.co.accura.wtm.domain.teal.entity.TealEntry;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface TealEntryRepository extends JpaRepository {
+
+ List findByTealVersion_Id(Long tealVersionId);
+
+ List findByTealVersion_IdAndIsActiveTrue(Long tealVersionId);
+
+ List findByCanonicalWbs_Id(Long canonicalWbsId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/repository/TealVersionRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/repository/TealVersionRepository.java
new file mode 100644
index 0000000..e4df2eb
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/repository/TealVersionRepository.java
@@ -0,0 +1,21 @@
+package kr.co.accura.wtm.domain.teal.repository;
+
+import kr.co.accura.wtm.domain.teal.entity.TealVersion;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface TealVersionRepository extends JpaRepository {
+
+ List findByProject_IdOrderByVersionNumberDesc(Long projectId);
+
+ @Query("SELECT MAX(v.versionNumber) FROM TealVersion v WHERE v.project.id = :projectId")
+ Optional findMaxVersionByProjectId(@Param("projectId") Long projectId);
+
+ Optional findByProject_IdAndStatus(Long projectId, String status);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/service/TealService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/service/TealService.java
new file mode 100644
index 0000000..96864c6
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/teal/service/TealService.java
@@ -0,0 +1,94 @@
+package kr.co.accura.wtm.domain.teal.service;
+
+import kr.co.accura.wbx.spring.common.BusinessException;
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.project.entity.Project;
+import kr.co.accura.wtm.domain.project.repository.ProjectRepository;
+import kr.co.accura.wtm.domain.teal.dto.TealEntryDto;
+import kr.co.accura.wtm.domain.teal.dto.TealVersionDto;
+import kr.co.accura.wtm.domain.teal.entity.TealEntry;
+import kr.co.accura.wtm.domain.teal.entity.TealVersion;
+import kr.co.accura.wtm.domain.teal.repository.TealEntryRepository;
+import kr.co.accura.wtm.domain.teal.repository.TealVersionRepository;
+import kr.co.accura.wtm.domain.wbs.repository.CanonicalWbsRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class TealService {
+
+ private final TealVersionRepository tealVersionRepository;
+ private final TealEntryRepository tealEntryRepository;
+ private final CanonicalWbsRepository canonicalWbsRepository;
+ private final ProjectRepository projectRepository;
+
+ /**
+ * Upload TEAL file - Activity list linked to Canonical WBS.
+ */
+ public TealVersionDto uploadTeal(Long projectId, MultipartFile file,
+ LocalDate effectiveDate, String description) {
+ Project project = projectRepository.findById(projectId)
+ .orElseThrow(() -> new NotFoundException("Project not found: " + projectId));
+
+ // TODO: Parse TEAL file (WBS Code | Activity Code | Activity Name | Discipline)
+ // For now, create an empty version as a stub
+
+ int nextVersion = tealVersionRepository
+ .findMaxVersionByProjectId(projectId)
+ .map(v -> v + 1).orElse(1);
+
+ TealVersion version = TealVersion.builder()
+ .project(project)
+ .versionNumber(nextVersion)
+ .effectiveDate(effectiveDate)
+ .description(description)
+ .status("DRAFT")
+ .build();
+ tealVersionRepository.save(version);
+
+ return TealVersionDto.from(version, 0);
+ }
+
+ /**
+ * Get TEAL versions for a project.
+ */
+ @Transactional(readOnly = true)
+ public List getVersions(Long projectId) {
+ return tealVersionRepository.findByProject_IdOrderByVersionNumberDesc(projectId).stream()
+ .map(v -> {
+ int count = tealEntryRepository.findByTealVersion_Id(v.getId()).size();
+ return TealVersionDto.from(v, count);
+ })
+ .toList();
+ }
+
+ /**
+ * Get active TEAL entries for timesheet input.
+ */
+ @Transactional(readOnly = true)
+ public List getActiveTealEntries(Long projectId) {
+ TealVersion activeVersion = tealVersionRepository.findByProject_IdAndStatus(projectId, "ACTIVE")
+ .orElseThrow(() -> new NotFoundException("No active TEAL version found for project: " + projectId));
+
+ return tealEntryRepository.findByTealVersion_IdAndIsActiveTrue(activeVersion.getId()).stream()
+ .map(TealEntryDto::from)
+ .toList();
+ }
+
+ /**
+ * Get TEAL entries by canonical WBS ID.
+ */
+ @Transactional(readOnly = true)
+ public List getEntriesByWbs(Long projectId, Long wbsId) {
+ return tealEntryRepository.findByCanonicalWbs_Id(wbsId).stream()
+ .map(TealEntryDto::from)
+ .toList();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/NonProjectCategory.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/NonProjectCategory.java
new file mode 100644
index 0000000..2245d6d
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/NonProjectCategory.java
@@ -0,0 +1,17 @@
+package kr.co.accura.wtm.domain.timesheet;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum NonProjectCategory {
+ ANNUAL_LEAVE("연차"),
+ SICK_LEAVE("병가"),
+ TRAINING("교육"),
+ ADMIN("행정"),
+ PUBLIC_HOLIDAY("공휴일"),
+ OTHER("기타");
+
+ private final String displayName;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/TimesheetEntryType.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/TimesheetEntryType.java
new file mode 100644
index 0000000..e64df8e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/TimesheetEntryType.java
@@ -0,0 +1,7 @@
+package kr.co.accura.wtm.domain.timesheet;
+
+public enum TimesheetEntryType {
+ NON_PROJECT,
+ OTHER_PROJECT,
+ EPC
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/TimesheetStatus.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/TimesheetStatus.java
new file mode 100644
index 0000000..6a34602
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/TimesheetStatus.java
@@ -0,0 +1,9 @@
+package kr.co.accura.wtm.domain.timesheet;
+
+public enum TimesheetStatus {
+ DRAFT,
+ SUBMITTED,
+ DL_APPROVED,
+ APPROVED,
+ REJECTED
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetDto.java
new file mode 100644
index 0000000..6d8fb6a
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetDto.java
@@ -0,0 +1,17 @@
+package kr.co.accura.wtm.domain.timesheet.dto;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+public record TimesheetDto(
+ Long id,
+ Long userId,
+ LocalDate weekStartDate,
+ LocalDate weekEndDate,
+ String status,
+ BigDecimal totalHours,
+ LocalDateTime submittedAt,
+ List entries
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetEntryDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetEntryDto.java
new file mode 100644
index 0000000..154aff5
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetEntryDto.java
@@ -0,0 +1,19 @@
+package kr.co.accura.wtm.domain.timesheet.dto;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+public record TimesheetEntryDto(
+ Long id,
+ String entryType,
+ LocalDate entryDate,
+ BigDecimal hours,
+ String npCategory,
+ Long otherProjectId,
+ String otherCategory,
+ Long epcProjectId,
+ Long canonicalWbsId,
+ Long tealEntryId,
+ Integer revisionNumber,
+ String remark
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetEntryRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetEntryRequest.java
new file mode 100644
index 0000000..86cf9f7
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/TimesheetEntryRequest.java
@@ -0,0 +1,22 @@
+package kr.co.accura.wtm.domain.timesheet.dto;
+
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.PositiveOrZero;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+public record TimesheetEntryRequest(
+ Long id,
+ @NotNull String entryType,
+ @NotNull LocalDate entryDate,
+ @NotNull @PositiveOrZero BigDecimal hours,
+ String npCategory,
+ Long otherProjectId,
+ String otherCategory,
+ Long epcProjectId,
+ Long canonicalWbsId,
+ Long tealEntryId,
+ Integer revisionNumber,
+ String remark
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/UploadResultDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/UploadResultDto.java
new file mode 100644
index 0000000..d511d44
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/dto/UploadResultDto.java
@@ -0,0 +1,10 @@
+package kr.co.accura.wtm.domain.timesheet.dto;
+
+public record UploadResultDto(
+ Long uploadId,
+ int totalRows,
+ int successRows,
+ int errorRows,
+ String status,
+ String errorLog
+) {}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/Timesheet.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/Timesheet.java
new file mode 100644
index 0000000..d52fdbc
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/Timesheet.java
@@ -0,0 +1,75 @@
+package kr.co.accura.wtm.domain.timesheet.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import kr.co.accura.wbx.spring.common.BusinessException;
+import kr.co.accura.wtm.domain.timesheet.TimesheetStatus;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "timesheets", uniqueConstraints = {
+ @UniqueConstraint(columnNames = {"user_id", "week_start_date"})
+})
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Timesheet extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "user_id", nullable = false)
+ private Long userId;
+
+ @Column(name = "week_start_date", nullable = false)
+ private LocalDate weekStartDate;
+
+ @Column(name = "week_end_date", nullable = false)
+ private LocalDate weekEndDate;
+
+ @Enumerated(EnumType.STRING)
+ @Column(length = 20)
+ @Builder.Default
+ private TimesheetStatus status = TimesheetStatus.DRAFT;
+
+ @Column(name = "total_hours", precision = 10, scale = 2)
+ @Builder.Default
+ private BigDecimal totalHours = BigDecimal.ZERO;
+
+ @Column(name = "submitted_at")
+ private LocalDateTime submittedAt;
+
+ @OneToMany(mappedBy = "timesheet", cascade = CascadeType.ALL, orphanRemoval = true)
+ @Builder.Default
+ private List entries = new ArrayList<>();
+
+ // Business methods
+
+ public void addEntry(TimesheetEntry entry) {
+ entries.add(entry);
+ entry.setTimesheet(this);
+ recalculateTotal();
+ }
+
+ public void submit() {
+ if (status != TimesheetStatus.DRAFT && status != TimesheetStatus.REJECTED) {
+ throw new BusinessException("DRAFT 또는 REJECTED 상태에서만 제출 가능합니다.");
+ }
+ this.status = TimesheetStatus.SUBMITTED;
+ this.submittedAt = LocalDateTime.now();
+ }
+
+ public void recalculateTotal() {
+ this.totalHours = entries.stream()
+ .map(TimesheetEntry::getHours)
+ .reduce(BigDecimal.ZERO, BigDecimal::add);
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/TimesheetEntry.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/TimesheetEntry.java
new file mode 100644
index 0000000..968976b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/TimesheetEntry.java
@@ -0,0 +1,66 @@
+package kr.co.accura.wtm.domain.timesheet.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import kr.co.accura.wtm.domain.timesheet.NonProjectCategory;
+import kr.co.accura.wtm.domain.timesheet.TimesheetEntryType;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Entity
+@Table(name = "timesheet_entries")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TimesheetEntry extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "timesheet_id", nullable = false)
+ private Timesheet timesheet;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "entry_type", nullable = false, length = 20)
+ private TimesheetEntryType entryType;
+
+ @Column(name = "entry_date", nullable = false)
+ private LocalDate entryDate;
+
+ @Column(nullable = false, precision = 5, scale = 2)
+ @Builder.Default
+ private BigDecimal hours = BigDecimal.ZERO;
+
+ // Non-Project fields
+ @Column(name = "np_category", length = 100)
+ private String npCategory;
+
+ // Other Project fields
+ @Column(name = "other_project_id")
+ private Long otherProjectId;
+
+ @Column(name = "other_category", length = 100)
+ private String otherCategory;
+
+ // EPC Project fields
+ @Column(name = "epc_project_id")
+ private Long epcProjectId;
+
+ @Column(name = "canonical_wbs_id")
+ private Long canonicalWbsId;
+
+ @Column(name = "teal_entry_id")
+ private Long tealEntryId;
+
+ @Column(name = "revision_number")
+ @Builder.Default
+ private Integer revisionNumber = 1;
+
+ @Column(length = 500)
+ private String remark;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/TimesheetUpload.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/TimesheetUpload.java
new file mode 100644
index 0000000..41de1e0
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/entity/TimesheetUpload.java
@@ -0,0 +1,42 @@
+package kr.co.accura.wtm.domain.timesheet.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import lombok.*;
+
+@Entity
+@Table(name = "timesheet_uploads")
+@Getter @Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class TimesheetUpload extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "user_id", nullable = false)
+ private Long userId;
+
+ @Column(length = 500)
+ private String filename;
+
+ @Column(name = "file_path", length = 1000)
+ private String filePath;
+
+ @Column(name = "total_rows")
+ private Integer totalRows;
+
+ @Column(name = "success_rows")
+ private Integer successRows;
+
+ @Column(name = "error_rows")
+ private Integer errorRows;
+
+ @Column(name = "error_log", columnDefinition = "TEXT")
+ private String errorLog;
+
+ @Column(length = 20)
+ private String status;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetEntryRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetEntryRepository.java
new file mode 100644
index 0000000..26f63ba
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetEntryRepository.java
@@ -0,0 +1,11 @@
+package kr.co.accura.wtm.domain.timesheet.repository;
+
+import kr.co.accura.wtm.domain.timesheet.entity.TimesheetEntry;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface TimesheetEntryRepository extends JpaRepository {
+
+ List findByTimesheet_Id(Long timesheetId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetRepository.java
new file mode 100644
index 0000000..2eda242
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetRepository.java
@@ -0,0 +1,28 @@
+package kr.co.accura.wtm.domain.timesheet.repository;
+
+import kr.co.accura.wtm.domain.timesheet.entity.Timesheet;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.time.LocalDate;
+import java.util.Optional;
+
+public interface TimesheetRepository extends JpaRepository {
+
+ Optional findByUserIdAndWeekStartDate(Long userId, LocalDate weekStartDate);
+
+ Page findByUserId(Long userId, Pageable pageable);
+
+ @Query("SELECT t FROM Timesheet t WHERE t.userId = :userId " +
+ "AND (:from IS NULL OR t.weekStartDate >= :from) " +
+ "AND (:to IS NULL OR t.weekStartDate <= :to) " +
+ "ORDER BY t.weekStartDate DESC")
+ Page findByUserIdAndDateRange(
+ @Param("userId") Long userId,
+ @Param("from") LocalDate from,
+ @Param("to") LocalDate to,
+ Pageable pageable);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetUploadRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetUploadRepository.java
new file mode 100644
index 0000000..e4a1e61
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/repository/TimesheetUploadRepository.java
@@ -0,0 +1,7 @@
+package kr.co.accura.wtm.domain.timesheet.repository;
+
+import kr.co.accura.wtm.domain.timesheet.entity.TimesheetUpload;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface TimesheetUploadRepository extends JpaRepository {
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/rule/TimesheetRuleEngine.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/rule/TimesheetRuleEngine.java
new file mode 100644
index 0000000..6480735
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/rule/TimesheetRuleEngine.java
@@ -0,0 +1,73 @@
+package kr.co.accura.wtm.domain.timesheet.rule;
+
+import kr.co.accura.wtm.domain.timesheet.TimesheetEntryType;
+import kr.co.accura.wtm.domain.timesheet.entity.Timesheet;
+import kr.co.accura.wtm.domain.timesheet.entity.TimesheetEntry;
+import org.springframework.stereotype.Component;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+@Component
+public class TimesheetRuleEngine {
+
+ private static final BigDecimal MAX_DAILY_HOURS = new BigDecimal("8");
+ private static final BigDecimal MAX_WEEKLY_HOURS = new BigDecimal("52");
+ private static final BigDecimal WARN_DAILY_HOURS = new BigDecimal("10");
+ private static final BigDecimal HARD_DAILY_LIMIT = new BigDecimal("24");
+
+ /**
+ * Validate timesheet entries against business rules.
+ */
+ public ValidationResult validate(Timesheet timesheet) {
+ var result = new ValidationResult();
+
+ // 1. Daily hour limits
+ Map dailyTotals = timesheet.getEntries().stream()
+ .collect(Collectors.groupingBy(
+ TimesheetEntry::getEntryDate,
+ Collectors.reducing(BigDecimal.ZERO, TimesheetEntry::getHours, BigDecimal::add)
+ ));
+
+ for (var entry : dailyTotals.entrySet()) {
+ LocalDate date = entry.getKey();
+ BigDecimal total = entry.getValue();
+
+ if (total.compareTo(HARD_DAILY_LIMIT) > 0) {
+ result.addError(date, "일 최대 24시간을 초과할 수 없습니다.");
+ } else if (total.compareTo(WARN_DAILY_HOURS) > 0) {
+ result.addWarning(date,
+ String.format("일 %s시간 입력 — 기준(%sh) 초과", total, MAX_DAILY_HOURS));
+ }
+ }
+
+ // 2. Weekly total limit (52h)
+ if (timesheet.getTotalHours().compareTo(MAX_WEEKLY_HOURS) > 0) {
+ result.addError(null,
+ String.format("주간 합계 %s시간 — 최대 %sh 초과",
+ timesheet.getTotalHours(), MAX_WEEKLY_HOURS));
+ }
+
+ // 3. EPC entries require project and WBS
+ timesheet.getEntries().stream()
+ .filter(e -> e.getEntryType() == TimesheetEntryType.EPC)
+ .forEach(e -> {
+ if (e.getEpcProjectId() == null) {
+ result.addError(e.getEntryDate(), "EPC 시수 — 프로젝트 필수");
+ }
+ if (e.getCanonicalWbsId() == null) {
+ result.addError(e.getEntryDate(), "EPC 시수 — WBS 선택 필수");
+ }
+ });
+
+ // 4. No future dates
+ LocalDate today = LocalDate.now();
+ timesheet.getEntries().stream()
+ .filter(e -> e.getEntryDate().isAfter(today))
+ .forEach(e -> result.addError(e.getEntryDate(), "미래 날짜에 시수를 입력할 수 없습니다."));
+
+ return result;
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/rule/ValidationResult.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/rule/ValidationResult.java
new file mode 100644
index 0000000..125f4b5
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/rule/ValidationResult.java
@@ -0,0 +1,32 @@
+package kr.co.accura.wtm.domain.timesheet.rule;
+
+import lombok.Getter;
+
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+
+@Getter
+public class ValidationResult {
+
+ private final List errors = new ArrayList<>();
+ private final List warnings = new ArrayList<>();
+
+ public void addError(LocalDate date, String message) {
+ errors.add(new ValidationMessage(date, message));
+ }
+
+ public void addWarning(LocalDate date, String message) {
+ warnings.add(new ValidationMessage(date, message));
+ }
+
+ public boolean hasErrors() {
+ return !errors.isEmpty();
+ }
+
+ public boolean hasWarnings() {
+ return !warnings.isEmpty();
+ }
+
+ public record ValidationMessage(LocalDate date, String message) {}
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/service/TimesheetService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/service/TimesheetService.java
new file mode 100644
index 0000000..891ea16
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/timesheet/service/TimesheetService.java
@@ -0,0 +1,209 @@
+package kr.co.accura.wtm.domain.timesheet.service;
+
+import kr.co.accura.wbx.spring.common.BusinessException;
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.timesheet.TimesheetEntryType;
+import kr.co.accura.wtm.domain.timesheet.TimesheetStatus;
+import kr.co.accura.wtm.domain.timesheet.dto.*;
+import kr.co.accura.wtm.domain.timesheet.entity.Timesheet;
+import kr.co.accura.wtm.domain.timesheet.entity.TimesheetEntry;
+import kr.co.accura.wtm.domain.timesheet.entity.TimesheetUpload;
+import kr.co.accura.wtm.domain.timesheet.repository.TimesheetEntryRepository;
+import kr.co.accura.wtm.domain.timesheet.repository.TimesheetRepository;
+import kr.co.accura.wtm.domain.timesheet.repository.TimesheetUploadRepository;
+import kr.co.accura.wtm.domain.timesheet.rule.TimesheetRuleEngine;
+import kr.co.accura.wtm.domain.timesheet.rule.ValidationResult;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class TimesheetService {
+
+ private final TimesheetRepository timesheetRepository;
+ private final TimesheetEntryRepository timesheetEntryRepository;
+ private final TimesheetUploadRepository timesheetUploadRepository;
+ private final TimesheetRuleEngine ruleEngine;
+
+ public TimesheetDto getOrCreateWeekly(Long userId, LocalDate weekStart) {
+ LocalDate weekEnd = weekStart.plusDays(6);
+ Timesheet ts = timesheetRepository.findByUserIdAndWeekStartDate(userId, weekStart)
+ .orElseGet(() -> {
+ Timesheet newTs = Timesheet.builder()
+ .userId(userId)
+ .weekStartDate(weekStart)
+ .weekEndDate(weekEnd)
+ .build();
+ return timesheetRepository.save(newTs);
+ });
+ return toDto(ts);
+ }
+
+ public TimesheetEntryDto saveEntry(Long timesheetId, TimesheetEntryRequest request) {
+ Timesheet ts = findTimesheet(timesheetId);
+ ensureEditable(ts);
+
+ TimesheetEntry entry;
+ if (request.id() != null) {
+ entry = timesheetEntryRepository.findById(request.id())
+ .orElseThrow(() -> new NotFoundException("시수 항목을 찾을 수 없습니다."));
+ updateEntry(entry, request);
+ } else {
+ entry = createEntry(ts, request);
+ ts.addEntry(entry);
+ }
+
+ timesheetEntryRepository.save(entry);
+ ts.recalculateTotal();
+ timesheetRepository.save(ts);
+
+ return toEntryDto(entry);
+ }
+
+ public TimesheetDto saveBatch(Long timesheetId, List requests) {
+ Timesheet ts = findTimesheet(timesheetId);
+ ensureEditable(ts);
+
+ // Clear existing entries and replace
+ ts.getEntries().clear();
+ for (TimesheetEntryRequest request : requests) {
+ TimesheetEntry entry = createEntry(ts, request);
+ ts.addEntry(entry);
+ }
+
+ ts.recalculateTotal();
+ timesheetRepository.save(ts);
+ return toDto(ts);
+ }
+
+ public TimesheetDto submit(Long timesheetId) {
+ Timesheet ts = findTimesheet(timesheetId);
+
+ // Validate before submission
+ ValidationResult validation = ruleEngine.validate(ts);
+ if (validation.hasErrors()) {
+ String errorMsg = validation.getErrors().stream()
+ .map(e -> e.message())
+ .reduce((a, b) -> a + "; " + b)
+ .orElse("검증 오류");
+ throw new BusinessException(errorMsg);
+ }
+
+ ts.submit();
+ timesheetRepository.save(ts);
+ return toDto(ts);
+ }
+
+ @Transactional(readOnly = true)
+ public Page getHistory(Long userId, LocalDate from, LocalDate to, Pageable pageable) {
+ return timesheetRepository.findByUserIdAndDateRange(userId, from, to, pageable)
+ .map(this::toDto);
+ }
+
+ public UploadResultDto uploadExcel(Long userId, MultipartFile file, LocalDate weekStart) {
+ TimesheetUpload upload = TimesheetUpload.builder()
+ .userId(userId)
+ .filename(file.getOriginalFilename())
+ .status("PROCESSING")
+ .totalRows(0)
+ .successRows(0)
+ .errorRows(0)
+ .build();
+ upload = timesheetUploadRepository.save(upload);
+
+ // TODO: Implement Excel parsing with Apache POI
+ upload.setStatus("COMPLETED");
+ timesheetUploadRepository.save(upload);
+
+ return new UploadResultDto(
+ upload.getId(),
+ upload.getTotalRows() != null ? upload.getTotalRows() : 0,
+ upload.getSuccessRows() != null ? upload.getSuccessRows() : 0,
+ upload.getErrorRows() != null ? upload.getErrorRows() : 0,
+ upload.getStatus(),
+ upload.getErrorLog()
+ );
+ }
+
+ public void deleteEntry(Long timesheetId, Long entryId) {
+ Timesheet ts = findTimesheet(timesheetId);
+ ensureEditable(ts);
+ ts.getEntries().removeIf(e -> e.getId().equals(entryId));
+ ts.recalculateTotal();
+ timesheetRepository.save(ts);
+ }
+
+ // --- Helper methods ---
+
+ private Timesheet findTimesheet(Long id) {
+ return timesheetRepository.findById(id)
+ .orElseThrow(() -> new NotFoundException("Timesheet not found: " + id));
+ }
+
+ private void ensureEditable(Timesheet ts) {
+ if (ts.getStatus() != TimesheetStatus.DRAFT && ts.getStatus() != TimesheetStatus.REJECTED) {
+ throw new BusinessException("수정 가능한 상태가 아닙니다 (현재: " + ts.getStatus() + ")");
+ }
+ }
+
+ private TimesheetEntry createEntry(Timesheet ts, TimesheetEntryRequest req) {
+ return TimesheetEntry.builder()
+ .timesheet(ts)
+ .entryType(TimesheetEntryType.valueOf(req.entryType()))
+ .entryDate(req.entryDate())
+ .hours(req.hours())
+ .npCategory(req.npCategory())
+ .otherProjectId(req.otherProjectId())
+ .otherCategory(req.otherCategory())
+ .epcProjectId(req.epcProjectId())
+ .canonicalWbsId(req.canonicalWbsId())
+ .tealEntryId(req.tealEntryId())
+ .revisionNumber(req.revisionNumber() != null ? req.revisionNumber() : 1)
+ .remark(req.remark())
+ .build();
+ }
+
+ private void updateEntry(TimesheetEntry entry, TimesheetEntryRequest req) {
+ entry.setEntryType(TimesheetEntryType.valueOf(req.entryType()));
+ entry.setEntryDate(req.entryDate());
+ entry.setHours(req.hours());
+ entry.setNpCategory(req.npCategory());
+ entry.setOtherProjectId(req.otherProjectId());
+ entry.setOtherCategory(req.otherCategory());
+ entry.setEpcProjectId(req.epcProjectId());
+ entry.setCanonicalWbsId(req.canonicalWbsId());
+ entry.setTealEntryId(req.tealEntryId());
+ entry.setRevisionNumber(req.revisionNumber() != null ? req.revisionNumber() : 1);
+ entry.setRemark(req.remark());
+ }
+
+ private TimesheetDto toDto(Timesheet ts) {
+ List entryDtos = ts.getEntries().stream()
+ .map(this::toEntryDto)
+ .toList();
+ return new TimesheetDto(
+ ts.getId(), ts.getUserId(),
+ ts.getWeekStartDate(), ts.getWeekEndDate(),
+ ts.getStatus().name(), ts.getTotalHours(),
+ ts.getSubmittedAt(), entryDtos
+ );
+ }
+
+ private TimesheetEntryDto toEntryDto(TimesheetEntry e) {
+ return new TimesheetEntryDto(
+ e.getId(), e.getEntryType().name(), e.getEntryDate(),
+ e.getHours(), e.getNpCategory(),
+ e.getOtherProjectId(), e.getOtherCategory(),
+ e.getEpcProjectId(), e.getCanonicalWbsId(),
+ e.getTealEntryId(), e.getRevisionNumber(), e.getRemark()
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/EmploymentType.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/EmploymentType.java
new file mode 100644
index 0000000..2054bd7
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/EmploymentType.java
@@ -0,0 +1,6 @@
+package kr.co.accura.wtm.domain.user;
+
+public enum EmploymentType {
+ INTERNAL,
+ SUBCONTRACTOR
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/RoleAssignRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/RoleAssignRequest.java
new file mode 100644
index 0000000..c67d9b4
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/RoleAssignRequest.java
@@ -0,0 +1,13 @@
+package kr.co.accura.wtm.domain.user.dto;
+
+import java.util.List;
+
+public record RoleAssignRequest(
+ List roles
+) {
+ public record RoleEntry(
+ String roleCode,
+ Long projectId
+ ) {
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserCreateRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserCreateRequest.java
new file mode 100644
index 0000000..986989b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserCreateRequest.java
@@ -0,0 +1,17 @@
+package kr.co.accura.wtm.domain.user.dto;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+
+public record UserCreateRequest(
+ @NotBlank String employeeId,
+ @NotBlank @Email String email,
+ @NotBlank String username,
+ String fullName,
+ String department,
+ String discipline,
+ String positionTitle,
+ String location,
+ String employmentType
+) {
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserDto.java
new file mode 100644
index 0000000..02c8706
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserDto.java
@@ -0,0 +1,40 @@
+package kr.co.accura.wtm.domain.user.dto;
+
+import kr.co.accura.wtm.domain.user.entity.User;
+
+import java.util.List;
+
+public record UserDto(
+ Long id,
+ String employeeId,
+ String email,
+ String username,
+ String fullName,
+ String department,
+ String discipline,
+ String positionTitle,
+ String location,
+ String employmentType,
+ Boolean isActive,
+ List roles
+) {
+ public static UserDto from(User user) {
+ List roleNames = user.getUserRoles().stream()
+ .map(ur -> ur.getRole().getCode())
+ .toList();
+ return new UserDto(
+ user.getId(),
+ user.getEmployeeId(),
+ user.getEmail(),
+ user.getUsername(),
+ user.getFullName(),
+ user.getDepartment(),
+ user.getDiscipline(),
+ user.getPositionTitle(),
+ user.getLocation(),
+ user.getEmploymentType() != null ? user.getEmploymentType().name() : null,
+ user.getIsActive(),
+ roleNames
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserUpdateRequest.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserUpdateRequest.java
new file mode 100644
index 0000000..8cb5588
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/dto/UserUpdateRequest.java
@@ -0,0 +1,13 @@
+package kr.co.accura.wtm.domain.user.dto;
+
+public record UserUpdateRequest(
+ String username,
+ String fullName,
+ String department,
+ String discipline,
+ String positionTitle,
+ String location,
+ String employmentType,
+ Boolean isActive
+) {
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/HrUpload.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/HrUpload.java
new file mode 100644
index 0000000..9d7b816
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/HrUpload.java
@@ -0,0 +1,52 @@
+package kr.co.accura.wtm.domain.user.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "hr_uploads")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class HrUpload {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "user_id", nullable = false)
+ private User user;
+
+ @Column(length = 500)
+ private String filename;
+
+ @Column(name = "file_path", length = 1000)
+ private String filePath;
+
+ @Column(name = "total_rows")
+ private Integer totalRows;
+
+ @Column(name = "success_rows")
+ private Integer successRows;
+
+ @Column(name = "error_rows")
+ private Integer errorRows;
+
+ @Column(name = "error_log", columnDefinition = "TEXT")
+ private String errorLog;
+
+ @Column(length = 20)
+ private String status;
+
+ @Column(name = "sync_source", length = 50)
+ private String syncSource;
+
+ @Column(name = "created_at")
+ @Builder.Default
+ private LocalDateTime createdAt = LocalDateTime.now();
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/OrgHierarchy.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/OrgHierarchy.java
new file mode 100644
index 0000000..ba04128
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/OrgHierarchy.java
@@ -0,0 +1,48 @@
+package kr.co.accura.wtm.domain.user.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "org_hierarchy")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class OrgHierarchy {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(nullable = false, length = 255)
+ private String name;
+
+ @Column(length = 50)
+ private String code;
+
+ @Column(nullable = false)
+ private Integer level;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "parent_id")
+ private OrgHierarchy parent;
+
+ @Column(name = "sort_order")
+ @Builder.Default
+ private Integer sortOrder = 0;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+
+ @Column(name = "created_at")
+ @Builder.Default
+ private LocalDateTime createdAt = LocalDateTime.now();
+
+ @Column(name = "updated_at")
+ private LocalDateTime updatedAt;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/Role.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/Role.java
new file mode 100644
index 0000000..da618bf
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/Role.java
@@ -0,0 +1,31 @@
+package kr.co.accura.wtm.domain.user.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+@Entity
+@Table(name = "roles")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Role {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(unique = true, nullable = false, length = 20)
+ private String code;
+
+ @Column(nullable = false, length = 100)
+ private String name;
+
+ @Column(length = 500)
+ private String description;
+
+ @Column
+ @Builder.Default
+ private Integer level = 0;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/User.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/User.java
new file mode 100644
index 0000000..4014f32
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/User.java
@@ -0,0 +1,97 @@
+package kr.co.accura.wtm.domain.user.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wbx.spring.common.BaseEntity;
+import kr.co.accura.wtm.domain.user.EmploymentType;
+import lombok.*;
+
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+@Entity
+@Table(name = "users")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class User extends BaseEntity {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "employee_id", unique = true, nullable = false, length = 50)
+ private String employeeId;
+
+ @Column(unique = true, nullable = false, length = 255)
+ private String email;
+
+ @Column(nullable = false, length = 100)
+ private String username;
+
+ @Column(name = "full_name", length = 255)
+ private String fullName;
+
+ @Column(name = "hashed_password", length = 255)
+ private String hashedPassword;
+
+ @Column(length = 100)
+ private String department;
+
+ @Column(length = 100)
+ private String discipline;
+
+ @Column(name = "position_title", length = 100)
+ private String positionTitle;
+
+ @Column(length = 50)
+ private String location;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "employment_type", length = 20)
+ @Builder.Default
+ private EmploymentType employmentType = EmploymentType.INTERNAL;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+
+ @Column(name = "is_locked")
+ @Builder.Default
+ private Boolean isLocked = false;
+
+ @Column(name = "failed_attempts")
+ @Builder.Default
+ private Integer failedAttempts = 0;
+
+ @Column(name = "last_login_at")
+ private LocalDateTime lastLoginAt;
+
+ @Column(name = "password_changed_at")
+ private LocalDateTime passwordChangedAt;
+
+ @Column(name = "azure_oid", length = 255)
+ private String azureOid;
+
+ @Column(name = "mfa_enabled")
+ @Builder.Default
+ private Boolean mfaEnabled = false;
+
+ @OneToMany(mappedBy = "user", fetch = FetchType.LAZY)
+ @Builder.Default
+ private List userRoles = new ArrayList<>();
+
+ public boolean hasRole(String roleCode) {
+ return userRoles.stream()
+ .anyMatch(ur -> ur.getRole().getCode().equals(roleCode));
+ }
+
+ public boolean hasProjectRole(String roleCode, Long projectId) {
+ return userRoles.stream()
+ .anyMatch(ur -> ur.getRole().getCode().equals(roleCode)
+ && Objects.equals(ur.getProjectId(), projectId));
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/UserRole.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/UserRole.java
new file mode 100644
index 0000000..366ab86
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/entity/UserRole.java
@@ -0,0 +1,39 @@
+package kr.co.accura.wtm.domain.user.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "user_roles",
+ uniqueConstraints = @UniqueConstraint(columnNames = {"user_id", "role_id", "project_id"}))
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class UserRole {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "user_id", nullable = false)
+ private User user;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "role_id", nullable = false)
+ private Role role;
+
+ @Column(name = "project_id")
+ private Long projectId;
+
+ @Column(name = "granted_at")
+ @Builder.Default
+ private LocalDateTime grantedAt = LocalDateTime.now();
+
+ @Column(name = "granted_by")
+ private Long grantedBy;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/HrUploadRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/HrUploadRepository.java
new file mode 100644
index 0000000..4d23a84
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/HrUploadRepository.java
@@ -0,0 +1,15 @@
+package kr.co.accura.wtm.domain.user.repository;
+
+import kr.co.accura.wtm.domain.user.entity.HrUpload;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface HrUploadRepository extends JpaRepository {
+
+ List findByUser_IdOrderByCreatedAtDesc(Long userId);
+
+ List findByStatus(String status);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/OrgHierarchyRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/OrgHierarchyRepository.java
new file mode 100644
index 0000000..f60fc21
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/OrgHierarchyRepository.java
@@ -0,0 +1,20 @@
+package kr.co.accura.wtm.domain.user.repository;
+
+import kr.co.accura.wtm.domain.user.entity.OrgHierarchy;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface OrgHierarchyRepository extends JpaRepository {
+
+ List findByParent_Id(Long parentId);
+
+ List findByLevel(Integer level);
+
+ List findByIsActiveTrueOrderBySortOrder();
+
+ Optional findByCode(String code);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/RoleRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/RoleRepository.java
new file mode 100644
index 0000000..43c2325
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/RoleRepository.java
@@ -0,0 +1,13 @@
+package kr.co.accura.wtm.domain.user.repository;
+
+import kr.co.accura.wtm.domain.user.entity.Role;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface RoleRepository extends JpaRepository {
+
+ Optional findByCode(String code);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/UserRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/UserRepository.java
new file mode 100644
index 0000000..27249ff
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/UserRepository.java
@@ -0,0 +1,19 @@
+package kr.co.accura.wtm.domain.user.repository;
+
+import kr.co.accura.wtm.domain.user.entity.User;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface UserRepository extends JpaRepository {
+
+ Optional findByEmail(String email);
+
+ Optional findByEmployeeId(String employeeId);
+
+ boolean existsByEmail(String email);
+
+ boolean existsByEmployeeId(String employeeId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/UserRoleRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/UserRoleRepository.java
new file mode 100644
index 0000000..ec43d8b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/repository/UserRoleRepository.java
@@ -0,0 +1,17 @@
+package kr.co.accura.wtm.domain.user.repository;
+
+import kr.co.accura.wtm.domain.user.entity.UserRole;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface UserRoleRepository extends JpaRepository {
+
+ List findByUser_Id(Long userId);
+
+ List findByUser_IdAndProjectId(Long userId, Long projectId);
+
+ void deleteByUser_IdAndProjectId(Long userId, Long projectId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/service/UserService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/service/UserService.java
new file mode 100644
index 0000000..1536150
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/user/service/UserService.java
@@ -0,0 +1,119 @@
+package kr.co.accura.wtm.domain.user.service;
+
+import kr.co.accura.wbx.spring.common.BusinessException;
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.user.EmploymentType;
+import kr.co.accura.wtm.domain.user.dto.*;
+import kr.co.accura.wtm.domain.user.entity.Role;
+import kr.co.accura.wtm.domain.user.entity.User;
+import kr.co.accura.wtm.domain.user.entity.UserRole;
+import kr.co.accura.wtm.domain.user.repository.RoleRepository;
+import kr.co.accura.wtm.domain.user.repository.UserRepository;
+import kr.co.accura.wtm.domain.user.repository.UserRoleRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class UserService {
+
+ private final UserRepository userRepository;
+ private final RoleRepository roleRepository;
+ private final UserRoleRepository userRoleRepository;
+
+ @Transactional(readOnly = true)
+ public Page findAll(Pageable pageable) {
+ return userRepository.findAll(pageable).map(UserDto::from);
+ }
+
+ @Transactional(readOnly = true)
+ public UserDto findById(Long id) {
+ User user = userRepository.findById(id)
+ .orElseThrow(() -> new NotFoundException("User not found: " + id));
+ return UserDto.from(user);
+ }
+
+ @Transactional(readOnly = true)
+ public UserDto findByEmail(String email) {
+ User user = userRepository.findByEmail(email)
+ .orElseThrow(() -> new NotFoundException("User not found: " + email));
+ return UserDto.from(user);
+ }
+
+ public UserDto create(UserCreateRequest request) {
+ if (userRepository.existsByEmail(request.email())) {
+ throw new BusinessException("Email already exists: " + request.email());
+ }
+ if (userRepository.existsByEmployeeId(request.employeeId())) {
+ throw new BusinessException("Employee ID already exists: " + request.employeeId());
+ }
+
+ User user = User.builder()
+ .employeeId(request.employeeId())
+ .email(request.email())
+ .username(request.username())
+ .fullName(request.fullName())
+ .department(request.department())
+ .discipline(request.discipline())
+ .positionTitle(request.positionTitle())
+ .location(request.location())
+ .employmentType(request.employmentType() != null
+ ? EmploymentType.valueOf(request.employmentType())
+ : EmploymentType.INTERNAL)
+ .build();
+
+ userRepository.save(user);
+ return UserDto.from(user);
+ }
+
+ public UserDto update(Long id, UserUpdateRequest request) {
+ User user = userRepository.findById(id)
+ .orElseThrow(() -> new NotFoundException("User not found: " + id));
+
+ if (request.username() != null) user.setUsername(request.username());
+ if (request.fullName() != null) user.setFullName(request.fullName());
+ if (request.department() != null) user.setDepartment(request.department());
+ if (request.discipline() != null) user.setDiscipline(request.discipline());
+ if (request.positionTitle() != null) user.setPositionTitle(request.positionTitle());
+ if (request.location() != null) user.setLocation(request.location());
+ if (request.employmentType() != null) {
+ user.setEmploymentType(EmploymentType.valueOf(request.employmentType()));
+ }
+ if (request.isActive() != null) user.setIsActive(request.isActive());
+
+ userRepository.save(user);
+ return UserDto.from(user);
+ }
+
+ public void assignRoles(Long userId, RoleAssignRequest request) {
+ User user = userRepository.findById(userId)
+ .orElseThrow(() -> new NotFoundException("User not found: " + userId));
+
+ // Remove existing roles
+ userRoleRepository.deleteByUser_IdAndProjectId(userId, null);
+
+ // Assign new roles
+ for (RoleAssignRequest.RoleEntry entry : request.roles()) {
+ Role role = roleRepository.findByCode(entry.roleCode())
+ .orElseThrow(() -> new NotFoundException("Role not found: " + entry.roleCode()));
+
+ UserRole userRole = UserRole.builder()
+ .user(user)
+ .role(role)
+ .projectId(entry.projectId())
+ .build();
+ userRoleRepository.save(userRole);
+ }
+ }
+
+ @Transactional(readOnly = true)
+ public List getUserRoles(Long userId) {
+ return userRoleRepository.findByUser_Id(userId);
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/CanonicalWbsDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/CanonicalWbsDto.java
new file mode 100644
index 0000000..e57014b
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/CanonicalWbsDto.java
@@ -0,0 +1,29 @@
+package kr.co.accura.wtm.domain.wbs.dto;
+
+import kr.co.accura.wtm.domain.wbs.entity.CanonicalWbs;
+
+public record CanonicalWbsDto(
+ Long id,
+ Long projectId,
+ String wbsCode,
+ Integer level,
+ String name,
+ String parentCode,
+ String discipline,
+ Boolean isActive,
+ String mappedP6Code
+) {
+ public static CanonicalWbsDto from(CanonicalWbs cw) {
+ return new CanonicalWbsDto(
+ cw.getId(),
+ cw.getProjectId(),
+ cw.getWbsCode(),
+ cw.getLevel(),
+ cw.getName(),
+ cw.getParentCode(),
+ cw.getDiscipline(),
+ cw.getIsActive(),
+ cw.getMappedP6Code()
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsCompareResult.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsCompareResult.java
new file mode 100644
index 0000000..43e4b08
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsCompareResult.java
@@ -0,0 +1,30 @@
+package kr.co.accura.wtm.domain.wbs.dto;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsNode;
+import lombok.Getter;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Getter
+public class WbsCompareResult {
+
+ private final List added = new ArrayList<>();
+ private final List removed = new ArrayList<>();
+ private final List modified = new ArrayList<>();
+
+ public void addAdded(WbsNode node) {
+ added.add(WbsNodeDto.from(node));
+ }
+
+ public void addRemoved(WbsNode node) {
+ removed.add(WbsNodeDto.from(node));
+ }
+
+ public void addModified(WbsNode before, WbsNode after) {
+ modified.add(new ModifiedEntry(WbsNodeDto.from(before), WbsNodeDto.from(after)));
+ }
+
+ public record ModifiedEntry(WbsNodeDto before, WbsNodeDto after) {
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsDisciplineAssignmentDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsDisciplineAssignmentDto.java
new file mode 100644
index 0000000..ef225b5
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsDisciplineAssignmentDto.java
@@ -0,0 +1,26 @@
+package kr.co.accura.wtm.domain.wbs.dto;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsDisciplineAssignment;
+import lombok.*;
+
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class WbsDisciplineAssignmentDto {
+
+ private Long id;
+ private Long canonicalWbsId;
+ private String discipline;
+ private Boolean isActive;
+
+ public static WbsDisciplineAssignmentDto from(WbsDisciplineAssignment entity) {
+ return WbsDisciplineAssignmentDto.builder()
+ .id(entity.getId())
+ .canonicalWbsId(entity.getCanonicalWbs().getId())
+ .discipline(entity.getDiscipline())
+ .isActive(entity.getIsActive())
+ .build();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsNodeDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsNodeDto.java
new file mode 100644
index 0000000..fd07996
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsNodeDto.java
@@ -0,0 +1,36 @@
+package kr.co.accura.wtm.domain.wbs.dto;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsNode;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class WbsNodeDto {
+
+ private Long id;
+ private String wbsCode;
+ private String name;
+ private Integer level;
+ private String parentCode;
+ private String discipline;
+ private BigDecimal plannedHours;
+ private Boolean isLeaf;
+
+ public static WbsNodeDto from(WbsNode node) {
+ return WbsNodeDto.builder()
+ .id(node.getId())
+ .wbsCode(node.getWbsCode())
+ .name(node.getName())
+ .level(node.getLevel())
+ .parentCode(node.getParent() != null ? node.getParent().getWbsCode() : null)
+ .discipline(node.getDiscipline())
+ .plannedHours(node.getPlannedHours())
+ .isLeaf(node.getIsLeaf())
+ .build();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsParseResult.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsParseResult.java
new file mode 100644
index 0000000..559dd49
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsParseResult.java
@@ -0,0 +1,31 @@
+package kr.co.accura.wtm.domain.wbs.dto;
+
+import lombok.Getter;
+import lombok.Setter;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Getter
+@Setter
+public class WbsParseResult {
+
+ private final List nodes = new ArrayList<>();
+ private final List errors = new ArrayList<>();
+
+ public void addNode(WbsNodeDto node) {
+ nodes.add(node);
+ }
+
+ public void addError(String error) {
+ errors.add(error);
+ }
+
+ public boolean hasErrors() {
+ return !errors.isEmpty();
+ }
+
+ public void setError(String error) {
+ errors.add(error);
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsVersionDto.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsVersionDto.java
new file mode 100644
index 0000000..4aa0638
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/dto/WbsVersionDto.java
@@ -0,0 +1,36 @@
+package kr.co.accura.wtm.domain.wbs.dto;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsVersion;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+public record WbsVersionDto(
+ Long id,
+ Long projectId,
+ Integer versionNumber,
+ LocalDate effectiveDate,
+ String sourceType,
+ String sourceFilename,
+ String description,
+ String status,
+ Long uploadedBy,
+ LocalDateTime createdAt,
+ int nodeCount
+) {
+ public static WbsVersionDto from(WbsVersion version, int nodeCount) {
+ return new WbsVersionDto(
+ version.getId(),
+ version.getProjectId(),
+ version.getVersionNumber(),
+ version.getEffectiveDate(),
+ version.getSourceType(),
+ version.getSourceFilename(),
+ version.getDescription(),
+ version.getStatus(),
+ version.getUploadedBy(),
+ version.getCreatedAt(),
+ nodeCount
+ );
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/CanonicalWbs.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/CanonicalWbs.java
new file mode 100644
index 0000000..3fad6f6
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/CanonicalWbs.java
@@ -0,0 +1,68 @@
+package kr.co.accura.wtm.domain.wbs.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "canonical_wbs",
+ uniqueConstraints = @UniqueConstraint(columnNames = {"project_id", "wbs_code"}))
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class CanonicalWbs {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "project_id", nullable = false)
+ private Long projectId;
+
+ @Column(name = "wbs_code", nullable = false, length = 100)
+ private String wbsCode;
+
+ @Column(nullable = false)
+ private Integer level;
+
+ @Column(nullable = false, length = 500)
+ private String name;
+
+ @Column(name = "parent_code", length = 100)
+ private String parentCode;
+
+ @Column(length = 50)
+ private String discipline;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+
+ @Column(name = "mapped_p6_code", length = 100)
+ private String mappedP6Code;
+
+ @Column(name = "created_at")
+ @Builder.Default
+ private LocalDateTime createdAt = LocalDateTime.now();
+
+ public static CanonicalWbs fromWbsNode(Long projectId, WbsNode node) {
+ return CanonicalWbs.builder()
+ .projectId(projectId)
+ .wbsCode(node.getWbsCode())
+ .level(node.getLevel())
+ .name(node.getName())
+ .parentCode(node.getParent() != null ? node.getParent().getWbsCode() : null)
+ .discipline(node.getDiscipline())
+ .mappedP6Code(node.getWbsCode())
+ .build();
+ }
+
+ public void updateFrom(WbsNode node) {
+ this.name = node.getName();
+ this.level = node.getLevel();
+ this.discipline = node.getDiscipline();
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsDisciplineAssignment.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsDisciplineAssignment.java
new file mode 100644
index 0000000..dfc4925
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsDisciplineAssignment.java
@@ -0,0 +1,29 @@
+package kr.co.accura.wtm.domain.wbs.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+@Entity
+@Table(name = "wbs_discipline_assignments")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class WbsDisciplineAssignment {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "canonical_wbs_id", nullable = false)
+ private CanonicalWbs canonicalWbs;
+
+ @Column(length = 50)
+ private String discipline;
+
+ @Column(name = "is_active")
+ @Builder.Default
+ private Boolean isActive = true;
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsNode.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsNode.java
new file mode 100644
index 0000000..4315de7
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsNode.java
@@ -0,0 +1,64 @@
+package kr.co.accura.wtm.domain.wbs.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Entity
+@Table(name = "wbs_nodes",
+ uniqueConstraints = @UniqueConstraint(columnNames = {"wbs_version_id", "wbs_code"}))
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class WbsNode {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "wbs_version_id", nullable = false)
+ private WbsVersion wbsVersion;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "parent_id")
+ private WbsNode parent;
+
+ @Column(name = "wbs_code", nullable = false, length = 100)
+ private String wbsCode;
+
+ @Column(nullable = false)
+ private Integer level;
+
+ @Column(nullable = false, length = 500)
+ private String name;
+
+ @Column(length = 50)
+ private String discipline;
+
+ @Column(name = "planned_hours", precision = 10, scale = 2)
+ private BigDecimal plannedHours;
+
+ @Column(name = "sort_order")
+ @Builder.Default
+ private Integer sortOrder = 0;
+
+ @Column(name = "is_leaf")
+ @Builder.Default
+ private Boolean isLeaf = false;
+
+ /**
+ * Content equality check for version comparison.
+ */
+ public boolean contentEquals(WbsNode other) {
+ if (other == null) return false;
+ return java.util.Objects.equals(this.name, other.name)
+ && java.util.Objects.equals(this.level, other.level)
+ && java.util.Objects.equals(this.discipline, other.discipline)
+ && (this.plannedHours == null ? other.plannedHours == null
+ : this.plannedHours.compareTo(other.plannedHours) == 0);
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsVersion.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsVersion.java
new file mode 100644
index 0000000..02b6257
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/entity/WbsVersion.java
@@ -0,0 +1,66 @@
+package kr.co.accura.wtm.domain.wbs.entity;
+
+import jakarta.persistence.*;
+import kr.co.accura.wtm.domain.project.entity.Project;
+import lombok.*;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "wbs_versions",
+ uniqueConstraints = @UniqueConstraint(columnNames = {"project_id", "version_number"}))
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class WbsVersion {
+
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @ManyToOne(fetch = FetchType.LAZY)
+ @JoinColumn(name = "project_id", nullable = false)
+ private Project project;
+
+ @Column(name = "version_number", nullable = false)
+ private Integer versionNumber;
+
+ @Column(name = "effective_date", nullable = false)
+ private LocalDate effectiveDate;
+
+ @Column(name = "source_type", length = 20)
+ @Builder.Default
+ private String sourceType = "P6_UPLOAD";
+
+ @Column(name = "source_filename", length = 500)
+ private String sourceFilename;
+
+ @Column(length = 500)
+ private String description;
+
+ @Column(length = 20)
+ @Builder.Default
+ private String status = "DRAFT";
+
+ @Column(name = "uploaded_by")
+ private Long uploadedBy;
+
+ @Column(name = "created_at")
+ @Builder.Default
+ private LocalDateTime createdAt = LocalDateTime.now();
+
+ public void activate() {
+ this.status = "ACTIVE";
+ }
+
+ public void archive() {
+ this.status = "ARCHIVED";
+ }
+
+ public Long getProjectId() {
+ return project != null ? project.getId() : null;
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/parser/P6WbsParser.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/parser/P6WbsParser.java
new file mode 100644
index 0000000..1e4431e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/parser/P6WbsParser.java
@@ -0,0 +1,46 @@
+package kr.co.accura.wtm.domain.wbs.parser;
+
+import kr.co.accura.wtm.domain.wbs.dto.WbsNodeDto;
+import kr.co.accura.wtm.domain.wbs.dto.WbsParseResult;
+import org.springframework.stereotype.Service;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.math.BigDecimal;
+
+/**
+ * P6 WBS file parser stub.
+ * Parses P6 Export files (.xls/.csv) into WBS tree structure.
+ * Full implementation will use Apache POI for Excel parsing.
+ */
+@Service
+public class P6WbsParser {
+
+ /**
+ * Parse a P6 Export file into WBS nodes.
+ * Expected P6 columns:
+ * Activity ID | Activity Name | WBS Code | WBS Name | Level | Planned Hours
+ */
+ public WbsParseResult parse(MultipartFile file) {
+ var result = new WbsParseResult();
+
+ try {
+ // TODO: Implement Apache POI-based parsing
+ // Stub: return empty result for now
+ result.setError("P6 WBS parser not yet implemented. Upload a file to test.");
+ } catch (Exception e) {
+ result.setError("File parsing failed: " + e.getMessage());
+ }
+
+ return result;
+ }
+
+ /**
+ * Derive parent WBS code from a given WBS code.
+ * Example: "E.01.03.02.01" (Level 5) -> "E.01.03.02" (Level 4)
+ */
+ public String deriveParentCode(String wbsCode, int level) {
+ if (level <= 1) return null;
+ int lastDot = wbsCode.lastIndexOf('.');
+ return lastDot > 0 ? wbsCode.substring(0, lastDot) : null;
+ }
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/CanonicalWbsRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/CanonicalWbsRepository.java
new file mode 100644
index 0000000..c46ebd9
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/CanonicalWbsRepository.java
@@ -0,0 +1,22 @@
+package kr.co.accura.wtm.domain.wbs.repository;
+
+import kr.co.accura.wtm.domain.wbs.entity.CanonicalWbs;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.Set;
+
+@Repository
+public interface CanonicalWbsRepository extends JpaRepository {
+
+ List findByProjectIdAndIsActiveTrue(Long projectId);
+
+ Optional findByProjectIdAndWbsCode(Long projectId, String wbsCode);
+
+ @Query("SELECT c.wbsCode FROM CanonicalWbs c WHERE c.projectId = :projectId AND c.isActive = true")
+ Set findActiveCodesByProjectId(@Param("projectId") Long projectId);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsDisciplineAssignmentRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsDisciplineAssignmentRepository.java
new file mode 100644
index 0000000..c7ddfc5
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsDisciplineAssignmentRepository.java
@@ -0,0 +1,15 @@
+package kr.co.accura.wtm.domain.wbs.repository;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsDisciplineAssignment;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface WbsDisciplineAssignmentRepository extends JpaRepository {
+
+ List findByCanonicalWbs_Id(Long canonicalWbsId);
+
+ List findByCanonicalWbs_IdIn(List canonicalWbsIds);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsNodeRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsNodeRepository.java
new file mode 100644
index 0000000..12e719e
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsNodeRepository.java
@@ -0,0 +1,20 @@
+package kr.co.accura.wtm.domain.wbs.repository;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsNode;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface WbsNodeRepository extends JpaRepository {
+
+ List findByWbsVersion_Id(Long wbsVersionId);
+
+ @Query("SELECT n FROM WbsNode n WHERE n.wbsVersion.project.id = :projectId " +
+ "AND n.wbsVersion.versionNumber = :versionNumber ORDER BY n.sortOrder")
+ List findByProjectIdAndVersion(@Param("projectId") Long projectId,
+ @Param("versionNumber") int versionNumber);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsVersionRepository.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsVersionRepository.java
new file mode 100644
index 0000000..ca64d74
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/repository/WbsVersionRepository.java
@@ -0,0 +1,26 @@
+package kr.co.accura.wtm.domain.wbs.repository;
+
+import kr.co.accura.wtm.domain.wbs.entity.WbsVersion;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Modifying;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface WbsVersionRepository extends JpaRepository {
+
+ List findByProject_IdOrderByVersionNumberDesc(Long projectId);
+
+ @Query("SELECT MAX(v.versionNumber) FROM WbsVersion v WHERE v.project.id = :projectId")
+ Optional findMaxVersionByProjectId(@Param("projectId") Long projectId);
+
+ @Modifying
+ @Query("UPDATE WbsVersion v SET v.status = 'ARCHIVED' WHERE v.project.id = :projectId AND v.status = 'ACTIVE'")
+ void archiveActiveVersions(@Param("projectId") Long projectId);
+
+ Optional findByProject_IdAndVersionNumber(Long projectId, Integer versionNumber);
+}
diff --git a/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/service/WbsService.java b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/service/WbsService.java
new file mode 100644
index 0000000..5d6e1f6
--- /dev/null
+++ b/wtm-api/src/main/java/kr/co/accura/wtm/domain/wbs/service/WbsService.java
@@ -0,0 +1,230 @@
+package kr.co.accura.wtm.domain.wbs.service;
+
+import kr.co.accura.wbx.spring.common.BusinessException;
+import kr.co.accura.wbx.spring.common.NotFoundException;
+import kr.co.accura.wtm.domain.project.entity.Project;
+import kr.co.accura.wtm.domain.project.repository.ProjectRepository;
+import kr.co.accura.wtm.domain.wbs.dto.*;
+import kr.co.accura.wtm.domain.wbs.entity.CanonicalWbs;
+import kr.co.accura.wtm.domain.wbs.entity.WbsDisciplineAssignment;
+import kr.co.accura.wtm.domain.wbs.entity.WbsNode;
+import kr.co.accura.wtm.domain.wbs.entity.WbsVersion;
+import kr.co.accura.wtm.domain.wbs.parser.P6WbsParser;
+import kr.co.accura.wtm.domain.wbs.repository.CanonicalWbsRepository;
+import kr.co.accura.wtm.domain.wbs.repository.WbsDisciplineAssignmentRepository;
+import kr.co.accura.wtm.domain.wbs.repository.WbsNodeRepository;
+import kr.co.accura.wtm.domain.wbs.repository.WbsVersionRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class WbsService {
+
+ private final WbsVersionRepository wbsVersionRepository;
+ private final WbsNodeRepository wbsNodeRepository;
+ private final CanonicalWbsRepository canonicalWbsRepository;
+ private final WbsDisciplineAssignmentRepository wbsDisciplineAssignmentRepository;
+ private final ProjectRepository projectRepository;
+ private final P6WbsParser p6Parser;
+
+ /**
+ * Upload P6 WBS file and create a new version.
+ */
+ public WbsVersionDto uploadP6Wbs(Long projectId, MultipartFile file,
+ LocalDate effectiveDate, String description) {
+ Project project = projectRepository.findById(projectId)
+ .orElseThrow(() -> new NotFoundException("Project not found: " + projectId));
+
+ // 1. Parse file
+ WbsParseResult parseResult = p6Parser.parse(file);
+ if (parseResult.hasErrors()) {
+ throw new BusinessException("WBS parsing error: " + String.join(", ", parseResult.getErrors()));
+ }
+
+ // 2. Auto-increment version number
+ int nextVersion = wbsVersionRepository
+ .findMaxVersionByProjectId(projectId)
+ .map(v -> v + 1).orElse(1);
+
+ // 3. Save WBS version
+ WbsVersion version = WbsVersion.builder()
+ .project(project)
+ .versionNumber(nextVersion)
+ .effectiveDate(effectiveDate)
+ .sourceType("P6_UPLOAD")
+ .sourceFilename(file.getOriginalFilename())
+ .description(description)
+ .status("DRAFT")
+ .build();
+ wbsVersionRepository.save(version);
+
+ // 4. Bulk save WBS nodes
+ List nodes = parseResult.getNodes().stream()
+ .map(dto -> WbsNode.builder()
+ .wbsVersion(version)
+ .wbsCode(dto.getWbsCode())
+ .level(dto.getLevel())
+ .name(dto.getName())
+ .discipline(dto.getDiscipline())
+ .plannedHours(dto.getPlannedHours())
+ .isLeaf(dto.getLevel() != null && dto.getLevel() == 5)
+ .build())
+ .toList();
+ wbsNodeRepository.saveAll(nodes);
+
+ return WbsVersionDto.from(version, nodes.size());
+ }
+
+ /**
+ * Activate a WBS version (DRAFT -> ACTIVE).
+ * Archives any existing ACTIVE version.
+ */
+ public void activateVersion(Long versionId) {
+ WbsVersion version = wbsVersionRepository.findById(versionId)
+ .orElseThrow(() -> new NotFoundException("WBS version not found: " + versionId));
+
+ // Archive existing ACTIVE versions
+ wbsVersionRepository.archiveActiveVersions(version.getProjectId());
+
+ version.activate();
+ wbsVersionRepository.save(version);
+
+ // Sync canonical WBS
+ syncCanonicalWbs(version);
+ }
+
+ /**
+ * Get WBS versions for a project.
+ */
+ @Transactional(readOnly = true)
+ public List getVersions(Long projectId) {
+ return wbsVersionRepository.findByProject_IdOrderByVersionNumberDesc(projectId).stream()
+ .map(v -> {
+ int count = wbsNodeRepository.findByWbsVersion_Id(v.getId()).size();
+ return WbsVersionDto.from(v, count);
+ })
+ .toList();
+ }
+
+ /**
+ * Get WBS nodes for a specific version.
+ */
+ @Transactional(readOnly = true)
+ public List getVersionNodes(Long projectId, Integer versionNumber) {
+ WbsVersion version = wbsVersionRepository.findByProject_IdAndVersionNumber(projectId, versionNumber)
+ .orElseThrow(() -> new NotFoundException("WBS version not found"));
+ return wbsNodeRepository.findByWbsVersion_Id(version.getId()).stream()
+ .map(WbsNodeDto::from)
+ .toList();
+ }
+
+ /**
+ * Get canonical WBS for a project.
+ */
+ @Transactional(readOnly = true)
+ public List getCanonicalWbs(Long projectId) {
+ return canonicalWbsRepository.findByProjectIdAndIsActiveTrue(projectId).stream()
+ .map(CanonicalWbsDto::from)
+ .toList();
+ }
+
+ /**
+ * Compare two WBS versions.
+ */
+ @Transactional(readOnly = true)
+ public WbsCompareResult compareVersions(Long projectId, int versionA, int versionB) {
+ List nodesA = wbsNodeRepository.findByProjectIdAndVersion(projectId, versionA);
+ List nodesB = wbsNodeRepository.findByProjectIdAndVersion(projectId, versionB);
+
+ Map mapA = nodesA.stream()
+ .collect(Collectors.toMap(WbsNode::getWbsCode, Function.identity()));
+ Map mapB = nodesB.stream()
+ .collect(Collectors.toMap(WbsNode::getWbsCode, Function.identity()));
+
+ var result = new WbsCompareResult();
+
+ // Added in B
+ mapB.keySet().stream()
+ .filter(code -> !mapA.containsKey(code))
+ .forEach(code -> result.addAdded(mapB.get(code)));
+
+ // Removed from A
+ mapA.keySet().stream()
+ .filter(code -> !mapB.containsKey(code))
+ .forEach(code -> result.addRemoved(mapA.get(code)));
+
+ // Modified
+ mapA.keySet().stream()
+ .filter(mapB::containsKey)
+ .filter(code -> !mapA.get(code).contentEquals(mapB.get(code)))
+ .forEach(code -> result.addModified(mapA.get(code), mapB.get(code)));
+
+ return result;
+ }
+
+ /**
+ * Get WBS-Discipline assignments for a project.
+ */
+ @Transactional(readOnly = true)
+ public List getWbsDisciplines(Long projectId) {
+ List canonicalWbsList = canonicalWbsRepository.findByProjectIdAndIsActiveTrue(projectId);
+ List canonicalWbsIds = canonicalWbsList.stream().map(CanonicalWbs::getId).toList();
+ return wbsDisciplineAssignmentRepository.findByCanonicalWbs_IdIn(canonicalWbsIds).stream()
+ .map(WbsDisciplineAssignmentDto::from)
+ .toList();
+ }
+
+ /**
+ * Save WBS-Discipline assignments for a project.
+ */
+ public List saveWbsDisciplines(Long projectId,
+ List assignments) {
+ projectRepository.findById(projectId)
+ .orElseThrow(() -> new NotFoundException("Project not found: " + projectId));
+
+ List entities = assignments.stream().map(dto -> {
+ CanonicalWbs cw = canonicalWbsRepository.findById(dto.getCanonicalWbsId())
+ .orElseThrow(() -> new NotFoundException("Canonical WBS not found: " + dto.getCanonicalWbsId()));
+ return WbsDisciplineAssignment.builder()
+ .id(dto.getId())
+ .canonicalWbs(cw)
+ .discipline(dto.getDiscipline())
+ .isActive(dto.getIsActive() != null ? dto.getIsActive() : true)
+ .build();
+ }).toList();
+
+ return wbsDisciplineAssignmentRepository.saveAll(entities).stream()
+ .map(WbsDisciplineAssignmentDto::from)
+ .toList();
+ }
+
+ /**
+ * Sync canonical WBS from active WBS version.
+ */
+ private void syncCanonicalWbs(WbsVersion version) {
+ List nodes = wbsNodeRepository.findByWbsVersion_Id(version.getId());
+
+ for (WbsNode node : nodes) {
+ canonicalWbsRepository.findByProjectIdAndWbsCode(
+ version.getProjectId(), node.getWbsCode()
+ ).ifPresentOrElse(
+ existing -> {
+ existing.updateFrom(node);
+ existing.setMappedP6Code(node.getWbsCode());
+ },
+ () -> canonicalWbsRepository.save(
+ CanonicalWbs.fromWbsNode(version.getProjectId(), node))
+ );
+ }
+ }
+}
diff --git a/wtm-api/src/main/resources/application.yml b/wtm-api/src/main/resources/application.yml
new file mode 100644
index 0000000..5e0a9fb
--- /dev/null
+++ b/wtm-api/src/main/resources/application.yml
@@ -0,0 +1,62 @@
+spring:
+ application:
+ name: wtm-api
+
+ datasource:
+ url: jdbc:mysql://${DB_HOST:ws.ubuilder.co.kr}:${DB_PORT:3306}/${DB_NAME:mos}?useUnicode=true&characterEncoding=UTF-8&useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Seoul
+ username: ${DB_USER:jsh}
+ password: ${DB_PASS:jsh@}
+ driver-class-name: com.mysql.cj.jdbc.Driver
+
+ jpa:
+ hibernate:
+ ddl-auto: update # 개발 단계: Flyway + Hibernate 보완
+ open-in-view: false
+
+ flyway:
+ enabled: true
+ locations: classpath:db/migration/mysql
+ baseline-on-migrate: true
+ baseline-version: 0
+
+ data:
+ redis:
+ host: ${REDIS_HOST:localhost}
+ port: 6379
+
+server:
+ port: ${SERVER_PORT:8081}
+
+wbx:
+ spring:
+ api-prefix: /api/wtm
+ jwt:
+ secret: ${JWT_SECRET:dev-secret-key-minimum-256-bits-long-for-wtm-project}
+ expiration: 28800
+ admin-ui:
+ enabled: false # WTM은 자체 Admin 불필요
+ cors:
+ allowed-origins: ${CORS_ORIGINS:http://localhost:5173}
+ notification:
+ sse-enabled: true
+
+wtm:
+ work-rules:
+ default-min-daily-hours: 8
+ default-max-weekly-hours: 52
+
+management:
+ endpoints:
+ web:
+ exposure:
+ include: health,info,metrics
+ endpoint:
+ health:
+ show-details: when-authorized
+
+springdoc:
+ api-docs:
+ path: /api-docs
+ swagger-ui:
+ path: /swagger-ui
+ packages-to-scan: kr.co.accura.wtm,kr.co.accura.wbx.spring
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V100__init_users.sql b/wtm-api/src/main/resources/db/migration/mysql/V100__init_users.sql
new file mode 100644
index 0000000..4ef07f4
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V100__init_users.sql
@@ -0,0 +1,56 @@
+-- V1__init_users.sql (MySQL)
+-- Converted from MSSQL DDL in 02-database-schema.md
+
+CREATE TABLE users (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ employee_id VARCHAR(50) NOT NULL UNIQUE,
+ email VARCHAR(255) NOT NULL UNIQUE,
+ username VARCHAR(100) NOT NULL,
+ full_name VARCHAR(255),
+ hashed_password VARCHAR(255),
+ department VARCHAR(100),
+ discipline VARCHAR(100),
+ position_title VARCHAR(100),
+ location VARCHAR(50),
+ employment_type VARCHAR(20) DEFAULT 'INTERNAL',
+ is_active TINYINT(1) DEFAULT 1,
+ is_locked TINYINT(1) DEFAULT 0,
+ failed_attempts INT DEFAULT 0,
+ last_login_at DATETIME,
+ password_changed_at DATETIME,
+ azure_oid VARCHAR(255),
+ mfa_enabled TINYINT(1) DEFAULT 0,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ created_by BIGINT,
+ updated_by BIGINT
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE roles (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ code VARCHAR(20) NOT NULL UNIQUE,
+ name VARCHAR(100) NOT NULL,
+ description VARCHAR(500),
+ level INT DEFAULT 0
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE user_roles (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ user_id BIGINT NOT NULL,
+ role_id BIGINT NOT NULL,
+ project_id BIGINT NULL,
+ granted_at DATETIME DEFAULT NOW(),
+ granted_by BIGINT,
+ UNIQUE (user_id, role_id, project_id),
+ CONSTRAINT fk_user_roles_user FOREIGN KEY (user_id) REFERENCES users(id),
+ CONSTRAINT fk_user_roles_role FOREIGN KEY (role_id) REFERENCES roles(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- Seed roles
+INSERT INTO roles (code, name, level) VALUES
+ ('SA', 'System Administrator', 100),
+ ('PM', 'Project Manager', 80),
+ ('PCM', 'Project Control Manager', 70),
+ ('PTK', 'Project Timekeeper', 60),
+ ('DL', 'Discipline Lead', 50),
+ ('USER', 'General User', 10);
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V101__init_projects_wbs.sql b/wtm-api/src/main/resources/db/migration/mysql/V101__init_projects_wbs.sql
new file mode 100644
index 0000000..933626d
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V101__init_projects_wbs.sql
@@ -0,0 +1,68 @@
+-- V2__init_projects_wbs.sql (MySQL)
+-- Projects, WBS versions, WBS nodes, Canonical WBS
+
+CREATE TABLE projects (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ project_code VARCHAR(50) NOT NULL UNIQUE,
+ name VARCHAR(255) NOT NULL,
+ description VARCHAR(1000) CHARACTER SET utf8mb4,
+ project_type VARCHAR(20) NOT NULL,
+ status VARCHAR(20) DEFAULT 'ACTIVE',
+ start_date DATE,
+ end_date DATE,
+ pm_user_id BIGINT,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ CONSTRAINT fk_projects_pm FOREIGN KEY (pm_user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- user_roles FK to projects (deferred from V1 because projects did not exist yet)
+ALTER TABLE user_roles
+ ADD CONSTRAINT fk_user_roles_project FOREIGN KEY (project_id) REFERENCES projects(id);
+
+CREATE TABLE wbs_versions (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ project_id BIGINT NOT NULL,
+ version_number INT NOT NULL,
+ effective_date DATE NOT NULL,
+ source_type VARCHAR(20) DEFAULT 'P6_UPLOAD',
+ source_filename VARCHAR(500),
+ description VARCHAR(500) CHARACTER SET utf8mb4,
+ status VARCHAR(20) DEFAULT 'DRAFT',
+ uploaded_by BIGINT,
+ created_at DATETIME DEFAULT NOW(),
+ UNIQUE (project_id, version_number),
+ CONSTRAINT fk_wbs_ver_project FOREIGN KEY (project_id) REFERENCES projects(id),
+ CONSTRAINT fk_wbs_ver_uploader FOREIGN KEY (uploaded_by) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE wbs_nodes (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ wbs_version_id BIGINT NOT NULL,
+ parent_id BIGINT NULL,
+ wbs_code VARCHAR(100) NOT NULL,
+ level INT NOT NULL,
+ name VARCHAR(500) CHARACTER SET utf8mb4 NOT NULL,
+ discipline VARCHAR(50),
+ planned_hours DECIMAL(10,2),
+ sort_order INT DEFAULT 0,
+ is_leaf TINYINT(1) DEFAULT 0,
+ UNIQUE (wbs_version_id, wbs_code),
+ CONSTRAINT fk_wbs_node_version FOREIGN KEY (wbs_version_id) REFERENCES wbs_versions(id),
+ CONSTRAINT fk_wbs_node_parent FOREIGN KEY (parent_id) REFERENCES wbs_nodes(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE canonical_wbs (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ project_id BIGINT NOT NULL,
+ wbs_code VARCHAR(100) NOT NULL,
+ level INT NOT NULL,
+ name VARCHAR(500) CHARACTER SET utf8mb4 NOT NULL,
+ parent_code VARCHAR(100),
+ discipline VARCHAR(50),
+ is_active TINYINT(1) DEFAULT 1,
+ mapped_p6_code VARCHAR(100),
+ created_at DATETIME DEFAULT NOW(),
+ UNIQUE (project_id, wbs_code),
+ CONSTRAINT fk_canonical_wbs_project FOREIGN KEY (project_id) REFERENCES projects(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V102__init_teal.sql b/wtm-api/src/main/resources/db/migration/mysql/V102__init_teal.sql
new file mode 100644
index 0000000..f2000c8
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V102__init_teal.sql
@@ -0,0 +1,28 @@
+-- V3__init_teal.sql (MySQL)
+-- TEAL versions and entries
+
+CREATE TABLE teal_versions (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ project_id BIGINT NOT NULL,
+ version_number INT NOT NULL,
+ effective_date DATE NOT NULL,
+ description VARCHAR(500) CHARACTER SET utf8mb4,
+ status VARCHAR(20) DEFAULT 'DRAFT',
+ uploaded_by BIGINT,
+ created_at DATETIME DEFAULT NOW(),
+ UNIQUE (project_id, version_number),
+ CONSTRAINT fk_teal_ver_project FOREIGN KEY (project_id) REFERENCES projects(id),
+ CONSTRAINT fk_teal_ver_uploader FOREIGN KEY (uploaded_by) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE teal_entries (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ teal_version_id BIGINT NOT NULL,
+ canonical_wbs_id BIGINT,
+ activity_code VARCHAR(100) NOT NULL,
+ activity_name VARCHAR(500) CHARACTER SET utf8mb4,
+ discipline VARCHAR(50),
+ is_active TINYINT(1) DEFAULT 1,
+ CONSTRAINT fk_teal_entry_version FOREIGN KEY (teal_version_id) REFERENCES teal_versions(id),
+ CONSTRAINT fk_teal_entry_cwbs FOREIGN KEY (canonical_wbs_id) REFERENCES canonical_wbs(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V103__init_timesheets.sql b/wtm-api/src/main/resources/db/migration/mysql/V103__init_timesheets.sql
new file mode 100644
index 0000000..dd71cce
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V103__init_timesheets.sql
@@ -0,0 +1,57 @@
+-- V4__init_timesheets.sql (MySQL)
+-- Timesheets, timesheet entries, timesheet uploads
+
+CREATE TABLE timesheets (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ user_id BIGINT NOT NULL,
+ week_start_date DATE NOT NULL,
+ week_end_date DATE NOT NULL,
+ status VARCHAR(20) DEFAULT 'DRAFT',
+ total_hours DECIMAL(10,2) DEFAULT 0,
+ submitted_at DATETIME,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ UNIQUE (user_id, week_start_date),
+ CONSTRAINT fk_ts_user FOREIGN KEY (user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE timesheet_entries (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ timesheet_id BIGINT NOT NULL,
+ entry_type VARCHAR(20) NOT NULL,
+ entry_date DATE NOT NULL,
+ hours DECIMAL(5,2) NOT NULL DEFAULT 0,
+ np_category VARCHAR(100),
+ other_project_id BIGINT NULL,
+ other_category VARCHAR(100),
+ epc_project_id BIGINT NULL,
+ canonical_wbs_id BIGINT NULL,
+ teal_entry_id BIGINT NULL,
+ revision_number INT DEFAULT 1,
+ remark VARCHAR(500) CHARACTER SET utf8mb4,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ CONSTRAINT chk_hours CHECK (hours >= 0 AND hours <= 24),
+ CONSTRAINT fk_tse_timesheet FOREIGN KEY (timesheet_id) REFERENCES timesheets(id),
+ CONSTRAINT fk_tse_other_proj FOREIGN KEY (other_project_id) REFERENCES projects(id),
+ CONSTRAINT fk_tse_epc_proj FOREIGN KEY (epc_project_id) REFERENCES projects(id),
+ CONSTRAINT fk_tse_cwbs FOREIGN KEY (canonical_wbs_id) REFERENCES canonical_wbs(id),
+ CONSTRAINT fk_tse_teal FOREIGN KEY (teal_entry_id) REFERENCES teal_entries(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE INDEX idx_ts_entries_date ON timesheet_entries(entry_date);
+CREATE INDEX idx_ts_entries_type ON timesheet_entries(entry_type);
+
+CREATE TABLE timesheet_uploads (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ user_id BIGINT NOT NULL,
+ filename VARCHAR(500),
+ file_path VARCHAR(1000),
+ total_rows INT,
+ success_rows INT,
+ error_rows INT,
+ error_log TEXT CHARACTER SET utf8mb4,
+ status VARCHAR(20),
+ created_at DATETIME DEFAULT NOW(),
+ CONSTRAINT fk_tsu_user FOREIGN KEY (user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V104__init_approvals.sql b/wtm-api/src/main/resources/db/migration/mysql/V104__init_approvals.sql
new file mode 100644
index 0000000..b6fe453
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V104__init_approvals.sql
@@ -0,0 +1,40 @@
+-- V5__init_approvals.sql (MySQL)
+-- Approvals, approval lines, approval comments
+
+CREATE TABLE approvals (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ timesheet_id BIGINT NOT NULL,
+ requester_id BIGINT NOT NULL,
+ project_id BIGINT,
+ status VARCHAR(20) DEFAULT 'PENDING',
+ submitted_at DATETIME DEFAULT NOW(),
+ completed_at DATETIME,
+ UNIQUE (timesheet_id),
+ CONSTRAINT fk_appr_timesheet FOREIGN KEY (timesheet_id) REFERENCES timesheets(id),
+ CONSTRAINT fk_appr_requester FOREIGN KEY (requester_id) REFERENCES users(id),
+ CONSTRAINT fk_appr_project FOREIGN KEY (project_id) REFERENCES projects(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE approval_lines (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ approval_id BIGINT NOT NULL,
+ approver_id BIGINT NOT NULL,
+ approval_order INT NOT NULL,
+ role_code VARCHAR(20),
+ status VARCHAR(20) DEFAULT 'PENDING',
+ acted_at DATETIME,
+ created_at DATETIME DEFAULT NOW(),
+ CONSTRAINT fk_aline_approval FOREIGN KEY (approval_id) REFERENCES approvals(id),
+ CONSTRAINT fk_aline_approver FOREIGN KEY (approver_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE approval_comments (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ approval_id BIGINT NOT NULL,
+ user_id BIGINT NOT NULL,
+ comment VARCHAR(2000) CHARACTER SET utf8mb4,
+ action VARCHAR(20),
+ created_at DATETIME DEFAULT NOW(),
+ CONSTRAINT fk_acomm_approval FOREIGN KEY (approval_id) REFERENCES approvals(id),
+ CONSTRAINT fk_acomm_user FOREIGN KEY (user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V105__init_report_views.sql b/wtm-api/src/main/resources/db/migration/mysql/V105__init_report_views.sql
new file mode 100644
index 0000000..8650b51
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V105__init_report_views.sql
@@ -0,0 +1,41 @@
+-- V6__init_report_views.sql (MySQL)
+-- Report views with MySQL date functions
+
+CREATE OR REPLACE VIEW v_project_hours AS
+SELECT
+ te.epc_project_id AS project_id,
+ p.project_code,
+ p.name AS project_name,
+ te.entry_date,
+ YEAR(te.entry_date) AS `year`,
+ MONTH(te.entry_date) AS `month`,
+ WEEK(te.entry_date) AS `week`,
+ u.discipline,
+ u.department,
+ te.entry_type,
+ SUM(te.hours) AS total_hours,
+ COUNT(DISTINCT te.timesheet_id) AS timesheet_count
+FROM timesheet_entries te
+JOIN timesheets ts ON te.timesheet_id = ts.id
+JOIN users u ON ts.user_id = u.id
+LEFT JOIN projects p ON te.epc_project_id = p.id
+WHERE ts.status = 'APPROVED'
+GROUP BY te.epc_project_id, p.project_code, p.name,
+ te.entry_date, YEAR(te.entry_date),
+ MONTH(te.entry_date), WEEK(te.entry_date),
+ u.discipline, u.department, te.entry_type;
+
+CREATE OR REPLACE VIEW v_wbs_hours AS
+SELECT
+ cw.project_id,
+ cw.wbs_code,
+ cw.level AS wbs_level,
+ cw.name AS wbs_name,
+ cw.discipline,
+ SUM(te.hours) AS total_hours,
+ COUNT(DISTINCT ts.user_id) AS user_count
+FROM timesheet_entries te
+JOIN timesheets ts ON te.timesheet_id = ts.id
+JOIN canonical_wbs cw ON te.canonical_wbs_id = cw.id
+WHERE ts.status = 'APPROVED'
+GROUP BY cw.project_id, cw.wbs_code, cw.level, cw.name, cw.discipline;
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V106__init_config_audit.sql b/wtm-api/src/main/resources/db/migration/mysql/V106__init_config_audit.sql
new file mode 100644
index 0000000..654fa8a
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V106__init_config_audit.sql
@@ -0,0 +1,53 @@
+-- V7__init_config_audit.sql (MySQL)
+-- Overhead types, work rules, SA access logs + seed overhead types
+
+CREATE TABLE overhead_types (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ code VARCHAR(50) NOT NULL UNIQUE,
+ name VARCHAR(200) NOT NULL,
+ category VARCHAR(50),
+ is_active TINYINT(1) DEFAULT 1,
+ sort_order INT DEFAULT 0,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE work_rules (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ location VARCHAR(50),
+ min_daily_hours DECIMAL(4,2) DEFAULT 8.00,
+ max_daily_hours DECIMAL(4,2) DEFAULT 12.00,
+ max_weekly_hours DECIMAL(5,2) DEFAULT 52.00,
+ is_active TINYINT(1) DEFAULT 1,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE sa_access_logs (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ user_id BIGINT NOT NULL,
+ action VARCHAR(50) NOT NULL,
+ resource VARCHAR(100),
+ resource_id BIGINT,
+ ip_address VARCHAR(50),
+ user_agent VARCHAR(500),
+ detail VARCHAR(2000) CHARACTER SET utf8mb4,
+ created_at DATETIME DEFAULT NOW(),
+ CONSTRAINT fk_sa_log_user FOREIGN KEY (user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE INDEX idx_sa_log_user ON sa_access_logs(user_id, created_at);
+CREATE INDEX idx_sa_log_action ON sa_access_logs(action, created_at);
+
+-- Seed overhead types (Non-Project categories)
+INSERT INTO overhead_types (code, name, category, sort_order) VALUES
+ ('LEAVE', 'Annual Leave', 'LEAVE', 1),
+ ('SICK', 'Sick Leave', 'LEAVE', 2),
+ ('HOLIDAY', 'Public Holiday', 'LEAVE', 3),
+ ('TRAINING', 'Training', 'ADMIN', 10),
+ ('MEETING', 'General Meeting', 'ADMIN', 11),
+ ('ADMIN', 'Administrative Work', 'ADMIN', 12),
+ ('TRAVEL', 'Business Travel', 'TRAVEL', 20),
+ ('SAFETY', 'Safety Training', 'ADMIN', 13),
+ ('IT_SUPPORT', 'IT Support', 'ADMIN', 14),
+ ('OTHER', 'Other Overhead', 'OTHER', 99);
diff --git a/wtm-api/src/main/resources/db/migration/mysql/V107__init_missing_tables.sql b/wtm-api/src/main/resources/db/migration/mysql/V107__init_missing_tables.sql
new file mode 100644
index 0000000..f6052e3
--- /dev/null
+++ b/wtm-api/src/main/resources/db/migration/mysql/V107__init_missing_tables.sql
@@ -0,0 +1,68 @@
+-- V107__init_missing_tables.sql (MySQL)
+-- Missing tables: project_assignments, wbs_discipline_assignments, org_hierarchy, hr_uploads, project_type_config
+
+CREATE TABLE IF NOT EXISTS project_assignments (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ project_id BIGINT NOT NULL,
+ user_id BIGINT NOT NULL,
+ role VARCHAR(50),
+ assigned_at DATETIME DEFAULT NOW(),
+ assigned_by BIGINT,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ created_by BIGINT,
+ updated_by BIGINT,
+ UNIQUE (project_id, user_id),
+ CONSTRAINT fk_proj_assign_project FOREIGN KEY (project_id) REFERENCES projects(id),
+ CONSTRAINT fk_proj_assign_user FOREIGN KEY (user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS wbs_discipline_assignments (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ canonical_wbs_id BIGINT NOT NULL,
+ discipline VARCHAR(100) NOT NULL,
+ is_active TINYINT(1) DEFAULT 1,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ CONSTRAINT fk_wbs_disc_canonical FOREIGN KEY (canonical_wbs_id) REFERENCES canonical_wbs(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS org_hierarchy (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ name VARCHAR(255) NOT NULL,
+ code VARCHAR(50),
+ level INT NOT NULL,
+ parent_id BIGINT,
+ sort_order INT DEFAULT 0,
+ is_active TINYINT(1) DEFAULT 1,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ CONSTRAINT fk_org_hierarchy_parent FOREIGN KEY (parent_id) REFERENCES org_hierarchy(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS hr_uploads (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ user_id BIGINT NOT NULL,
+ filename VARCHAR(500),
+ file_path VARCHAR(1000),
+ total_rows INT,
+ success_rows INT,
+ error_rows INT,
+ error_log TEXT CHARACTER SET utf8mb4,
+ status VARCHAR(20),
+ sync_source VARCHAR(50),
+ created_at DATETIME DEFAULT NOW(),
+ CONSTRAINT fk_hr_uploads_user FOREIGN KEY (user_id) REFERENCES users(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS project_type_config (
+ id BIGINT AUTO_INCREMENT PRIMARY KEY,
+ project_type VARCHAR(20) NOT NULL,
+ config_key VARCHAR(100) NOT NULL,
+ config_value VARCHAR(500),
+ description VARCHAR(500),
+ is_active TINYINT(1) DEFAULT 1,
+ created_at DATETIME DEFAULT NOW(),
+ updated_at DATETIME,
+ UNIQUE (project_type, config_key)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
diff --git a/wtm-frontend/.env b/wtm-frontend/.env
new file mode 100644
index 0000000..47e26ed
--- /dev/null
+++ b/wtm-frontend/.env
@@ -0,0 +1 @@
+VITE_APP_TITLE=WTM - Work Time Manager
diff --git a/wtm-frontend/.env.development b/wtm-frontend/.env.development
new file mode 100644
index 0000000..6c6a0cc
--- /dev/null
+++ b/wtm-frontend/.env.development
@@ -0,0 +1,2 @@
+VITE_API_BASE_URL=http://localhost:8080
+VITE_APP_ENV=development
diff --git a/wtm-frontend/.env.production b/wtm-frontend/.env.production
new file mode 100644
index 0000000..814af35
--- /dev/null
+++ b/wtm-frontend/.env.production
@@ -0,0 +1,2 @@
+VITE_API_BASE_URL=https://wtmgr.hanwhaocean.com
+VITE_APP_ENV=production
diff --git a/wtm-frontend/.gitignore b/wtm-frontend/.gitignore
new file mode 100644
index 0000000..a547bf3
--- /dev/null
+++ b/wtm-frontend/.gitignore
@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
diff --git a/wtm-frontend/.prettierrc.json b/wtm-frontend/.prettierrc.json
new file mode 100644
index 0000000..08740cc
--- /dev/null
+++ b/wtm-frontend/.prettierrc.json
@@ -0,0 +1,9 @@
+{
+ "semi": true,
+ "singleQuote": true,
+ "tabWidth": 2,
+ "trailingComma": "all",
+ "printWidth": 100,
+ "endOfLine": "lf",
+ "vueIndentScriptAndStyle": false
+}
diff --git a/wtm-frontend/README.md b/wtm-frontend/README.md
new file mode 100644
index 0000000..33895ab
--- /dev/null
+++ b/wtm-frontend/README.md
@@ -0,0 +1,5 @@
+# Vue 3 + TypeScript + Vite
+
+This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `
+