feat(ecosystem): full Grade 10 curriculum sync, real device fingerprinting, teacher video dashboard, and official textbook assets

This commit is contained in:
Hamza-Ayed
2026-09-11 16:46:40 +03:00
parent fc8f874bf9
commit d1bc39604b
404 changed files with 118547 additions and 1093 deletions
@@ -0,0 +1,148 @@
import 'dart:convert';
import 'dart:io' show Platform;
import 'dart:math';
import 'package:crypto/crypto.dart';
import 'package:device_info_plus/device_info_plus.dart';
import 'package:flutter/foundation.dart';
import 'package:shared_preferences/shared_preferences.dart';
/// Enterprise Real Device Fingerprint & Hardware Identity Service (Directorate Admin)
class DeviceFingerprintService {
static final DeviceInfoPlugin _deviceInfoPlugin = DeviceInfoPlugin();
static String? _cachedFingerprint;
static Map<String, String>? _cachedMetadata;
static const String _storageKeyDeviceId = 'saqel_admin_device_persistent_id';
/// Returns the deterministic, physical/hardware-based device fingerprint.
/// Format: saqel_{platform}_{sha256_hash_first_32_chars}
static Future<String> getFingerprint() async {
if (_cachedFingerprint != null && _cachedFingerprint!.isNotEmpty) {
return _cachedFingerprint!;
}
final metadata = await getDeviceMetadata();
_cachedFingerprint = metadata['device_fingerprint']!;
return _cachedFingerprint!;
}
/// Extracts comprehensive physical/hardware metadata from the running platform.
static Future<Map<String, String>> getDeviceMetadata() async {
if (_cachedMetadata != null) {
return _cachedMetadata!;
}
String platform = 'unknown';
String hardwareId = '';
String model = '';
String brand = '';
String osVersion = '';
String deviceName = '';
try {
if (kIsWeb) {
platform = 'web';
final web = await _deviceInfoPlugin.webBrowserInfo;
hardwareId = '${web.vendor}_${web.platform}_${web.hardwareConcurrency}';
model = web.browserName.name;
brand = web.vendor ?? 'Web';
osVersion = web.userAgent ?? 'UnknownWeb';
deviceName = 'Web Browser';
} else if (Platform.isAndroid) {
platform = 'android';
final android = await _deviceInfoPlugin.androidInfo;
hardwareId = android.id.isNotEmpty ? android.id : android.fingerprint;
model = android.model;
brand = android.brand;
osVersion = 'Android ${android.version.release} (SDK ${android.version.sdkInt})';
deviceName = '${android.brand} ${android.model}';
} else if (Platform.isIOS) {
platform = 'ios';
final ios = await _deviceInfoPlugin.iosInfo;
hardwareId = ios.identifierForVendor ?? '';
model = ios.model;
brand = 'Apple';
osVersion = 'iOS ${ios.systemVersion}';
deviceName = ios.name;
} else if (Platform.isMacOS) {
platform = 'macos';
final mac = await _deviceInfoPlugin.macOsInfo;
hardwareId = mac.systemGUID ?? '';
model = mac.model;
brand = 'Apple';
osVersion = 'macOS ${mac.osRelease}';
deviceName = mac.computerName;
} else if (Platform.isWindows) {
platform = 'windows';
final win = await _deviceInfoPlugin.windowsInfo;
hardwareId = win.deviceId;
model = win.productName;
brand = 'Microsoft';
osVersion = 'Windows ${win.majorVersion}.${win.minorVersion}.${win.buildNumber}';
deviceName = win.computerName;
} else if (Platform.isLinux) {
platform = 'linux';
final linux = await _deviceInfoPlugin.linuxInfo;
hardwareId = linux.machineId ?? '';
model = linux.name;
brand = linux.id;
osVersion = linux.versionId ?? '';
deviceName = linux.prettyName;
}
} catch (_) {
platform = kIsWeb
? 'web'
: (Platform.isAndroid
? 'android'
: (Platform.isIOS ? 'ios' : 'desktop'));
}
final persistentId = await _getOrCreatePersistentInstallationId();
final rawSeed =
'saqel_hw:$platform:$hardwareId:$brand:$model:$osVersion:$persistentId';
final hash = sha256.convert(utf8.encode(rawSeed)).toString();
final fingerprint = 'saqel_${platform}_${hash.substring(0, 32)}';
_cachedMetadata = {
'device_fingerprint': fingerprint,
'platform': platform,
'hardware_id': hardwareId,
'model': model,
'brand': brand,
'os_version': osVersion,
'device_name': deviceName,
'persistent_install_id': persistentId,
};
return _cachedMetadata!;
}
static Future<String> _getOrCreatePersistentInstallationId() async {
try {
final prefs = await SharedPreferences.getInstance();
var id = prefs.getString(_storageKeyDeviceId);
if (id != null && id.isNotEmpty) {
return id;
}
final rand = Random.secure();
final bytes = List<int>.generate(16, (_) => rand.nextInt(256));
bytes[6] = (bytes[6] & 0x0f) | 0x40;
bytes[8] = (bytes[8] & 0x3f) | 0x80;
final hex = bytes.map((b) => b.toRadixString(16).padLeft(2, '0')).join();
id =
'${hex.substring(0, 8)}-${hex.substring(8, 12)}-${hex.substring(12, 16)}-${hex.substring(16, 20)}-${hex.substring(20)}';
await prefs.setString(_storageKeyDeviceId, id);
return id;
} catch (_) {
return 'fallback-${DateTime.now().millisecondsSinceEpoch}';
}
}
static void resetCache() {
_cachedFingerprint = null;
_cachedMetadata = null;
}
}
@@ -5,6 +5,7 @@ import 'package:http/http.dart' as http;
import '../core/services/storage_service.dart';
import '../core/utils/app_logger.dart';
import '../data/models/directorate_models.dart';
import 'device_fingerprint_service.dart';
/// Authenticated API client for principals, supervisors, and directorates.
/// Operational data always comes from the server; connection errors stay errors.
@@ -21,11 +22,14 @@ class DirectorateApiService {
if (token == null || token.isEmpty) {
throw StateError('جلسة الإدارة غير متوفرة. يرجى تسجيل الدخول.');
}
final fingerprint = await DeviceFingerprintService.getFingerprint();
final metadata = await DeviceFingerprintService.getDeviceMetadata();
return {
'Accept': 'application/json',
'Content-Type': 'application/json',
'Authorization': 'Bearer $token',
'X-Device-Fingerprint': 'saqel_admin_flutter',
'X-Device-Fingerprint': fingerprint,
'X-Device-Platform': metadata['platform'] ?? 'unknown',
};
}
@@ -75,18 +79,22 @@ class DirectorateApiService {
required String otp,
required String role,
}) async {
final fingerprint = await DeviceFingerprintService.getFingerprint();
final metadata = await DeviceFingerprintService.getDeviceMetadata();
final response = await http
.post(
Uri.parse('$baseUrl/api/auth/otp/verify'),
headers: const {
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
'Content-Type': 'application/json',
'X-Device-Fingerprint': fingerprint,
'X-Device-Platform': metadata['platform'] ?? 'unknown',
},
body: json.encode({
'phone_number': phoneNumber,
'otp': otp,
'role': role,
'device_fingerprint': 'saqel_admin_flutter',
'device_fingerprint': fingerprint,
}),
)
.timeout(const Duration(seconds: 30));
+1 -1
View File
@@ -74,7 +74,7 @@ packages:
source: hosted
version: "0.3.5+5"
crypto:
dependency: transitive
dependency: "direct main"
description:
name: crypto
sha256: c8ea0233063ba03258fbcf2ca4d6dadfefe14f02fab57702265467a19f27fadf
+1
View File
@@ -32,6 +32,7 @@ dependencies:
shared_preferences: ^2.2.3
http: ^1.2.0
device_info_plus: ^10.1.0
crypto: ^3.0.3
google_fonts: ^6.2.1
intl: ^0.19.0
file_picker: 8.3.7