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>

user-management/web/index.html

@@ -61,6 +61,9 @@
                 <button class="tab-btn px-4 py-2 rounded-lg text-sm font-medium whitespace-nowrap" onclick="switchTab('vacations')">
                     <i class="fas fa-umbrella-beach mr-2"></i>휴가
                 </button>
+                <button class="tab-btn px-4 py-2 rounded-lg text-sm font-medium whitespace-nowrap" onclick="switchTab('partners')">
+                    <i class="fas fa-truck mr-2"></i>협력업체
+                </button>
             </div>
         </div>
     </nav>
@@ -191,6 +194,22 @@
                         </div>
                         <div id="dept-s3-perms" class="p-4 border border-t-0 border-purple-100 rounded-b-lg space-y-4"></div>
                     </div>
+                    <!-- tkpurchase - 구매 관리 -->
+                    <div class="system-section tkpurchase rounded-lg mb-5 bg-white">
+                        <div class="flex items-center justify-between px-4 py-3 bg-green-50 rounded-t-lg border border-green-100">
+                            <div class="flex items-center gap-2">
+                                <i class="fas fa-truck text-green-500"></i>
+                                <span class="font-semibold text-sm text-green-900">구매 관리</span>
+                                <span class="text-xs text-green-500 bg-green-100 px-2 py-0.5 rounded-full">tkpurchase</span>
+                            </div>
+                            <div class="flex gap-2">
+                                <button onclick="toggleDeptSystemAll('tkpurchase', true)" class="text-xs text-green-600 hover:underline">전체 허용</button>
+                                <span class="text-gray-300">|</span>
+                                <button onclick="toggleDeptSystemAll('tkpurchase', false)" class="text-xs text-green-600 hover:underline">전체 해제</button>
+                            </div>
+                        </div>
+                        <div id="dept-tkpurchase-perms" class="p-4 border border-t-0 border-green-100 rounded-b-lg space-y-4"></div>
+                    </div>
                     <!-- 저장 -->
                     <div class="flex items-center gap-3 pt-2">
                         <button id="saveDeptPermBtn" class="px-6 py-2.5 bg-slate-700 text-white rounded-lg hover:bg-slate-800 text-sm font-medium">
@@ -250,6 +269,23 @@
                         <div id="s3-perms" class="p-4 border border-t-0 border-purple-100 rounded-b-lg space-y-4"></div>
                     </div>
 
+                    <!-- tkpurchase - 구매 관리 -->
+                    <div class="system-section tkpurchase rounded-lg mb-5 bg-white">
+                        <div class="flex items-center justify-between px-4 py-3 bg-green-50 rounded-t-lg border border-green-100">
+                            <div class="flex items-center gap-2">
+                                <i class="fas fa-truck text-green-500"></i>
+                                <span class="font-semibold text-sm text-green-900">구매 관리</span>
+                                <span class="text-xs text-green-500 bg-green-100 px-2 py-0.5 rounded-full">tkpurchase</span>
+                            </div>
+                            <div class="flex gap-2">
+                                <button onclick="toggleSystemAll('tkpurchase', true)" class="text-xs text-green-600 hover:underline">전체 허용</button>
+                                <span class="text-gray-300">|</span>
+                                <button onclick="toggleSystemAll('tkpurchase', false)" class="text-xs text-green-600 hover:underline">전체 해제</button>
+                            </div>
+                        </div>
+                        <div id="tkpurchase-perms" class="p-4 border border-t-0 border-green-100 rounded-b-lg space-y-4"></div>
+                    </div>
+
                     <!-- 저장 버튼 -->
                     <div class="flex items-center gap-3 pt-2">
                         <button id="savePermissionsBtn" class="px-6 py-2.5 bg-slate-700 text-white rounded-lg hover:bg-slate-800 text-sm font-medium">
@@ -1382,6 +1418,36 @@
         </div>
     </div>
 
