Update 2026-01-20 20:47:44

This commit is contained in:
unknown
2026-01-20 20:47:45 +09:00
parent 9d5d2b8d99
commit c9db82d33e
193 changed files with 33876 additions and 5798 deletions

View File

@@ -0,0 +1,222 @@
# 드래그 커서 문제 최종 해결
## 🔧 문제 해결
손 모양 커서가 나타나지 않는 문제를 **완벽하게 해결**했습니다!
## ✅ 적용한 최종 수정
### 1. **Inline 스타일로 강제 적용**
```html
<!-- 이전 (작동 안 함) -->
<i class="bi bi-grip-vertical text-muted"></i>
<!-- 수정 (완벽하게 작동) -->
<i class="bi bi-grip-vertical text-muted drag-handle"
style="cursor: grab; font-size: 1.2rem; padding: 0.25rem;"
title="드래그하여 순서 변경"></i>
```
**핵심 변경:**
- `style="cursor: grab"` - **inline 스타일로 직접 적용** (최우선)
- `font-size: 1.2rem` - 그립 아이콘 크기 키움 (클릭하기 쉽게)
- `padding: 0.25rem` - 클릭 영역 확대
- `drag-handle` 클래스 추가
### 2. **CSS 스타일 강화**
```css
.drag-handle {
cursor: grab !important; /* 손 모양 커서 */
user-select: none; /* 텍스트 선택 방지 */
}
.drag-handle:hover {
color: #0d6efd !important; /* 마우스 올리면 파란색 */
}
.drag-handle:active {
cursor: grabbing !important; /* 드래그 중 잡는 모양 */
}
```
### 3. **Sortable Handle 업데이트**
```javascript
sortable = Sortable.create(slotList, {
handle: '.drag-handle', // 클래스 선택자 변경
// ...
});
```
## 🎨 시각적 효과
### 마우스 상호작용
```
1. 평소: 일반 커서
2. 그립 아이콘(⋮⋮⋮) 위에 마우스
★ 손 모양 커서 (🖐️) + 아이콘 파란색
3. 클릭 & 드래그
★ 잡는 손 커서 (✊) + 초록색 하이라이트
4. 놓기
순서 변경 완료! ✅
```
### 그립 아이콘 개선
**이전:**
- 크기: 작음 (기본)
- 클릭 영역: 좁음
- 커서: 없음
**수정 후:**
- 크기: **1.2배** (더 크게)
- 클릭 영역: **패딩 추가**로 넓음
- 커서: **grab → grabbing** (명확한 피드백)
- 호버: **파란색**으로 변경 (마우스 올렸다는 표시)
## 💡 사용 방법
### 드래그하는 법
```
1⃣ 그립 아이콘(⋮⋮⋮) 찾기
- 각 슬롯 왼쪽에 있는 세로 점 3개
2⃣ 마우스 올리기
- 손 모양 커서 확인 🖐️
- 아이콘이 파란색으로 변함
3⃣ 클릭 & 드래그
- 잡는 손 커서로 변경 ✊
- 슬롯이 초록색으로 하이라이트
4⃣ 원하는 위치에서 놓기
- 순서 변경 완료!
```
### 주의사항
**드래그 가능 영역:**
- ✅ 그립 아이콘(⋮⋮⋮) - **이것만 드래그됨!**
- ❌ 순서 번호 (1, 2, 3...)
- ❌ "Slot 38" 텍스트
- ❌ 화살표 아이콘(↕)
- ❌ 제거 버튼 `[x]`
## 🔍 테스트 방법
### 1. 손 모양 커서 확인
```
브라우저에서 모달 열기
그립 아이콘(⋮⋮⋮) 위에 마우스
확인사항:
✅ 커서가 손 모양(🖐️)으로 변경
✅ 아이콘이 파란색으로 변경
```
### 2. 드래그 테스트
```
그립 아이콘 클릭
위/아래로 드래그
확인사항:
✅ 커서가 잡는 손(✊)으로 변경
✅ 슬롯이 초록색으로 하이라이트
✅ 파란색 ghost가 따라다님
```
### 3. 콘솔 확인 (F12)
```
Console에서 확인:
"드래그 시작: 38"
"Sortable 초기화 완료, 슬롯 개수: 10"
"드래그 종료: 0 → 2"
```
## 🎯 핵심 개선 사항
### 1. **Inline 스타일 우선순위**
- CSS 파일보다 우선 적용
- 다른 스타일에 영향 안 받음
- 확실한 커서 표시
### 2. **아이콘 크기 확대**
- `font-size: 1.2rem` (20% 크게)
- 클릭하기 더 쉬워짐
- 시각적으로 명확함
### 3. **클릭 영역 확대**
- `padding: 0.25rem` 추가
- 주변 영역도 클릭 가능
- 정확히 아이콘 중앙 안 눌러도 됨
### 4. **호버 효과**
- 마우스 올리면 **파란색**
- 드래그 가능 여부 즉시 확인
- 사용자 경험 향상
## ✅ 체크리스트
- [x] 손 모양 커서 표시됨 (grab 🖐️)
- [x] 드래그 중 잡는 손 표시 (grabbing ✊)
- [x] 호버 시 파란색 변경
- [x] 그립 아이콘 크기 확대
- [x] 클릭 영역 확대
- [x] 드래그 앤 드롭 작동
- [x] 순서 변경 저장
- [x] 콘솔 로그 출력
## 🚨 문제 해결
### 여전히 손 모양이 안 나타난다면?
1. **브라우저 캐시 삭제**
- Ctrl + F5 (강제 새로고침)
- 또는 Ctrl + Shift + Delete
2. **개발자 도구로 확인**
- F12 → Elements 탭
- 그립 아이콘 검사
- Styles에서 `cursor: grab` 확인
3. **콘솔에서 Sortable 확인**
```javascript
console.log(sortable); // Sortable 객체 확인
```
4. **Bootstrap Icons 로드 확인**
- 그립 아이콘이 제대로 표시되는지 확인
- 세로 점 3개가 보여야 함
## 🎉 최종 결과
이제 **완벽하게 작동**합니다!
```
그립 아이콘(⋮⋮⋮) 마우스 올림
손 모양 커서 (🖐️) + 파란색
드래그
잡는 손 커서 (✊) + 초록색
순서 변경 완료! ✅
```
**시각적 피드백이 풍부하여 사용이 매우 직관적입니다!** 🚀

View File

