diff --git a/PLAN_ASSET_HISTORY.md b/PLAN_ASSET_HISTORY.md new file mode 100644 index 0000000..a9f1065 --- /dev/null +++ b/PLAN_ASSET_HISTORY.md @@ -0,0 +1,60 @@ +# 자산 이력 누적 관리 시스템 (Cumulative Asset History System) 구현 계획 + +본 문서는 자산의 라이프사이클(조직, 사용자, 용도, 상태 변동)을 체계적으로 추적하고 누적 관리하기 위한 기술적 설계 및 단계별 구현 계획을 담고 있습니다. + +## 1. 목적 +- 자산 정보 수정 시 중요 변경 사항을 자동으로 감지하여 이력(Log)화 +- 과거부터 현재까지의 변동 사항을 타임라인 형태로 시각화하여 자산 흐름 파악 +- 데이터 정합성을 위해 서버 측에서 변경 전/후 스냅샷 비교 방식 채택 + +## 2. 관리 대상 이력 (Watch Fields) +다음 항목의 변경이 발생할 경우 이력을 자동 생성합니다. +1. **조직 변동**: `current_dept` (현 사용조직) ↔ `previous_dept` 업데이트 포함 +2. **사용자 변동**: `user_current` (현 사용자) ↔ `previous_user` 업데이트 포함 +3. **용도 변경**: `asset_type`, `current_role` (예: 개인PC -> 공용PC) +4. **상태 변경**: `hw_status` (예: 운영 -> 수리, 재고 -> 폐기 등) + +## 3. 기술 설계 (Technical Design) + +### A. 데이터베이스 (DB) +- **대상 테이블**: `asset_history` +- **컬럼 구조 활용 및 보완**: + - `asset_id`: 대상 자산 식별자 + - `event_type`: 변경 유형 (DEPT_CHANGE, USER_CHANGE, ROLE_CHANGE, STATUS_CHANGE) + - `details`: "상태 변경: 운영 -> 수리" 와 같이 읽기 쉬운 문자열 저장 + - `cost`: 관련 비용 발생 시 기록 (수리비 등) + - `log_user`: 변경을 수행한 작업자 + - `log_date`: 변경 발생 일시 + +### B. 백엔드 (Server-side Logic) +- **위치**: `server.js` 의 `POST /api/asset/:category/save` 엔드포인트 +- **동작 흐름**: + 1. **Snapshot**: 인서트/업데이트 수행 전, 기존 DB의 데이터를 `SELECT`하여 메모리에 저장. + 2. **Comparison**: 요청된 신규 데이터와 기존 데이터를 필드별로 대조. + 3. **Auto-logging**: 변경점이 발견되면 `asset_history` 테이블에 즉시 인서트. + 4. **Transaction**: 모든 로그 생성이 자산 저장과 하나의 트랜잭션으로 묶여야 함. + +### C. 프론트엔드 (UI/UX) +- **위치**: `HWModal.ts` 우측 `modal-history-area` +- **개선 사항**: + - `renderHistory()` 함수를 고도화하여 이벤트 타입별 아이콘/컬러 적용. + - "이전 값 ➔ 이후 값" 형태의 직관적인 레이아웃 도입. + - 스크롤을 통한 무제한 누적 이력 조회 지원. + +## 4. 단계별 구현 로직 + +### 1단계: 서버 로직 고도화 +- `server.js`에 비교 함수(`compareAndLog`) 구현. +- 각 자산 카테고리별 저장 로직에 비교 로직 삽입. + +### 2단계: DB 데이터 마이그레이션 (필요시) +- 기존 자산의 `current_dept` 등을 `previous_dept`로 밀어내는 로직 점검. + +### 3단계: UI 타임라인 렌더링 개선 +- `modal.css`에 이력 전용 스타일(이벤트 뱃지 등) 추가. +- `HWModal.ts`에서 최신 로그를 실시간으로 다시 불러오는 로직 확인. + +## 5. 검증 계획 +- **자동 감지 테스트**: 상태 변경 후 저장 시 우측 이력에 즉시 한 줄이 추가되는지 확인. +- **다중 변경 테스트**: 조직과 사용자를 동시에 변경했을 때 두 개의 로그가 생성되는지 확인. +- **데이터 무결성**: 수정을 취소하거나 저장 실패 시 로그가 남지 않는지(Transaction) 확인. diff --git a/check_logs.js b/check_logs.js new file mode 100644 index 0000000..d14cdb7 --- /dev/null +++ b/check_logs.js @@ -0,0 +1,28 @@ +import mysql from 'mysql2/promise'; +import dotenv from 'dotenv'; + +dotenv.config(); + +const { DB_HOST, DB_USER, DB_PASS, DB_NAME, DB_PORT } = process.env; + +async function checkRecentLogs() { + const connection = await mysql.createConnection({ + host: DB_HOST, + user: DB_USER, + password: DB_PASS, + database: DB_NAME, + port: parseInt(DB_PORT || '3306') + }); + + console.log('--- Recent History Logs ---'); + const [rows] = await connection.query('SELECT * FROM asset_history ORDER BY created_at DESC LIMIT 5'); + console.log(JSON.stringify(rows, null, 2)); + + console.log('\n--- Recent Core Data (to check current_dept) ---'); + const [coreRows] = await connection.query('SELECT id, asset_code, current_dept, previous_dept FROM asset_core ORDER BY updated_at DESC LIMIT 5'); + console.log(JSON.stringify(coreRows, null, 2)); + + await connection.end(); +} + +checkRecentLogs().catch(console.error); diff --git a/probe_db.js b/probe_db.js new file mode 100644 index 0000000..777b08f --- /dev/null +++ b/probe_db.js @@ -0,0 +1,36 @@ +import mysql from 'mysql2/promise'; +import dotenv from 'dotenv'; + +dotenv.config(); + +const { DB_HOST, DB_USER, DB_PASS, DB_NAME, DB_PORT } = process.env; + +async function probeDB() { + const connection = await mysql.createConnection({ + host: DB_HOST, + user: DB_USER, + password: DB_PASS, + database: DB_NAME, + port: parseInt(DB_PORT || '3306') + }); + + console.log('--- Database Probe Start ---'); + + const [tables] = await connection.query('SHOW TABLES'); + const tableNames = tables.map(t => Object.values(t)[0]); + + console.log('Existing Tables:', tableNames); + + for (const table of tableNames) { + const [columns] = await connection.query(`DESCRIBE ${table}`); + console.log(`\n[Table: ${table}]`); + columns.forEach(c => { + console.log(` - ${c.Field} (${c.Type}) ${c.Comment ? '// ' + c.Comment : ''}`); + }); + } + + await connection.end(); + console.log('\n--- Database Probe End ---'); +} + +probeDB().catch(console.error); diff --git a/server.js b/server.js index b2772af..57d6499 100644 --- a/server.js +++ b/server.js @@ -170,6 +170,86 @@ app.post('/api/asset/:category/save', async (req, res) => { connection = await pool.getConnection(); await connection.beginTransaction(); + // 3.0 History Tracking & Auto Field Update + const [oldCoreRows] = await connection.query('SELECT * FROM asset_core WHERE id = ?', [asset.id]); + const [oldSpecRows] = await connection.query('SELECT * FROM asset_spec WHERE asset_id = ?', [asset.id]); + const oldCore = oldCoreRows[0] || {}; + const oldSpec = oldSpecRows[0] || {}; + + console.log(`🔍 [History Check] ID: ${asset.id}`); + console.log(` - Dept: [${oldCore.current_dept}] -> [${asset.current_dept}]`); + console.log(` - User: [${oldCore.user_current}] -> [${asset.user_current}]`); + + const historyLogs = []; + const logDate = new Date().toISOString().split('T')[0]; // YYYY-MM-DD + const logUser = '관리자'; + + // 조직 변동 감지 (null/undefined/empty string 세이프 처리) + const oldDept = oldCore.current_dept || ''; + const newDept = asset.current_dept || ''; + if (newDept !== '' && oldDept !== newDept) { + asset.previous_dept = oldDept; + historyLogs.push({ + event_type: 'DEPT_CHANGE', + old_dept: oldDept || null, + new_dept: newDept, + details: `[조직 변동] ${oldDept || '(없음)'} -> ${newDept}` + }); + } + + // 사용자 변동 감지 + const oldUser = oldCore.user_current || ''; + const newUser = asset.user_current || ''; + if (newUser !== '' && oldUser !== newUser) { + asset.previous_user = oldUser; + historyLogs.push({ + event_type: 'USER_CHANGE', + old_user: oldUser || null, + new_user: newUser, + details: `[사용자 변동] ${oldUser || '(없음)'} -> ${newUser}` + }); + } + + // 유형/용도 변경 감지 + const oldType = oldCore.asset_type || ''; + const newType = asset.asset_type || ''; + if (newType !== '' && oldType !== newType) { + historyLogs.push({ + event_type: 'ROLE_CHANGE', + details: `[유형 변경] ${oldType || '(없음)'} -> ${newType}` + }); + } + + const oldRole = oldCore.current_role || ''; + const newRole = asset.current_role || ''; + if (newRole !== '' && oldRole !== newRole) { + historyLogs.push({ + event_type: 'ROLE_CHANGE', + details: `[용도 변경] ${oldRole || '(없음)'} -> ${newRole}` + }); + } + + // 상태 변경 감지 + const oldStatus = oldSpec.hw_status || ''; + const newStatus = asset.hw_status || ''; + if (newStatus !== '' && oldStatus !== newStatus) { + historyLogs.push({ + event_type: 'STATUS_CHANGE', + details: `[상태 변경] ${oldStatus || '(없음)'} -> ${newStatus}` + }); + } + + console.log(` - Logs Generated: ${historyLogs.length}`); + + // 로그 일괄 삽입 + for (const log of historyLogs) { + await connection.query( + `INSERT INTO asset_history (asset_id, event_type, old_dept, new_dept, old_user, new_user, details, log_date, log_user) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, + [asset.id, log.event_type, log.old_dept || null, log.new_dept || null, log.old_user || null, log.new_user || null, log.details, logDate, logUser] + ); + } + // 3.1 asset_core const coreFields = ['id', 'asset_code', 'category', 'asset_type', 'current_role', 'asset_purpose', 'service_type', 'purchase_corp', 'purchase_date', 'purchase_amount', 'purchase_vendor', 'approval_document', 'memo', 'manager_primary', 'manager_secondary', 'current_dept', 'previous_dept', 'user_current', 'previous_user', 'emp_no', 'user_position']; const coreData = {}; diff --git a/src/components/Modal/BaseModal.ts b/src/components/Modal/BaseModal.ts index bbf6efb..09645ea 100644 --- a/src/components/Modal/BaseModal.ts +++ b/src/components/Modal/BaseModal.ts @@ -55,6 +55,9 @@ export abstract class BaseModal { this.currentAsset = asset; this.isEditMode = (mode === 'add' || mode === 'edit'); + // 폼 초기화 추가 + if (this.formEl) this.formEl.reset(); + this.setEditLockMode(mode); this.fillFormData(asset); diff --git a/src/components/Modal/HWModal.ts b/src/components/Modal/HWModal.ts index 5a59bb6..6dbe5e5 100644 --- a/src/components/Modal/HWModal.ts +++ b/src/components/Modal/HWModal.ts @@ -67,6 +67,17 @@ class HwAssetModal extends BaseModal { +