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>
This commit is contained in:
Hyungi Ahn
2026-03-13 15:01:44 +09:00
parent 1ad82fd52c
commit 7fd646e9ba
102 changed files with 1446 additions and 94 deletions

View File

@@ -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);

View File

@@ -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;

View File

@@ -154,7 +154,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-checklist.js"></script>
<script>initChecklistPage();</script>
</body>

View File

@@ -187,7 +187,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-education.js?v=20260313"></script>
<script>initEducationPage();</script>
</body>

View File

@@ -103,7 +103,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-entry-dashboard.js?v=1"></script>
<script>initEntryDashboard();</script>
</body>

View File

@@ -274,7 +274,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-visit.js?v=20260313"></script>
<script>initVisitPage();</script>
</body>

41
tksafety/web/push-sw.js Normal file
View File

@@ -0,0 +1,41 @@
// Push Notification Service Worker
// 캐싱 없음 — Push 수신 전용
self.addEventListener('push', function(event) {
var data = { title: '알림', body: '새 알림이 있습니다.', url: '/' };
if (event.data) {
try { data = Object.assign(data, event.data.json()); } catch(e) {}
}
event.waitUntil(
self.registration.showNotification(data.title, {
body: data.body,
icon: '/static/img/icon-192.png',
badge: '/static/img/badge-72.png',
data: { url: data.url || '/' },
tag: 'tk-notification-' + Date.now(),
renotify: true
})
);
// 메인 페이지에 뱃지 갱신 신호 전송
self.clients.matchAll({ type: 'window' }).then(function(clients) {
clients.forEach(function(client) {
client.postMessage({ type: 'NOTIFICATION_RECEIVED' });
});
});
});
self.addEventListener('notificationclick', function(event) {
event.notification.close();
var url = (event.notification.data && event.notification.data.url) || '/';
event.waitUntil(
self.clients.matchAll({ type: 'window' }).then(function(clients) {
for (var i = 0; i < clients.length; i++) {
if (clients[i].url.includes(self.location.origin)) {
clients[i].navigate(url);
return clients[i].focus();
}
}
return self.clients.openWindow(url);
})
);
});

View File

@@ -1,6 +1,8 @@
/* ===== 서비스 워커 해제 ===== */
/* ===== 서비스 워커 해제 (push-sw.js 제외) ===== */
if ('serviceWorker' in navigator) {
navigator.serviceWorker.getRegistrations().then(function(regs) { regs.forEach(function(r) { r.unregister(); }); });
navigator.serviceWorker.getRegistrations().then(function(regs) { regs.forEach(function(r) {
if (!r.active || !r.active.scriptURL.includes('push-sw.js')) { r.unregister(); }
}); });
if (typeof caches !== 'undefined') { caches.keys().then(function(ns) { ns.forEach(function(n) { caches.delete(n); }); }); }
}
@@ -134,6 +136,17 @@ function initAuth() {
if (nameEl) nameEl.textContent = dn;
if (avatarEl) avatarEl.textContent = dn.charAt(0).toUpperCase();
renderNavbar();
// 알림 벨 로드
_loadNotificationBell();
setTimeout(() => document.querySelector('.fade-in')?.classList.add('visible'), 50);
return true;
}
/* ===== 알림 벨 ===== */
function _loadNotificationBell() {
const s = document.createElement('script');
s.src = (location.hostname.includes('technicalkorea.net') ? 'https://tkfb.technicalkorea.net' : location.protocol + '//' + location.hostname + ':30000') + '/shared/notification-bell.js?v=1';
document.head.appendChild(s);
}

View File

@@ -133,7 +133,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-training.js"></script>
<script>initTrainingPage();</script>
</body>

View File

@@ -181,7 +181,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-visit-management.js?v=2"></script>
<script>initVisitManagementPage();</script>
</body>

View File

@@ -145,7 +145,7 @@
</div>
</div>
<script src="/static/js/tksafety-core.js?v=2"></script>
<script src="/static/js/tksafety-core.js?v=3"></script>
<script src="/static/js/tksafety-visit-request.js?v=2"></script>
<script>initVisitRequestPage();</script>
</body>