feat(apps): 重构 UI 架构为 presentation 层并新增 l10n 国际化支持

apps/lib/features/contacts/data/users/models/user_response.dart

@@ -0,0 +1,41 @@
+class UserResponse {
+  final String id;
+  final String username;
+  final String? phone;
+  final String? avatarUrl;
+  final String? bio;
+
+  const UserResponse({
+    required this.id,
+    required this.username,
+    this.phone,
+    this.avatarUrl,
+    this.bio,
+  });
+
+  factory UserResponse.fromJson(Map<String, dynamic> json) {
+    return UserResponse(
+      id: json['id'] as String,
+      username: json['username'] as String,
+      phone: json['phone'] as String?,
+      avatarUrl: json['avatar_url'] as String?,
+      bio: json['bio'] as String?,
+    );
+  }
+}
+
+class UserUpdateRequest {
+  final String? username;
+  final String? avatarUrl;
+  final String? bio;
+
+  const UserUpdateRequest({this.username, this.avatarUrl, this.bio});
+
+  Map<String, dynamic> toJson() {
+    return {
+      if (username != null) 'username': username,
+      if (avatarUrl != null) 'avatar_url': avatarUrl,
+      if (bio != null) 'bio': bio,
+    };
+  }
+}

apps/lib/features/contacts/data/users/users_api.dart

@@ -0,0 +1,73 @@
+import 'dart:io';
+import 'package:dio/dio.dart';
+import 'package:social_app/core/network/i_api_client.dart';
+import 'models/user_response.dart';
+
+class UserBasicInfo {
+  final String id;
+  final String username;
+  final String? avatarUrl;
+
+  UserBasicInfo({required this.id, required this.username, this.avatarUrl});
+
+  factory UserBasicInfo.fromJson(Map<String, dynamic> json) {
+    return UserBasicInfo(
+      id: json['id'] as String,
+      username: json['username'] as String,
+      avatarUrl: json['avatar_url'] as String?,
+    );
+  }
+}
+
+class UsersApi {
+  final IApiClient _client;
+  static const _prefix = '/api/v1/users';
+
+  UsersApi(this._client);
+
+  Future<UserBasicInfo> getById(String userId) async {
+    final response = await _client.get('$_prefix/$userId');
+    return UserBasicInfo.fromJson(response.data);
+  }
+
+  Future<UserResponse> getMe() async {
+    final response = await _client.get('$_prefix/me');
+    return UserResponse.fromJson(response.data);
+  }
+
+  Future<UserResponse> updateMe(UserUpdateRequest request) async {
+    final response = await _client.patch('$_prefix/me', data: request.toJson());
+    return UserResponse.fromJson(response.data);
+  }
+
+  Future<String> uploadAvatar(File file) async {
+    final formData = FormData.fromMap({
+      'file': await MultipartFile.fromFile(
+        file.path,
+        filename: file.path.split('/').last,
+      ),
+    });
+    final response = await _client.post<Map<String, dynamic>>(
+      '$_prefix/me/avatar',
+      data: formData,
+    );
+    final payload = response.data;
+    if (payload is! Map<String, dynamic>) {
+      throw StateError('Invalid /users/me/avatar response');
+    }
+    final url = payload['url'];
+    if (url is! String) {
+      throw StateError('Missing url in /users/me/avatar response');
+    }
+    return url;
+  }
+
+  Future<List<UserResponse>> searchUsers(String query) async {
+    final response = await _client.post(
+      '$_prefix/search',
+      data: {'query': query},
+    );
+    final List<dynamic> data = response.data;
+    return data.map((json) => UserResponse.fromJson(json)).toList();
+  }
+}

apps/lib/features/contacts/data/users/users_repository.dart

@@ -0,0 +1,7 @@
+import 'models/user_response.dart';
+
+abstract class UsersRepository {
+  Future<UserResponse> getMe();
+  Future<UserResponse> updateMe(UserUpdateRequest request);
+  Future<List<UserResponse>> searchUsers(String query);
+}

apps/lib/features/contacts/data/users/users_repository_impl.dart

@@ -0,0 +1,24 @@
+import 'users_api.dart';
+import 'users_repository.dart';
+import 'models/user_response.dart';
+
+class UsersRepositoryImpl implements UsersRepository {
+  final UsersApi _api;
+
+  UsersRepositoryImpl({required UsersApi api}) : _api = api;
+
+  @override
+  Future<UserResponse> getMe() {
+    return _api.getMe();
+  }
+
+  @override
+  Future<UserResponse> updateMe(UserUpdateRequest request) {
+    return _api.updateMe(request);
+  }
+
+  @override
+  Future<List<UserResponse>> searchUsers(String query) {
+    return _api.searchUsers(query);
+  }
+}