MotorSignal-App/lib/services/github/github_sync_service.dart

292 lines
11 KiB
Dart

import 'dart:convert';
import 'dart:io';
import 'package:drift/drift.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:http/http.dart' as http;
import 'package:intl/intl.dart';
import 'package:shared_preferences/shared_preferences.dart';
import '../../core/version/app_identity.dart';
import '../../database/database.dart';
import '../../features/records/records_service.dart';
import '../export_service.dart';
import '../field_test/field_test_export_service.dart';
import 'github_auth_service.dart';
enum GitHubUploadState {
idle,
queued,
uploading,
success,
failed,
authRequired,
}
class GitHubUploadResult {
final bool success;
final String message;
final String? commitSha;
final String? targetPath;
final DateTime timestamp;
GitHubUploadResult({
required this.success,
required this.message,
this.commitSha,
this.targetPath,
DateTime? timestamp,
}) : timestamp = timestamp ?? DateTime.now();
}
/// Offline-first background synchronization service for GitHub ride logs
class GitHubSyncService extends ChangeNotifier {
final AppDatabase _db;
final GitHubAuthService _auth;
final SharedPreferences _prefs;
final http.Client _client;
GitHubUploadState _state = GitHubUploadState.idle;
String _statusMessage = '';
final Set<int> _uploadQueue = {};
GitHubSyncService(this._db, this._auth, this._prefs, [http.Client? client])
: _client = client ?? http.Client();
GitHubUploadState get state => _state;
String get statusMessage => _statusMessage;
Set<int> get queuedRideIds => Set.unmodifiable(_uploadQueue);
bool isRideUploaded(int rideId) {
return _prefs.getBool('github_uploaded_ride_$rideId') ?? false;
}
String? getRideCommitSha(int rideId) {
return _prefs.getString('github_sha_ride_$rideId');
}
String? getRideUploadTimestamp(int rideId) {
return _prefs.getString('github_uploaded_at_ride_$rideId');
}
/// Queues a ride for background synchronization
void queueRideForUpload(int rideId) {
if (isRideUploaded(rideId)) return;
_uploadQueue.add(rideId);
_state = GitHubUploadState.queued;
_statusMessage = 'Ride #$rideId queued for GitHub upload';
notifyListeners();
// Trigger async upload
processQueue();
}
/// Processes queued rides sequentially without blocking main thread
Future<void> processQueue() async {
if (_uploadQueue.isEmpty || _state == GitHubUploadState.uploading) return;
final token = _auth.getToken();
if (token == null || token.isEmpty) {
_state = GitHubUploadState.authRequired;
_statusMessage = 'GitHub Personal Access Token required for sync';
notifyListeners();
return;
}
final toProcess = List<int>.from(_uploadQueue);
for (final rideId in toProcess) {
await uploadRide(rideId);
}
}
/// Synchronizes a specific ride session to GitHub repository
Future<GitHubUploadResult> uploadRide(int rideId, {bool isManual = false}) async {
final token = _auth.getToken();
if (token == null || token.isEmpty) {
_state = GitHubUploadState.authRequired;
_statusMessage = 'GitHub token required';
notifyListeners();
return GitHubUploadResult(success: false, message: 'Authentication required');
}
_state = GitHubUploadState.uploading;
_statusMessage = 'Uploading Ride #$rideId to GitHub...';
notifyListeners();
try {
final ride = await (_db.select(_db.rides)..where((r) => r.id.equals(rideId))).getSingleOrNull();
if (ride == null) {
_state = GitHubUploadState.failed;
_statusMessage = 'Ride #$rideId not found in local database';
notifyListeners();
return GitHubUploadResult(success: false, message: 'Ride record not found');
}
final dateStr = DateFormat('yyyy-MM-dd-HHmmss').format(ride.startTime.toLocal());
final folderName = 'field_test_session_${rideId}_$dateStr/field_test_session';
final repo = _auth.getRepository();
final branch = _auth.getBranch();
// Generate bundle files from local SQLite database (preserving offline data integrity)
final fieldTestExport = FieldTestExportService(_db);
final exportService = ExportService(_db);
final sessionJson = await fieldTestExport.generateFieldTestSessionJson(rideId);
final eventsCsv = await fieldTestExport.generateFieldTestEventsCsv(rideId);
final telemetryCsv = await exportService.exportRideCsv(rideId);
final gpxContent = await exportService.exportRideGpx(rideId);
final samples = await (_db.select(_db.telemetrySamples)
..where((t) => t.rideId.equals(rideId))
..orderBy([(t) => OrderingTerm(expression: t.timestamp)])
).get();
final events = await (_db.select(_db.fieldTestEvents)
..where((e) => e.rideId.equals(rideId))
..orderBy([(e) => OrderingTerm(expression: e.timestamp)])
).get();
final summaryRecord = await (_db.select(_db.fieldTestSummaries)
..where((s) => s.rideId.equals(rideId))
).getSingleOrNull();
final appIdentity = AppIdentity.current();
// README.txt
final readme = StringBuffer();
readme.writeln('=====================================================');
readme.writeln('MOTORCYCLE DASH — FORENSIC FIELD TEST SESSION REPORT');
readme.writeln('=====================================================');
readme.writeln('Application Version: ${appIdentity.semanticVersion}');
readme.writeln('Build Number: ${appIdentity.buildNumber}');
readme.writeln('Git Revision: ${appIdentity.gitCommit}');
readme.writeln('Git Branch: ${appIdentity.gitBranch}');
readme.writeln('Release Channel: ${appIdentity.releaseChannel}');
readme.writeln('Telemetry Schema Version: ${appIdentity.telemetrySchemaVersion}');
readme.writeln('Export Format Version: ${appIdentity.exportSchemaVersion}');
readme.writeln('Build Timestamp: ${appIdentity.buildTimestamp}');
readme.writeln('Field Test Session / Ride ID: $rideId');
readme.writeln('Session Start: ${ride.startTime.toIso8601String()}');
readme.writeln('Session End: ${ride.endTime?.toIso8601String() ?? "IN_PROGRESS"}');
readme.writeln('Export Timestamp: ${DateTime.now().toIso8601String()}');
readme.writeln('Summary Result: ${summaryRecord?.rideQualityRating ?? "COMPLETED"}');
readme.writeln('Ride Quality Score: ${summaryRecord?.rideQualityScore ?? 100} / 100');
readme.writeln('Total Telemetry Samples: ${samples.length}');
readme.writeln('Total Forensic Events: ${events.length}');
// ride_summary.json
final rideSummaryJson = const JsonEncoder.withIndent(' ').convert({
'rideId': ride.id,
'startTime': ride.startTime.toIso8601String(),
'endTime': ride.endTime?.toIso8601String(),
'distanceMiles': ride.distanceMiles,
'topSpeedMph': ride.topSpeedMph,
'maxLeanLeft': ride.maxLeanLeft,
'maxLeanRight': ride.maxLeanRight,
'maxMovingLeanLeft': ride.maxLeanLeft,
'maxMovingLeanRight': ride.maxLeanRight,
'maxAccelG': ride.maxAccelG,
'maxBrakingG': ride.maxBrakingG,
'averageSpeed': ride.averageSpeed,
'movingTime': ride.movingTime,
'stoppedTime': ride.stoppedTime,
'qualityScore': summaryRecord?.rideQualityScore ?? 100,
'qualityRating': summaryRecord?.rideQualityRating ?? 'EXCELLENT',
'software': appIdentity.toJson(),
});
final filesToUpload = <String, String>{
'$folderName/README.txt': readme.toString(),
'$folderName/ride_summary.json': rideSummaryJson,
'$folderName/field_test_session.json': sessionJson,
'$folderName/field_test_events.csv': eventsCsv,
'$folderName/telemetry.csv': telemetryCsv,
};
if (gpxContent.isNotEmpty) {
filesToUpload['$folderName/telemetry.gpx'] = gpxContent;
}
String? lastCommitSha;
for (final entry in filesToUpload.entries) {
final filePath = entry.key;
final fileContent = entry.value;
// Check if file already exists on branch to retrieve SHA
String? existingSha;
final getUrl = Uri.parse('https://api.github.com/repos/$repo/contents/$filePath?ref=$branch');
final getRes = await _client.get(getUrl, headers: {
'Authorization': 'Bearer $token',
'Accept': 'application/vnd.github.v3+json',
'User-Agent': 'MotorSignal-Telemetry/1.0.2',
}).timeout(const Duration(seconds: 10));
if (getRes.statusCode == 200) {
final data = jsonDecode(getRes.body);
existingSha = data['sha'];
}
// Upload file via Contents API
final putUrl = Uri.parse('https://api.github.com/repos/$repo/contents/$filePath');
final payload = <String, dynamic>{
'message': 'feat(telemetry): upload ride #$rideId forensic session data [v1.0.2+102]',
'content': base64.encode(utf8.encode(fileContent)),
'branch': branch,
};
if (existingSha != null) {
payload['sha'] = existingSha;
}
final putRes = await _client.put(
putUrl,
headers: {
'Authorization': 'Bearer $token',
'Accept': 'application/vnd.github.v3+json',
'Content-Type': 'application/json',
'User-Agent': 'MotorSignal-Telemetry/1.0.2',
},
body: jsonEncode(payload),
).timeout(const Duration(seconds: 15));
if (putRes.statusCode == 200 || putRes.statusCode == 201) {
final resData = jsonDecode(putRes.body);
lastCommitSha = resData['commit']?['sha'];
} else {
throw HttpException('Failed uploading $filePath (Status: ${putRes.statusCode})');
}
}
// Record success metadata locally
await _prefs.setBool('github_uploaded_ride_$rideId', true);
await _prefs.setString('github_uploaded_at_ride_$rideId', DateTime.now().toIso8601String());
if (lastCommitSha != null) {
await _prefs.setString('github_sha_ride_$rideId', lastCommitSha);
}
_uploadQueue.remove(rideId);
_state = GitHubUploadState.success;
_statusMessage = 'Ride #$rideId successfully uploaded to $repo ($branch)';
notifyListeners();
return GitHubUploadResult(
success: true,
message: _statusMessage,
commitSha: lastCommitSha,
targetPath: folderName,
);
} catch (e) {
_state = GitHubUploadState.failed;
_statusMessage = 'Upload failed for Ride #$rideId: $e';
notifyListeners();
return GitHubUploadResult(
success: false,
message: 'Upload failed: $e',
);
}
}
}
final githubSyncServiceProvider = ChangeNotifierProvider<GitHubSyncService>((ref) {
final db = ref.watch(databaseProvider);
final auth = ref.watch(githubAuthServiceProvider);
final prefs = ref.watch(sharedPreferencesProvider);
return GitHubSyncService(db, auth, prefs);
});