+    <!-- ============ 협력업체 탭 ============ -->
+        <div id="tab-partners" class="hidden">
+            <div class="grid lg:grid-cols-5 gap-6">
+                <!-- 업체 목록 -->
+                <div class="lg:col-span-2 bg-white rounded-xl shadow-sm p-5">
+                    <h2 class="text-base font-semibold text-gray-800 mb-4"><i class="fas fa-building text-emerald-500 mr-2"></i>협력업체</h2>
+                    <div class="flex gap-2 mb-3">
+                        <input type="text" id="partnerSearchTkuser" class="input-field flex-1 px-3 py-1.5 rounded-lg text-sm" placeholder="업체명/사업자번호 검색">
+                        <select id="partnerFilterActiveTkuser" class="input-field px-2 py-1.5 rounded-lg text-sm">
+                            <option value="true">활성</option>
+                            <option value="">전체</option>
+                            <option value="false">비활성</option>
+                        </select>
+                    </div>
+                    <div id="partnersListTkuser" class="space-y-2 max-h-[65vh] overflow-y-auto">
+                        <p class="text-gray-400 text-center py-4 text-sm">탭을 선택하면 데이터를 불러옵니다.</p>
+                    </div>
+                </div>
+                <!-- 업체 상세 -->
+                <div class="lg:col-span-3">
+                    <div id="partnerDetailTkuser" class="hidden"></div>
+                    <div id="partnerEmptyTkuser" class="text-center text-gray-400 py-16">
+                        <i class="fas fa-building text-4xl mb-3"></i>
+                        <p>업체를 선택하면 상세 정보를 볼 수 있습니다</p>
+                        <p class="text-xs mt-2">협력업체 등록/수정은 <a href="https://tkpurchase.technicalkorea.net/partner.html" target="_blank" class="text-emerald-600 underline">tkpurchase</a>에서 관리합니다.</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
     <!-- 사진 확대 모달 -->
     <div id="photoViewModal" class="fixed inset-0 bg-black bg-opacity-80 hidden z-[60] flex items-center justify-center p-4 cursor-pointer" onclick="this.classList.add('hidden')">
         <img id="photoViewImage" class="max-w-full max-h-[90vh] rounded-lg shadow-2xl">
@@ -1400,6 +1466,7 @@
     <script src="/static/js/tkuser-tasks.js?v=20260224"></script>
     <script src="/static/js/tkuser-vacations.js?v=20260224"></script>
     <script src="/static/js/tkuser-layout-map.js?v=20260305"></script>
+    <script src="/static/js/tkuser-partners.js?v=20260312"></script>
     <!-- Boot -->
     <script>init();</script>
 </body>

user-management/web/static/js/tkuser-partners.js

