Aptli

Sites

Les sites représentent des emplacements de stockage où l'inventaire est détenu. Les sites peuvent être des emplacements physiques (entrepôts), des sites sur le terrain ou des emplacements logiques (travailleurs individuels, véhicules).

Types de Sites (Implicites)

Hiérarchie des Sites :

Entrepôt Central
├── Grande capacité, accès contrôlé
├── Personnel avec permission canFacilitatePickups
└── Point de réception primaire (fournisseurs → entrepôt)

Sites de Mise en Place sur le Terrain
├── Temporaires, spécifiques au projet
├── Capacité moyenne
└── Transferts depuis l'entrepôt → consommation par les travailleurs

Sites Personnels (Travailleurs)
├── Auto-créés lors du premier retrait QR
├── Inventaire mobile (suit le travailleur)
└── Transactions de consommation (le travail épuise le stock)

Sites Véhicules
├── Référence à l'actif véhicule ou opérateur
├── Stockage mobile (équipes itinérantes)
└── Le stock se déplace avec le véhicule

Page des sites montrant les emplacements de stockage avec types et informations de capacité

Aptli utilise des types de sites implicites basés sur les champs présents :

Sites Physiques

Sites avec géométrie (coordonnées GPS ou polygones de zone) :

  • Entrepôts centraux
  • Centres de distribution régionaux
  • Zones de mise en place sur le terrain
  • Cours de stockage

Exemple :

Nom : "Entrepôt Central"
Géométrie : Point à (lat: 40.7128, lng: -74.0060)
Adresse : "123 Storage Way, New York, NY"

Sites Personnels

Sites avec référence à un utilisateur ou véhicule (pas de géométrie) :

  • Inventaire de travailleur individuel
  • Inventaire de véhicule
  • Équipement mobile

Exemple :

Nom : "Inventaire Personnel de John"
Référence : { user_id: "..." }

Cette conception évite les problèmes de synchronisation enum - la présence de géométrie vs. référence détermine le comportement implicite.

Champs de Sites

Informations de Base :

  • Nom - Nom descriptif
  • Type - Catégorie pour le filtrage (entrepôt, terrain, véhicule, personnel)
  • Géométrie - Coordonnées GPS ou zone polygonale (optionnel)
  • Référence - Lien vers utilisateur ou véhicule (optionnel)
  • Adresse - Adresse physique pour les entrepôts

