refactor: 프로젝트 전반 코드 정리 및 정적 자산 빌드 경로 수정 #24

New Issue

Taehoon · 2026-06-19T15:12:50+09:00

Taehoon commented

2026-06-19 15:12:50 +09:00

작업 개요

프로젝트의 불필요한 목업 데이터 파일을 삭제하고 중복 코드를 제거하여 빌드 용량을 최적화하였으며, 정적 자산 경로 결함으로 인해 배포 환경에서 이미지가 보이지 않던 문제를 수정했습니다.

상세 작업 내용

1. 미사용 파일 및 데드 코드(Dead Code) 제거

목업 파일 삭제: 실제 데이터베이스 연동으로 인해 더 이상 사용하지 않는 목업 데이터 파일들을 삭제했습니다.
- src/core/dummyData.ts (333 KB)
- src/core/realServerData.ts (43 KB)
- src/server_data.json (308 B)
xlsx 라이브러리 의존성 제거: src/core/excelHandler.ts 내에서 호출되지 않던 대용량 엑셀 관련 기능들을 제거하고 날짜 포맷 함수만 남겨, 클라이언트 번들 크기를 줄였습니다.

2. 코드 중복 제거

src/views/List/ListFactory.ts와 src/core/utils.ts 양쪽에 똑같이 구현되어 있던 약 120여 줄의 PC 점수 감점 연산 함수(calculatePcScoreDeductive)를 제거하고, utils.ts에서 가져다 쓰도록 임포트로 통합했습니다.

3. 폴더 구조 및 HTML 정리

루트 폴더에 방치되어 있던 기획/설계 관련 마크다운 및 HTML 파일들을 docs/plans/ 하위로 이동하여 최상위 폴더를 정돈했습니다.
루트의 중복된 PC_사양_적정성_분석_기획서.html 파일을 삭제하여 단일 파일만 남겼습니다.

4. 배포 환경 이미지 엑박(Broken Image) 오류 해결

루트의 img/ 폴더는 Vite 빌드 시 빌드 결과물(dist/)에 포함되지 않아 실배포 시 로고 및 장비 실물 사진이 깨져 보이던 결함이 있었습니다.
이를 해결하기 위해 img/ 폴더를 public/img/ 하위로 이동시켜 빌드 시 정적 자산으로 정상 복사되도록 조치했습니다.

빌드 검증 결과

npm run build 결과 에러 없이 번들링이 완료되었으며, dist/img에 로고 및 이미지 자산들이 정상적으로 복사되어 출력됨을 확인했습니다.

### 작업 개요 프로젝트의 불필요한 목업 데이터 파일을 삭제하고 중복 코드를 제거하여 빌드 용량을 최적화하였으며, 정적 자산 경로 결함으로 인해 배포 환경에서 이미지가 보이지 않던 문제를 수정했습니다. ### 상세 작업 내용 #### 1. 미사용 파일 및 데드 코드(Dead Code) 제거 - **목업 파일 삭제**: 실제 데이터베이스 연동으로 인해 더 이상 사용하지 않는 목업 데이터 파일들을 삭제했습니다. - `src/core/dummyData.ts` (333 KB) - `src/core/realServerData.ts` (43 KB) - `src/server_data.json` (308 B) - **xlsx 라이브러리 의존성 제거**: `src/core/excelHandler.ts` 내에서 호출되지 않던 대용량 엑셀 관련 기능들을 제거하고 날짜 포맷 함수만 남겨, 클라이언트 번들 크기를 줄였습니다. #### 2. 코드 중복 제거 - `src/views/List/ListFactory.ts`와 `src/core/utils.ts` 양쪽에 똑같이 구현되어 있던 약 120여 줄의 PC 점수 감점 연산 함수(`calculatePcScoreDeductive`)를 제거하고, `utils.ts`에서 가져다 쓰도록 임포트로 통합했습니다. #### 3. 폴더 구조 및 HTML 정리 - 루트 폴더에 방치되어 있던 기획/설계 관련 마크다운 및 HTML 파일들을 `docs/plans/` 하위로 이동하여 최상위 폴더를 정돈했습니다. - 루트의 중복된 `PC_사양_적정성_분석_기획서.html` 파일을 삭제하여 단일 파일만 남겼습니다. #### 4. 배포 환경 이미지 엑박(Broken Image) 오류 해결 - 루트의 `img/` 폴더는 Vite 빌드 시 빌드 결과물(`dist/`)에 포함되지 않아 실배포 시 로고 및 장비 실물 사진이 깨져 보이던 결함이 있었습니다. - 이를 해결하기 위해 `img/` 폴더를 `public/img/` 하위로 이동시켜 빌드 시 정적 자산으로 정상 복사되도록 조치했습니다. ### 빌드 검증 결과 - `npm run build` 결과 에러 없이 번들링이 완료되었으며, `dist/img`에 로고 및 이미지 자산들이 정상적으로 복사되어 출력됨을 확인했습니다.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Taehoon/ITAM#24