feat: 실시간 알림 시스템 (Web Push + 알림 벨 + 서비스간 알림 연동)

- Phase 1: 모든 서비스 헤더에 알림 벨 UI 추가 (notification-bell.js)
- Phase 2: VAPID Web Push 구독/전송 (push-sw.js, pushSubscription API)
- Phase 3: 내부 알림 API + notifyHelper로 서비스간 알림 연동
  - tksafety: 출입 승인/반려, 안전교육 완료, 방문자 체크인
  - tkpurchase: 일용공 신청, 작업보고서 제출
  - system2-report: 신고 접수/확인/처리완료
- Phase 4: 30일 이상 알림 자동 정리 cron, Redis 캐싱
- CORS에 tkuser/tkpurchase/tksafety 서브도메인 추가
- HTML cache busting 버전 갱신

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

tksafety/api/controllers/visitRequestController.js

@@ -1,4 +1,5 @@
 const visitRequestModel = require('../models/visitRequestModel');
+const notify = require('../utils/notifyHelper');
 
 // ==================== 출입 신청 관리 ====================
 
@@ -104,6 +105,21 @@ exports.approveVisitRequest = async (req, res) => {
     if (result.affectedRows === 0) {
       return res.status(404).json({ success: false, message: '출입 신청을 찾을 수 없습니다.' });
     }
+
+    // 알림: 신청자에게 승인 알림
+    const request = await visitRequestModel.getVisitRequestById(req.params.id).catch(() => null);
+    if (request) {
+      notify.send({
+        type: 'safety',
+        title: '출입 신청 승인',
+        message: `${request.visitor_company || ''} 출입 신청이 승인되었습니다.`,
+        link_url: '/visit-request.html',
+        reference_type: 'visit_requests',
+        reference_id: parseInt(req.params.id),
+        created_by: req.user.user_id
+      });
+    }
+
     res.json({ success: true, message: '출입 신청이 승인되었습니다.' });
   } catch (err) {
     console.error('출입 신청 승인 오류:', err);
@@ -121,6 +137,21 @@ exports.rejectVisitRequest = async (req, res) => {
     if (result.affectedRows === 0) {
       return res.status(404).json({ success: false, message: '출입 신청을 찾을 수 없습니다.' });
     }
+
+    // 알림: 신청자에게 반려 알림
+    const request = await visitRequestModel.getVisitRequestById(req.params.id).catch(() => null);
+    if (request) {
+      notify.send({
+        type: 'safety',
+        title: '출입 신청 반려',
+        message: `${request.visitor_company || ''} 출입 신청이 반려되었습니다. 사유: ${rejectionData.rejection_reason}`,
+        link_url: '/visit-request.html',
+        reference_type: 'visit_requests',
+        reference_id: parseInt(req.params.id),
+        created_by: req.user.user_id
+      });
+    }
+
     res.json({ success: true, message: '출입 신청이 반려되었습니다.' });
   } catch (err) {
     console.error('출입 신청 반려 오류:', err);
@@ -273,6 +304,17 @@ exports.completeTraining = async (req, res) => {
       console.error('출입 신청 상태 업데이트 오류:', statusErr);
     }
 
+    // 알림: 안전교육 완료
+    notify.send({
+      type: 'safety',
+      title: '안전교육 완료',
+      message: '안전교육이 완료되었습니다.',
+      link_url: '/training.html',
+      reference_type: 'training_records',
+      reference_id: parseInt(trainingId),
+      created_by: req.user.user_id
+    });
+
     res.json({ success: true, message: '안전교육이 완료되었습니다.' });
   } catch (err) {
     console.error('안전교육 완료 처리 오류:', err);
@@ -326,6 +368,21 @@ exports.checkIn = async (req, res) => {
     if (result.error) {
       return res.status(result.status).json({ success: false, message: result.error });
     }
+
+    // 알림: 방문자 체크인
+    const request = await visitRequestModel.getVisitRequestById(req.params.id).catch(() => null);
+    if (request) {
+      notify.send({
+        type: 'safety',
+        title: '방문자 체크인',
+        message: `${request.visitor_company || ''} ${request.visitor_name || ''} 체크인`,
+        link_url: '/visit-management.html',
+        reference_type: 'visit_requests',
+        reference_id: parseInt(req.params.id),
+        created_by: req.user.user_id
+      });
+    }
+
     res.json({ success: true, message: '체크인되었습니다.' });
   } catch (err) {
     console.error('체크인 오류:', err);

tksafety/api/utils/notifyHelper.js

@@ -0,0 +1,63 @@
+// utils/notifyHelper.js — 공용 알림 헬퍼
+// system1-factory의 내부 알림 API를 통해 DB 저장 + Push 전송
+const http = require('http');
+
+const NOTIFY_URL = 'http://system1-api:3005/api/notifications/internal';
+const SERVICE_KEY = process.env.INTERNAL_SERVICE_KEY || '';
+
+const notifyHelper = {
+  /**
+   * 알림 전송
+   * @param {Object} opts
+   * @param {string} opts.type - 알림 유형 (safety, maintenance, repair, system)
+   * @param {string} opts.title - 알림 제목
+   * @param {string} [opts.message] - 알림 내용
+   * @param {string} [opts.link_url] - 클릭 시 이동 URL
+   * @param {string} [opts.reference_type] - 연관 테이블명
+   * @param {number} [opts.reference_id] - 연관 레코드 ID
+   * @param {number} [opts.created_by] - 생성자 user_id
+   */
+  async send(opts) {
+    try {
+      const body = JSON.stringify(opts);
+      const url = new URL(NOTIFY_URL);
+
+      return new Promise((resolve) => {
+        const req = http.request({
+          hostname: url.hostname,
+          port: url.port,
+          path: url.pathname,
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Internal-Service-Key': SERVICE_KEY,
+            'Content-Length': Buffer.byteLength(body)
+          },
+          timeout: 5000
+        }, (res) => {
+          res.resume(); // drain
+          resolve(true);
+        });
+
+        req.on('error', (err) => {
+          console.error('[notifyHelper] 알림 전송 실패:', err.message);
+          resolve(false);
+        });
+
+        req.on('timeout', () => {
+          req.destroy();
+          console.error('[notifyHelper] 알림 전송 타임아웃');
+          resolve(false);
+        });
+
+        req.write(body);
+        req.end();
+      });
+    } catch (err) {
+      console.error('[notifyHelper] 알림 전송 오류:', err.message);
+      return false;
+    }
+  }
+};
+
+module.exports = notifyHelper;