주석화 진행상황 정리하고 핵심 모듈에 한글 주석 추가

lib/features/masters/user/domain/entities/user.dart

@@ -1,3 +1,4 @@
+/// 사용자(User) 도메인 엔티티.
 class UserAccount {
   UserAccount({
     this.id,
@@ -25,6 +26,7 @@ class UserAccount {
   final DateTime? createdAt;
   final DateTime? updatedAt;
 
+  /// 선택된 속성만 변경한 새 인스턴스를 반환한다.
   UserAccount copyWith({
     int? id,
     String? employeeNo,
@@ -54,6 +56,7 @@ class UserAccount {
   }
 }
 
+/// 사용자에 연결된 그룹 정보.
 class UserGroup {
   UserGroup({required this.id, required this.groupName});
 
@@ -61,6 +64,7 @@ class UserGroup {
   final String groupName;
 }
 
+/// 사용자 생성/수정 입력 모델.
 class UserInput {
   UserInput({
     required this.employeeNo,
@@ -80,6 +84,7 @@ class UserInput {
   final bool isActive;
   final String? note;
 
+  /// API 요청 바디로 직렬화한다.
   Map<String, dynamic> toPayload() {
     return {
       'employee_no': employeeNo,

lib/features/masters/user/domain/repositories/user_repository.dart

@@ -2,7 +2,9 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 
 import '../entities/user.dart';
 
+/// 사용자 데이터를 다루는 도메인 저장소 인터페이스.
 abstract class UserRepository {
+  /// 사용자 목록을 조회한다.
   Future<PaginatedResult<UserAccount>> list({
     int page = 1,
     int pageSize = 20,
@@ -11,11 +13,15 @@ abstract class UserRepository {
     bool? isActive,
   });
 
+  /// 사용자를 생성한다.
   Future<UserAccount> create(UserInput input);
 
+  /// 사용자 정보를 수정한다.
   Future<UserAccount> update(int id, UserInput input);
 
+  /// 사용자를 삭제한다.
   Future<void> delete(int id);
 
+  /// 삭제된 사용자를 복구한다.
   Future<UserAccount> restore(int id);
 }