Sigarra files api

uni/lib/controller/cleanup.dart

@@ -41,3 +41,38 @@ Future<void> cleanupStoredData(BuildContext context) async {
     directory.deleteSync(recursive: true);
   }
 }
+
+Future<void> cleanupCachedFiles() async {
+  final lastCleanupDate = await PreferencesController.getLastCleanUpDate();
+  final daysSinceLastCleanup =
+      DateTime.now().difference(lastCleanupDate).inDays;
+
+  if (daysSinceLastCleanup < 14) {
+    return;
+  }
+
+  final toCleanDirectory = await getApplicationDocumentsDirectory();
+  final treshold = DateTime.now().subtract(const Duration(days: 30));
+  final directories = toCleanDirectory.listSync(followLinks: false);
+
+  for (final directory in directories) {
+    if (directory is Directory) {
+      final files = directory.listSync(recursive: true, followLinks: false);
+
+      final oldFiles = files.where((file) {
+        try {
+          final fileDate = File(file.path).lastModifiedSync();
+          return fileDate.isBefore(treshold);
+        } catch (e) {
+          return false;
+        }
+      });
+
+      for (final file in oldFiles) {
+        await File(file.path).delete();
+      }
+    }
+  }
+
+  await PreferencesController.setLastCleanUpDate(DateTime.now());
+}

uni/lib/controller/fetchers/course_units_fetcher/course_units_info_fetcher.dart

@@ -3,6 +3,7 @@ import 'package:uni/controller/fetchers/session_dependant_fetcher.dart';
 import 'package:uni/controller/networking/network_router.dart';
 import 'package:uni/controller/parsers/parser_course_unit_info.dart';
 import 'package:uni/model/entities/course_units/course_unit_class.dart';
+import 'package:uni/model/entities/course_units/course_unit_directory.dart';
 import 'package:uni/model/entities/course_units/course_unit_sheet.dart';
 import 'package:uni/model/entities/session.dart';
 
@@ -26,6 +27,27 @@ class CourseUnitsInfoFetcher implements SessionDependantFetcher {
     return parseCourseUnitSheet(response);
   }
 
