# Applications Intégrées dans Agency Handy

La fonctionnalité **Applications Intégrées** permet aux **Superadmins** et **Admins** d’intégrer des outils externes (Google Docs, Figma, Notion, YouTube, etc.) **directement dans l’interface de Agency Handy**. Cela favorise un meilleur flux de travail, une collaboration fluide et un contrôle d'accès efficace — sans quitter la plateforme.

***

#### 🎯 Objectifs

✅ Éviter les allers-retours entre plusieurs plateformes.\
✅ Collaborer en temps réel sur des outils tiers.\
✅ Contrôler l’accès aux outils selon le rôle de l’utilisateur.\
✅ Centraliser tous les outils importants (documents, designs, plannings, etc.) pour l’équipe et les clients au sein d’Agency Handy.

***

#### 🧾 Fonctionnalités

Les utilisateurs peuvent :

* Intégrer des applications via **iframe** ou **lien URL**.
* Partager des apps avec les membres de l’équipe ou des clients.
* Définir **qui peut voir quoi** avec des autorisations de visibilité précises.
* **Personnaliser l’accès depuis la barre latérale** pour un lancement rapide.
* Modifier ou supprimer les applications à tout moment.

***

#### 🧑‍💼 Conditions préalables

* **Seuls les Superadmins et Admins** peuvent créer, éditer ou supprimer des applications intégrées.
* Tous les utilisateurs doivent avoir un rôle actif (Admin, PM, Assigné, Client).
* L’URL intégrée doit être compatible avec un **iframe** ou un lien externe.
* Les icônes doivent être dans un format pris en charge (SVG, PNG, JPG).
* Les **clients** peuvent uniquement voir les apps partagées dans leur barre latérale (vue canvas).
* Les barres latérales sont **personnalisées par utilisateur**.

***

#### 🗺️ Parcours Utilisateur

1. Le Superadmin/Admin ajoute une application.
2. Choisit une icône.
3. Ajoute une URL ou un iframe.
4. Définit la visibilité.
5. Active le raccourci dans la barre latérale.
6. Sauvegarde.

👉 Les autres Admins et membres de l’équipe voient les apps partagées selon les permissions.\
👉 Les clients ne voient que les apps qui leur sont attribuées.

***

#### 📚 Guide Étape par Étape

**Étape 1 : Ajouter une nouvelle application**

1. **Aller dans Applications Intégrées**\
   Depuis l’interface principale, cliquez sur **"Applications intégrées"**.
2. **Ajouter une nouvelle app**\
   Cliquez sur **"Ajouter"**.
3. **Renseigner les détails**

* **Titre** : Donnez un nom clair à l’application (ex. : "Tableau de bord projet").
* **Type d’affichage** :
  * **URL** : Affiche l’app dans une nouvelle fenêtre intégrée si l’URL est partageable.
  * **Iframe** : Affiche l’app directement dans l’interface.
* **URL de contenu** : Collez l’URL de l’outil à intégrer.

📌 **Google Drive** (iframe uniquement) :

* Le dossier doit être visible par "Toute personne disposant du lien".
* Convertir l’URL :
  * De : `https://drive.google.com/drive/folders/ID?usp=sharing`
  * Vers : `https://drive.google.com/embeddedfolderview?id=ID`

📌 **YouTube** (URL uniquement) :

* Convertir l’URL :
  * De : `https://www.youtube.com/watch?v=VIDEO_ID`
  * Vers : `https://www.youtube.com/embed/VIDEO_ID`

***

**Étape 2 : Définir la visibilité**

* **Équipe** : Sélectionnez "Tous les membres" ou des utilisateurs spécifiques.\
  Les rôles apparaissent (PM, Assigné, etc.).
* **Clients** : Sélectionnez "Tous les clients" ou des clients spécifiques.\
  ⚠️ Les apps client apparaissent uniquement dans **leur barre latérale**.

***

**Étape 3 : Activer dans votre barre latérale (optionnel)**

* Activez **"Afficher dans ma barre latérale"** pour un accès rapide.\
  ⚠️ Cette option est **personnelle** et ne s’applique qu’à votre compte.

***

**Étape 4 : Sauvegarder**

* Cliquez sur **"Sauvegarder"**.
* L’application s’affichera dans son onglet correspondant (ex. : tous les Google Docs ensemble).

***

#### 👥 Vue par rôle utilisateur

**👑 Superadmin/Admin**

* Voit **toutes les apps intégrées** (les siennes et celles des autres).
* Onglets groupés par type (Figma, Airtable, etc.).
* Peut :
  * Afficher les apps.
  * Les épingler à la barre latérale.
  * Voir les utilisateurs avec qui elles sont partagées.
  * **Modifier ou supprimer** via le menu (⋮).

**🧑‍💼 Membres de l’équipe (PMs, Assignés)**

* Voient uniquement les apps partagées avec eux.
* Peuvent épingler ou retirer de leur propre barre latérale.
* Lecture seule — **aucune option de modification**.

**👤 Clients**

* Voient **uniquement les apps partagées avec eux**.
* Accès via leur **barre latérale (canvas)**.
* Lecture seule — **aucune option de modification ou d’épinglement**.

***

#### 🔍 Filtres & Tri

* **Recherche par Titre**
* **Filtrer par Visibilité** :
  * Partagé avec tous les membres
  * Partagé avec des membres spécifiques
  * Partagé avec tous les clients
  * Partagé avec des clients spécifiques
* **Trier par** :
  * Plus ancien en premier (**par défaut**)

***

#### ⚠️ Remarques Importantes

* ✅ Aucun **limite** sur le nombre d'apps intégrées.
* ✅ Clients et membres de l’équipe ne peuvent **pas gérer** les apps, uniquement les consulter.
* ✅ Les apps sont accessibles par tous les utilisateurs concernés, même si elles ont été ajoutées par un seul Admin.
* ✅ Les icônes apparaissent uniquement dans la **vue secondaire** et dans la **barre latérale**.
* ✅ Une URL ou iframe invalide affichera une **erreur**.
* ✅ Une app supprimée est **supprimée pour tous**.
* ✅ Les raccourcis de barre latérale sont **personnels** à chaque utilisateur.
* ✅ Les **logs d’audit** enregistrent qui a ajouté, modifié ou supprimé une application et à quel moment.