""" 생활기록부 섹션 템플릿 정의 v2.0 패턴 감지가 아닌 '고정 타이틀 매칭' 방식 - 타이틀 변형을 명시적으로 정의 - 문서 버전(구버전 8섹션 / 신버전 9섹션) 자동 감지 - 대입전형용(번호 없음) 지원 """ from dataclasses import dataclass, field from typing import Optional from enum import Enum class DocVersion(Enum): """문서 버전""" V1_8_SECTIONS = "v1" # 구버전 (8섹션, ~2024) V2_9_SECTIONS = "v2" # 신버전 (9섹션, 2024~ 학교폭력 추가) COLLEGE_ADMISSION = "ca" # 대입전형용 (번호 없음) @dataclass class SectionDef: """섹션 정의""" id: str # 고유 ID titles: list[str] # 매칭할 타이틀 목록 (공백 무시 매칭) order_v1: Optional[int] = None # 구버전에서의 순서 (번호) order_v2: Optional[int] = None # 신버전에서의 순서 (번호) required: bool = True # 필수 섹션 여부 # ═══════════════════════════════════════════════════════════════════════════════ # 섹션 타이틀 정의 # ═══════════════════════════════════════════════════════════════════════════════ SECTIONS = [ SectionDef( id="인적학적", titles=["인적·학적사항", "인적 학적사항", "인적학적사항", "인적사항"], order_v1=1, order_v2=1, ), SectionDef( id="출결", titles=["출결상황", "출 결 상 황"], order_v1=2, order_v2=2, ), SectionDef( id="수상", titles=["수상경력", "수 상 경 력"], order_v1=3, order_v2=3, ), SectionDef( id="자격증", titles=["자격증 및 인증 취득상황", "자격증", "자격증 및 인증"], order_v1=4, order_v2=4, required=False, ), SectionDef( id="학교폭력", titles=["학교폭력 조치상황 관리", "학교폭력 조치상황"], order_v1=None, order_v2=5, # 신버전에만 존재 required=False, ), SectionDef( id="창체", titles=["창의적 체험활동상황", "창의적체험활동상황", "창의적 체험활동"], order_v1=5, order_v2=6, ), SectionDef( id="교과", titles=["교과학습발달상황", "교과학습 발달상황", "교과 학습 발달 상황"], order_v1=6, order_v2=7, ), SectionDef( id="독서", titles=["독서활동상황", "독서 활동 상황", "독서활동"], order_v1=7, order_v2=8, ), SectionDef( id="행동", titles=["행동특성 및 종합의견", "행동특성및종합의견", "행동 특성 및 종합 의견"], order_v1=8, order_v2=9, ), ] # 빠른 조회용 딕셔너리 SECTION_BY_ID = {s.id: s for s in SECTIONS} # ═══════════════════════════════════════════════════════════════════════════════ # 창의적 체험활동 내부 구조 # ═══════════════════════════════════════════════════════════════════════════════ @dataclass class CreativeActivityArea: """창체 영역 정의""" id: str titles: list[str] has_hours: bool = True # 시간 필드 있음 has_details: bool = True # 특기사항 있음 extra_fields: list[str] = field(default_factory=list) # 추가 필드 CREATIVE_ACTIVITY_AREAS = [ CreativeActivityArea( id="자율", titles=["자율활동", "자율 활동"], ), CreativeActivityArea( id="동아리", titles=["동아리활동", "동아리 활동"], extra_fields=["club_name"], # (동아리명)(시간) 형식 ), CreativeActivityArea( id="진로", titles=["진로활동", "진로 활동"], extra_fields=["desired_field"], # 희망분야 별도 행 ), CreativeActivityArea( id="봉사", titles=["봉사활동", "봉사 활동", "봉사활동실적"], has_details=False, # 테이블 형식 extra_fields=["date", "location", "activity", "cumulative_hours"], ), ] CREATIVE_AREA_BY_ID = {a.id: a for a in CREATIVE_ACTIVITY_AREAS} # ═══════════════════════════════════════════════════════════════════════════════ # 교과학습발달상황 내부 구조 # ═══════════════════════════════════════════════════════════════════════════════ @dataclass class AcademicCategory: """교과 카테고리 정의""" id: str titles: list[str] # 매칭할 마커 목록 (일반은 빈 목록 = 기본값) marker: Optional[str] # 문서 내 실제 마커 (일반은 None) columns: list[str] # 테이블 컬럼 구조 has_rank: bool = True # 석차등급 있음 has_distribution: bool = False # 성취도별 분포 있음 has_score: bool = True # 원점수/평균/표준편차 있음 # 카테고리별 테이블 컬럼 정의 # - 일반: 학기|교과|과목|단위수|원점수/평균(표준편차)|성취도(수강자)|석차등급 # - 진로선택: 학기|교과|과목|단위수|원점수/평균(표준편차)|성취도(수강자)|성취도별분포 # - 체육예술: 학기|교과|과목|단위수|성취도 ACADEMIC_CATEGORIES = [ AcademicCategory( id="일반", titles=[], # 기본값 - 명시적 마커 없음 marker=None, columns=["학기", "교과", "과목", "단위수", "원점수/평균(표준편차)", "성취도(수강자)", "석차등급"], has_rank=True, has_distribution=False, has_score=True, ), AcademicCategory( id="진로선택", titles=["<진로 선택 과목>", "진로 선택 과목", "진로선택", "진로 선택"], marker="<진로 선택 과목>", columns=["학기", "교과", "과목", "단위수", "원점수/평균(표준편차)", "성취도(수강자)", "성취도별분포"], has_rank=False, has_distribution=True, has_score=True, ), AcademicCategory( id="체육예술", titles=["<체육ㆍ예술>", "<체육·예술>", "체육·예술", "체육ㆍ예술", "체육예술", "체육·예술(교양)"], marker="<체육ㆍ예술>", columns=["학기", "교과", "과목", "단위수", "성취도"], has_rank=False, has_distribution=False, has_score=False, # 원점수/평균 없음 ), ] ACADEMIC_CATEGORY_BY_ID = {c.id: c for c in ACADEMIC_CATEGORIES} @dataclass class SubjectRemarkPattern: """세부능력특기사항 패턴""" # 과목 세특: "과목명: 내용" 또는 "(학기)과목명: 내용" subject_prefix_pattern: str = r"^(?:\(([12])학기\))?([가-힣A-Za-zⅠ-Ⅲ\s·]+)\s*[::]" # 개인 세특: 과목명 없이 시작 (마지막에 위치) personal_remark_min_length: int = 50 # 최소 50자 이상 # ═══════════════════════════════════════════════════════════════════════════════ # 출결상황 테이블 구조 # ═══════════════════════════════════════════════════════════════════════════════ ATTENDANCE_COLUMNS = { "primary": ["학년", "수업일수"], "absence": { "header": "결석일수", "sub": ["질병", "미인정", "기타"], }, "late": { "header": "지각", "sub": ["질병", "미인정", "기타"], }, "early_leave": { "header": "조퇴", "sub": ["질병", "미인정", "기타"], }, "class_absence": { "header": "결과", # 결과 = 수업결손 "sub": ["질병", "미인정", "기타"], }, "notes": "특기사항", } # ═══════════════════════════════════════════════════════════════════════════════ # 수상경력 테이블 구조 # ═══════════════════════════════════════════════════════════════════════════════ AWARDS_COLUMNS = [ "학년", "학기", # (학기) 또는 별도 컬럼 "수상명", "등급", # 등급(위) "수상연월일", "수여기관", "참가대상", # (참가인원) ] # ═══════════════════════════════════════════════════════════════════════════════ # 독서활동상황 구조 # ═══════════════════════════════════════════════════════════════════════════════ @dataclass class ReadingFormat: """독서활동 형식""" # 학년별로 구분 grade_based: bool = True # 과목별 구분 (있는 경우) subject_based: bool = False # 도서 형식: "제목(저자)" 또는 "제목" book_pattern: str = r"([^(]+)(?:\(([^)]+)\))?" # ═══════════════════════════════════════════════════════════════════════════════ # 헬퍼 함수 # ═══════════════════════════════════════════════════════════════════════════════ def normalize_text(text: str) -> str: """공백 및 특수문자 정규화 (매칭용)""" import re # 공백 제거 text = re.sub(r'\s+', '', text) # 특수 점(·, ㆍ) 통일 text = text.replace('ㆍ', '·') return text def match_title(text: str, titles: list[str]) -> bool: """타이틀 매칭 (공백 무시)""" normalized = normalize_text(text) for title in titles: if normalize_text(title) in normalized: return True return False def detect_doc_version(full_text: str) -> DocVersion: """문서 버전 감지""" import re # 번호 없이 섹션 시작하면 대입전형용 if re.search(r'^인적[·\s]*학적', full_text, re.MULTILINE): if not re.search(r'^\d+\.\s*인적', full_text, re.MULTILINE): return DocVersion.COLLEGE_ADMISSION # 학교폭력 섹션 있으면 신버전 if match_title(full_text, SECTION_BY_ID["학교폭력"].titles): return DocVersion.V2_9_SECTIONS return DocVersion.V1_8_SECTIONS def get_section_order(section_id: str, version: DocVersion) -> Optional[int]: """버전에 따른 섹션 순서 반환""" section = SECTION_BY_ID.get(section_id) if not section: return None if version == DocVersion.V2_9_SECTIONS: return section.order_v2 else: return section.order_v1