waiting-system/평일주말_클래스_구분_완료.md

평일/주말 클래스 구분 작업 완료 보고서

작업 일시

2025-12-04

작업 내용

1. 데이터베이스 구분 확인 및 마이그레이션 ✅

데이터베이스 스키마 확인

• class_info 테이블에 class_type 컬럼이 이미 존재하며 정상 작동 중
• class_type 가능한 값: 'weekday' (평일), 'weekend' (주말), 'all' (전체)
• weekday_schedule JSON 컬럼으로 각 요일별 운영 여부 저장

기존 데이터 변환

기존에 모든 클래스가 'all' 타입으로 저장되어 있어 평일/주말 구분이 불명확했습니다.

마이그레이션 실행 결과:

✅ 5개의 클래스를 'all' → 'weekday'로 변환 완료
📊 변환 후 클래스 타입별 개수:
   - 평일: 17개
   - 주말: 1개

데이터베이스 확인:

SELECT id, class_number, class_name, class_type, weekday_schedule
FROM class_info
LIMIT 5;

-- 결과 예시:
1|1|1교시|weekday|{"mon": true, "tue": true, "wed": true, "thu": true, "fri": true, "sat": false, "sun": false}
18|1|1교시|weekend|{"mon": false, "tue": false, "wed": false, "thu": false, "fri": false, "sat": true, "sun": true}

2. 클래스 관리(routers/class_management.py) 확인 ✅

클래스 관리 API는 이미 평일/주말 구분을 완벽하게 지원하고 있습니다:

클래스 생성 시 (POST /api/classes/)

• class_type 파라미터로 평일/주말/전체 선택
• 같은 매장 내에서 같은 class_type과 class_number 조합 중복 불가
• 예: 평일 1교시와 주말 1교시는 별도로 생성 가능

# 중복 체크 로직 (lines 130-141)
existing = db.query(ClassInfo).filter(
    ClassInfo.store_id == current_store.id,
    ClassInfo.class_number == class_info.class_number,
    ClassInfo.class_type == class_info.class_type  # class_type별로 구분
).first()

클래스 목록 조회 시 (GET /api/classes/)

• class_type 필터 파라미터 지원
• 예: /api/classes/?class_type=weekday → 평일 클래스만 조회
• 예: /api/classes/?class_type=weekend → 주말 클래스만 조회

# 필터링 로직 (lines 169-171)
if class_type:
    query = query.filter(ClassInfo.class_type == class_type)

클래스 수정 시 (PUT /api/classes/{class_id})

• class_type 변경 가능
• 변경 시에도 중복 체크 수행

3. 대기 등록(routers/waiting.py) 확인 ✅

대기 등록 시스템은 요일별로 자동으로 적절한 클래스만 배정합니다:

요일별 필터링 (filter_classes_by_weekday())

def filter_classes_by_weekday(classes: List[ClassInfo], target_date: date) -> List[ClassInfo]:
    """특정 날짜의 요일에 맞는 클래스만 필터링"""
    weekday = WEEKDAY_MAP[target_date.weekday()]
    filtered_classes = []

    for cls in classes:
        schedule = parse_weekday_schedule(cls.weekday_schedule)
        if schedule.get(weekday, True):  # 해당 요일이 활성화된 클래스만
            filtered_classes.append(cls)

    return filtered_classes

동작 방식:

• 월요일에 대기 등록 → 월요일이 활성화된 클래스만 표시 (주말 클래스 제외)
• 토요일에 대기 등록 → 토요일이 활성화된 클래스만 표시 (평일 클래스 제외)

4. UI 개선 (templates/settings.html) ✅

클래스 타입 선택 추가

매장 설정 화면의 클래스 생성/수정 모달에 클래스 타입 선택 드롭다운 추가:

<select id="classType" class="form-control" required>
    <option value="weekday">평일 클래스</option>
    <option value="weekend">주말 클래스</option>
    <option value="all">전체 요일 클래스</option>
</select>

평일/주말 탭 분리 렌더링

function renderClasses() {
    // 평일 클래스만 평일 탭에 표시
    const weekdayClasses = classes.filter(cls => cls.class_type === 'weekday');

    // 주말 클래스만 주말 탭에 표시
    const weekendClasses = classes.filter(cls => cls.class_type === 'weekend');

    // 전체 요일 클래스는 양쪽 탭에 모두 표시 (회색 배지로 구분)
    const allClasses = classes.filter(cls => cls.class_type === 'all');
}

시각적 구분

• 평일 클래스: 보라색 배지 "평일 전용"
• 주말 클래스: 보라색 배지 "주말 전용"
• 전체 요일 클래스: 회색 배지 "전체 요일" (양쪽 탭에 모두 표시)

5. 현황대기판(routers/waiting_board.py) 수정 ✅

Pydantic 검증 오류 수정:

def convert_class_to_dict(cls: ClassInfo) -> dict:
    """ClassInfo 모델 객체를 dict로 변환"""
    return {
        "id": cls.id,
        "class_number": cls.class_number,
        "class_name": cls.class_name,
        # ... 기타 필드 ...
        "weekday_schedule": parse_weekday_schedule(cls.weekday_schedule),  # JSON 문자열 → dict 변환
        "class_type": cls.class_type if hasattr(cls, 'class_type') else 'all'
    }

검증 결과

데이터베이스 레벨

sqlite> SELECT class_type, COUNT(*) FROM class_info GROUP BY class_type;
weekday|17
weekend|1

✅ 평일 17개, 주말 1개 클래스가 명확히 구분되어 저장됨

API 레벨

• ✅ 클래스 생성 시 class_type별 중복 체크 정상 작동
• ✅ 클래스 목록 조회 시 class_type 필터링 정상 작동
• ✅ 대기 등록 시 요일별 자동 필터링 정상 작동

UI 레벨

• ✅ 평일 탭에 평일 클래스만 표시
• ✅ 주말 탭에 주말 클래스만 표시
• ✅ 전체 요일 클래스는 양쪽에 모두 표시되며 회색으로 구분됨

결론

사용자 요청사항:

"평일 클래스와 주말 클래스가 UI 화면상으로만 구분을 해 놓고 데이터베이스는 같은 것 같은데 평일 클래스와 주말 클래스를 구분하여 저장 할 수 있게 수정"

작업 결과:

1. ✅ 데이터베이스에 class_type 컬럼이 존재하며 정상 작동 중
2. ✅ 기존 'all' 타입 데이터를 'weekday'로 변환하여 구분 명확화
3. ✅ 클래스 관리 API가 class_type별 완벽한 CRUD 지원
4. ✅ 대기 등록 시 요일별 자동 필터링 작동
5. ✅ UI에서 평일/주말 탭 분리 및 시각적 구분

평일/주말 클래스는 UI뿐만 아니라 데이터베이스 레벨에서도 완전히 분리되어 저장되고 관리됩니다.

생성된 파일

• migrate_convert_all_to_weekday.py - 대화형 마이그레이션 스크립트
• migrate_convert_all_to_weekday_auto.py - 자동 실행 마이그레이션 스크립트 (실행 완료)
• 평일주말_클래스_구분_완료.md - 본 보고서