Ressources

Les ressources représentent des types d'éléments de travail, de matériaux, d'équipements ou de main-d'œuvre qui peuvent être suivis dans l'inventaire ou consommés lors d'opérations sur le terrain.

Types de Ressources

Matériaux et Consommables

• Éléments physiques suivis par volume/quantité
• Exemples : câble (mètres), conduit (pieds), supports de montage (unités)
• Épuisés par la consommation sur le terrain
• Réapprovisionnés par les reçus

Équipement

• Éléments réutilisables avec des quantités limitées
• Exemples : échelles, chariots élévateurs, équipements de test
• Transférés entre sites, non consommés
• Retournés après utilisation

Main-d'œuvre

• Effort de travail suivi par heures ou tâches
• Exemples : heures d'électricien, tâches d'installation
• Utilisés dans les exigences de ressources des tâches
• Suivis dans les rapports mais pas dans l'inventaire physique

Champs de Ressources

Informations de Base

• Nom - Nom descriptif (par exemple, "Câble Réseau Cat6")
• Catégorie - Regroupement pour le filtrage (par exemple, "Câblage", "Matériel")
• UDM par Défaut - Unité de mesure standard (par exemple, "mètres", "unités", "heures")
• Description - Spécifications détaillées ou notes

Contrôle d'Inventaire

• Est Consommable - Vrai pour les éléments épuisés par l'utilisation (matériaux)
• Nécessite une Protection - Vrai pour l'inventaire restreint (retrait par code QR requis)
• Niveau de Stock Minimum - Seuil d'alerte pour un inventaire faible
• Coût Standard - Prix par défaut par unité (pour le budget)

Conversions - Tableau intégré pour les conversions d'unités et les décompositions composites

Conversions de Ressources

Types de Conversion :

Conversion d'Unité               Décomposition Composite
     ↓                              ↓
Même Ressource              Ressources Différentes
1 ft → 0.3048 m           1 Kit → Éléments Multiples
resource: null            resource: [IDs...]
     ↓                              ↓
Câble (pieds)              Kit Porte → Porte
     ↓                         ↓       Vis
Câble (mètres)                ↓       Adhésif
                              └────→ Ruban Mesure

Page de détail de ressource montrant la configuration des conversions d'unités et de la décomposition composite

Les conversions gèrent deux scénarios dans une structure unifiée :

Conversions d'Unités (Même Ressource)

Convertir entre unités de mesure pour la même ressource.

Exemple : Conversion de longueur de câble

Ressource : "Câble Réseau Cat6"
Conversion : {
  sourceVolume: 1,
  sourceUom: "feet",
  outputs: [{
    resource: null,        // null = même ressource
    volume: 0.3048,
    uom: "meters"
  }]
}

Décompositions Composites (Ressources Multiples)

Décomposer les kits assemblés en matériaux composants.

Exemple : Décomposition de kit d'installation

Ressource : "Kit d'Installation de Porte"
Conversion : {
  sourceVolume: 1,
  sourceUom: "units",
  outputs: [
    { resource: tape_measure_id, volume: 1, uom: "units" },
    { resource: mounting_screws_id, volume: 12, uom: "units" },
    { resource: adhesive_id, volume: 0.5, uom: "liters" }
  ]
}

Points Clés :

• resource: null indique une conversion d'unité de même ressource
• resource non nul indique une décomposition composite vers différents matériaux
• Plusieurs sorties prises en charge (une source → plusieurs cibles)
• Intégré dans la ressource pour les performances (pas de recherches séparées)

Ressources Protégées

Les ressources disposent d'un indicateur Collecte libre qui contrôle le mode d'autorisation pour les scans de code QR :

• Désactivé (par défaut — protégé) : Le code QR est verrouillé à l'utilisateur. Seule la personne à qui le code a été émis (ou le personnel disposant de la permission canFacilitatePickups) peut le scanner. L'identité est vérifiée à chaque scan.
• Activé (collecte libre) : Le code QR est un bon transférable. Mikaël peut recevoir le code et le transmettre à Jean ; Jean le scanne et la transaction enregistre Jean comme collecteur effectif. Aucune vérification d'identité — tout scan valide déduit le stock.