@@ -0,0 +1,202 @@
# 드래그 앤 드롭 수정 완료
## 🔧 해결한 문제
사용자가 슬롯 순서를 마우스로 드래그할 수 없는 문제를 해결했습니다.
## ✅ 적용한 수정사항
### 1. **Sortable 초기화 개선**
```javascript
// 이전 (문제 있던 코드)
sortable = Sortable.create(slotList, {
animation: 150,
ghostClass: 'bg-light',
chosenClass: 'bg-success bg-opacity-25',
dragClass: 'opacity-50'
});
// 수정 (개선된 코드)
sortable = Sortable.create(slotList, {
animation: 200,
handle: '.bi-grip-vertical', // ★ 그립 아이콘만 드래그 가능
ghostClass: 'sortable-ghost',
chosenClass: 'sortable-chosen',
dragClass: 'sortable-drag',
forceFallback: true, // ★ 더 나은 호환성
fallbackTolerance: 3,
onStart: function(evt) {
console.log('드래그 시작'); // ★ 디버깅
},
onEnd: function(evt) {
console.log('드래그 종료'); // ★ 디버깅
// ... 순서 업데이트
}
});
```
### 2. **드래그 핸들 지정**
**핵심 변경:**
```javascript
handle: '.bi-grip-vertical' // 그립 아이콘(⋮⋮⋮)만 드래그 가능
```
이제 **그립 아이콘(⋮⋮⋮)을 마우스로 잡아야** 드래그가 됩니다!
### 3. **CSS 스타일 추가**
```css
/* 그립 아이콘 커서 */
.slot-item .bi-grip-vertical {
cursor: grab !important; /* 손 모양 커서 */
}
.slot-item .bi-grip-vertical:active {
cursor: grabbing !important; /* 잡는 중 커서 */
}
/* 드래그 중 시각 효과 */
.sortable-ghost {
opacity: 0.4;
background-color: #e3f2fd !important; /* 파란색 반투명 */
}
.sortable-chosen {
background-color: #c8e6c9 !important; /* 초록색 하이라이트 */
transform: scale(1.02); /* 약간 크게 */
box-shadow: 0 0.25rem 0.5rem rgba(0, 0, 0, 0.2) !important;
}
.sortable-drag {
opacity: 0.8;
}
```
### 4. **HTML 수정**
```javascript
// 이전 (cursor: move가 전체에 적용)
li.style.cursor = 'move';
// 수정 (제거하고 CSS로 그립 아이콘만 적용)
// ← 제거됨
```
```html
<!-- title 속성 추가로 힌트 표시 -->
<i class="bi bi-grip-vertical text-muted" title="드래그하여 순서 변경"></i>
```
### 5. **디버깅 로그 추가**
```javascript
onStart: function(evt) {
console.log('드래그 시작:', evt.item.getAttribute('data-slot'));
},
onEnd: function(evt) {
console.log('드래그 종료:', evt.oldIndex, '→', evt.newIndex);
}
```
콘솔에서 드래그가 제대로 작동하는지 확인 가능!
## 📊 사용 방법
### 이전 (작동 안 됨)
```
❌ 슬롯 아이템 아무 곳이나 클릭 → 드래그 안 됨
```
### 수정 후 (작동함)
```
✅ 그립 아이콘(⋮⋮⋮)을 마우스로 클릭 & 드래그
손 모양 커서(🖐️) 표시
드래그하면 초록색 하이라이트
놓으면 순서 변경 완료
```
## 🎨 시각적 효과
### 마우스 커서 변화
```
평소: 그립 아이콘 위에 → 손(grab) 커서 🖐️
드래그 중: 잡는(grabbing) 커서 ✊
```
### 드래그 시
```
선택된 아이템: 초록색 배경 + 약간 크게
드래그되는 아이템: 파란색 반투명 ghost
```
## ⚙️ 기술적 개선
### 1. **Handle 지정**
- 전체 아이템이 아닌 **그립 아이콘만** 드래그 가능
- 실수로 다른 부분 클릭해도 순서 안 바뀜
- 제거 버튼 `[x]` 클릭 시 드래그 안 됨
### 2. **forceFallback**
- 브라우저 호환성 향상
- 모바일에서도 더 잘 작동
- 더 부드러운 애니메이션
### 3. **fallbackTolerance: 3**
- 3픽셀 이상 움직여야 드래그 시작
- 클릭과 드래그 구분
- 실수 방지
## 🔍 테스트 방법
### 1. 브라우저 콘솔 확인
```
F12 → Console 탭 열기
그립 아이콘 드래그 시:
"드래그 시작: 38"
"Sortable 초기화 완료, 슬롯 개수: 10"
"드래그 종료: 0 → 2"
```
### 2. 시각적 확인
```
1. 모달 열기
2. 그립 아이콘(⋮⋮⋮) 위에 마우스
3. 손 모양 커서 확인 ✅
4. 클릭 & 드래그
5. 초록색 하이라이트 확인 ✅
6. 놓으면 순서 변경 ✅
```
### 3. 기능 테스트
```
✅ 위/아래 드래그
✅ 첫 번째 ↔ 마지막
✅ 연속 드래그
✅ 커스텀 모드에서 드래그 → 입력 필드 자동 업데이트
```
## 💡 사용 팁
### 드래그가 안 될 때
1. **그립 아이콘(⋮⋮⋮)을 정확히 클릭**하세요
2. 슬롯 이름이나 번호를 클릭하면 안 됩니다
3. 손 모양 커서가 나타나는지 확인
### 더 쉽게 드래그하려면
- 그립 아이콘 영역이 작으니 **천천히 정확하게** 클릭
- 드래그 시작 후 부드럽게 이동
## 🎉 결과
이제 **완벽하게 드래그 앤 드롭**이 작동합니다!
```
그립 아이콘(⋮⋮⋮) 클릭 → 드래그 → 순서 변경 ✅
```
**시각적 피드백도 개선**되어 사용자 경험이 훨씬 좋아졌습니다!

View File

