feat: tkpurchase 시스템 Phase 1 - 협력업체 마스터 + 당일 방문 관리

신규 독립 시스템 tkpurchase (구매/방문 관리) 구축:
- 협력업체 CRUD + 소속 작업자 관리 (마스터 데이터 소유)
- 당일 방문 등록/체크인/체크아웃 + 일괄 마감
- 업체 자동완성, CSV 내보내기, 집계 통계
- 자정 자동 체크아웃 (node-cron)
- tkuser 협력업체 읽기 전용 탭 + 권한 그리드(tkpurchase-perms) 추가
- docker-compose에 tkpurchase-api/web 서비스 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Hyungi Ahn
2026-03-12 15:45:37 +09:00
parent 5b1b89254c
commit 281f5d35d1
29 changed files with 2641 additions and 7 deletions

View File

@@ -0,0 +1,136 @@
const dailyVisitModel = require('../models/dailyVisitModel');
const PURPOSE_LABELS = {
day_labor: '일용공', equipment_repair: '설비수리', inspection: '검사',
delivery: '납품/배송', safety_audit: '안전점검', client_audit: '고객심사',
construction: '공사', other: '기타'
};
async function today(req, res) {
try {
const [visits, stats] = await Promise.all([
dailyVisitModel.findToday(),
dailyVisitModel.getTodayStats()
]);
res.json({ success: true, data: { visits, stats } });
} catch (err) {
console.error('Today visits error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function list(req, res) {
try {
const rows = await dailyVisitModel.findAll(req.query);
res.json({ success: true, data: rows });
} catch (err) {
console.error('Visit list error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function create(req, res) {
try {
const { visitor_name, purpose, company_id, company_name } = req.body;
if (!visitor_name || !visitor_name.trim()) {
return res.status(400).json({ success: false, error: '방문자명은 필수입니다' });
}
if (!purpose) {
return res.status(400).json({ success: false, error: '방문 목적은 필수입니다' });
}
if (!company_id && (!company_name || !company_name.trim())) {
return res.status(400).json({ success: false, error: '업체를 선택하거나 업체명을 입력해주세요' });
}
const userId = req.user.user_id || req.user.id;
const visit = await dailyVisitModel.create({ ...req.body, registered_by: userId });
res.status(201).json({ success: true, data: visit });
} catch (err) {
console.error('Visit create error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function update(req, res) {
try {
const visit = await dailyVisitModel.update(req.params.id, req.body);
if (!visit) return res.status(404).json({ success: false, error: '방문 기록을 찾을 수 없습니다' });
res.json({ success: true, data: visit });
} catch (err) {
console.error('Visit update error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function checkout(req, res) {
try {
const visit = await dailyVisitModel.checkout(req.params.id, req.body.checkout_note);
if (!visit) return res.status(404).json({ success: false, error: '방문 기록을 찾을 수 없습니다' });
res.json({ success: true, data: visit });
} catch (err) {
console.error('Checkout error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function bulkCheckout(req, res) {
try {
const result = await dailyVisitModel.bulkCheckout();
res.json({ success: true, data: { affected: result.affectedRows } });
} catch (err) {
console.error('Bulk checkout error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function deleteVisit(req, res) {
try {
await dailyVisitModel.deleteVisit(req.params.id);
res.json({ success: true, message: '삭제 완료' });
} catch (err) {
console.error('Visit delete error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function stats(req, res) {
try {
const data = await dailyVisitModel.getStats(req.query);
res.json({ success: true, data });
} catch (err) {
console.error('Stats error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
async function exportCsv(req, res) {
try {
const rows = await dailyVisitModel.exportCsv(req.query);
const BOM = '\uFEFF';
const header = '방문일,업체,방문자,인원,목적,상세,작업장,안전교육,차량번호,체크인,체크아웃,상태,담당부서,비고';
const lines = rows.map(r => [
r.visit_date ? String(r.visit_date).substring(0, 10) : '',
`"${(r.company || '').replace(/"/g, '""')}"`,
`"${(r.visitor_name || '').replace(/"/g, '""')}"`,
r.visitor_count || 1,
PURPOSE_LABELS[r.purpose] || r.purpose,
`"${(r.purpose_detail || '').replace(/"/g, '""')}"`,
`"${(r.workplace_name || '').replace(/"/g, '""')}"`,
r.safety_education_yn ? 'Y' : 'N',
r.vehicle_number || '',
r.check_in_time || '',
r.check_out_time || '',
r.status,
r.managing_department || '',
`"${(r.notes || '').replace(/"/g, '""')}"`
].join(','));
res.setHeader('Content-Type', 'text/csv; charset=utf-8');
res.setHeader('Content-Disposition', 'attachment; filename=visits.csv');
res.send(BOM + header + '\n' + lines.join('\n'));
} catch (err) {
console.error('Export error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
module.exports = { today, list, create, update, checkout, bulkCheckout, deleteVisit, stats, exportCsv };

View File

@@ -0,0 +1,147 @@
const partnerModel = require('../models/partnerModel');
// 업체 목록
async function list(req, res) {
try {
const { search, is_active } = req.query;
const rows = await partnerModel.findAll({
search,
is_active: is_active !== undefined ? is_active === 'true' || is_active === '1' : undefined
});
res.json({ success: true, data: rows });
} catch (err) {
console.error('Partner list error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 업체 상세 (작업자 포함)
async function getById(req, res) {
try {
const company = await partnerModel.findById(req.params.id);
if (!company) return res.status(404).json({ success: false, error: '업체를 찾을 수 없습니다' });
const workers = await partnerModel.findWorkersByCompany(req.params.id);
res.json({ success: true, data: { ...company, workers } });
} catch (err) {
console.error('Partner get error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 업체 등록
async function create(req, res) {
try {
const { company_name } = req.body;
if (!company_name || !company_name.trim()) {
return res.status(400).json({ success: false, error: '업체명은 필수입니다' });
}
const company = await partnerModel.create(req.body);
res.status(201).json({ success: true, data: company });
} catch (err) {
if (err.code === 'ER_DUP_ENTRY') {
return res.status(400).json({ success: false, error: '이미 등록된 사업자번호입니다' });
}
console.error('Partner create error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 업체 수정
async function update(req, res) {
try {
const company = await partnerModel.update(req.params.id, req.body);
if (!company) return res.status(404).json({ success: false, error: '업체를 찾을 수 없습니다' });
res.json({ success: true, data: company });
} catch (err) {
if (err.code === 'ER_DUP_ENTRY') {
return res.status(400).json({ success: false, error: '이미 등록된 사업자번호입니다' });
}
console.error('Partner update error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 업체 비활성화
async function deactivate(req, res) {
try {
await partnerModel.deactivate(req.params.id);
res.json({ success: true, message: '비활성화 완료' });
} catch (err) {
console.error('Partner deactivate error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 업체 자동완성 검색
async function searchCompanies(req, res) {
try {
const q = req.query.q || '';
if (q.length < 1) return res.json({ success: true, data: [] });
const rows = await partnerModel.search(q);
res.json({ success: true, data: rows });
} catch (err) {
console.error('Partner search error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 소속 작업자 목록
async function listWorkers(req, res) {
try {
const rows = await partnerModel.findWorkersByCompany(req.params.id);
res.json({ success: true, data: rows });
} catch (err) {
console.error('Workers list error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 작업자 등록
async function createWorker(req, res) {
try {
const { worker_name, is_team_leader, phone } = req.body;
if (!worker_name || !worker_name.trim()) {
return res.status(400).json({ success: false, error: '작업자명은 필수입니다' });
}
if (is_team_leader && (!phone || !phone.trim())) {
return res.status(400).json({ success: false, error: '팀장급은 연락처 필수입니다' });
}
const worker = await partnerModel.createWorker(req.params.id, req.body);
res.status(201).json({ success: true, data: worker });
} catch (err) {
console.error('Worker create error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 작업자 수정
async function updateWorker(req, res) {
try {
const { is_team_leader, phone } = req.body;
if (is_team_leader && (!phone || !phone.trim())) {
return res.status(400).json({ success: false, error: '팀장급은 연락처 필수입니다' });
}
const worker = await partnerModel.updateWorker(req.params.id, req.body);
if (!worker) return res.status(404).json({ success: false, error: '작업자를 찾을 수 없습니다' });
res.json({ success: true, data: worker });
} catch (err) {
console.error('Worker update error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
// 작업자 비활성화
async function deactivateWorker(req, res) {
try {
await partnerModel.deactivateWorker(req.params.id);
res.json({ success: true, message: '비활성화 완료' });
} catch (err) {
console.error('Worker deactivate error:', err);
res.status(500).json({ success: false, error: err.message });
}
}
module.exports = {
list, getById, create, update, deactivate, searchCompanies,
listWorkers, createWorker, updateWorker, deactivateWorker
};