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 폴더 제거.
This commit is contained in:
@@ -0,0 +1,71 @@
|
||||
---
|
||||
id: wiki-2026-0514-python-145
|
||||
title: setuptools와 build backend
|
||||
category: 10_Wiki/Topics/Coding/Python
|
||||
status: needs_review
|
||||
canonical_id: self
|
||||
aliases: [python_setuptools_backend]
|
||||
duplicate_of: none
|
||||
source_trust_level: C
|
||||
confidence_score: 0.6
|
||||
created_at: 2026-05-14
|
||||
updated_at: 2026-05-14
|
||||
last_reinforced: 2026-05-14
|
||||
review_reason: ai_generated_concept_batch
|
||||
merge_history: []
|
||||
tags: [Python, packaging, python_setuptools_backend]
|
||||
raw_sources: [user_request:2026-05-14-python-coding-batch]
|
||||
tech_stack: { language: "Python", pillar: "packaging" }
|
||||
applied_in: []
|
||||
verification_status: conceptual
|
||||
related_notes: [setuptools, build backend, packaging]
|
||||
---
|
||||
|
||||
# setuptools와 build backend
|
||||
|
||||
## 한 줄 통찰
|
||||
> 패키징 도구 선택은 메타데이터, 빌드, 배포 흐름을 같이 봐야 한다.
|
||||
|
||||
## 핵심 개념
|
||||
- 요약: build backend 개념과 setuptools 위치를 정리한다.
|
||||
- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축
|
||||
- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다.
|
||||
|
||||
## 세부 내용
|
||||
- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다.
|
||||
- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다.
|
||||
- 의존성 관리는 기술 부채의 주요 출발점이다.
|
||||
- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다.
|
||||
|
||||
## 의사결정 기준
|
||||
- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다.
|
||||
- 재현 가능한 환경과 잠금 전략을 함께 설계한다.
|
||||
- 개발용 설정과 배포용 설정을 명확히 분리한다.
|
||||
|
||||
## 안티패턴
|
||||
- 전역 환경에 무분별하게 설치한다.
|
||||
- 의존성 버전 전략 없이 패키지를 추가한다.
|
||||
- 배포 메타데이터를 나중 문제로 미룬다.
|
||||
|
||||
## 적용 사례
|
||||
- 아직 직접 연결된 실제 적용 사례는 없다.
|
||||
- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다.
|
||||
|
||||
## 중복 검사 결과
|
||||
- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다.
|
||||
- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다.
|
||||
|
||||
## 모순 및 업데이트
|
||||
- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다.
|
||||
- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다.
|
||||
|
||||
## 관련 문서
|
||||
- [[setuptools]]
|
||||
- [[build backend]]
|
||||
- [[packaging]]
|
||||
|
||||
## Raw Source
|
||||
- user_request:2026-05-14-python-coding-batch
|
||||
|
||||
## 변경 이력
|
||||
- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성.
|
||||
Reference in New Issue
Block a user