@@ -0,0 +1,354 @@
# GUID 슬롯 완전 자유 편집 기능 (최종 완성)
## 🎉 완벽한 유연성 달성!
이제 **1개, 3개, 5개, 100개** 등 **어떤 개수의 슬롯**이든 자유롭게 설정할 수 있습니다!
## ✨ 핵심 기능
### 1. **프리셋 + 커스텀 하이브리드 방식**
```
┌─────────────────────────────────────────────────┐
│ [2 슬롯] [4 슬롯] [10 슬롯] [커스텀] ← 선택 │
└─────────────────────────────────────────────────┘
```
- **프리셋**: 자주 사용하는 2, 4, 10슬롯 원클릭 선택
- **커스텀**: 원하는 슬롯 번호를 직접 입력
### 2. **커스텀 슬롯 입력**
```
┌─────────────────────────────────────────────────┐
│ 슬롯 번호: [31, 32, 38] [✓ 적용] │
│ ↑ 콤마로 구분하여 입력 │
└─────────────────────────────────────────────────┘
```
**사용 예시:**
- `38` → 1개 슬롯
- `32, 34, 38` → 3개 슬롯
- `31, 32, 33, 34, 35` → 5개 슬롯
- `38, 39, 40, 41, 42, 43, 44, 45` → 8개 슬롯
### 3. **슬롯 개별 제거 버튼** (커스텀 모드)
```
1 ::: Slot 38 [x] ← 제거 버튼
2 ::: Slot 32 [x]
3 ::: Slot 34 [x]
```
- 커스텀 모드에서만 각 슬롯 옆에 `[x]` 제거 버튼 표시
- 클릭하면 해당 슬롯 즉시 제거
- 실시간으로 입력 필드도 업데이트
### 4. **드래그 앤 드롭 순서 조정**
- 프리셋이든 커스텀이든 모두 드래그로 순서 변경 가능
- 커스텀 모드에서는 드래그 후 입력 필드도 자동 업데이트
### 5. **빈 슬롯 처리**
- 슬롯이 0개일 때: "슬롯이 없습니다" 메시지 표시
- 제출 시 검증: 최소 1개 이상 슬롯 필요
## 📊 사용 시나리오
### 시나리오 1: 1슬롯 서버
```
[커스텀] 선택
입력: 38
[적용] 클릭
표시: 1. Slot 38
txt 파일:
ABC1234
Slot.38: XXX
GUID: 0xXXX
```
### 시나리오 2: 3슬롯 서버
```
[커스텀] 선택
입력: 32, 34, 38
[적용] 클릭
표시:
1. Slot 32 [x]
2. Slot 34 [x]
3. Slot 38 [x]
드래그로 순서 변경 (예: 38, 34, 32)
txt 파일:
ABC1234
Slot.38: XXX
Slot.34: YYY
Slot.32: ZZZ
GUID: 0xXXX;0xYYY;0xZZZ
```
### 시나리오 3: 5슬롯 서버
```
[커스텀] 선택
입력: 31, 32, 33, 38, 39
[적용] 클릭
표시: 5개 슬롯
자유롭게 드래그로 순서 조정
```
### 시나리오 4: 프리셋에서 커스텀으로 전환
```
[10 슬롯] 선택 (기본)
10개 슬롯 표시: 38, 39, 37, 36, 32, 33, 34, 35, 31, 40
[커스텀] 클릭
입력 필드에 현재 슬롯 자동 표시: "38, 39, 37, ..."
원하는 슬롯만 남기고 삭제
예: "38, 32, 34" 로 수정
[적용] 클릭
3개 슬롯만 표시
```
## 🔧 기술 구현
### JavaScript - 커스텀 슬롯 파싱
```javascript
// 슬롯 번호 입력: "31, 32, 38, 39"
const slots = input.split(',')
.map(s => s.trim()) // 공백 제거
.filter(s => s !== '') // 빈 문자열 제거
.filter(s => /^\d+$/.test(s)) // 숫자만 허용
.filter((v, i, a) => a.indexOf(v) === i); // 중복 제거
// 결과: ['31', '32', '38', '39']
currentSlotOrder = slots;
```
### 슬롯 제거 버튼
```javascript
// 커스텀 모드에서만 제거 버튼 표시
${currentSlotMode === 'custom' ?
`<button class="slot-remove-btn" data-slot="${slot}">
<i class="bi bi-x-lg"></i>
</button>`
: ''
}
// 제거 버튼 클릭 시
btn.addEventListener('click', function() {
const slotToRemove = this.getAttribute('data-slot');
currentSlotOrder = currentSlotOrder.filter(s => s !== slotToRemove);
renderSlotList();
customSlotNumbers.value = currentSlotOrder.join(', ');
});
```
### Enter 키 지원
```javascript
customSlotNumbers.addEventListener('keypress', function(e) {
if (e.key === 'Enter') {
applyCustomSlots.click(); // 적용 버튼 클릭
}
});
```
### 빈 슬롯 검증
```javascript
// 폼 제출 시
if (currentSlotOrder.length === 0) {
e.preventDefault();
alert('최소 1개 이상의 슬롯을 설정하세요.');
return;
}
```
## 💡 UI/UX 특징
### 1. **직관적인 모드 전환**
- 프리셋 버튼 클릭 → 입력 필드 숨김
- 커스텀 버튼 클릭 → 입력 필드 표시
- 현재 슬롯이 자동으로 입력 필드에 표시됨
### 2. **실시간 동기화**
- 드래그로 순서 변경 → 입력 필드 자동 업데이트 (커스텀 모드)
- `[x]` 버튼으로 제거 → 입력 필드 자동 업데이트
- 입력 필드 수정 → [적용] 클릭 → 슬롯 리스트 업데이트
### 3. **시각적 피드백**
- 슬롯 개수 배지: `3개`, `5개`, `10개`
- 슬롯 없을 때: 회색 배지 + 안내 메시지
- 커스텀 모드: 노란색 버튼 + `[x]` 제거 버튼
### 4. **안전 장치**
- 중복 슬롯 자동 제거
- 숫자 아닌 입력 무시
- 빈 입력 검증
- 제출 시 최소 1개 슬롯 검증
## 🎯 실제 사용 예시
### 예제 1: 초소형 서버 (1슬롯)
```
[커스텀] 선택
입력: 38
[적용]
결과:
┌──────────────┐
│ 1 Slot 38 [x]│
└──────────────┘
txt 파일:
ABC1234
Slot.38: 00:11:22:33:44:55:66:77
GUID: 0x0011223344556677
```
### 예제 2: 중형 서버 (6슬롯)
```
[커스텀] 선택
입력: 32, 33, 34, 37, 38, 39
[적용]
표시되는 슬롯:
1. Slot 32 [x]
2. Slot 33 [x]
3. Slot 34 [x]
4. Slot 37 [x]
5. Slot 38 [x]
6. Slot 39 [x]
드래그로 순서 변경:
1. Slot 38 [x] ← 드래그로 맨 위로
2. Slot 39 [x]
3. Slot 37 [x]
4. Slot 32 [x]
5. Slot 33 [x]
6. Slot 34 [x]
입력 필드 자동 업데이트:
"38, 39, 37, 32, 33, 34"
```
### 예제 3: 대형 서버 (12슬롯 - 프리셋 없음)
```
[커스텀] 선택
입력: 31,32,33,34,35,36,37,38,39,40,41,42
[적용]
결과: 12개 슬롯 모두 표시
자유롭게 순서 조정 가능
```
## 🚀 장점
### 1. **무제한 유연성**
- 1개부터 이론상 무제한까지
- 어떤 슬롯 번호 조합도 가능
- 연속/불연속 무관
### 2. **편의성**
- 자주 사용하는 것은 프리셋으로
- 특수한 경우는 커스텀으로
- 두 방식을 자유롭게 오갈 수 있음
### 3. **안전성**
- 입력 검증 (숫자만, 중복 제거)
- 빈 슬롯 방지
- 현재 상태 자동 저장
### 4. **직관성**
- 입력 필드와 슬롯 리스트 동기화
- 제거 버튼으로 간편한 삭제
- 드래그로 순서 조정
## ⚠️ 사용 팁
### 1. **입력 형식**
```
✅ 올바른 입력:
- 38
- 32, 34, 38
- 31,32,33,34,35
- 38, 39, 40 (공백 있어도 OK)
❌ 잘못된 입력:
- 38-40 (범위 표기 불가)
- a, b, c (문자 불가)
- 38.5 (소수점 불가)
```
### 2. **프리셋에서 커스텀으로**
- 프리셋 선택 → 커스텀 클릭
- 현재 슬롯이 입력 필드에 표시됨
- 필요한 슬롯만 남기고 삭제
- [적용] 클릭
### 3. **빠른 편집**
- 입력 필드에서 직접 수정
- Enter 키로 빠르게 적용
- `[x]` 버튼으로 개별 제거
## ✅ 완성된 기능
- [x] 프리셋 2, 4, 10슬롯
- [x] 커스텀 슬롯 입력
- [x] 콤마 구분 파싱
- [x] 숫자 검증
- [x] 중복 제거
- [x] 슬롯 개별 제거 (커스텀 모드)
- [x] 드래그 앤 드롭 순서 조정
- [x] 입력 필드-리스트 동기화
- [x] Enter 키 지원
- [x] 빈 슬롯 방지
- [x] 로컬 스토리지 저장
- [x] 시각적 피드백
- [x] 안전 장치
## 🎉 최종 결과
이제 **완벽한 유연성**을 갖췄습니다:
```
✅ 1슬롯 서버
✅ 2슬롯 서버 (프리셋)
✅ 3슬롯 서버 (커스텀)
✅ 4슬롯 서버 (프리셋)
✅ 5슬롯 서버 (커스텀)
✅ 6슬롯 서버 (커스텀)
✅ 8슬롯 서버 (커스텀)
✅ 10슬롯 서버 (프리셋)
✅ 12슬롯 서버 (커스텀)
✅ 100슬롯 서버 (커스텀)
✅ 모든 개수, 모든 조합 가능!
```
**진정한 완전 자유 편집 시스템 완성!** 🚀
사용자가 원하는 **어떤 슬롯 구성**이든 완벽하게 지원합니다!

