Initial project

apps/im_app/lib/data/models/user_dto.dart

@@ -0,0 +1,68 @@
+import 'package:json_annotation/json_annotation.dart';
+
+import '../../domain/entities/user.dart';
+
+part 'user_dto.g.dart';
+
+/// 用户 DTO（Data Transfer Object）
+///
+/// local / remote 共用的数据传输对象，放在 data/models/。
+/// 提供与 Domain Entity [User] 之间的双向转换。
+///
+/// ## 数据流位置（本地存储场景）
+///
+/// ```
+/// 写入本地：
+///   LoginData.toEntity() → User
+///     → UserDto.fromEntity(user) → ★ UserDto ★   ← 你在这里
+///       → toJson() → SQLite / SharedPreferences
+///
+/// 读取本地：
+///   SQLite / SharedPreferences → JSON
+///     → ★ UserDto.fromJson() ★                    ← 你在这里
+///       → UserDto.toEntity() → User
+///         → ViewModel.state → View
+/// ```
+///
+/// 注意：登录接口的 Response DTO 是 [LoginData]（含 token），
+/// 本类用于纯用户信息的本地持久化，不含 token。
+@JsonSerializable()
+class UserDto {
+  @JsonKey(name: 'user_id')
+  final String userId;
+  final String email;
+  final String? nickname;
+  final String? avatar;
+
+  const UserDto({
+    required this.userId,
+    required this.email,
+    this.nickname,
+    this.avatar,
+  });
+
+  factory UserDto.fromJson(Map<String, dynamic> json) =>
+      _$UserDtoFromJson(json);
+
+  Map<String, dynamic> toJson() => _$UserDtoToJson(this);
+
+  /// DTO → Domain Entity
+  User toEntity() {
+    return User(
+      id: userId,
+      email: email,
+      nickname: nickname,
+      avatar: avatar,
+    );
+  }
+
+  /// Domain Entity → DTO
+  factory UserDto.fromEntity(User user) {
+    return UserDto(
+      userId: user.id,
+      email: user.email,
+      nickname: user.nickname,
+      avatar: user.avatar,
+    );
+  }
+}