diff --git a/backend/app.py b/backend/app.py
index 9473765..ed3fe66 100644
--- a/backend/app.py
+++ b/backend/app.py
@@ -27,6 +27,7 @@
RouteController,
StudioController,
UserCollectionImportController,
+ UserCollectionImportHelpController,
UserController,
)
from services import (
@@ -116,6 +117,7 @@
auth_guard,
reset_job_coordinator=library_reset_job_coordinator,
)
+user_collection_import_help_controller = UserCollectionImportHelpController(auth_guard)
library_service_provider = LibraryServiceProvider()
library_controller = LibraryController(
auth_guard,
@@ -159,6 +161,7 @@
collection_share_controller.register_routes(app)
user_controller.register_routes(app)
user_collection_import_controller.register_routes(app)
+user_collection_import_help_controller.register_routes(app)
collection_controller.register_routes(app)
library_controller.register_routes(app)
platform_controller.register_routes(app)
diff --git a/backend/controllers/__init__.py b/backend/controllers/__init__.py
index 1715a5f..4fe5d0c 100644
--- a/backend/controllers/__init__.py
+++ b/backend/controllers/__init__.py
@@ -21,6 +21,7 @@
from .route_controller import RouteController
from .studio_controller import StudioController
from .user_collection_import_controller import UserCollectionImportController
+from .user_collection_import_help_controller import UserCollectionImportHelpController
from .user_controller import UserController
__all__ = [
@@ -35,4 +36,5 @@
"StudioController",
"UserController",
"UserCollectionImportController",
+ "UserCollectionImportHelpController",
]
diff --git a/backend/controllers/user_collection_import_help_controller.py b/backend/controllers/user_collection_import_help_controller.py
new file mode 100644
index 0000000..c143164
--- /dev/null
+++ b/backend/controllers/user_collection_import_help_controller.py
@@ -0,0 +1,75 @@
+# ____ _ _ ____ _ _ _ _ ___
+# / ___| | ___ _ _ __| |/ ___|___ | | | ___ ___| |_(_) ___ _ __ / _ \ _ __ _ __
+# | | | |/ _ \| | | |/ _` | | / _ \| | |/ _ \/ __| __| |/ _ \| `_ \| | | | `_ \| `_ |
+# | |___| | (_) | |_| | (_| | |__| (_) | | | __/ (__| |_| | (_) | | | | |_| | |_) | |_) |
+# \____|_|\___/ \__,_|\__,_|\____\___|_|_|\___|\___|\__|_|\___/|_| |_|\___/| .__/| .__/
+# |_| |_|
+# Projet : CloudCollectionApp
+# Date de creation : 2026-08-23
+# Auteurs : OpenAI ChatGPT, Codex, Binda Sébastien
+# Licence : Apache 2.0
+#
+# Description : controleur HTTP d'aide a la correction d'import.
+
+from flask import Flask, jsonify, request
+
+from services import AuthGuard, UserProfile
+from services.collection.imports import CollectionImportInvalidValueHelpService
+
+
+class UserCollectionImportHelpController:
+ """Enregistre les routes d'aide liees aux erreurs d'import utilisateur."""
+
+ def __init__(
+ self,
+ auth_guard: AuthGuard,
+ invalid_value_help_service_class=CollectionImportInvalidValueHelpService,
+ ):
+ """Initialise le controleur d'aide d'import.
+
+ Args:
+ auth_guard (AuthGuard): Garde d'authentification et de profil.
+ invalid_value_help_service_class (type): Classe d'aide sur les valeurs refusees.
+
+ Returns:
+ None: Le constructeur ne retourne aucune valeur.
+ """
+
+ self.auth_guard = auth_guard
+ self.invalid_value_help_service_class = invalid_value_help_service_class
+
+ def register_routes(self, flask_app: Flask) -> None:
+ """Enregistre les routes d'aide de collection utilisateur dans Flask.
+
+ Args:
+ flask_app (Flask): Application Flask cible.
+
+ Returns:
+ None: La methode ne retourne aucune valeur.
+ """
+
+ flask_app.add_url_rule(
+ "/api/users/import/invalid-value-help",
+ endpoint="get_import_invalid_value_help",
+ view_func=self.auth_guard.require_profile(UserProfile.USER.value)(
+ self.get_import_invalid_value_help
+ ),
+ methods=["GET"],
+ )
+
+ def get_import_invalid_value_help(self):
+ """Retourne l'aide de correction d'une valeur d'import refusee.
+
+ Args:
+ Aucun.
+
+ Returns:
+ tuple[flask.Response, int] | flask.Response: Aide JSON ou erreur.
+ """
+
+ field = str(request.args.get("field") or "").strip()
+ value = str(request.args.get("value") or "").strip()
+ if not field:
+ return jsonify({"error": "Le parametre field est requis."}), 400
+ help_result = self.invalid_value_help_service_class().get_help(field, value)
+ return jsonify(help_result.to_dict()), 200
diff --git a/backend/resources/collection_import_refusal_email_template.txt b/backend/resources/collection_import_refusal_email_template.txt
index 0b9d82b..6c64ff2 100644
--- a/backend/resources/collection_import_refusal_email_template.txt
+++ b/backend/resources/collection_import_refusal_email_template.txt
@@ -19,6 +19,9 @@
Code raison: ${reason}
Jeux en erreur: ${invalid_games_count}/${total_games_count}
+Compteurs d'erreur
+${error_counters}
+
Resultat de l'import
- Plateformes rattachees: ${linked_platforms}
@@ -31,9 +34,7 @@
Erreurs des jeux
${invalid_games}
-Warnings
-
-${warnings}
-
+Plateformes à valider par l'admin
+${manual_platform_mappings}