테스트 주석화 계획 문서 추가

doc/commenting_plan.md

@@ -44,5 +44,8 @@
 - 대용량 파일(>400 LOC)은 주석보다 구조 분리를 우선 검토.
 ## 인벤토리 모듈 주석화
 자세한 일정과 적용 파일은 doc/inventory_commenting_plan.md 참고
+
+## 테스트 주석화
+세부 계획은 doc/test_commenting_plan.md 참고
 ## Core/Widgets 주석화
 세부 계획은 doc/core_commenting_plan.md 참고

doc/test_commenting_plan.md

@@ -0,0 +1,27 @@
+# 테스트 주석화 계획
+
+| 테스트 파일 | 주석 방향 |
+|--------------|----------------|
+| test/core/permissions/permission_manager_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/approvals/history/presentation/controllers/approval_history_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/approvals/presentation/controllers/approval_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/approvals/step/presentation/controllers/approval_step_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/approvals/template/presentation/controllers/approval_template_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/customer/presentation/controllers/customer_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/group/presentation/controllers/group_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/group_permission/presentation/controllers/group_permission_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/menu/presentation/controllers/menu_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/product/presentation/controllers/product_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/user/presentation/controllers/user_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/vendor/presentation/controllers/vendor_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+| test/features/masters/warehouse/presentation/controllers/warehouse_controller_test.dart | 주요 기능 테스트 목표 및 검증 범위 |
+
+## 우선 적용
+1. 결재/인벤토리 컨트롤러 테스트
+2. 마스터 관리 컨트롤러 테스트
+3. 공통 위젯/유틸 테스트
+
+## 주석 작성 원칙
+- 시나리오별로 // 주석으로 목적/검증 포인트 요약
+- Mock/Stub 선언부에는 /// Doc 주석으로 역할 설명
+- 공통 헬퍼 함수에는 /// Doc 주석 작성