@xdev-asia/xdev-knowledge-mcp 1.0.36

package/content/series/lap-trinh/flutter-dart-tu-co-ban-den-nang-cao/chapters/03-phan-3-networking-va-data/lessons/09-bai-9-http-va-rest-api-integration.md

@@ -0,0 +1,172 @@
+---
+id: 019d8b40-e301-7001-b006-flutter000301
+title: 'Bài 9: HTTP & REST API Integration'
+slug: bai-9-http-va-rest-api-integration
+description: >-
+  Dio HTTP client, interceptors, retry. JSON serialization với
+  json_serializable/freezed. Repository pattern, error handling.
+  Pagination, infinite scroll.
+duration_minutes: 150
+is_free: true
+video_url: null
+sort_order: 9
+section_title: "Phần 3: Networking & Data"
+course:
+  id: 019d8b40-e100-7001-b006-flutter000001
+  title: 'Flutter & Dart: Từ Cơ bản đến Nâng cao'
+  slug: flutter-dart-tu-co-ban-den-nang-cao
+---
+
+<h2 id="1-dio"><strong>1. Dio HTTP Client</strong></h2>
+
+<pre><code class="language-yaml">dependencies:
+  dio: ^5.4.0
+  json_annotation: ^4.8.0
+  retrofit: ^4.1.0
+
+dev_dependencies:
+  json_serializable: ^6.7.0
+  retrofit_generator: ^8.1.0
+  build_runner: ^2.4.0
+</code></pre>
+
+<pre><code class="language-dart">class ApiClient {
+  late final Dio _dio;
+
+  ApiClient({required String baseUrl, String? token}) {
+    _dio = Dio(BaseOptions(
+      baseUrl: baseUrl,
+      connectTimeout: const Duration(seconds: 10),
+      receiveTimeout: const Duration(seconds: 15),
+      headers: {'Content-Type': 'application/json'},
+    ));
+
+    _dio.interceptors.addAll([
+      LogInterceptor(requestBody: true, responseBody: true),
+      InterceptorsWrapper(
+        onRequest: (options, handler) {
+          if (token != null) options.headers['Authorization'] = 'Bearer $token';
+          handler.next(options);
+        },
+        onError: (error, handler) {
+          if (error.response?.statusCode == 401) {
+            // Refresh token logic
+          }
+          handler.next(error);
+        },
+      ),
+    ]);
+  }
+}
+</code></pre>
+
+<h2 id="2-models"><strong>2. JSON Serialization</strong></h2>
+
+<pre><code class="language-dart">import 'package:json_annotation/json_annotation.dart';
+part 'product.g.dart';
+
+@JsonSerializable()
+class Product {
+  final String id;
+  final String name;
+  final double price;
+  @JsonKey(name: 'created_at')
+  final DateTime createdAt;
+  @JsonKey(name: 'image_url')
+  final String? imageUrl;
+
+  const Product({
+    required this.id,
+    required this.name,
+    required this.price,
+    required this.createdAt,
+    this.imageUrl,
+  });
+
+  factory Product.fromJson(Map&lt;String, dynamic&gt; json) => _$ProductFromJson(json);
+  Map&lt;String, dynamic&gt; toJson() => _$ProductToJson(this);
+}
+</code></pre>
+
+<h2 id="3-repository"><strong>3. Repository Pattern</strong></h2>
+
+<pre><code class="language-dart">class ProductRepository {
+  final Dio _dio;
+
+  ProductRepository(this._dio);
+
+  Future&lt;List&lt;Product&gt;&gt; getProducts({int page = 1, int limit = 20}) async {
+    try {
+      final response = await _dio.get('/products', queryParameters: {
+        'page': page,
+        'limit': limit,
+      });
+      return (response.data['data'] as List)
+          .map((json) => Product.fromJson(json))
+          .toList();
+    } on DioException catch (e) {
+      throw ApiException.fromDioError(e);
+    }
+  }
+}
+
+class ApiException implements Exception {
+  final String message;
+  final int? statusCode;
+
+  ApiException(this.message, {this.statusCode});
+
+  factory ApiException.fromDioError(DioException e) {
+    return switch (e.type) {
+      DioExceptionType.connectionTimeout => ApiException('Kết nối timeout'),
+      DioExceptionType.receiveTimeout => ApiException('Server phản hồi chậm'),
+      _ => ApiException(e.response?.data?['message'] ?? 'Lỗi không xác định',
+          statusCode: e.response?.statusCode),
+    };
+  }
+}
+</code></pre>
+
+<h2 id="4-pagination"><strong>4. Infinite Scroll với Riverpod</strong></h2>
+
+<pre><code class="language-dart">class ProductListNotifier extends StateNotifier&lt;AsyncValue&lt;List&lt;Product&gt;&gt;&gt; {
+  final ProductRepository _repo;
+  int _page = 1;
+  bool _hasMore = true;
+
+  ProductListNotifier(this._repo) : super(const AsyncLoading()) {
+    loadMore();
+  }
+
+  Future&lt;void&gt; loadMore() async {
+    if (!_hasMore) return;
+    try {
+      final products = await _repo.getProducts(page: _page);
+      _hasMore = products.length == 20;
+      _page++;
+      state = AsyncData([
+        ...state.valueOrNull ?? [],
+        ...products,
+      ]);
+    } catch (e, st) {
+      state = AsyncError(e, st);
+    }
+  }
+}
+
+// UI — NotificationListener
+NotificationListener&lt;ScrollNotification&gt;(
+  onNotification: (notification) {
+    if (notification.metrics.pixels >= notification.metrics.maxScrollExtent - 200) {
+      ref.read(productListProvider.notifier).loadMore();
+    }
+    return false;
+  },
+  child: ListView.builder(
+    itemCount: products.length,
+    itemBuilder: (_, i) => ProductCard(product: products[i]),
+  ),
+);
+</code></pre>
+
+<p>Bài tiếp theo: <strong>Local Storage & Offline First</strong>.</p>

