엑셀 원본 파일의 자유로운 교체와 WSL 경로 변환 자동화 시스템 구축 #11

New Issue

Hyein · 2026-03-24T13:25:18+09:00

Hyein commented

2026-03-24 13:25:18 +09:00

1. 발생 배경 및 문제점

기존 시스템은 PTC(2023-2026.02).xlsx라는 특정 파일명이 서버 코드(ptc_api_server.py)에 하드코딩되어 있었습니다. 이로 인해 다음과 같은 심각한 운영상 제약이 발생했습니다.

파일명 변경 불가: 새로운 월의 데이터가 들어와 파일명이 바뀌면 개발자가 코드를 직접 수정해야 함.
경로 불일치: 서버는 WSL(Linux) 환경에서 돌고 있는데, 사용자는 Windows 탐색기 경로(C:\Users\...)를 사용하므로 경로 인식이 불가능함.
데이터 갱신 지연: 원본 파일이 업데이트되어도 서버를 껐다 켜기 전까지는 DB에 반영되지 않는 문제.

2. 해결 방법 및 작업 내용

이 문제를 해결하기 위해 **"설정 파일 기반의 동적 로드"**와 **"Windows 전용 경로 변환 헬퍼"**를 도입했습니다.

외부 설정 파일 도입: server/ptc_source_path.txt를 생성하여 서버가 실행될 때 이 파일에 적힌 경로를 최우선으로 읽도록 get_xlsx_path() 로직을 설계함.
Windows용 GUI 유틸리티 개발: windows/set_ptc_source.bat 파일을 제작하여 사용자가 마우스 클릭으로 엑셀 파일을 선택하면, 내부적으로 wslpath 명령어를 호출해 Linux용 경로로 자동 변환하여 저장하도록 구현함.
파일 시그니처 감지: 단순히 경로만 보는 것이 아니라 파일의 수정 시간(mtime)을 체크하여, 파일이 바뀌었을 때만 DB를 초기화하고 다시 적재하는 스마트 업데이트 로직을 추가함.

3. 도입 결과

이제 IT 지식이 없는 일반 사용자도 .bat 실행 한 번으로 분석 대상 엑셀 파일을 자유롭게 바꿀 수 있게 되었습니다.
Windows와 WSL 간의 복잡한 경로 문제를 완벽하게 은폐하여 운영 실수를 원천 차단했습니다.

### 1. 발생 배경 및 문제점 기존 시스템은 `PTC(2023-2026.02).xlsx`라는 특정 파일명이 서버 코드(`ptc_api_server.py`)에 하드코딩되어 있었습니다. 이로 인해 다음과 같은 심각한 운영상 제약이 발생했습니다. - **파일명 변경 불가**: 새로운 월의 데이터가 들어와 파일명이 바뀌면 개발자가 코드를 직접 수정해야 함. - **경로 불일치**: 서버는 WSL(Linux) 환경에서 돌고 있는데, 사용자는 Windows 탐색기 경로(`C:\Users\...`)를 사용하므로 경로 인식이 불가능함. - **데이터 갱신 지연**: 원본 파일이 업데이트되어도 서버를 껐다 켜기 전까지는 DB에 반영되지 않는 문제. ### 2. 해결 방법 및 작업 내용 이 문제를 해결하기 위해 **"설정 파일 기반의 동적 로드"**와 **"Windows 전용 경로 변환 헬퍼"**를 도입했습니다. - **외부 설정 파일 도입**: `server/ptc_source_path.txt`를 생성하여 서버가 실행될 때 이 파일에 적힌 경로를 최우선으로 읽도록 `get_xlsx_path()` 로직을 설계함. - **Windows용 GUI 유틸리티 개발**: `windows/set_ptc_source.bat` 파일을 제작하여 사용자가 마우스 클릭으로 엑셀 파일을 선택하면, 내부적으로 `wslpath` 명령어를 호출해 Linux용 경로로 자동 변환하여 저장하도록 구현함. - **파일 시그니처 감지**: 단순히 경로만 보는 것이 아니라 파일의 수정 시간(`mtime`)을 체크하여, 파일이 바뀌었을 때만 DB를 초기화하고 다시 적재하는 스마트 업데이트 로직을 추가함. ### 3. 도입 결과 - 이제 IT 지식이 없는 일반 사용자도 `.bat` 실행 한 번으로 분석 대상 엑셀 파일을 자유롭게 바꿀 수 있게 되었습니다. - Windows와 WSL 간의 복잡한 경로 문제를 완벽하게 은폐하여 운영 실수를 원천 차단했습니다.

Hyein added the ptc 실행분석 label 2026-03-24 13:25:18 +09:00

Hyein changed title from ~~유연한 데이터 소스 관리 및 원본 설정 도구 개발~~ to [Tool] 데이터 소스 이식성 향상을 위한 동적 경로 설정 및 윈도우 유틸리티

2026-03-24 13:27:26 +09:00

Hyein changed title from ~~[Tool] 데이터 소스 이식성 향상을 위한 동적 경로 설정 및 윈도우 유틸리티~~ to [Tool] 엑셀 원본 파일의 자유로운 교체와 WSL 경로 변환 자동화 시스템 구축

2026-03-24 13:28:41 +09:00

Hyein changed title from ~~[Tool] 엑셀 원본 파일의 자유로운 교체와 WSL 경로 변환 자동화 시스템 구축~~ to 엑셀 원본 파일의 자유로운 교체와 WSL 경로 변환 자동화 시스템 구축

2026-03-24 13:30:35 +09:00

Hyein closed this issue

2026-03-24 16:53:39 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Hyein/PTC#11