Initial commit

flutter/lib/features/.gitkeep

@@ -0,0 +1 @@
+// Empty directory placeholder

flutter/lib/features/user/data/models/user_model.dart

@@ -0,0 +1,27 @@
+/// 사용자 모델 — 백엔드 UserResponseDto 와 1:1 대응한다.
+/// (freezed/json_serializable 도입 시 이 클래스를 생성 모델로 교체)
+class UserModel {
+  const UserModel({
+    required this.id,
+    required this.email,
+    required this.name,
+  });
+
+  final int id;
+  final String email;
+  final String name;
+
+  factory UserModel.fromJson(Map<String, dynamic> json) {
+    return UserModel(
+      id: json['id'] as int,
+      email: json['email'] as String,
+      name: json['name'] as String,
+    );
+  }
+
+  Map<String, dynamic> toJson() => {
+        'id': id,
+        'email': email,
+        'name': name,
+      };
+}

flutter/lib/features/user/data/repositories/user_repository.dart

@@ -0,0 +1,44 @@
+import 'package:dio/dio.dart';
+
+import '../models/user_model.dart';
+
+/// 사용자 API 호출 구현체 — 새 도메인은 이 패턴을 복제한다.
+///
+/// 응답 언래핑({ success, data } → data)과 에러 코드 매핑은 dio 인터셉터가 담당하므로
+/// 리포지토리는 파싱만 책임진다. (여기서 try/catch 로 메시지를 만들지 않는다)
+class UserRepository {
+  const UserRepository(this._dio);
+
+  final Dio _dio;
+
+  Future<UserModel> getUser(int id) async {
+    final response = await _dio.get<Map<String, dynamic>>('/users/$id');
+    return UserModel.fromJson(response.data!);
+  }
+
+  /// 커서 기반 목록 조회 — 목록 API 는 항상 페이지네이션을 적용한다.
+  Future<({List<UserModel> items, String? nextCursor, bool hasNext})> getUsers({
+    int limit = 20,
+    String? cursor,
+  }) async {
+    final response = await _dio.get<Map<String, dynamic>>(
+      '/users',
+      queryParameters: {
+        'limit': limit,
+        'cursor': ?cursor,
+      },
+    );
+
+    final data = response.data!;
+    final items = (data['items'] as List<dynamic>)
+        .map((json) => UserModel.fromJson(json as Map<String, dynamic>))
+        .toList();
+    final pageInfo = data['pageInfo'] as Map<String, dynamic>;
+
+    return (
+      items: items,
+      nextCursor: pageInfo['nextCursor'] as String?,
+      hasNext: pageInfo['hasNext'] as bool? ?? false,
+    );
+  }
+}

flutter/lib/features/user/presentation/providers/user_provider.dart

@@ -0,0 +1,15 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../../../../core/api/dio_provider.dart';
+import '../../data/models/user_model.dart';
+import '../../data/repositories/user_repository.dart';
+
+// 리포지토리 Provider — dioProvider 를 주입받아 생성
+final userRepositoryProvider = Provider<UserRepository>((ref) {
+  return UserRepository(ref.watch(dioProvider));
+});
+
+// 특정 사용자 조회 Provider (family)
+// 위젯에서: ref.watch(userProvider(id)).when(data:..., loading:..., error:...)
+final userProvider = FutureProvider.family<UserModel, int>((ref, id) {
+  return ref.watch(userRepositoryProvider).getUser(id);
+});