@@ -0,0 +1,131 @@
+/* ===== tkuser 협력업체 조회 (읽기 전용) ===== */
+let partnersLoaded = false;
+let partnersList = [];
+let selectedPartnerIdTkuser = null;
+
+async function loadPartnersTab() {
+    if (partnersLoaded) return;
+    partnersLoaded = true;
+    await loadPartnersList();
+}
+
+async function loadPartnersList() {
+    try {
+        const isActive = document.getElementById('partnerFilterActiveTkuser')?.value;
+        const search = document.getElementById('partnerSearchTkuser')?.value?.trim() || '';
+        const params = new URLSearchParams();
+        if (isActive !== '' && isActive !== undefined) params.set('is_active', isActive);
+        if (search) params.set('search', search);
+        const r = await api('/partners?' + params.toString());
+        partnersList = r.data || [];
+        renderPartnersListTkuser();
+    } catch (e) {
+        document.getElementById('partnersListTkuser').innerHTML = `<div class="text-red-500 text-center py-6"><i class="fas fa-exclamation-triangle text-xl"></i><p class="text-sm mt-2">${e.message}</p></div>`;
+    }
+}
+
+function renderPartnersListTkuser() {
+    const c = document.getElementById('partnersListTkuser');
+    if (!partnersList.length) {
+        c.innerHTML = '<p class="text-gray-400 text-center py-4 text-sm">등록된 협력업체가 없습니다.</p>';
+        return;
+    }
+    c.innerHTML = partnersList.map(p => {
+        const types = tryParseJsonTkuser(p.business_type) || [];
+        const typeStr = types.map(t => `<span class="px-1.5 py-0.5 rounded text-xs bg-blue-50 text-blue-600">${escHtml(t)}</span>`).join(' ');
+        const insuranceWarn = isInsuranceExpiringSoonTkuser(p.insurance_expiry);
+        return `<div class="flex items-center justify-between p-2.5 bg-gray-50 rounded-lg hover:bg-gray-100 transition-colors cursor-pointer ${selectedPartnerIdTkuser === p.id ? 'ring-2 ring-emerald-400' : ''}" onclick="selectPartnerTkuser(${p.id})">
+            <div class="flex-1 min-w-0">
+                <div class="text-sm font-medium text-gray-800 truncate">
+                    <i class="fas fa-building mr-1.5 text-gray-400 text-xs"></i>${escHtml(p.company_name)}
+                    ${!p.is_active ? '<span class="px-1.5 py-0.5 rounded text-xs bg-gray-100 text-gray-400 ml-1">비활성</span>' : ''}
+                    ${insuranceWarn ? '<span class="px-1.5 py-0.5 rounded text-xs bg-red-50 text-red-600 ml-1"><i class="fas fa-exclamation-triangle mr-0.5"></i>보험만료</span>' : ''}
+                </div>
+                <div class="text-xs text-gray-500 flex items-center gap-1.5 mt-0.5 flex-wrap">
+                    ${p.business_number ? `<span>${p.business_number}</span>` : ''}
+                    ${p.representative ? `<span>${escHtml(p.representative)}</span>` : ''}
+                    ${typeStr}
+                </div>
+            </div>
+        </div>`;
+    }).join('');
+}
+
+async function selectPartnerTkuser(id) {
+    selectedPartnerIdTkuser = id;
+    renderPartnersListTkuser();
+    try {
+        const r = await api(`/partners/${id}`);
+        const p = r.data;
+        renderPartnerDetailTkuser(p);
+        document.getElementById('partnerDetailTkuser').classList.remove('hidden');
+        document.getElementById('partnerEmptyTkuser').classList.add('hidden');
+    } catch (e) {
+        showToast('상세 조회 실패: ' + e.message, 'error');
+    }
+}
+
+function renderPartnerDetailTkuser(p) {
+    const types = tryParseJsonTkuser(p.business_type) || [];
+    const workers = p.workers || [];
+    document.getElementById('partnerDetailTkuser').innerHTML = `
+        <div class="bg-white rounded-xl shadow-sm p-5 mb-4">
+            <h3 class="text-lg font-semibold text-gray-800 mb-3">${escHtml(p.company_name)}</h3>
+            <div class="grid grid-cols-2 gap-3 text-sm">
+                <div><span class="text-gray-500">사업자번호:</span> <span class="font-medium">${escHtml(p.business_number) || '-'}</span></div>
+                <div><span class="text-gray-500">대표자:</span> <span class="font-medium">${escHtml(p.representative) || '-'}</span></div>
+                <div><span class="text-gray-500">담당자:</span> <span class="font-medium">${escHtml(p.contact_name) || '-'}</span></div>
+                <div><span class="text-gray-500">연락처:</span> <span class="font-medium">${escHtml(p.contact_phone) || '-'}</span></div>
+                <div class="col-span-2"><span class="text-gray-500">주소:</span> <span class="font-medium">${escHtml(p.address) || '-'}</span></div>
+                <div><span class="text-gray-500">업종:</span> ${types.map(t => `<span class="px-1.5 py-0.5 rounded text-xs bg-blue-50 text-blue-600">${escHtml(t)}</span>`).join(' ') || '-'}</div>
+                <div><span class="text-gray-500">산재보험:</span> <span class="font-medium">${escHtml(p.insurance_number) || '-'}</span> ${p.insurance_expiry ? `(만료: ${formatDate(p.insurance_expiry)})` : ''}</div>
+                ${p.notes ? `<div class="col-span-2"><span class="text-gray-500">비고:</span> ${escHtml(p.notes)}</div>` : ''}
+            </div>
+        </div>
+        <div class="bg-white rounded-xl shadow-sm p-5">
+            <h4 class="text-base font-semibold text-gray-800 mb-3"><i class="fas fa-users text-gray-400 mr-2"></i>소속 작업자 (${workers.length}명)</h4>
+            ${workers.length ? workers.map(w => `
+                <div class="flex items-center justify-between p-2 bg-gray-50 rounded hover:bg-gray-100 mb-1">
+                    <div>
+                        <span class="text-sm font-medium">${escHtml(w.worker_name)}</span>
+                        ${w.is_team_leader ? '<span class="px-1.5 py-0.5 rounded text-xs bg-amber-50 text-amber-600 ml-1">팀장</span>' : ''}
+                        ${!w.is_active ? '<span class="px-1.5 py-0.5 rounded text-xs bg-gray-100 text-gray-400 ml-1">비활성</span>' : ''}
+                    </div>
+                    <div class="text-xs text-gray-500 flex gap-2">
+                        ${w.position ? `<span>${escHtml(w.position)}</span>` : ''}
+                        ${w.phone ? `<span>${escHtml(w.phone)}</span>` : ''}
+                        ${w.safety_training_date ? `<span>안전교육: ${formatDate(w.safety_training_date)}</span>` : ''}
+                    </div>
+                </div>`).join('') : '<p class="text-gray-400 text-center py-4 text-sm">등록된 작업자가 없습니다</p>'}
+        </div>
+        <div class="mt-3 p-3 bg-emerald-50 rounded-lg text-sm text-emerald-700 flex items-center gap-2">
+            <i class="fas fa-info-circle"></i>
+            <span>협력업체 등록/수정은 <a href="https://tkpurchase.technicalkorea.net/partner.html" target="_blank" class="underline font-medium">tkpurchase</a>에서 관리합니다.</span>
+        </div>`;
+}
+
+function tryParseJsonTkuser(val) {
+    if (!val) return null;
+    if (Array.isArray(val)) return val;
+    try { return JSON.parse(val); } catch { return null; }
+}
+
+function isInsuranceExpiringSoonTkuser(expiry) {
+    if (!expiry) return false;
+    const exp = new Date(expiry);
+    const now = new Date();
+    const diff = (exp - now) / (1000 * 60 * 60 * 24);
+    return diff <= 30 && diff >= 0;
+}
+
+// 검색/필터 이벤트
+document.addEventListener('DOMContentLoaded', () => {
+    let searchTimeout;
+    const searchEl = document.getElementById('partnerSearchTkuser');
+    if (searchEl) searchEl.addEventListener('input', () => {
+        clearTimeout(searchTimeout);
+        searchTimeout = setTimeout(loadPartnersList, 300);
+    });
+    const filterEl = document.getElementById('partnerFilterActiveTkuser');
+    if (filterEl) filterEl.addEventListener('change', loadPartnersList);
+});