Suivi d'Inventaire :

  • Éléments de Stock - Tableau des ressources détenues à ce site (géré via transactions)
  • Capacité - Volume/unité maximum optionnel (alertes lors de l'approche de la limite)

Contrôle d'Accès :

  • Personnel Autorisé - Utilisateurs qui peuvent créer des reçus/ajustements à ce site
  • Nécessite une Supervision - Si vrai, permission canFacilitatePickups requise pour les transferts

Création de Sites

Site Physique :

  1. Naviguer vers Inventaire → Sites
  2. Cliquer sur "Ajouter un Site"
  3. Entrer nom, type, adresse
  4. Cliquer sur la carte pour définir la géométrie (point ou polygone)
  5. Définir la capacité si applicable
  6. Enregistrer

Site Personnel (Auto-Créé) : Lorsqu'un travailleur scanne le premier code QR de retrait :

  • Site personnel créé automatiquement
  • Nommé : "Inventaire Personnel de Nom du Travailleur"
  • Référence définie sur l'ID utilisateur du travailleur
  • Pas de création manuelle nécessaire

Site Véhicule :

  1. Créer un site avec référence à l'actif véhicule
  2. Ou référence à l'utilisateur qui opère le véhicule
  3. Les éléments de stock suivent ce qui est dans le véhicule
  4. Utile pour l'inventaire mobile (équipes itinérantes)

Modèles d'Utilisation des Sites

Entrepôt Central

  • Objectif : Réception et stockage primaires
  • Caractéristiques : Grande capacité, accès contrôlé, emplacement fixe
  • Transactions : Réceptions des fournisseurs, transferts vers travailleurs/sites sur le terrain
  • Personnel : Gestionnaires d'entrepôt avec permission canFacilitatePickups

Site de Mise en Place sur le Terrain

  • Objectif : Stockage temporaire près de la zone de travail active
  • Caractéristiques : Capacité moyenne, spécifique au projet, temporaire
  • Transactions : Transferts depuis l'entrepôt, consommation par les travailleurs
  • Cycle de Vie : Créé pour le projet, vidé lorsque le projet se termine

Site Personnel (Travailleur)

  • Objectif : Inventaire mobile pour l'individu
  • Caractéristiques : Petite capacité, se déplace avec le travailleur, spécifique au travailleur
  • Transactions : Retraits via scan QR, consommation via rapports, retours à l'entrepôt
  • Accès : Seul le travailleur peut consommer depuis son site personnel

Site Véhicule

  • Objectif : Inventaire voyageant avec le véhicule d'équipe
  • Caractéristiques : Capacité moyenne, se déplace avec le véhicule, spécifique à l'équipe
  • Transactions : Similaire au site personnel mais pour les équipes multi-personnes
  • Suivi : Utile pour la conformité (quels matériaux sont sur site)

Transactions de Sites

Voir toute l'activité à un site :

  • Naviguer vers la vue de détail du site
  • "Historique des Transactions" montre :
    • Toutes les réceptions, transferts entrants/sortants, consommations
    • Éléments de stock actuels et volumes
    • Personnel qui a effectué les transactions

Aide à répondre :

  • Quel inventaire actuellement à ce site ?
  • Qu'est-ce qui a quitté le site récemment ?
  • Qui a reçu des matériaux de ce site ?

Suivi GPS pour les Transferts

Lorsqu'un retrait QR est scanné :

  • La transaction enregistre scanLocation (coordonnées GPS)
  • Valide que le travailleur était physiquement au site source (si le site a une géométrie)
  • Piste d'audit montre où le scan s'est produit
  • Aide à détecter les transferts non autorisés

Validation de Géofence (Optionnel) : Configurer l'entrepôt pour nécessiter un scan dans un rayon de 50m

  • Empêche le scan QR à distance (capture d'écran envoyée à un ami)
  • Transaction rejetée si GPS trop loin de la géométrie du site

Organisation des Éléments de Stock

Chaque site contient des éléments de stock :

Entrepôt Central
  ├── Câble Cat6 : 500m
  ├── Supports de Montage : 200 unités
  └── Kits d'Installation : 15 unités

Inventaire Personnel de John
  ├── Câble Cat6 : 10m
  └── Supports de Montage : 5 unités

Navigation :

  • Depuis le site : voir tous les éléments de stock à cet emplacement
  • Depuis l'élément de stock : voir quel site détient cet inventaire
  • Relation bidirectionnelle

Alertes de Capacité des Sites

Définir des limites de capacité pour éviter la surcharge :

  • Basé sur le Volume : Total mètres cubes/pieds
  • Basé sur le Poids : Kilogrammes/livres maximum
  • Basé sur le Nombre : Nombre maximum d'unités

Lors de l'approche de la capacité :

  • Alerte affichée dans la vue du site
  • Empêche les réceptions supplémentaires si dépassement de capacité
  • Invite à la redistribution vers d'autres sites

Meilleures Pratiques

Nommer de Manière Cohérente :

  • Sites physiques : Inclure l'identifiant d'emplacement (par exemple, "Entrepôt - NYC", "Site Terrain - Projet Alpha")
  • Sites personnels : Les noms générés automatiquement fonctionnent bien ("Inventaire de Nom")
  • Sites véhicules : Inclure l'ID du véhicule (par exemple, "Camion 42", "Van - Immatriculation ABC123")

Utiliser la Géométrie pour les Sites Physiques :

  • Permet le filtrage de proximité (trouver le site le plus proche avec ressource)
  • Valide les retraits QR (travailleur à l'emplacement correct)
  • Montre les sites sur la vue carte

Limiter la Création de Sites Personnels :

  • Créer seulement lorsque le travailleur a besoin de responsabilité d'inventaire
  • Tous les utilisateurs n'ont pas besoin de sites personnels
  • Créé automatiquement lors du premier retrait (ne pas pré-créer)

Auditer Régulièrement :

  • Examiner les sites avec zéro élément de stock (sites inutilisés)
  • Archiver les sites terrain après achèvement du projet
  • Rapprocher les sites personnels pendant les comptages cycliques