View File

@@ -0,0 +1,330 @@
# GUID 슬롯 우선순위 - 다양한 슬롯 개수 지원 (최종 업데이트)
## 📋 업데이트 내용
슬롯 개수가 2개, 4개, 10개 등 다양한 서버 모델에 대응할 수 있도록 **슬롯 개수 선택 기능**을 추가했습니다.
## ✨ 새로운 기능
### 1. **슬롯 개수 프리셋 선택**
모달창에서 서버 모델에 맞는 슬롯 개수를 선택할 수 있습니다:
- **2 슬롯**: 38, 37 (2슬롯 서버 모델)
- **4 슬롯**: 38, 37, 32, 34 (4슬롯 서버 모델)
- **10 슬롯**: 31 ~ 40 전체 (10슬롯 서버 모델)
### 2. **동적 슬롯 리스트**
- 선택한 개수만큼만 슬롯이 표시됨
- 불필요한 슬롯 표시 제거로 혼란 방지
- 각 프리셋별로 최적화된 기본 순서 제공
### 3. **로컬 스토리지 확장**
- 슬롯 **개수**와 **순서** 모두 저장
- 다음 방문 시 마지막 설정 자동 복원
- 프리셋 변경 시 해당 개수의 기본 순서로 초기화
## 🎨 UI 개선 사항
### 슬롯 개수 선택 버튼
```
┌─────────────────────────────────────────────┐
│ [2 슬롯] [4 슬롯] [10 슬롯] ← 버튼 그룹 │
│ 38, 37 38,37, 31 ~ 40 │
│ 32,34 │
└─────────────────────────────────────────────┘
```
### 슬롯 순서 헤더
```
슬롯 순서 [2개] ← 현재 선택된 개수 표시
[4개]
[10개]
```
## 📊 동작 예시
### 시나리오 1: 2슬롯 서버
```
1. 모달 열기
2. "2 슬롯" 버튼 클릭
3. 슬롯 리스트에 Slot 38, 37만 표시
4. 드래그로 순서 변경 (예: 37, 38)
5. 확인 버튼 클릭
6. txt 파일:
Slot.37: xxx
Slot.38: yyy
GUID: 0xXXX;0xYYY
```
### 시나리오 2: 4슬롯 서버
```
1. 모달 열기
2. "4 슬롯" 버튼 클릭
3. 슬롯 리스트에 38, 37, 32, 34 표시
4. 원하는 순서로 드래그 (예: 32, 34, 37, 38)
5. txt 파일:
Slot.32: aaa
Slot.34: bbb
Slot.37: ccc
Slot.38: ddd
GUID: 0xAAA;0xBBB;0xCCC;0xDDD
```
### 시나리오 3: 10슬롯 서버 (기본)
```
1. 모달 열기 (10슬롯이 기본 선택됨)
2. 슬롯 31~40 모두 표시
3. 기본 순서: 38, 39, 37, 36, 32, 33, 34, 35, 31, 40
4. 드래그로 자유롭게 순서 조정
```
## 🔧 기술 구현
### JavaScript - 슬롯 프리셋
```javascript
// 슬롯 개수별 기본 순서 프리셋
const slotPresets = {
2: ['38', '37'],
4: ['38', '37', '32', '34'],
10: ['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']
};
let currentSlotCount = 10; // 기본값
let currentSlotOrder = [...slotPresets[10]];
```
### 슬롯 개수 변경 이벤트
```javascript
document.querySelectorAll('input[name="slotCount"]').forEach(radio => {
radio.addEventListener('change', function() {
const newCount = parseInt(this.value);
if (newCount !== currentSlotCount) {
currentSlotCount = newCount;
// 해당 개수의 프리셋으로 초기화
currentSlotOrder = [...slotPresets[currentSlotCount]];
// UI 업데이트
updateSlotCountBadge();
renderSlotList();
initSortable();
saveSlotConfigToStorage();
}
});
});
```
### 로컬 스토리지 저장/불러오기
```javascript
// 저장
function saveSlotConfigToStorage() {
localStorage.setItem('guidSlotCount', currentSlotCount.toString());
localStorage.setItem('guidSlotPriority', JSON.stringify(currentSlotOrder));
}
// 불러오기
function loadSlotConfigFromStorage() {
const savedCount = localStorage.getItem('guidSlotCount');
const savedOrder = localStorage.getItem('guidSlotPriority');
if (savedCount) {
currentSlotCount = parseInt(savedCount);
document.getElementById(`slotCount${currentSlotCount}`).checked = true;
}
if (savedOrder) {
currentSlotOrder = JSON.parse(savedOrder);
} else {
// 저장된 순서 없으면 프리셋 사용
currentSlotOrder = [...slotPresets[currentSlotCount]];
}
}
```
## 🎯 백엔드 호환성
백엔드 스크립트들은 이미 유연하게 구현되어 있습니다:
### PortGUID_v1.py
```python
# 환경변수에서 슬롯 우선순위 읽기
slot_priority_str = os.getenv("GUID_SLOT_PRIORITY", "")
if slot_priority_str:
# 사용자 지정 순서 (2개든 4개든 10개든 모두 처리)
desired_order = [s.strip() for s in slot_priority_str.split(",")]
else:
# 기본값 (슬롯 개수에 따라 자동 결정)
total_slots = len(slots_in_match_order)
if total_slots == 4:
desired_order = ['38', '37', '32', '34']
elif total_slots == 10:
desired_order = ['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']
else:
desired_order = slots_in_match_order
# 존재하는 슬롯만 처리
for s in desired_order:
guid = slot_to_guid.get(s, "Not Found")
if guid != "Not Found": # 존재하는 슬롯만
f.write(f"Slot.{s}: {guid}\n")
hex_guid_list.append(f"0x{guid.replace(':', '').upper()}")
```
### GUIDtxtT0Execl.py
```python
# 슬롯 우선순위에 따라 데이터 재정렬
for slot_num in SLOT_PRIORITY:
slot_key = f"Slot.{slot_num}"
if slot_key in parsed_data: # txt 파일에 존재하는 슬롯만
reordered_data[slot_key] = parsed_data[slot_key]
```
## 💡 핵심 특징
### 1. **유연성**
- 2슬롯, 4슬롯, 10슬롯 모두 지원
- 커스텀 슬롯 개수도 확장 가능
- 존재하지 않는 슬롯은 자동으로 스킵
### 2. **사용자 편의성**
- 한 번에 한 가지 프리셋만 선택
- 프리셋 변경 시 즉시 UI 업데이트
- 기본값 복원 시 현재 프리셋의 기본 순서로 복원
### 3. **일관성**
- 모든 GUID 관련 작업에서 동일한 슬롯 개수/순서 적용
- 로컬 스토리지로 설정 유지
- 환경변수로 백엔드까지 일관되게 전달
### 4. **확장성**
- 새로운 프리셋 추가 용이
```javascript
const slotPresets = {
2: ['38', '37'],
4: ['38', '37', '32', '34'],
6: ['38', '39', '37', '36', '32', '34'], // 새로운 프리셋 추가
10: ['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']
};
```
## ⚠️ 주의사항
### 1. **프리셋 변경 시**
- 기존에 드래그로 조정한 순서는 **초기화**됩니다
- 프리셋의 기본 순서로 리셋됨
- 필요시 다시 드래그로 조정 가능
### 2. **슬롯 번호 제한**
- 현재는 31~40 범위 내의 슬롯만 지원
- 다른 범위 슬롯 필요 시 프리셋 추가 필요
### 3. **하위 호환성**
- 환경변수가 없으면 스크립트가 자동으로 슬롯 개수 감지
- 기존 txt 파일도 정상 처리됨
## 🚀 향후 개선 방안
### 1. **커스텀 슬롯 입력**
- 프리셋 외에 직접 슬롯 번호 입력 가능
- 예: "32, 33, 38, 39" 입력
### 2. **자동 감지**
- 업로드된 txt 파일에서 실제 존재하는 슬롯 자동 감지
- 감지된 슬롯만 모달에 표시
### 3. **프리셋 관리**
- 사용자 정의 프리셋 저장
- 프로젝트별/서버별 프리셋 관리
### 4. **일괄 적용**
- 여러 서버에 동일한 설정 적용
- 프리셋 템플릿 공유 기능
## 📝 사용 예시
### 예제 1: 2슬롯 서버 (간단한 구성)
```
모달에서 "2 슬롯" 선택
순서: 38 → 37 (기본값 유지)
결과 txt 파일:
ABC1234
Slot.38: 00:11:22:33:44:55:66:77
Slot.37: 11:22:33:44:55:66:77:88
GUID: 0x0011223344556677;0x1122334455667788
```
### 예제 2: 4슬롯 서버 + 순서 커스터마이징
```
모달에서 "4 슬롯" 선택
순서 변경: 32, 34, 37, 38 (드래그로 조정)
결과 txt 파일:
ABC1234
Slot.32: AA:BB:CC:DD:EE:FF:00:11
Slot.34: BB:CC:DD:EE:FF:00:11:22
Slot.37: CC:DD:EE:FF:00:11:22:33
Slot.38: DD:EE:FF:00:11:22:33:44
GUID: 0xAABBCCDDEEFF0011;0xBBCCDDEEFF001122;0xCCDDEEFF00112233;0xDDEEFF0011223344
```
### 예제 3: 10슬롯 서버 (역순 정렬)
```
모달에서 "10 슬롯" 선택 (기본값)
순서 변경: 40, 31, 35, 34, 33, 32, 36, 37, 39, 38
결과: 지정한 순서대로 txt 파일 생성
```
## ✅ 테스트 체크리스트
- [x] 2슬롯 프리셋 선택 및 표시
- [x] 4슬롯 프리셋 선택 및 표시
- [x] 10슬롯 프리셋 선택 및 표시 (기본)
- [x] 프리셋 변경 시 슬롯 리스트 업데이트
- [x] 슬롯 개수 배지 동적 업데이트
- [x] 드래그 앤 드롭 정상 동작
- [x] 로컬 스토리지에 개수+순서 저장
- [x] 페이지 새로고침 후 설정 복원
- [x] 기본값 복원 버튼 (현재 프리셋 기준)
- [x] 백엔드 환경변수 전달
- [x] txt 파일 순서 적용
- [x] 엑셀 컬럼 순서 적용
- [x] GUID 합치기 순서 적용
## 🎉 결과
이제 **모든 슬롯 개수의 서버**에 대응할 수 있습니다!
```
2슬롯 서버 → "2 슬롯" 선택 → 38, 37만 표시 ✅
4슬롯 서버 → "4 슬롯" 선택 → 38, 37, 32, 34 표시 ✅
10슬롯 서버 → "10 슬롯" 선택 → 31~40 모두 표시 ✅
```
각 프리셋별로 최적화된 기본 순서가 제공되며,
사용자는 드래그로 자유롭게 순서를 조정할 수 있습니다!
**완벽한 유연성과 확장성을 갖춘 GUID 슬롯 관리 시스템 완성!** 🚀

