ajout message info, doc

app/entreprises/routes.py

@@ -53,7 +53,7 @@ from werkzeug.utils import secure_filename
 @permission_required(Permission.RelationsEntreprisesView)
 def index():
     """
-    Permet d'afficher une page avec la liste des entreprises et une liste des dernières opérations
+    Permet d'afficher une page avec la liste des entreprises (visible) et une liste des dernières opérations
     """
     entreprises = Entreprise.query.filter_by(visible=True)
     logs = EntrepriseLog.query.order_by(EntrepriseLog.date.desc()).limit(LOGS_LEN).all()
@@ -86,7 +86,7 @@ def logs():
 @permission_required(Permission.RelationsEntreprisesValidate)
 def validation():
     """
-    Permet d'afficher une page avec la liste des entreprises a valider
+    Permet d'afficher une page avec la liste des entreprises a valider (non visible)
     """
     entreprises = Entreprise.query.filter_by(visible=False).all()
     return render_template(
@@ -100,7 +100,7 @@ def validation():
 @permission_required(Permission.RelationsEntreprisesView)
 def contacts():
     """
-    Permet d'afficher une page la liste des contacts et une liste des dernières opérations
+    Permet d'afficher une page avec la liste des contacts des entreprises visibles et une liste des dernières opérations
     """
     contacts = (
         db.session.query(EntrepriseContact, Entreprise)
@@ -170,7 +170,7 @@ def fiche_entreprise(id):
 @permission_required(Permission.RelationsEntreprisesView)
 def logs_entreprise(id):
     """
-    Permet d'afficher les logs (toutes les entreprises)
+    Permet d'afficher les logs d'une entreprise
     """
     page = request.args.get("page", 1, type=int)
     entreprise = Entreprise.query.filter_by(id=id, visible=True).first_or_404(
@@ -211,7 +211,7 @@ def fiche_entreprise_validation(id):
 @permission_required(Permission.RelationsEntreprisesView)
 def offres_recues():
     """
-    Permet d'afficher la page où l'on recoit les offres
+    Permet d'afficher la page où l'on peut voir les offres reçues
     """
     offres_recues = (
         db.session.query(EntrepriseEnvoiOffre, EntrepriseOffre)
@@ -624,6 +624,9 @@ def delete_offre(id):
 @bp.route("/delete_offre_recue/<int:id>", methods=["GET", "POST"])
 @permission_required(Permission.RelationsEntreprisesView)
 def delete_offre_recue(id):
+    """
+    Permet de supprimer une offre reçue
+    """
     offre_recue = EntrepriseEnvoiOffre.query.filter_by(
         id=id, receiver_id=current_user.id
     ).first_or_404(description=f"offre recu {id} inconnue")
@@ -635,11 +638,18 @@ def delete_offre_recue(id):
 @bp.route("/expired/<int:id>", methods=["GET", "POST"])
 @permission_required(Permission.RelationsEntreprisesChange)
 def expired(id):
+    """
+    Permet de rendre expirée et non expirée une offre
+    """
     offre = EntrepriseOffre.query.filter_by(id=id).first_or_404(
         description=f"offre {id} inconnue"
     )
     offre.expired = not offre.expired
     db.session.commit()
+    if offre.expired:
+        flash("L'offre a été rendu expirée")
+    else:
+        flash("L'offre a été rendu non expirée")
     return redirect(url_for("entreprises.fiche_entreprise", id=offre.entreprise_id))
 
 
@@ -815,7 +825,7 @@ def add_historique(id):
 @permission_required(Permission.RelationsEntreprisesSend)
 def envoyer_offre(id):
     """
-    Permet d'envoyer une offre à un utilisateur
+    Permet d'envoyer une offre à un utilisateur ScoDoc
     """
     offre = EntrepriseOffre.query.filter_by(id=id).first_or_404(
         description=f"offre {id} inconnue"
@@ -877,7 +887,7 @@ def json_etudiants():
 @permission_required(Permission.RelationsEntreprisesChange)
 def json_responsables():
     """
-    Permet de récuperer un JSON avec tous les étudiants
+    Permet de récuperer un JSON avec tous les utilisateurs ScoDoc
     """
     if request.args.get("term") is None:
         abort(400)
@@ -921,7 +931,7 @@ def export_entreprises():
 @permission_required(Permission.RelationsEntreprisesExport)
 def get_import_entreprises_file_sample():
     """
-    Permet de récupérer un fichier pour pouvoir importer des entreprises
+    Permet de récupérer un fichier exemple vide pour pouvoir importer des entreprises
     """
     keys = [
         "siret",
@@ -1052,7 +1062,7 @@ def export_contacts():
 @permission_required(Permission.RelationsEntreprisesExport)
 def get_import_contacts_file_sample():
     """
-    Permet de récupérer un fichier pour pouvoir importer des contacts
+    Permet de récupérer un fichier exemple vide pour pouvoir importer des contacts
     """
     keys = [
         "nom",
@@ -1254,6 +1264,9 @@ def delete_offre_file(offre_id, filedir):
 @bp.route("/preferences", methods=["GET", "POST"])
 @permission_required(Permission.RelationsEntreprisesValidate)
 def preferences():
+    """
+    Permet d'afficher la page des préférences du module gestion des relations entreprises
+    """
     form = PreferencesForm()
     if form.validate_on_submit():
         EntreprisePreferences.set_email_notifications(form.mail_entreprise.data.strip())