+  Future<List<CourseUnitFileDirectory>> fetchCourseUnitFiles(
+    Session session,
+    int occurId,
+  ) async {
+    final url = '${getEndpoints(session)[0]}mob_ucurr_geral.conteudos';
+    final response = await NetworkRouter.getWithCookies(
+      url,
+      {
+        'pv_ocorrencia_id': occurId.toString(),
+      },
+      session,
+    );
+    return parseFiles(response, session);
+  }
+
+  Future<String> getDownloadLink(
+    Session session,
+  ) async {
+    return '${getEndpoints(session)[0]}conteudos_service.conteudos_cont';
+  }
+
   Future<List<CourseUnitClass>> fetchCourseUnitClasses(
     Session session,
     int occurrId,

uni/lib/controller/local_storage/file_offline_storage.dart

@@ -11,7 +11,7 @@ import 'package:uni/model/entities/session.dart';
 
 /// The offline image storage location on the device.
 Future<String> get _localPath async {
-  final directory = await getTemporaryDirectory();
+  final directory = await getApplicationDocumentsDirectory();
   return directory.path;
 }
 
@@ -67,9 +67,11 @@ Future<File?> _downloadAndSaveFile(
   Session? session,
   Map<String, String>? headers,
 ) async {
+  final header = headers ?? <String, String>{};
+
   final response = session == null
       ? await http.get(url.toUri(), headers: headers)
-      : await NetworkRouter.getWithCookies(url, {}, session);
+      : await NetworkRouter.getWithCookies(url, header, session);
 
   if (response.statusCode == 200) {
     return File(filePath).writeAsBytes(response.bodyBytes);

uni/lib/controller/local_storage/preferences_controller.dart

@@ -33,6 +33,7 @@ class PreferencesController {
   static const String _isDataCollectionBannerViewedKey =
       'data_collection_banner';
   static const String _locale = 'app_locale';
+  static const String _lastCacheCleanUpDate = 'last_clean';
   static const String _favoriteCards = 'favorite_cards';
   static final List<FavoriteWidgetType> _defaultFavoriteCards = [
     FavoriteWidgetType.schedule,
@@ -139,6 +140,18 @@ class PreferencesController {
     );
   }
 
+  static Future<void> setLastCleanUpDate(DateTime date) async {
+    final prefs = await SharedPreferences.getInstance();
+    await prefs.setString(_lastCacheCleanUpDate, date.toString());
+  }
+
+  static Future<DateTime> getLastCleanUpDate() async {
+    final prefs = await SharedPreferences.getInstance();
+    final date =
+        prefs.getString(_lastCacheCleanUpDate) ?? DateTime.now().toString();
+    return DateTime.parse(date);
+  }
+
   /// Deletes the user's student number and password.
   static Future<void> removePersistentUserInfo() async {
     await prefs.remove(_userNumber);

uni/lib/controller/parsers/parser_course_unit_info.dart

@@ -1,7 +1,43 @@
+import 'dart:convert';
+
 import 'package:html/parser.dart';
 import 'package:http/http.dart' as http;
+import 'package:uni/controller/fetchers/course_units_fetcher/course_units_info_fetcher.dart';
 import 'package:uni/model/entities/course_units/course_unit_class.dart';
+import 'package:uni/model/entities/course_units/course_unit_directory.dart';
+import 'package:uni/model/entities/course_units/course_unit_file.dart';
 import 'package:uni/model/entities/course_units/course_unit_sheet.dart';
+import 'package:uni/model/entities/session.dart';
+
+Future<List<CourseUnitFileDirectory>> parseFiles(
+  http.Response response,
+  Session session,
+) async {
+  final json = jsonDecode(response.body) as List<dynamic>;
+  final dirs = <CourseUnitFileDirectory>[];
+  if (json.isEmpty) return [];
+
+  for (var item in json) {
+    item = item as Map<String, dynamic>;
+    final files = <CourseUnitFile>[];
+    for (final file in item['ficheiros'] as List<dynamic>) {
+      if (file is Map<String, dynamic>) {
+        final fileName = file['nome'].toString();
+        final fileDate = file['data_actualizacao'].toString();
+        final fileCode = file['codigo'].toString();
+        final url = await CourseUnitsInfoFetcher().getDownloadLink(session);
+        final courseUnitFile = CourseUnitFile(
+          '${fileName}_$fileDate',
+          url,
+          fileCode,
+        );
+        files.add(courseUnitFile);
+      }
+    }
+    dirs.add(CourseUnitFileDirectory(item['nome'].toString(), files));
+  }
+  return dirs;
+}
 
 Future<CourseUnitSheet> parseCourseUnitSheet(http.Response response) async {
   final document = parse(response.body);

uni/lib/generated/intl/messages_en.dart

@@ -129,6 +129,7 @@ class MessageLookup extends MessageLookupByLibrary {
             MessageLookupByLibrary.simpleMessage("Deadline for next fee:"),
         "fee_notification":
             MessageLookupByLibrary.simpleMessage("Fee deadline"),
+        "files": MessageLookupByLibrary.simpleMessage("Files"),
         "first_year_registration": MessageLookupByLibrary.simpleMessage(
             "Year of first registration: "),
         "floor": MessageLookupByLibrary.simpleMessage("Floor"),
@@ -185,12 +186,14 @@ class MessageLookup extends MessageLookupByLibrary {
             "Looks like you are on vacation!"),
         "no_favorite_restaurants":
             MessageLookupByLibrary.simpleMessage("No favorite restaurants"),
+        "no_files_found":
+            MessageLookupByLibrary.simpleMessage("No files found"),
         "no_info": MessageLookupByLibrary.simpleMessage(
             "There is no information to display"),
-        "no_link":
-            MessageLookupByLibrary.simpleMessage("We couldn\'t open the link"),
         "no_library_info": MessageLookupByLibrary.simpleMessage(
             "No library occupation information available"),
+        "no_link":
+            MessageLookupByLibrary.simpleMessage("We couldn\'t open the link"),
         "no_menu_info": MessageLookupByLibrary.simpleMessage(
             "There is no information available about meals"),
         "no_menus": MessageLookupByLibrary.simpleMessage(

uni/lib/generated/intl/messages_pt_PT.dart

@@ -128,6 +128,7 @@ class MessageLookup extends MessageLookupByLibrary {
             "Data limite próxima prestação:"),
         "fee_notification":
             MessageLookupByLibrary.simpleMessage("Data limite de propina"),
+        "files": MessageLookupByLibrary.simpleMessage("Ficheiros"),
         "first_year_registration":
             MessageLookupByLibrary.simpleMessage("Ano da primeira inscrição: "),
         "floor": MessageLookupByLibrary.simpleMessage("Piso"),
@@ -186,12 +187,14 @@ class MessageLookup extends MessageLookupByLibrary {
             MessageLookupByLibrary.simpleMessage("Parece que estás de férias!"),
         "no_favorite_restaurants":
             MessageLookupByLibrary.simpleMessage("Sem restaurantes favoritos"),
+        "no_files_found":
+            MessageLookupByLibrary.simpleMessage("Nenhum ficheiro encontrado"),
         "no_info": MessageLookupByLibrary.simpleMessage(
             "Não existem informações para apresentar"),
-        "no_link": MessageLookupByLibrary.simpleMessage(
-            "Não conseguimos abrir o link"),
         "no_library_info":
             MessageLookupByLibrary.simpleMessage("Sem informação de ocupação"),
+        "no_link": MessageLookupByLibrary.simpleMessage(
+            "Não conseguimos abrir o link"),
         "no_menu_info": MessageLookupByLibrary.simpleMessage(
             "Não há informação disponível sobre refeições"),
         "no_menus": MessageLookupByLibrary.simpleMessage(

uni/lib/l10n/intl_en.arb

@@ -222,6 +222,8 @@
   "@of_month": {},
   "no_link": "We couldn't open the link",
   "@no_link": {},
+  "no_files_found": "No files found",
+  "@no_files_found": {},
   "other_links": "Other links",
   "@other_links": {},
   "pass_change_request": "For security reasons, passwords must be changed periodically.",
@@ -252,6 +254,8 @@
   "@restaurant_main_page": {},
   "room": "Room",
   "@room": {},
+  "files": "Files",
+  "@files": {},
   "school_calendar": "School Calendar",
   "@school_calendar": {},
   "semester": "Semester",

uni/lib/l10n/intl_pt_PT.arb

@@ -222,6 +222,8 @@
   "@of_month": {},
   "no_link": "Não conseguimos abrir o link",
   "@no_link": {},
+  "no_files_found": "Nenhum ficheiro encontrado",
+  "@no_files_found": {},
   "other_links": "Outros links",
   "@other_links": {},
   "pass_change_request": "Por razões de segurança, as palavras-passe têm de ser alteradas periodicamente.",
@@ -252,6 +254,8 @@
   "@restaurant_main_page": {},
   "room": "Sala",
   "@room": {},
+  "files": "Ficheiros",
+  "@files": {},
   "school_calendar": "Calendário Escolar",
   "@school_calendar": {},
   "semester": "Semestre",

uni/lib/main.dart

@@ -10,6 +10,7 @@ import 'package:provider/provider.dart';
 import 'package:sentry_flutter/sentry_flutter.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 import 'package:uni/controller/background_workers/background_callback.dart';
+import 'package:uni/controller/cleanup.dart';
 import 'package:uni/controller/fetchers/terms_and_conditions_fetcher.dart';
 import 'package:uni/controller/local_storage/preferences_controller.dart';
 import 'package:uni/generated/l10n.dart';
@@ -77,6 +78,8 @@ Future<void> main() async {
     ReferenceProvider(),
   );
 
+  unawaited(cleanupCachedFiles());
+
   // Initialize WorkManager for background tasks
   await Workmanager().initialize(
     workerStartCallback,

uni/lib/model/entities/course_units/course_unit_directory.dart

@@ -0,0 +1,8 @@
+import 'package:uni/model/entities/course_units/course_unit_file.dart';
+
+class CourseUnitFileDirectory {
+  CourseUnitFileDirectory(this.folderName, this.files);
+
+  final String folderName;
+  final List<CourseUnitFile> files;
+}

uni/lib/model/entities/course_units/course_unit_file.dart

@@ -0,0 +1,10 @@
+class CourseUnitFile {
+  CourseUnitFile(
+    this.name,
+    this.url,
+    this.fileCode,
+  );
+  String fileCode;
+  String name;
+  String url;
+}

uni/lib/model/providers/lazy/course_units_info_provider.dart

@@ -4,23 +4,25 @@ import 'package:tuple/tuple.dart';
 import 'package:uni/controller/fetchers/course_units_fetcher/course_units_info_fetcher.dart';
 import 'package:uni/model/entities/course_units/course_unit.dart';
 import 'package:uni/model/entities/course_units/course_unit_class.dart';
+import 'package:uni/model/entities/course_units/course_unit_directory.dart';
 import 'package:uni/model/entities/course_units/course_unit_sheet.dart';
 import 'package:uni/model/entities/session.dart';
 import 'package:uni/model/providers/state_provider_notifier.dart';
 import 'package:uni/model/providers/state_providers.dart';
 
 typedef SheetsMap = Map<CourseUnit, CourseUnitSheet>;
 typedef ClassesMap = Map<CourseUnit, List<CourseUnitClass>>;
+typedef FilesMap = Map<CourseUnit, List<CourseUnitFileDirectory>>;
 
 class CourseUnitsInfoProvider
-    extends StateProviderNotifier<Tuple2<SheetsMap, ClassesMap>> {
+    extends StateProviderNotifier<Tuple3<SheetsMap, ClassesMap, FilesMap>> {
   CourseUnitsInfoProvider()
       : super(
           cacheDuration: null,
           // Const constructor is not allowed here because of the
           // need for mutable maps
           // ignore: prefer_const_constructors
-          initialState: Tuple2({}, {}),
+          initialState: Tuple3({}, {}, {}),
         );
 
   UnmodifiableMapView<CourseUnit, CourseUnitSheet> get courseUnitsSheets =>
@@ -29,6 +31,9 @@ class CourseUnitsInfoProvider
   UnmodifiableMapView<CourseUnit, List<CourseUnitClass>>
       get courseUnitsClasses => UnmodifiableMapView(state!.item2);
 
+  UnmodifiableMapView<CourseUnit, List<CourseUnitFileDirectory>>
+      get courseUnitsFiles => UnmodifiableMapView(state!.item3);
+
   Future<void> fetchCourseUnitSheet(
     CourseUnit courseUnit,
     Session session,
@@ -46,17 +51,25 @@ class CourseUnitsInfoProvider
         .fetchCourseUnitClasses(session, courseUnit.occurrId);
   }
 
+  Future<void> fetchCourseUnitFiles(
+    CourseUnit courseUnit,
+    Session session,
+  ) async {
+    state!.item3[courseUnit] = await CourseUnitsInfoFetcher()
+        .fetchCourseUnitFiles(session, courseUnit.occurrId);
+  }
+
   @override
-  Future<Tuple2<SheetsMap, ClassesMap>> loadFromRemote(
+  Future<Tuple3<SheetsMap, ClassesMap, FilesMap>> loadFromRemote(
     StateProviders stateProviders,
   ) async {
-    return const Tuple2({}, {});
+    return const Tuple3({}, {}, {});
   }
 
   @override
-  Future<Tuple2<SheetsMap, ClassesMap>> loadFromStorage(
+  Future<Tuple3<SheetsMap, ClassesMap, FilesMap>> loadFromStorage(
     StateProviders stateProviders,
   ) async {
-    return const Tuple2({}, {});
+    return const Tuple3({}, {}, {});
   }
 }