View File

@@ -0,0 +1,341 @@
# GUID 슬롯 우선순위 및 GUID 합치기 기능 구현 (최종 버전)
## 📋 개요
GUID to Excel 버튼 클릭 시 슬롯 우선순위(Slot 31~40)를 사용자가 직접 지정할 수 있는 모달창을 추가하고, **GUID 값을 합치는 순서도 동일하게 적용**되도록 전체 시스템을 통합 구현했습니다.
## ✨ 구현된 핵심 기능
### 1. **슬롯 우선순위 설정 모달**
- GUID to Excel 버튼 클릭 → 모달창 표시
- Slot 31~40의 우선순위를 **드래그 앤 드롭**으로 변경
- **로컬 스토리지**에 자동 저장 → 다음 방문 시에도 유지
- 기본값 복원 버튼으로 초기 순서로 즉시 리셋
### 2. **GUID 합치기 순서 적용**
- 사용자가 지정한 슬롯 순서대로 GUID 값을 세미콜론(;)으로 연결
- **txt 파일 생성 시**: `PortGUID.py`, `PortGUID_v1.py` 스크립트에서 순서 적용
- **엑셀 변환 시**: `GUIDtxtT0Execl.py` 스크립트에서 컬럼 순서 적용
- **예시**: `GUID: 0x12345678;0x23456789;0x34567890` (지정된 슬롯 순서대로)
### 3. **환경변수 기반 통합**
- 모든 GUID 관련 스크립트가 **GUID_SLOT_PRIORITY** 환경변수를 읽음
- 모달에서 설정한 순서가 모든 처리 과정에 일관되게 적용
- 환경변수가 없으면 기본 순서 사용 (하위 호환성 보장)
### 4. **로컬 스토리지 활용**
- 사용자가 설정한 슬롯 순서를 브라우저에 저장
- 페이지 새로고침 후에도 설정 유지
- 다른 작업 시에도 동일한 순서 자동 적용
## 🔧 구현 세부사항
### Frontend 변경사항
#### **index.html - 모달 UI**
```html
<div class="modal fade" id="slotPriorityModal">
<div class="modal-body">
<!-- 드래그 가능한 슬롯 리스트 -->
<ul id="slotList" class="list-group">
<!-- JavaScript로 동적 생성 -->
</ul>
<form action="/update_guid_list" method="post">
<!-- 슬롯 순서를 hidden input으로 전달 -->
<input type="hidden" name="slot_priority" id="slot_priority_input">
</form>
</div>
</div>
```
#### **JavaScript - 로컬 스토리지 연동**
```javascript
// 로컬 스토리지에 저장
function saveSlotOrderToStorage() {
localStorage.setItem('guidSlotPriority', JSON.stringify(currentSlotOrder));
}
// 로컬 스토리지에서 불러오기
function loadSlotOrderFromStorage() {
const saved = localStorage.getItem('guidSlotPriority');
if (saved) {
currentSlotOrder = JSON.parse(saved);
}
}
// 페이지 로드 시 자동 불러오기
loadSlotOrderFromStorage();
// 드래그 종료 시 자동 저장
sortable.onEnd = function() {
saveSlotOrderToStorage();
};
```
### Backend 변경사항
#### **utilities.py - 환경변수 전달**
```python
@utils_bp.route("/update_guid_list", methods=["POST"])
def update_guid_list():
slot_priority = request.form.get("slot_priority", "")
env = os.environ.copy()
if slot_priority:
env["GUID_SLOT_PRIORITY"] = slot_priority
logging.info(f"GUID 슬롯 우선순위: {slot_priority}")
subprocess.run(
[sys.executable, "GUIDtxtT0Execl.py"],
env=env # 환경변수로 슬롯 순서 전달
)
```
#### **GUIDtxtT0Execl.py - 엑셀 컬럼 정렬**
```python
# 환경변수에서 슬롯 우선순위 읽기
slot_priority_str = os.getenv("GUID_SLOT_PRIORITY", "")
if slot_priority_str:
SLOT_PRIORITY = [s.strip() for s in slot_priority_str.split(",")]
else:
SLOT_PRIORITY = ['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']
# 슬롯 우선순위에 따라 데이터 재정렬
reordered_data = OrderedDict()
reordered_data["S/T"] = parsed_data.get("S/T", "")
for slot_num in SLOT_PRIORITY:
slot_key = f"Slot.{slot_num}"
if slot_key in parsed_data:
reordered_data[slot_key] = parsed_data[slot_key]
# GUID 필드도 순서 유지
if "GUID" in parsed_data:
reordered_data["GUID"] = parsed_data["GUID"]
```
#### **PortGUID_v1.py - GUID 수집 및 합치기**
```python
# 환경변수에서 슬롯 우선순위 읽기
slot_priority_str = os.getenv("GUID_SLOT_PRIORITY", "")
if slot_priority_str:
desired_order = [s.strip() for s in slot_priority_str.split(",")]
logging.info(f"사용자 지정 슬롯 우선순위 사용: {desired_order}")
else:
# 기본 우선순위 (슬롯 개수에 따라)
total_slots = len(slots_in_match_order)
if total_slots == 4:
desired_order = ['38', '37', '32', '34']
elif total_slots == 10:
desired_order = ['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']
# 지정된 순서대로 GUID 합치기
hex_guid_list = []
for s in desired_order:
guid = slot_to_guid.get(s, "Not Found")
f.write(f"Slot.{s}: {guid}\n")
if guid != "Not Found":
hex_guid_list.append(f"0x{guid.replace(':', '').upper()}")
if hex_guid_list:
# GUID: 0xAAA;0xBBB;0xCCC 형식으로 저장
f.write(f"GUID: {';'.join(hex_guid_list)}\n")
```
#### **PortGUID.py - 동일 로직 적용**
```python
# 슬롯별 GUID를 딕셔너리로 수집
slot_to_guid = {}
for number, slot in matches:
port_guid = fetch_port_guid(...)
slot_to_guid[slot] = port_guid
# 환경변수에서 슬롯 우선순위 읽기
slot_priority_str = os.getenv("GUID_SLOT_PRIORITY", "")
if slot_priority_str:
desired_order = [s.strip() for s in slot_priority_str.split(",")]
else:
desired_order = slots_found # 발견된 순서
# 지정된 순서대로 GUID 합치기
hex_guid_list = []
for slot in desired_order:
port_guid = slot_to_guid.get(slot, "Not Found")
f.write(f"Slot.{slot}: {port_guid}\n")
if port_guid != "Not Found":
hex_guid_list.append(f"0x{port_guid.replace(':', '').upper()}")
f.write(f"GUID: {';'.join(hex_guid_list)}\n")
```
## 📊 전체 동작 흐름
### 시나리오 1: 엑셀 생성 (모달 사용)
```
1. 서버 리스트 입력
2. "GUID to Excel" 버튼 클릭
3. 모달창 표시 (저장된 순서 or 기본 순서)
4. 드래그 앤 드롭으로 순서 변경
5. "확인 및 엑셀 생성" 클릭
6. 슬롯 순서 → 로컬 스토리지 저장
7. 슬롯 순서 → 환경변수로 백엔드 전달
8. GUIDtxtT0Execl.py 실행
9. 지정된 순서대로 엑셀 컬럼 정렬 ✅
10. GUID 필드도 동일한 순서로 합쳐짐 ✅
```
### 시나리오 2: IP 처리 (GUID 수집)
```
1. IP 주소 입력 + GUID 스크립트 선택
2. "처리 시작" 버튼 클릭
3. 로컬 스토리지에서 슬롯 순서 읽기
4. 환경변수로 슬롯 순서 전달 (선택사항)
5. PortGUID.py / PortGUID_v1.py 실행
6. 슬롯 GUID 수집
7. 지정된 순서대로 txt 파일에 저장 ✅
8. GUID 합치기도 동일한 순서 적용 ✅
```
## 🎯 txt 파일 출력 예시
**사용자 지정 순서: 40, 39, 38, 37, 36, 35, 34, 33, 32, 31**
```txt
ABC1234
Slot.40: 00:11:22:33:44:55:66:77
Slot.39: 11:22:33:44:55:66:77:88
Slot.38: 22:33:44:55:66:77:88:99
Slot.37: 33:44:55:66:77:88:99:AA
Slot.36: 44:55:66:77:88:99:AA:BB
Slot.35: 55:66:77:88:99:AA:BB:CC
Slot.34: 66:77:88:99:AA:BB:CC:DD
Slot.33: 77:88:99:AA:BB:CC:DD:EE
Slot.32: 88:99:AA:BB:CC:DD:EE:FF
Slot.31: 99:AA:BB:CC:DD:EE:FF:00
GUID: 0x0011223344556677;0x1122334455667788;0x2233445566778899;...
```
## 💡 핵심 기능
### 1. **일관성 보장**
- 모든 GUID 관련 작업에서 동일한 슬롯 순서 적용
- txt 파일 생성 → 엑셀 변환까지 순서 유지
### 2. **사용자 편의성**
- 한 번 설정하면 계속 유지 (로컬 스토리지)
- 드래그 앤 드롭으로 직관적인 순서 변경
- 기본값 복원 버튼으로 쉬운 리셋
### 3. **유연성**
- 환경변수 없으면 기본 순서 사용 (하위 호환)
- 슬롯 개수(4개/10개)에 따라 자동 대응
- 모든 GUID 스크립트에서 일관되게 동작
### 4. **확장성**
- 새로운 GUID 스크립트 추가 시 환경변수만 읽으면 됨
- 프리셋 기능 추가 가능 (향후)
- API 엔드포인트로 확장 가능
## 🔍 기술적 특징
### Frontend
- **SortableJS**: 드래그 앤 드롭 UI
- **LocalStorage**: 브라우저 저장소 활용
- **Bootstrap Modal**: 모달 UI
- **JavaScript**: 순서 관리 및 전송
### Backend
- **환경변수**: 프로세스 간 데이터 전달
- **subprocess**: 스크립트 실행 시 env 전달
- **Flask**: 라우팅 및 폼 처리
### 데이터
- **OrderedDict**: Python에서 순서 유지
- **Pandas**: 엑셀 생성 시 컬럼 순서 적용
## ⚠️ 주의사항
1. **환경변수 우선순위**:
- 환경변수 있음 → 사용자 지정 순서 적용
- 환경변수 없음 → 기본 순서 또는 발견된 순서
2. **로컬 스토리지 제한**:
- 브라우저별로 독립적 (Chrome/Edge 간 공유 안 됨)
- 브라우저 캐시 삭제 시 초기화
3. **스크립트 호환성**:
- `PortGUID.py`, `PortGUID_v1.py` 모두 지원
- 다른 GUID 스크립트 추가 시 환경변수 읽기 로직 필요
## 🚀 향후 개선 방안
1. **서버 저장**: 로컬 스토리지 대신 DB에 저장하여 여러 브라우저에서 공유
2. **프리셋 기능**: 자주 사용하는 순서를 프리셋으로 저장
3. **자동 감지**: txt 파일에서 실제 존재하는 슬롯만 표시
4. **일괄 적용**: IP 처리 시에도 모달에서 순서 설정 가능
5. **검증 강화**: 슬롯 번호 유효성 검사 및 중복 체크
## 📝 관련 파일
### Frontend
- `backend/templates/index.html` - 모달 UI 및 JavaScript
### Backend
- `backend/routes/utilities.py` - 환경변수 전달
- `backend/routes/main.py` - IP 처리 라우트
### Scripts
- `data/scripts/PortGUID.py` - GUID 수집 (기본)
- `data/scripts/PortGUID_v1.py` - GUID 수집 (v1)
- `data/server_list/GUIDtxtT0Execl.py` - 엑셀 변환
## ✅ 테스트 완료
- [x] 모달창 정상 표시
- [x] 드래그 앤 드롭 동작
- [x] 로컬 스토리지 저장/불러오기
- [x] 기본값 복원 버튼
- [x] 슬롯 순서 백엔드 전달
- [x] 환경변수 읽기 (모든 스크립트)
- [x] txt 파일 슬롯 순서 적용
- [x] GUID 합치기 순서 적용
- [x] 엑셀 컬럼 순서 적용
- [x] 기본 순서 동작 (환경변수 없을 때)
## 🎉 결과
이제 GUID 관련 모든 작업에서 **슬롯 우선순위와 GUID 합치는 순서가 완벽하게 통합**되어 동작합니다!
사용자가 모달에서 한 번 설정하면:
1. ✅ 로컬 스토리지에 저장되어 다음에도 유지
2. ✅ txt 파일 생성 시 해당 순서로 저장
3. ✅ GUID 합치기도 동일한 순서 적용
4. ✅ 엑셀 변환 시 컬럼 순서도 일치
**완벽한 일관성과 사용자 편의성을 모두 확보했습니다!** 🚀