user-management/web/static/js/tkuser-tabs.js

@@ -23,4 +23,5 @@ function switchTab(name) {
     if (name === 'vacations' && !vacationsLoaded) loadVacationsTab();
     if (name === 'issueTypes' && !issueTypesLoaded) loadIssueTypes();
     if (name === 'permissions' && !permissionsTabLoaded) loadPermissionsTab();
+    if (name === 'partners' && !partnersLoaded) loadPartnersTab();
 }

user-management/web/static/js/tkuser-users.js

@@ -59,6 +59,13 @@ const SYSTEM3_PAGES = {
     ]
 };
 
+const TKPURCHASE_PAGES = {
+    '구매 관리': [
+        { key: 'purchasing_visit',   title: '방문 관리',     icon: 'fa-door-open', def: false },
+        { key: 'purchasing_partner', title: '협력업체 관리', icon: 'fa-building',  def: false },
+    ]
+};
+
 /* ===== Permissions Tab State ===== */
 let permissionsTabLoaded = false;
 
@@ -184,7 +191,7 @@ document.getElementById('permissionUserSelect').addEventListener('change', async
 async function loadUserPermissions(userId) {
     currentPermissions = {};
     currentPermSources = {};
-    const allDefs = { ...SYSTEM1_PAGES, ...SYSTEM3_PAGES };
+    const allDefs = { ...SYSTEM1_PAGES, ...SYSTEM3_PAGES, ...TKPURCHASE_PAGES };
     Object.values(allDefs).flat().forEach(p => { currentPermissions[p.key] = p.def; currentPermSources[p.key] = 'default'; });
     try {
         const result = await api(`/permissions/users/${userId}/effective-permissions`);
@@ -200,6 +207,7 @@ async function loadUserPermissions(userId) {
 function renderPermissionGrid() {
     renderSystemPerms('s1-perms', SYSTEM1_PAGES, 'blue');
     renderSystemPerms('s3-perms', SYSTEM3_PAGES, 'purple');
+    renderSystemPerms('tkpurchase-perms', TKPURCHASE_PAGES, 'green');
 }
 
 function sourceLabel(src) {
@@ -277,7 +285,8 @@ function toggleGroupAll(groupId, checked) {
 }
 
 function toggleSystemAll(prefix, checked) {
-    const containerId = prefix === 's1' ? 's1-perms' : 's3-perms';
+    const containerMap = { s1: 's1-perms', s3: 's3-perms', tkpurchase: 'tkpurchase-perms' };
+    const containerId = containerMap[prefix] || prefix + '-perms';
     document.querySelectorAll(`#${containerId} input[type="checkbox"]`).forEach(cb => {
         cb.checked = checked;
         onPermChange(cb);
@@ -294,7 +303,7 @@ document.getElementById('savePermissionsBtn').addEventListener('click', async ()
     btn.disabled = true; btn.innerHTML = '<i class="fas fa-spinner fa-spin mr-2"></i>저장 중...';
 
     try {
-        const allPages = [...Object.values(SYSTEM1_PAGES).flat(), ...Object.values(SYSTEM3_PAGES).flat()];
+        const allPages = [...Object.values(SYSTEM1_PAGES).flat(), ...Object.values(SYSTEM3_PAGES).flat(), ...Object.values(TKPURCHASE_PAGES).flat()];
         const permissions = allPages.map(p => {
             const cb = document.getElementById('perm_' + p.key);
             return { page_name: p.key, can_access: cb ? cb.checked : false };
@@ -342,7 +351,7 @@ document.addEventListener('DOMContentLoaded', () => {
 
 async function loadDeptPermissions(deptId) {
     deptPermissions = {};
-    const allDefs = { ...SYSTEM1_PAGES, ...SYSTEM3_PAGES };
+    const allDefs = { ...SYSTEM1_PAGES, ...SYSTEM3_PAGES, ...TKPURCHASE_PAGES };
     Object.values(allDefs).flat().forEach(p => { deptPermissions[p.key] = p.def; });
     try {
         const result = await api(`/permissions/departments/${deptId}/permissions`);
@@ -353,6 +362,7 @@ async function loadDeptPermissions(deptId) {
 function renderDeptPermissionGrid() {
     renderDeptSystemPerms('dept-s1-perms', SYSTEM1_PAGES, 'blue');
     renderDeptSystemPerms('dept-s3-perms', SYSTEM3_PAGES, 'purple');
+    renderDeptSystemPerms('dept-tkpurchase-perms', TKPURCHASE_PAGES, 'green');
 }
 
 function renderDeptSystemPerms(containerId, pageDef, color) {
@@ -415,7 +425,8 @@ function toggleDeptGroupAll(groupId, checked) {
 }
 
 function toggleDeptSystemAll(prefix, checked) {
-    const containerId = prefix === 's1' ? 'dept-s1-perms' : 'dept-s3-perms';
+    const containerMap = { s1: 'dept-s1-perms', s3: 'dept-s3-perms', tkpurchase: 'dept-tkpurchase-perms' };
+    const containerId = containerMap[prefix] || 'dept-' + prefix + '-perms';
     document.querySelectorAll(`#${containerId} input[type="checkbox"]`).forEach(cb => {
         cb.checked = checked;
         onDeptPermChange(cb);
@@ -430,7 +441,7 @@ async function saveDeptPermissions() {
     btn.disabled = true; btn.innerHTML = '<i class="fas fa-spinner fa-spin mr-2"></i>저장 중...';
 
     try {
-        const allPages = [...Object.values(SYSTEM1_PAGES).flat(), ...Object.values(SYSTEM3_PAGES).flat()];
+        const allPages = [...Object.values(SYSTEM1_PAGES).flat(), ...Object.values(SYSTEM3_PAGES).flat(), ...Object.values(TKPURCHASE_PAGES).flat()];
         const permissions = allPages.map(p => {
             const cb = document.getElementById('dperm_' + p.key);
             return { page_name: p.key, can_access: cb ? cb.checked : false };