La collecte libre convient aux consommables de faible valeur ou aux situations où l'identité du collecteur n'a pas d'importance opérationnelle. La collecte protégée convient aux matériaux de haute valeur ou traçables pour lesquels la chaîne de responsabilité est importante.

Lorsque la protection est active, le scan valide :

1. Le code d'autorisation et son expiration
2. Le scanner est le destinataire autorisé (protégé) OU le code est un bon valide (libre)
3. Le scanner dispose de la permission canFacilitatePickups (dérogation du personnel, protégé uniquement)
4. La disponibilité du stock sur le site source

Cas d'usage du mode protégé :

• Équipement de haute valeur
• Matériaux contrôlés (nécessitent une traçabilité)
• Articles soumis à des exigences réglementaires

Création de Ressources

Accès Requis : Droit d'administration resourcesCreate

Page des ressources montrant la liste des ressources définies avec catégories et unités de mesure par défaut

Flux de Travail Courant :

1. Naviguer vers administration → Ressources
2. Cliquer sur "Ajouter une Ressource"
3. Remplir les informations de base (nom, catégorie, UDM par défaut)
4. Définir les indicateurs de contrôle d'inventaire (consommable, protégé)
5. Ajouter des conversions si nécessaire (conversions d'unités ou décompositions de kits)
6. Enregistrer

Meilleures Pratiques :

• Utiliser des conventions de nommage cohérentes (par exemple, "Câble Cat6" pas "fil réseau chat 6")
• Définir des niveaux de stock minimum réalistes pour les consommables
• Ajouter des conversions tôt (plus difficile à rétrofitter après l'existence d'éléments de stock)
• Grouper les ressources liées avec le champ catégorie

Visibilité de la demande et de l'offre

La page des ressources peut afficher deux colonnes agrégées en regard de chaque entrée du catalogue :

• Demande — volume total de cette ressource déclaré dans toutes les entrées resources[] des tâches actives. Indique la quantité requise pour les travaux terrain planifiés.
• Offre — volume total dans tous les articles en stock actifs pour cette ressource. Indique la quantité physiquement disponible sur l'ensemble des sites.

Pour alimenter ces colonnes, cliquez sur Récupérer la demande/offre dans la barre de filtres. Le système lit chaque ressource actuellement visible dans le tableau et interroge en parallèle les collections de tâches et d'articles en stock. Un indicateur de chargement s'affiche sur le bouton pendant la requête.

Pourquoi à la demande plutôt que toujours visible ?

L'agrégation sur l'ensemble des tâches et des articles en stock à chaque chargement de page serait coûteuse à grande échelle. Le chargement à la demande vous permet de consulter les chiffres quand vous en avez besoin — planification de capacité, vérifications avant projet, appels de passation de marchés — sans alourdir la navigation courante.

Détail de l'article en stock :

La page de détail d'un article en stock affiche automatiquement la Demande totale et l'Offre totale pour la ressource à laquelle cet article appartient, sans nécessiter de chargement manuel. Puisque vous consultez déjà un article spécifique, la requête est peu coûteuse (un seul identifiant de ressource).

Interprétation de l'écart :

Si la demande dépasse l'offre, les achats doivent intervenir avant que les équipes terrain puissent collecter les matériaux. Si l'offre dépasse la demande, vous disposez d'une marge — ou d'un stock excédentaire qui pourrait être transféré ailleurs. Aucune des deux colonnes ne tient compte des matériaux réservés ou en transit ; traitez l'écart comme un signal d'investigation, et non comme un blocage ferme.

Utilisation des Ressources

Les ressources apparaissent dans :

• Tâches - Matériaux/main-d'œuvre requis pour le travail (prise en charge multi-ressources)
• Éléments de Stock - Inventaire physique de la ressource sur les sites
• Transactions - Enregistrements de mouvement et de consommation
• Rapports - Consommation réelle pendant le travail sur le terrain
• Attributions - Cibles de ressources (objectifs, pas réservations)

Les ressources NE réservent PAS l'inventaire - elles définissent ce qui peut être suivi. Les éléments de stock représentent l'inventaire physique réel.