feat: 응답 계약 정의와 페이지네이션·추적 ID 추가

세 클라이언트가 공유하는 계약 중 정의가 빠져 있던 부분을 채운다.

- 목록 응답 형태를 {items, pageInfo} 로 고정하고 커서/오프셋 쿼리 DTO 제공
- @SkipTransform() 으로 스트림·204 등 래핑하면 안 되는 응답을 제외
- ApiStandardResponse/ApiErrorResponse 로 Swagger 문서를 실응답과 일치시킴
  (컨트롤러는 raw 를 반환하지만 실제 응답은 래핑되어 문서가 어긋나 있었다)
- RequestIdMiddleware 로 모든 요청에 x-request-id 부여
- API 설계 규약(api-design.md) 신설 — REST 경로·쿼리·날짜/ID 표현·버전 관리

또한 .gitignore 의 data/ 패턴이 모든 depth 에 매칭되어
flutter/lib/features/user/data/ 의 소스가 커밋되지 않던 문제를 함께 고친다.
(user_provider.dart 가 import 하는 파일이 저장소에 없어 flutter analyze 가 깨져 있었다)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

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,
+    );
+  }
+}