package/content/series/lap-trinh/flutter-dart-tu-co-ban-den-nang-cao/chapters/03-phan-3-networking-va-data/lessons/10-bai-10-local-storage-va-offline-first.md

@@ -0,0 +1,131 @@
+---
+id: 019d8b40-e302-7001-b006-flutter000302
+title: 'Bài 10: Local Storage & Offline First'
+slug: bai-10-local-storage-va-offline-first
+description: >-
+  SharedPreferences, Hive, Isar database. Drift (moor) cho SQL.
+  Offline-first architecture, sync strategies. Cache management.
+duration_minutes: 120
+is_free: true
+video_url: null
+sort_order: 10
+section_title: "Phần 3: Networking & Data"
+course:
+  id: 019d8b40-e100-7001-b006-flutter000001
+  title: 'Flutter & Dart: Từ Cơ bản đến Nâng cao'
+  slug: flutter-dart-tu-co-ban-den-nang-cao
+---
+
+<h2 id="1-shared-preferences"><strong>1. SharedPreferences</strong></h2>
+
+<pre><code class="language-dart">class SettingsService {
+  Future&lt;void&gt; setThemeMode(ThemeMode mode) async {
+    final prefs = await SharedPreferences.getInstance();
+    await prefs.setInt('theme_mode', mode.index);
+  }
+
+  Future&lt;ThemeMode&gt; getThemeMode() async {
+    final prefs = await SharedPreferences.getInstance();
+    final index = prefs.getInt('theme_mode') ?? 0;
+    return ThemeMode.values[index];
+  }
+}
+</code></pre>
+
+<h2 id="2-hive"><strong>2. Hive — NoSQL Local Database</strong></h2>
+
+<pre><code class="language-dart">@HiveType(typeId: 0)
+class CachedProduct extends HiveObject {
+  @HiveField(0)
+  final String id;
+  @HiveField(1)
+  final String name;
+  @HiveField(2)
+  final double price;
+  @HiveField(3)
+  final DateTime cachedAt;
+
+  CachedProduct({required this.id, required this.name, required this.price, required this.cachedAt});
+}
+
+// Sử dụng
+Future&lt;void&gt; main() async {
+  await Hive.initFlutter();
+  Hive.registerAdapter(CachedProductAdapter());
+  await Hive.openBox&lt;CachedProduct&gt;('products');
+  runApp(const MyApp());
+}
+
+class ProductCache {
+  final Box&lt;CachedProduct&gt; _box = Hive.box('products');
+
+  List&lt;CachedProduct&gt; getAll() => _box.values.toList();
+
+  Future&lt;void&gt; saveAll(List&lt;CachedProduct&gt; products) async {
+    await _box.clear();
+    for (final p in products) {
+      await _box.put(p.id, p);
+    }
+  }
+
+  bool isStale(Duration maxAge) {
+    if (_box.isEmpty) return true;
+    final oldest = _box.values.first.cachedAt;
+    return DateTime.now().difference(oldest) > maxAge;
+  }
+}
+</code></pre>
+
+<h2 id="3-drift"><strong>3. Drift — Type-safe SQL</strong></h2>
+
+<pre><code class="language-dart">@DriftDatabase(tables: [Products, Orders])
+class AppDatabase extends _$AppDatabase {
+  AppDatabase() : super(_openConnection());
+
+  @override
+  int get schemaVersion => 1;
+
+  Future&lt;List&lt;Product&gt;&gt; getAllProducts() => select(products).get();
+
+  Stream&lt;List&lt;Product&gt;&gt; watchProducts() => select(products).watch();
+
+  Future&lt;void&gt; insertProduct(ProductsCompanion product) =>
+      into(products).insert(product);
+}
+
+class Products extends Table {
+  TextColumn get id => text()();
+  TextColumn get name => text().withLength(min: 1, max: 255)();
+  RealColumn get price => real()();
+  DateTimeColumn get createdAt => dateTime().withDefault(currentDateAndTime)();
+
+  @override
+  Set&lt;Column&gt; get primaryKey => {id};
+}
+</code></pre>
+
+<h2 id="4-offline-first"><strong>4. Offline-First Architecture</strong></h2>
+
+<pre><code class="language-dart">class OfflineFirstRepository {
+  final ApiClient _api;
+  final ProductCache _cache;
+  final ConnectivityService _connectivity;
+
+  OfflineFirstRepository(this._api, this._cache, this._connectivity);
+
+  Future&lt;List&lt;Product&gt;&gt; getProducts() async {
+    if (await _connectivity.isOnline) {
+      try {
+        final products = await _api.getProducts();
+        await _cache.saveAll(products);
+        return products;
+      } catch (_) {
+        return _cache.getAll(); // Fallback to cache
+      }
+    }
+    return _cache.getAll(); // Offline — trả cache
+  }
+}
+</code></pre>
+
+<p>Bài tiếp theo: <strong>Firebase Integration</strong>.</p>