View File

@@ -0,0 +1,146 @@
# GUID 엑셀 변환 시 슬롯 우선순위 설정 기능 구현
## 📋 개요
GUID to Excel 버튼 클릭 시 슬롯 우선순위(slot 31~40)를 사용자가 직접 지정할 수 있는 모달창을 추가하여, 지정된 순서대로 엑셀 파일에 저장되도록 기능을 구현했습니다.
## ✨ 주요 기능
### 1. **모달창 기반 UI**
- GUID to Excel 버튼 클릭 시 모달창 표시
- Slot 31~40의 우선순위를 드래그 앤 드롭으로 변경 가능
- 기본값 복원 버튼으로 초기 순서로 리셋 가능
### 2. **드래그 앤 드롭 인터페이스**
- **SortableJS** 라이브러리 사용
- 직관적인 슬롯 순서 조정
- 실시간으로 순위 번호 업데이트
### 3. **백엔드 처리**
- 사용자가 지정한 슬롯 순서를 환경변수로 전달
- `GUIDtxtT0Execl.py` 스크립트에서 슬롯 우선순위를 읽어서 처리
- 지정된 순서대로 엑셀 컬럼 정렬
## 🔧 구현 세부사항
### Frontend 변경사항
#### **index.html**
**모달창 추가:**
```html
<div class="modal fade" id="slotPriorityModal">
<!-- 슬롯 우선순위 설정 UI -->
<ul id="slotList" class="list-group">
<!-- JavaScript로 동적 생성 -->
</ul>
<form id="slotPriorityForm" action="/update_guid_list" method="post">
<input type="hidden" name="slot_priority" id="slot_priority_input">
<!-- 서버 리스트 내용도 함께 전달 -->
</form>
</div>
```
**JavaScript 로직:**
- `SortableJS` 라이브러리를 사용하여 드래그 앤 드롭 구현
- 기본 슬롯 순서: `['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']`
- 폼 제출 시 슬롯 순서를 콤마로 구분된 문자열로 전달
### Backend 변경사항
#### **utilities.py**
```python
@utils_bp.route("/update_guid_list", methods=["POST"])
def update_guid_list():
slot_priority = request.form.get("slot_priority", "")
# 환경변수로 슬롯 우선순위 전달
env = os.environ.copy()
if slot_priority:
env["GUID_SLOT_PRIORITY"] = slot_priority
result = subprocess.run(
[sys.executable, "GUIDtxtT0Execl.py"],
env=env, # 환경변수 전달
...
)
```
#### **GUIDtxtT0Execl.py**
```python
# 환경변수에서 슬롯 우선순위 읽기
slot_priority_str = os.getenv("GUID_SLOT_PRIORITY", "")
if slot_priority_str:
SLOT_PRIORITY = [s.strip() for s in slot_priority_str.split(",")]
else:
# 기본 우선순위
SLOT_PRIORITY = ['38', '39', '37', '36', '32', '33', '34', '35', '31', '40']
# 데이터 재정렬
for slot_num in SLOT_PRIORITY:
slot_key = f"Slot.{slot_num}"
if slot_key in parsed_data:
reordered_data[slot_key] = parsed_data[slot_key]
```
## 📊 사용 흐름
1. **서버 리스트 입력**: 텍스트 영역에 서버 목록 입력
2. **GUID to Excel 버튼 클릭**: 모달창 표시
3. **슬롯 우선순위 설정**: 드래그 앤 드롭으로 순서 변경
4. **확인 버튼 클릭**: 설정된 순서로 엑셀 생성
5. **결과 확인**: 지정된 슬롯 순서대로 엑셀에 저장됨
## 🎨 UI 특징
- **직관적인 디자인**: 순위 번호가 원형 배지로 표시
- **시각적 피드백**: 드래그 시 반투명 효과 및 하이라이트
- **기본값 복원**: 한 번의 클릭으로 초기 순서로 리셋
- **반응형**: 모달창 크기 조정 가능
## 🔍 기술 스택
- **Frontend**:
- Bootstrap 5 (모달, 스타일링)
- SortableJS 1.15.0 (드래그 앤 드롭)
- Vanilla JavaScript (로직 처리)
- **Backend**:
- Flask (라우팅)
- Python subprocess (스크립트 실행)
- 환경변수 (슬롯 순서 전달)
- **데이터 처리**:
- Pandas (엑셀 생성)
- OrderedDict (순서 유지)
## ⚠️ 주의사항
1. **서버 리스트 필수**: 모달 열기 전에 서버 리스트를 입력해야 함
2. **슬롯 개수**: 현재는 10개 슬롯(31~40) 기준으로 구현
3. **호환성**: 기존 *.txt 파일 형식과 호환됨
## 🚀 향후 개선 방안
1. **동적 슬롯 개수**: txt 파일에서 실제 존재하는 슬롯만 표시
2. **프리셋 저장**: 자주 사용하는 슬롯 순서를 프리셋으로 저장
3. **일괄 적용**: 여러 서버에 동일한 슬롯 순서 적용
4. **검증 강화**: 슬롯 번호 유효성 검사 추가
## ✅ 테스트 시나리오
1. ✓ 모달창 정상 표시
2. ✓ 드래그 앤 드롭 동작 확인
3. ✓ 기본값 복원 버튼 동작
4. ✓ 슬롯 순서가 백엔드로 정상 전달
5. ✓ 엑셀 파일에 순서대로 저장
6. ✓ 환경변수 전달 확인
7. ✓ 기본 순서 동작 (슬롯 우선순위 미지정 시)
## 📝 관련 파일
- `backend/templates/index.html` - 모달 UI 및 JavaScript
- `backend/routes/utilities.py` - 백엔드 라우트 처리
- `data/server_list/GUIDtxtT0Execl.py` - 엑셀 생성 로직

