feat(tkuser): Sprint 001 Section A — 연차/휴가 백엔드 전환 (DB + API)

workers/vacation_balance_details → sso_users/sp_vacation_balances 기반 전환.
부서장 설정, 승인권한 CRUD, vacation_settings 테이블, 장기근속 자동부여,
startup migration 추가.

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

user-management/api/controllers/departmentController.js

@@ -1,7 +1,7 @@
 /**
  * Department Controller
  *
- * 부서 CRUD
+ * 부서 CRUD + 승인권한 관리
  */
 
 const departmentModel = require('../models/departmentModel');
@@ -63,4 +63,49 @@ async function remove(req, res, next) {
   }
 }
 
-module.exports = { getAll, getById, create, update, remove };
+/* ===== 승인권한 (Approval Authority) ===== */
+
+async function getApprovalAuthorities(req, res, next) {
+  try {
+    const departmentId = parseInt(req.params.id);
+    const data = await departmentModel.getApprovalAuthorities(departmentId);
+    res.json({ success: true, data });
+  } catch (err) {
+    next(err);
+  }
+}
+
+async function createApprovalAuthority(req, res, next) {
+  try {
+    const departmentId = parseInt(req.params.id);
+    const { approval_type, approver_user_id } = req.body;
+    if (!approval_type || !approver_user_id) {
+      return res.status(400).json({ success: false, error: '승인유형과 승인자는 필수입니다' });
+    }
+    const data = await departmentModel.createApprovalAuthority({
+      department_id: departmentId,
+      ...req.body
+    });
+    res.status(201).json({ success: true, data });
+  } catch (err) {
+    if (err.code === 'ER_DUP_ENTRY') {
+      return res.status(409).json({ success: false, error: '이미 등록된 승인권한입니다' });
+    }
+    next(err);
+  }
+}
+
+async function deleteApprovalAuthority(req, res, next) {
+  try {
+    const authId = parseInt(req.params.authId);
+    await departmentModel.deleteApprovalAuthority(authId);
+    res.json({ success: true, message: '승인권한이 삭제되었습니다' });
+  } catch (err) {
+    next(err);
+  }
+}
+
+module.exports = {
+  getAll, getById, create, update, remove,
+  getApprovalAuthorities, createApprovalAuthority, deleteApprovalAuthority
+};

user-management/api/controllers/vacationController.js

@@ -2,6 +2,7 @@
  * Vacation Controller
  *
  * 휴가 유형 + 연차 배정 관리
+ * Sprint 001: sso_users 기반 전환 + 장기근속
  */
 
 const vacationModel = require('../models/vacationModel');
@@ -65,20 +66,20 @@ async function getBalancesByYear(req, res, next) {
   } catch (err) { next(err); }
 }
 
-async function getBalancesByWorkerYear(req, res, next) {
+async function getBalancesByUserYear(req, res, next) {
   try {
-    const workerId = parseInt(req.params.workerId);
+    const userId = parseInt(req.params.userId);
     const year = parseInt(req.params.year);
-    const data = await vacationModel.getBalancesByWorkerYear(workerId, year);
+    const data = await vacationModel.getBalancesByUserYear(userId, year);
     res.json({ success: true, data });
   } catch (err) { next(err); }
 }
 
 async function createBalance(req, res, next) {
   try {
-    const { worker_id, vacation_type_id, year } = req.body;
-    if (!worker_id || !vacation_type_id || !year) {
-      return res.status(400).json({ success: false, error: '작업자, 휴가유형, 연도는 필수입니다' });
+    const { user_id, vacation_type_id, year } = req.body;
+    if (!user_id || !vacation_type_id || !year) {
+      return res.status(400).json({ success: false, error: '사용자, 휴가유형, 연도는 필수입니다' });
     }
     const data = await vacationModel.createBalance({ ...req.body, created_by: req.user.user_id });
     res.status(201).json({ success: true, data });
@@ -112,15 +113,33 @@ async function bulkUpsertBalances(req, res, next) {
 
 async function autoCalculate(req, res, next) {
   try {
-    const { year } = req.body;
+    const { year, departmentId } = req.body;
     if (!year) return res.status(400).json({ success: false, error: '연도는 필수입니다' });
-    const result = await vacationModel.autoCalculateForAllWorkers(year, req.user.user_id);
+    const result = await vacationModel.autoCalculateForAllUsers(year, req.user.user_id, departmentId);
     res.json({ success: true, data: result, message: `${result.count}명 자동 배정 완료` });
   } catch (err) { next(err); }
 }
 
+/* ===== 장기근속 제외 설정 ===== */
+
+async function setLongServiceExclusion(req, res, next) {
+  try {
+    const { user_id, excluded } = req.body;
+    if (!user_id || excluded === undefined) {
+      return res.status(400).json({ success: false, error: 'user_id와 excluded는 필수입니다' });
+    }
+    const { getPool } = require('../models/userModel');
+    const db = getPool();
+    await db.query(
+      'UPDATE sso_users SET long_service_excluded = ? WHERE user_id = ?',
+      [excluded ? 1 : 0, user_id]
+    );
+    res.json({ success: true, message: `장기근속 제외 설정이 ${excluded ? '활성화' : '해제'}되었습니다` });
+  } catch (err) { next(err); }
+}
+
 module.exports = {
   getVacationTypes, createVacationType, updateVacationType, deleteVacationType, updatePriorities,
-  getBalancesByYear, getBalancesByWorkerYear, createBalance, updateBalance, deleteBalance,
-  bulkUpsertBalances, autoCalculate
+  getBalancesByYear, getBalancesByUserYear, createBalance, updateBalance, deleteBalance,
+  bulkUpsertBalances, autoCalculate, setLongServiceExclusion
 };

user-management/api/controllers/vacationSettingsController.js

@@ -0,0 +1,27 @@
+/**
+ * Vacation Settings Controller
+ *
+ * 연차 계산 규칙 설정 GET/PUT
+ */
+
+const vacationSettingsModel = require('../models/vacationSettingsModel');
+
+async function getSettings(req, res, next) {
+  try {
+    const data = await vacationSettingsModel.getAll();
+    res.json({ success: true, data });
+  } catch (err) { next(err); }
+}
+
+async function updateSettings(req, res, next) {
+  try {
+    const { settings } = req.body;
+    if (!settings || !Array.isArray(settings)) {
+      return res.status(400).json({ success: false, error: 'settings 배열이 필요합니다' });
+    }
+    const data = await vacationSettingsModel.updateSettings(settings, req.user.user_id);
+    res.json({ success: true, data, message: '설정이 업데이트되었습니다' });
+  } catch (err) { next(err); }
+}
+
+module.exports = { getSettings, updateSettings };