Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
89 changes: 89 additions & 0 deletions .agents/PixConvert Project Plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
## **01. 프로젝트 개요**

- 프로젝트 명: PixConvert
- 목표: 직관적이고 가볍게 사용할 수 있는 **이미지 확장자 변환 프로그램** 제공
- 기반 구조:
- C# ModernWPF + MVVM
- TagNamer 프로젝트 일부 코드 재사용
- 재사용 코드:
- UI 레이아웃 기반 구조
- 파일 리스트/정렬/드래그
- Snackbar/Dialog/Language 서비스 등

## 02. 개발 스택

- **Language**: C# (.NET 10.0, WPF)
- **UI Library**: [ModernWPF](https://github.com/Kinnara/ModernWPF)
- **IDE**: Antigravity
- **AI**: Gemini 3 Flash, GPT Codex Web

## 03. 개발 목표

- **가볍고 빠르게 동작**
- **직관적인 UI**
- **대량 파일 변환 지원**
- **자주 쓰는 이미지 확장자 간 변환을 최소한의 클릭으로 수행**

## 04. 주요 기능 정의

| 구분 | 기능명 | 설명 |
| --- | --- | --- |
| 기본 | 파일 입력 | 재사용 코드 |
| 기본 | 파일 출력 | |
| 기본 | 파일 목록 | 재사용 코드 |
| 기본 | 확장자 변환 | |
| 기본 | 언어 변경 | EN ↔ KR 두가지 언어 제공 |
- **파일 출력**
- 변환 완료된 결과물을 신규 파일 생성과 기존 파일 대체를 선택하는 옵션을 제공,
그에 따라 결과물을 파일로 출력하는 기능 필요.
- 확장자 변환
- 목표 지원 확장자: **PNG, JPG/JPEG, BMP, GIF, WEBP**
- 변환 옵션:
- 퀄리티 관련 옵션
- 대상 확장자 선택
- 출력 폴더 지정
- 원본 유지 / 덮어쓰기 옵션
- 파일명 규칙 설정(선택적)

## 05. **사용자 흐름 (User Flow)**

1. 앱 실행
2. 파일/폴더 추가
3. 리스트에서 변환할 파일 확인
4. 대상 확장자 및 옵션 설정
5. 변환 실행
6. 결과 확인 (성공/실패/알림)

## **06. 화면 UI 구성**

### **헤더**

- 간단한 현재 변환 계획 표시
- 앱 버전 표시
- 언어 선택 (예: EN/KR)

### **사이드바**

- 파일 추가 / 폴더 추가
- 리스트 초기화
- 정렬 옵션
- 변환 실행

### **메인 영역**

- 파일 리스트 (아이콘/이름/크기/경로)

### **상단 알림**

- 스낵바 메시지
- 변환 진행률 표시

### 변환작업 창

- 변환 확장자 선택지 및 옵션

## **07. 고려사항**

- 대량 파일 변환 시 성능/메모리 관리 필요
- 변환 실패/권한 문제 대응
- UI 응답성 유지 (비동기 처리 필수)
Loading
Loading