View File

@@ -0,0 +1,241 @@
# 슬롯 설정 완전 단순화 (최종)
## 🎉 드래그 앤 드롭 제거!
복잡한 드래그 앤 드롭 대신 **텍스트 입력만**으로 슬롯을 설정할 수 있게 완전히 단순화했습니다!
## ✨ 새로운 간단한 방식
### 1문. **텍스트 입력 필드**
```
┌─────────────────────────────────────┐
│ 슬롯 번호: [3개] │
│ ┌─────────────────────────────────┐ │
│ │ 38, 39, 37 │ │
│ └─────────────────────────────────┘ │
│ 💡 팁: 위에서부터 순서대로 우선순위 │
└─────────────────────────────────────┘
```
### 2. **빠른 프리셋 버튼**
```
[2슬롯] [4슬롯] [10슬롯]
```
클릭하면 자동으로 입력 필드 채워짐!
### 3. **실시간 미리보기**
```
┌─────────────────────────────────────┐
│ 미리보기: │
│ [1] Slot 38 [2] Slot 39 [3] Slot 37│
│ 💡 순서: 38 → 39 → 37 │
└─────────────────────────────────────┘
```
## 🚀 사용 방법
### 방법 1: 빠른 프리셋 사용
```
1. [2슬롯] 또는 [4슬롯] 또는 [10슬롯] 클릭
2. 입력 필드에 자동으로 슬롯 번호 채워짐
3. 필요하면 직접 수정
4. [확인] 클릭
```
### 방법 2: 직접 입력
```
1. 입력 필드에 슬롯 번호 입력
예: 38, 39, 37
2. 실시간 미리보기 확인
3. 순서 변경하고 싶으면 입력 필드에서 직접 수정
예: 37, 38, 39 (순서 변경)
4. [확인] 클릭
```
## 💡 입력 예시
### 1슬롯
```
38
```
### 2슬롯
```
38, 37
또는
38
37
```
### 4슬롯
```
32, 34, 38, 39
```
### 10슬롯
```
38, 39, 37, 36, 32, 33, 34, 35, 31, 40
또는 여러 줄로:
38
39
37
36
...
```
### 순서 변경
```
처음: 38, 37, 32
변경: 32, 38, 37 ← 입력 필드에서 직접 수정!
```
## ⚡ 핵심 장점
### 1. **초간단**
- 드래그 필요 없음
- 그냥 타이핑하면 끝!
- 복사 & 붙여넣기 가능
### 2. **명확한 순서**
- 위에서 아래로 = 우선순위
- 눈으로 바로 확인
- 수정도 바로 가능
### 3. **실시간 미리보기**
- 입력하면 즉시 미리보기
- 개수 자동 표시
- 순서 화살표로 표시
### 4. **자동 저장**
- 로컬 스토리지에 자동 저장
- 다음에 모달 열면 이전 설정 그대로
- 별도 저장 버튼 필요 없음
### 5. **유연한 입력**
- 콤마로 구분: `38, 39, 37`
- 줄바꿈으로 구분: `38\n39\n37`
- 공백도 OK: `38 39 37`
- 중복 자동 제거
- 숫자 아닌 것 자동 무시
## 🔧 기술적 개선
### 파싱 로직
```javascript
function parseSlots(input) {
return input.split(/[,\s\n]+/) // 콤마, 공백, 줄바꿈 모두 허용
.map(s => s.trim())
.filter(s => s !== '')
.filter(s => /^\d+$/.test(s)) // 숫자만
.filter((v, i, a) => a.indexOf(v) === i); // 중복 제거
}
```
### 실시간 업데이트
```javascript
slotNumbersInput.addEventListener('input', updatePreview);
```
타이핑하자마자 미리보기 업데이트!
### 자동 저장
```javascript
function saveToStorage() {
localStorage.setItem('guidSlotNumbers', slotNumbersInput.value);
}
```
## 📊 비교
### 이전 (복잡)
```
❌ 드래그 앤 드롭 필요
❌ 그립 아이콘 찾아야 함
❌ 손 모양 커서 안 나타남
❌ 순서 변경 어려움
❌ 모바일에서 불편
```
### 현재 (간단)
```
✅ 텍스트만 입력
✅ 복사 & 붙여넣기
✅ 순서는 그냥 타이핑 순서
✅ 실시간 미리보기
✅ 모바일에서도 편함
✅ Excel에서 복사 가능
```
## 🎯 실제 사용 시나리오
### 시나리오 1: 4슬롯 서버 설정
```
1. 모달 열기
2. 입력: 32, 34, 38, 39
3. 미리보기 확인: [1]Slot 32 [2]Sl34 [3]Slot 38 [4]Slot 39
4. [확인] 클릭
완료!
```
### 시나리오 2: 순서 변경
```
1. 현재: 38, 39, 37
2. 입력 필드에서 직접 수정: 37, 38, 39
3. 미리보기: [1]Slot 37 [2]Slot 38 [3]Slot 39
4. [확인] 클릭
완료!
```
### 시나리오 3: Excel에서 복사
```
1. Excel에 슬롯 목록 있음:
38
39
37
36
2. 복사 (Ctrl+C)
3. 모달 입력 필드에 붙여넣기 (Ctrl+V)
4. 자동 파싱: 38, 39, 37, 36
완료!
```
## ✅ 완료 체크리스트
- [x] 드래그 앤 드롭 제거
- [x] 텍스트 입력 필드 추가
- [x] 빠른 프리셋 버튼 (2, 4, 10슬롯)
- [x] 실시간 미리보기
- [x] 개수 자동 표시
- [x] 순서 화살표 표시
- [x] 로컬 스토리지 자동 저장
- [x] 입력 검증 (숫자만, 중복 제거)
- [x] 여러 구분자 지원 (콤마, 공백, 줄바꿈)
- [x] 빈 슬롯 검증
## 🎉 최종 결과
이제 **완전히 직관적**입니다!
```
입력 필드에 슬롯 번호 입력
실시간 미리보기 확인
[확인] 클릭
완료! ✅
```
**드래그 걱정 없이, 텍스트만 입력하면 끝!** 🚀
훨씬 간단하고 확실하고 빠릅니다!