package/content/series/lap-trinh/flutter-dart-tu-co-ban-den-nang-cao/chapters/03-phan-3-networking-va-data/lessons/11-bai-11-firebase-integration.md

@@ -0,0 +1,118 @@
+---
+id: 019d8b40-e303-7001-b006-flutter000303
+title: 'Bài 11: Firebase Integration'
+slug: bai-11-firebase-integration
+description: >-
+  Firebase setup với FlutterFire CLI. Cloud Firestore CRUD, realtime listeners.
+  Firebase Auth, Cloud Storage, Cloud Messaging. Analytics, Crashlytics.
+duration_minutes: 150
+is_free: true
+video_url: null
+sort_order: 11
+section_title: "Phần 3: Networking & Data"
+course:
+  id: 019d8b40-e100-7001-b006-flutter000001
+  title: 'Flutter & Dart: Từ Cơ bản đến Nâng cao'
+  slug: flutter-dart-tu-co-ban-den-nang-cao
+---
+
+<h2 id="1-setup"><strong>1. Firebase Setup</strong></h2>
+
+<pre><code class="language-bash"># Cài FlutterFire CLI
+dart pub global activate flutterfire_cli
+
+# Cấu hình project
+flutterfire configure --project=my-flutter-app
+</code></pre>
+
+<pre><code class="language-dart">void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
+  runApp(const MyApp());
+}
+</code></pre>
+
+<h2 id="2-firestore"><strong>2. Cloud Firestore</strong></h2>
+
+<pre><code class="language-dart">class FirestoreProductRepository {
+  final _collection = FirebaseFirestore.instance.collection('products');
+
+  // Create
+  Future&lt;void&gt; add(Product product) async {
+    await _collection.doc(product.id).set(product.toJson());
+  }
+
+  // Read
+  Future&lt;List&lt;Product&gt;&gt; getAll() async {
+    final snapshot = await _collection.orderBy('createdAt', descending: true).get();
+    return snapshot.docs.map((doc) => Product.fromJson(doc.data())).toList();
+  }
+
+  // Realtime stream
+  Stream&lt;List&lt;Product&gt;&gt; watchAll() {
+    return _collection
+        .orderBy('createdAt', descending: true)
+        .snapshots()
+        .map((snapshot) => snapshot.docs.map((doc) => Product.fromJson(doc.data())).toList());
+  }
+
+  // Query
+  Future&lt;List&lt;Product&gt;&gt; getByCategory(String category, {int limit = 20}) async {
+    final snapshot = await _collection
+        .where('category', isEqualTo: category)
+        .where('price', isGreaterThan: 0)
+        .limit(limit)
+        .get();
+    return snapshot.docs.map((doc) => Product.fromJson(doc.data())).toList();
+  }
+
+  // Update
+  Future&lt;void&gt; update(String id, Map&lt;String, dynamic&gt; data) async {
+    await _collection.doc(id).update(data);
+  }
+
+  // Delete
+  Future&lt;void&gt; delete(String id) async {
+    await _collection.doc(id).delete();
+  }
+}
+</code></pre>
+
+<h2 id="3-storage"><strong>3. Cloud Storage</strong></h2>
+
+<pre><code class="language-dart">class StorageService {
+  final _storage = FirebaseStorage.instance;
+
+  Future&lt;String&gt; uploadImage(File file, String path) async {
+    final ref = _storage.ref().child(path);
+    final uploadTask = ref.putFile(file, SettableMetadata(contentType: 'image/jpeg'));
+
+    uploadTask.snapshotEvents.listen((event) {
+      final progress = event.bytesTransferred / event.totalBytes;
+      debugPrint('Upload: ${(progress * 100).toStringAsFixed(0)}%');
+    });
+
+    final snapshot = await uploadTask;
+    return snapshot.ref.getDownloadURL();
+  }
+}
+</code></pre>
+
+<h2 id="4-crashlytics"><strong>4. Crashlytics & Analytics</strong></h2>
+
+<pre><code class="language-dart">void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
+
+  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;
+  PlatformDispatcher.instance.onError = (error, stack) {
+    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
+    return true;
+  };
+
+  await FirebaseAnalytics.instance.logEvent(name: 'app_open');
+  runApp(const MyApp());
+}
+</code></pre>
+
+<p>Bài tiếp theo: <strong>Authentication & Authorization</strong>.</p>

