# Core/Widgets 주석화 계획

## 대상 모듈 (1차)
| 우선순위 | 파일 | 주석 필요 위치 |
|----------|------|----------------|
| 1 | `lib/core/network/api_client.dart` | API 호출, 에러 매핑, 인터셉터 연결 |
| 1 | `lib/core/network/api_error.dart` | 에러 모델/매퍼 설명 |
| 1 | `lib/core/permissions/permission_manager.dart` | 권한 검사/Scope 동작 |
| 2 | `lib/core/config/environment.dart` | env 초기화 흐름, 추가 설명 필요시 |
| 2 | `lib/core/theme/superport_shad_theme.dart` | 테마 팩토리 설명 |
| 2 | `lib/core/routing/app_router.dart` | 라우터 설정 요약 |
| 3 | `lib/widgets/components/**` (이미 일부 주석 있음) | 추가 주석 대상 확인 |

## 진행 순서
1. `core/network` → `core/permissions`
2. `core/theme`, `core/routing`, `core/config`
3. 추가 위젯/공통 컴포넌트 재검토

## 작성 원칙
- 퍼블릭 API, 초기화 로직, 복잡한 흐름 중심으로 `///` Doc 주석 작성
- `//` 한 줄 주석은 로직 분기 / 예외 처리 근거에만 사용
- 주석 추가 후 `flutter analyze`, `flutter test`

## 산출물
- 파일별 주석 적용 커밋
- 계획 문서(`doc/core_commenting_plan.md`) 유지 보수