feat: 일일순회점검 시스템 구축 및 관리 기능 개선

- 일일순회점검 시스템 신규 구현
  - DB 테이블: patrol_checklist_items, daily_patrol_sessions, patrol_check_records, workplace_items, item_types
  - API: /api/patrol/* 엔드포인트
  - 프론트엔드: 지도 기반 작업장 점검 UI

- 설비 관리 기능 개선
  - 구매 관련 필드 추가 (구매일, 가격, 공급업체 등)
  - 설비 코드 자동 생성 (TKP-XXX 형식)

- 작업장 관리 개선
  - 레이아웃 이미지 업로드 기능
  - 마커 위치 저장 기능

- 부서 관리 기능 추가
- 사이드바 네비게이션 카테고리 재구성
- 이미지 401 오류 수정 (정적 파일 경로 처리)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Hyungi Ahn
2026-02-04 11:41:41 +09:00
parent 2e9d24faf2
commit 90d3e32992
101 changed files with 17421 additions and 7047 deletions

View File

@@ -0,0 +1,241 @@
// controllers/departmentController.js
const departmentModel = require('../models/departmentModel');
const departmentController = {
// 모든 부서 조회
async getAll(req, res) {
try {
const { active_only } = req.query;
const departments = active_only === 'true'
? await departmentModel.getActive()
: await departmentModel.getAll();
res.json({
success: true,
data: departments
});
} catch (error) {
console.error('부서 목록 조회 오류:', error);
res.status(500).json({
success: false,
error: '부서 목록을 불러오는데 실패했습니다.'
});
}
},
// 부서 상세 조회
async getById(req, res) {
try {
const { id } = req.params;
const department = await departmentModel.getById(id);
if (!department) {
return res.status(404).json({
success: false,
error: '부서를 찾을 수 없습니다.'
});
}
res.json({
success: true,
data: department
});
} catch (error) {
console.error('부서 조회 오류:', error);
res.status(500).json({
success: false,
error: '부서 정보를 불러오는데 실패했습니다.'
});
}
},
// 부서 생성
async create(req, res) {
try {
const { department_name, parent_id, description, is_active, display_order } = req.body;
if (!department_name) {
return res.status(400).json({
success: false,
error: '부서명은 필수입니다.'
});
}
const departmentId = await departmentModel.create({
department_name,
parent_id,
description,
is_active,
display_order
});
const newDepartment = await departmentModel.getById(departmentId);
res.status(201).json({
success: true,
message: '부서가 생성되었습니다.',
data: newDepartment
});
} catch (error) {
console.error('부서 생성 오류:', error);
res.status(500).json({
success: false,
error: '부서 생성에 실패했습니다.'
});
}
},
// 부서 수정
async update(req, res) {
try {
const { id } = req.params;
const { department_name, parent_id, description, is_active, display_order } = req.body;
if (!department_name) {
return res.status(400).json({
success: false,
error: '부서명은 필수입니다.'
});
}
// 자기 자신을 상위 부서로 지정하는 것 방지
if (parent_id && parseInt(parent_id) === parseInt(id)) {
return res.status(400).json({
success: false,
error: '자기 자신을 상위 부서로 지정할 수 없습니다.'
});
}
const updated = await departmentModel.update(id, {
department_name,
parent_id,
description,
is_active,
display_order
});
if (!updated) {
return res.status(404).json({
success: false,
error: '부서를 찾을 수 없습니다.'
});
}
const updatedDepartment = await departmentModel.getById(id);
res.json({
success: true,
message: '부서 정보가 수정되었습니다.',
data: updatedDepartment
});
} catch (error) {
console.error('부서 수정 오류:', error);
res.status(500).json({
success: false,
error: '부서 수정에 실패했습니다.'
});
}
},
// 부서 삭제
async delete(req, res) {
try {
const { id } = req.params;
await departmentModel.delete(id);
res.json({
success: true,
message: '부서가 삭제되었습니다.'
});
} catch (error) {
console.error('부서 삭제 오류:', error);
res.status(400).json({
success: false,
error: error.message || '부서 삭제에 실패했습니다.'
});
}
},
// 부서별 작업자 조회
async getWorkers(req, res) {
try {
const { id } = req.params;
const workers = await departmentModel.getWorkersByDepartment(id);
res.json({
success: true,
data: workers
});
} catch (error) {
console.error('부서 작업자 조회 오류:', error);
res.status(500).json({
success: false,
error: '작업자 목록을 불러오는데 실패했습니다.'
});
}
},
// 작업자 부서 이동
async moveWorker(req, res) {
try {
const { workerId, departmentId } = req.body;
if (!workerId || !departmentId) {
return res.status(400).json({
success: false,
error: '작업자 ID와 부서 ID가 필요합니다.'
});
}
await departmentModel.moveWorker(workerId, departmentId);
res.json({
success: true,
message: '작업자 부서가 변경되었습니다.'
});
} catch (error) {
console.error('작업자 부서 이동 오류:', error);
res.status(500).json({
success: false,
error: '작업자 부서 변경에 실패했습니다.'
});
}
},
// 여러 작업자 부서 일괄 이동
async moveWorkers(req, res) {
try {
const { workerIds, departmentId } = req.body;
if (!workerIds || !Array.isArray(workerIds) || workerIds.length === 0) {
return res.status(400).json({
success: false,
error: '이동할 작업자를 선택하세요.'
});
}
if (!departmentId) {
return res.status(400).json({
success: false,
error: '대상 부서를 선택하세요.'
});
}
const count = await departmentModel.moveWorkers(workerIds, departmentId);
res.json({
success: true,
message: `${count}명의 작업자 부서가 변경되었습니다.`
});
} catch (error) {
console.error('작업자 일괄 이동 오류:', error);
res.status(500).json({
success: false,
error: '작업자 부서 변경에 실패했습니다.'
});
}
}
};
module.exports = departmentController;

View File

@@ -266,6 +266,11 @@ const EquipmentController = {
map_height_percent: req.body.map_height_percent
};
// workplace_id가 있으면 포함 (설비를 다른 작업장으로 이동 가능)
if (req.body.workplace_id !== undefined) {
positionData.workplace_id = req.body.workplace_id;
}
EquipmentModel.updateMapPosition(equipmentId, positionData, (error, result) => {
if (error) {
console.error('설비 위치 업데이트 오류:', error);
@@ -343,6 +348,37 @@ const EquipmentController = {
message: '서버 오류가 발생했습니다.'
});
}
},
// GET NEXT EQUIPMENT CODE - 다음 관리번호 자동 생성
getNextEquipmentCode: (req, res) => {
try {
const prefix = req.query.prefix || 'TKP';
EquipmentModel.getNextEquipmentCode(prefix, (error, nextCode) => {
if (error) {
console.error('다음 관리번호 조회 오류:', error);
return res.status(500).json({
success: false,
message: '다음 관리번호 조회 중 오류가 발생했습니다.'
});
}
res.json({
success: true,
data: {
next_code: nextCode,
prefix: prefix
}
});
});
} catch (error) {
console.error('다음 관리번호 조회 오류:', error);
res.status(500).json({
success: false,
message: '서버 오류가 발생했습니다.'
});
}
}
};

View File

@@ -0,0 +1,295 @@
// patrolController.js
// 일일순회점검 시스템 컨트롤러
const PatrolModel = require('../models/patrolModel');
const PatrolController = {
// ==================== 순회점검 세션 ====================
// 세션 시작/조회
getOrCreateSession: async (req, res) => {
try {
const { patrol_date, patrol_time, category_id } = req.body;
const inspectorId = req.user.user_id;
if (!patrol_date || !patrol_time || !category_id) {
return res.status(400).json({ success: false, message: '필수 정보가 누락되었습니다.' });
}
const session = await PatrolModel.getOrCreateSession(patrol_date, patrol_time, category_id, inspectorId);
res.json({ success: true, data: session });
} catch (error) {
console.error('세션 생성/조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 세션 상세 조회
getSession: async (req, res) => {
try {
const { sessionId } = req.params;
const session = await PatrolModel.getSession(sessionId);
if (!session) {
return res.status(404).json({ success: false, message: '세션을 찾을 수 없습니다.' });
}
res.json({ success: true, data: session });
} catch (error) {
console.error('세션 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 세션 목록 조회
getSessions: async (req, res) => {
try {
const { patrol_date, patrol_time, category_id, status, limit } = req.query;
const sessions = await PatrolModel.getSessions({
patrol_date,
patrol_time,
category_id,
status,
limit
});
res.json({ success: true, data: sessions });
} catch (error) {
console.error('세션 목록 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 세션 완료
completeSession: async (req, res) => {
try {
const { sessionId } = req.params;
await PatrolModel.completeSession(sessionId);
res.json({ success: true, message: '순회점검이 완료되었습니다.' });
} catch (error) {
console.error('세션 완료 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 세션 메모 업데이트
updateSessionNotes: async (req, res) => {
try {
const { sessionId } = req.params;
const { notes } = req.body;
await PatrolModel.updateSessionNotes(sessionId, notes);
res.json({ success: true, message: '메모가 저장되었습니다.' });
} catch (error) {
console.error('메모 저장 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// ==================== 체크리스트 항목 ====================
// 체크리스트 항목 조회
getChecklistItems: async (req, res) => {
try {
const { category_id, workplace_id } = req.query;
const items = await PatrolModel.getChecklistItems(category_id, workplace_id);
// 카테고리별로 그룹화
const grouped = {};
items.forEach(item => {
if (!grouped[item.check_category]) {
grouped[item.check_category] = [];
}
grouped[item.check_category].push(item);
});
res.json({ success: true, data: { items, grouped } });
} catch (error) {
console.error('체크리스트 항목 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 체크리스트 항목 추가
createChecklistItem: async (req, res) => {
try {
const itemId = await PatrolModel.createChecklistItem(req.body);
res.json({ success: true, data: { item_id: itemId }, message: '항목이 추가되었습니다.' });
} catch (error) {
console.error('항목 추가 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 체크리스트 항목 수정
updateChecklistItem: async (req, res) => {
try {
const { itemId } = req.params;
await PatrolModel.updateChecklistItem(itemId, req.body);
res.json({ success: true, message: '항목이 수정되었습니다.' });
} catch (error) {
console.error('항목 수정 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 체크리스트 항목 삭제
deleteChecklistItem: async (req, res) => {
try {
const { itemId } = req.params;
await PatrolModel.deleteChecklistItem(itemId);
res.json({ success: true, message: '항목이 삭제되었습니다.' });
} catch (error) {
console.error('항목 삭제 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// ==================== 체크 기록 ====================
// 작업장별 체크 기록 조회
getCheckRecords: async (req, res) => {
try {
const { sessionId } = req.params;
const { workplace_id } = req.query;
const records = await PatrolModel.getCheckRecords(sessionId, workplace_id);
res.json({ success: true, data: records });
} catch (error) {
console.error('체크 기록 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 체크 기록 저장
saveCheckRecord: async (req, res) => {
try {
const { sessionId } = req.params;
const { workplace_id, check_item_id, is_checked, check_result, note } = req.body;
if (!workplace_id || !check_item_id) {
return res.status(400).json({ success: false, message: '필수 정보가 누락되었습니다.' });
}
await PatrolModel.saveCheckRecord(sessionId, workplace_id, check_item_id, is_checked, check_result, note);
res.json({ success: true, message: '저장되었습니다.' });
} catch (error) {
console.error('체크 기록 저장 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 체크 기록 일괄 저장
saveCheckRecords: async (req, res) => {
try {
const { sessionId } = req.params;
const { workplace_id, records } = req.body;
if (!workplace_id || !records || !Array.isArray(records)) {
return res.status(400).json({ success: false, message: '필수 정보가 누락되었습니다.' });
}
await PatrolModel.saveCheckRecords(sessionId, workplace_id, records);
res.json({ success: true, message: '저장되었습니다.' });
} catch (error) {
console.error('체크 기록 일괄 저장 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// ==================== 작업장 물품 현황 ====================
// 작업장 물품 조회
getWorkplaceItems: async (req, res) => {
try {
const { workplaceId } = req.params;
const { include_inactive } = req.query;
const items = await PatrolModel.getWorkplaceItems(workplaceId, include_inactive !== 'true');
res.json({ success: true, data: items });
} catch (error) {
console.error('물품 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 물품 추가
createWorkplaceItem: async (req, res) => {
try {
const { workplaceId } = req.params;
const data = { ...req.body, workplace_id: workplaceId, created_by: req.user.user_id };
const itemId = await PatrolModel.createWorkplaceItem(data);
res.json({ success: true, data: { item_id: itemId }, message: '물품이 추가되었습니다.' });
} catch (error) {
console.error('물품 추가 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 물품 수정
updateWorkplaceItem: async (req, res) => {
try {
const { itemId } = req.params;
await PatrolModel.updateWorkplaceItem(itemId, req.body, req.user.user_id);
res.json({ success: true, message: '물품이 수정되었습니다.' });
} catch (error) {
console.error('물품 수정 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 물품 삭제
deleteWorkplaceItem: async (req, res) => {
try {
const { itemId } = req.params;
const { permanent } = req.query;
if (permanent === 'true') {
await PatrolModel.hardDeleteWorkplaceItem(itemId);
} else {
await PatrolModel.deleteWorkplaceItem(itemId, req.user.user_id);
}
res.json({ success: true, message: '물품이 삭제되었습니다.' });
} catch (error) {
console.error('물품 삭제 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// ==================== 물품 유형 ====================
// 물품 유형 목록
getItemTypes: async (req, res) => {
try {
const types = await PatrolModel.getItemTypes();
res.json({ success: true, data: types });
} catch (error) {
console.error('물품 유형 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// ==================== 대시보드/통계 ====================
// 오늘 순회점검 현황
getTodayStatus: async (req, res) => {
try {
const { category_id } = req.query;
const status = await PatrolModel.getTodayPatrolStatus(category_id);
res.json({ success: true, data: status });
} catch (error) {
console.error('오늘 현황 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
},
// 작업장별 점검 현황
getWorkplaceCheckStatus: async (req, res) => {
try {
const { sessionId } = req.params;
const status = await PatrolModel.getWorkplaceCheckStatus(sessionId);
res.json({ success: true, data: status });
} catch (error) {
console.error('작업장별 점검 현황 조회 오류:', error);
res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
}
}
};
module.exports = PatrolController;

View File

@@ -43,11 +43,17 @@ const getAllUsers = asyncHandler(async (req, res) => {
r.name as role,
u._access_level_old as access_level,
u.is_active,
u.worker_id,
w.worker_name,
w.department_id,
d.department_name,
u.created_at,
u.updated_at,
u.last_login_at as last_login
FROM users u
LEFT JOIN roles r ON u.role_id = r.id
LEFT JOIN workers w ON u.worker_id = w.worker_id
LEFT JOIN departments d ON w.department_id = d.department_id
ORDER BY u.created_at DESC
`;
@@ -218,7 +224,7 @@ const updateUser = asyncHandler(async (req, res) => {
checkAdminPermission(req.user);
const { id } = req.params;
const { username, name, email, role, role_id, password } = req.body;
const { username, name, email, role, role_id, password, worker_id } = req.body;
if (!id || isNaN(id)) {
throw new ValidationError('유효하지 않은 사용자 ID입니다');
@@ -227,7 +233,7 @@ const updateUser = asyncHandler(async (req, res) => {
logger.info('사용자 수정 요청', { userId: id, body: req.body });
// 최소 하나의 수정 필드가 필요
if (!username && !name && email === undefined && !role && !role_id && !password) {
if (!username && !name && email === undefined && !role && !role_id && !password && worker_id === undefined) {
throw new ValidationError('수정할 필드가 없습니다');
}
@@ -318,6 +324,22 @@ const updateUser = asyncHandler(async (req, res) => {
values.push(hashedPassword);
}
// worker_id 업데이트 (null도 허용 - 연결 해제)
if (worker_id !== undefined) {
if (worker_id !== null) {
// worker_id가 유효한지 확인
const [workerCheck] = await db.execute('SELECT worker_id, worker_name FROM workers WHERE worker_id = ?', [worker_id]);
if (workerCheck.length === 0) {
throw new ValidationError('유효하지 않은 작업자 ID입니다');
}
logger.info('작업자 연결', { userId: id, worker_id, worker_name: workerCheck[0].worker_name });
} else {
logger.info('작업자 연결 해제', { userId: id });
}
updates.push('worker_id = ?');
values.push(worker_id);
}
updates.push('updated_at = NOW()');
values.push(id);
@@ -476,6 +498,69 @@ const deleteUser = asyncHandler(async (req, res) => {
}
});
/**
* 사용자 영구 삭제 (Hard Delete)
*/
const permanentDeleteUser = asyncHandler(async (req, res) => {
checkAdminPermission(req.user);
const { id } = req.params;
if (!id || isNaN(id)) {
throw new ValidationError('유효하지 않은 사용자 ID입니다');
}
// 자기 자신 삭제 방지
if (req.user && req.user.user_id == id) {
throw new ValidationError('자기 자신은 삭제할 수 없습니다');
}
logger.info('사용자 영구 삭제 요청', { userId: id });
const { getDb } = require('../dbPool');
const db = await getDb();
try {
// 사용자 존재 확인
const checkQuery = 'SELECT user_id, username FROM users WHERE user_id = ?';
const [users] = await db.execute(checkQuery, [id]);
if (users.length === 0) {
throw new NotFoundError('사용자를 찾을 수 없습니다');
}
const username = users[0].username;
// 관련 데이터 삭제 (외래 키 제약 조건 때문에 순서 중요)
// 1. 로그인 로그 삭제
await db.execute('DELETE FROM login_logs WHERE user_id = ?', [id]);
// 2. 페이지 접근 권한 삭제
await db.execute('DELETE FROM user_page_access WHERE user_id = ?', [id]);
// 3. 사용자 삭제
await db.execute('DELETE FROM users WHERE user_id = ?', [id]);
logger.info('사용자 영구 삭제 성공', {
userId: id,
username: username,
deletedBy: req.user.username
});
res.json({
success: true,
data: { user_id: id },
message: `사용자 "${username}"이(가) 영구적으로 삭제되었습니다`
});
} catch (error) {
if (error instanceof NotFoundError || error instanceof ValidationError) {
throw error;
}
logger.error('사용자 영구 삭제 실패', { userId: id, error: error.message });
throw new DatabaseError('사용자를 영구 삭제하는데 실패했습니다');
}
});
/**
* 사용자의 페이지 접근 권한 조회
*/
@@ -647,6 +732,7 @@ module.exports = {
updateUser,
updateUserStatus,
deleteUser,
permanentDeleteUser,
getUserPageAccess,
updateUserPageAccess,
resetUserPassword

View File

@@ -73,9 +73,9 @@ exports.createWorker = asyncHandler(async (req, res) => {
* 전체 작업자 조회 (캐싱 및 페이지네이션 적용)
*/
exports.getAllWorkers = asyncHandler(async (req, res) => {
const { page = 1, limit = 10, search = '', status = '' } = req.query;
const { page = 1, limit = 10, search = '', status = '', department_id = null } = req.query;
const cacheKey = cache.createKey('workers', 'list', page, limit, search, status);
const cacheKey = cache.createKey('workers', 'list', page, limit, search, status, department_id);
// 캐시에서 조회
const cachedData = await cache.get(cacheKey);
@@ -90,7 +90,7 @@ exports.getAllWorkers = asyncHandler(async (req, res) => {
}
// 최적화된 쿼리 사용
const result = await optimizedQueries.getWorkersPaged(page, limit, search, status);
const result = await optimizedQueries.getWorkersPaged(page, limit, search, status, department_id);
// 캐시에 저장 (5분)
await cache.set(cacheKey, result, cache.TTL.MEDIUM);