package/content/series/lap-trinh/flutter-dart-tu-co-ban-den-nang-cao/chapters/03-phan-3-networking-va-data/lessons/12-bai-12-authentication-va-authorization.md

@@ -0,0 +1,155 @@
+---
+id: 019d8b40-e304-7001-b006-flutter000304
+title: 'Bài 12: Authentication & Authorization'
+slug: bai-12-authentication-va-authorization
+description: >-
+  Firebase Auth: email/password, Google Sign-In, Apple Sign-In.
+  JWT token management. Auth state persistence. Role-based access control.
+  Biometric authentication.
+duration_minutes: 120
+is_free: true
+video_url: null
+sort_order: 12
+section_title: "Phần 3: Networking & Data"
+course:
+  id: 019d8b40-e100-7001-b006-flutter000001
+  title: 'Flutter & Dart: Từ Cơ bản đến Nâng cao'
+  slug: flutter-dart-tu-co-ban-den-nang-cao
+---
+
+<h2 id="1-firebase-auth"><strong>1. Firebase Auth</strong></h2>
+
+<pre><code class="language-dart">class AuthService {
+  final FirebaseAuth _auth = FirebaseAuth.instance;
+
+  Stream&lt;User?&gt; get authStateChanges => _auth.authStateChanges();
+
+  // Email/Password
+  Future&lt;UserCredential&gt; register(String email, String password) async {
+    return _auth.createUserWithEmailAndPassword(email: email, password: password);
+  }
+
+  Future&lt;UserCredential&gt; login(String email, String password) async {
+    return _auth.signInWithEmailAndPassword(email: email, password: password);
+  }
+
+  // Google Sign-In
+  Future&lt;UserCredential&gt; signInWithGoogle() async {
+    final googleUser = await GoogleSignIn().signIn();
+    final googleAuth = await googleUser!.authentication;
+    final credential = GoogleAuthProvider.credential(
+      accessToken: googleAuth.accessToken,
+      idToken: googleAuth.idToken,
+    );
+    return _auth.signInWithCredential(credential);
+  }
+
+  Future&lt;void&gt; signOut() async {
+    await GoogleSignIn().signOut();
+    await _auth.signOut();
+  }
+}
+</code></pre>
+
+<h2 id="2-auth-state"><strong>2. Auth State với Riverpod</strong></h2>
+
+<pre><code class="language-dart">final authServiceProvider = Provider&lt;AuthService&gt;((ref) => AuthService());
+
+final authStateProvider = StreamProvider&lt;User?&gt;((ref) {
+  return ref.watch(authServiceProvider).authStateChanges;
+});
+
+// Router guard
+final routerProvider = Provider&lt;GoRouter&gt;((ref) {
+  final authState = ref.watch(authStateProvider);
+
+  return GoRouter(
+    redirect: (context, state) {
+      final isLoggedIn = authState.valueOrNull != null;
+      final isLoginRoute = state.matchedLocation == '/login';
+
+      if (!isLoggedIn && !isLoginRoute) return '/login';
+      if (isLoggedIn && isLoginRoute) return '/home';
+      return null;
+    },
+    routes: [/* ... */],
+  );
+});
+</code></pre>
+
+<h2 id="3-jwt"><strong>3. JWT Token Management</strong></h2>
+
+<pre><code class="language-dart">class TokenManager {
+  static const _storage = FlutterSecureStorage();
+
+  Future&lt;void&gt; saveTokens({required String access, required String refresh}) async {
+    await _storage.write(key: 'access_token', value: access);
+    await _storage.write(key: 'refresh_token', value: refresh);
+  }
+
+  Future&lt;String?&gt; get accessToken => _storage.read(key: 'access_token');
+  Future&lt;String?&gt; get refreshToken => _storage.read(key: 'refresh_token');
+
+  Future&lt;void&gt; clear() => _storage.deleteAll();
+}
+
+// Dio interceptor — auto-refresh token
+class AuthInterceptor extends Interceptor {
+  final TokenManager _tokenManager;
+  final Dio _dio;
+
+  AuthInterceptor(this._tokenManager, this._dio);
+
+  @override
+  void onRequest(RequestOptions options, RequestInterceptorHandler handler) async {
+    final token = await _tokenManager.accessToken;
+    if (token != null) options.headers['Authorization'] = 'Bearer $token';
+    handler.next(options);
+  }
+
+  @override
+  void onError(DioException err, ErrorInterceptorHandler handler) async {
+    if (err.response?.statusCode == 401) {
+      final refresh = await _tokenManager.refreshToken;
+      if (refresh != null) {
+        try {
+          final response = await _dio.post('/auth/refresh', data: {'refresh_token': refresh});
+          await _tokenManager.saveTokens(
+            access: response.data['access_token'],
+            refresh: response.data['refresh_token'],
+          );
+          // Retry request
+          final retryResponse = await _dio.fetch(err.requestOptions);
+          handler.resolve(retryResponse);
+          return;
+        } catch (_) {
+          await _tokenManager.clear();
+        }
+      }
+    }
+    handler.next(err);
+  }
+}
+</code></pre>
+
+<h2 id="4-biometric"><strong>4. Biometric Authentication</strong></h2>
+
+<pre><code class="language-dart">class BiometricService {
+  final _auth = LocalAuthentication();
+
+  Future&lt;bool&gt; get isAvailable async {
+    final canCheck = await _auth.canCheckBiometrics;
+    final isSupported = await _auth.isDeviceSupported();
+    return canCheck && isSupported;
+  }
+
+  Future&lt;bool&gt; authenticate() async {
+    return _auth.authenticate(
+      localizedReason: 'Xác thực để truy cập ứng dụng',
+      options: const AuthenticationOptions(biometricOnly: true),
+    );
+  }
+}
+</code></pre>
+
+<p>Bài tiếp theo: <strong>Animations & Motion</strong>.</p>