Files
2nd/10_Wiki/Topic_Programming/Coding/052_dataclass_고급_옵션.md
T
Antigravity Agent 9148c358d0 docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를
Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류.

- 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로
  자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거,
  동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거.
- 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming,
  Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business,
  Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로,
  나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는
  title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백).
  원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지.
- 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서.
- 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는
  지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지.
- Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경.
- 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
2026-07-05 00:33:48 +09:00

2.8 KiB

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, last_reinforced, review_reason, merge_history, tags, raw_sources, tech_stack, applied_in, verification_status, related_notes
id title category status canonical_id aliases duplicate_of source_trust_level confidence_score created_at updated_at last_reinforced review_reason merge_history tags raw_sources tech_stack applied_in verification_status related_notes
wiki-2026-0514-python-052 dataclass 고급 옵션 10_Wiki/Topics/Coding/Python needs_review self
python_dataclass_advanced
none C 0.6 2026-05-14 2026-05-14 2026-05-14 ai_generated_concept_batch
Python
advanced
python_dataclass_advanced
user_request:2026-05-14-python-coding-batch
language pillar
Python advanced
conceptual
dataclass
frozen
slots

dataclass 고급 옵션

한 줄 통찰

dataclass는 편의 기능이지만 도메인 모델 설계 의도를 먼저 세워야 한다.

핵심 개념

  • 요약: frozen, slots, kw_only 등 dataclass 옵션을 정리한다.
  • 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘
  • 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다.

세부 내용

  • 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다.
  • 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다.
  • 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다.
  • 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다.

의사결정 기준

  • 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다.
  • 팀이 읽고 수정할 수 있는 수준인지 확인한다.
  • 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다.

안티패턴

  • 멋있어 보여서 고급 문법을 먼저 적용한다.
  • 설명 없이 메타프로그래밍을 남발한다.
  • 디버깅 비용을 무시하고 추상화 층만 늘린다.

적용 사례

  • 아직 직접 연결된 실제 적용 사례는 없다.
  • verification_status: conceptual 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다.

중복 검사 결과

  • 2026-05-14 기준 Topics/Coding 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다.
  • 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다.

모순 및 업데이트

  • 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다.
  • 실제 프로젝트 적용이나 코드 사례가 생기면 applied_inverification_status를 갱신한다.

관련 문서

Raw Source

  • user_request:2026-05-14-python-coding-batch

변경 이력

  • 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성.