Matériels (DSI/IT Hardware)

Vue d'ensemble

Le module Matériels permet de gérer l'ensemble du parc matériel informatique d'un tenant : postes de travail, serveurs, imprimantes, équipements réseau, téléphones, tablettes et machines virtuelles.

Chaque matériel est rattaché à une entité (via idc), peut être assigné à un ou plusieurs utilisateurs, et passe par un cycle de vie défini.

Types de matériels

Les types sont regroupés en onglets dans l'interface :

• Matériels — tous types confondus (vue d'ensemble)
• Postes de travail — FIX, POR, LIG
• Serveurs — SER
• Imprimantes / Copieurs — IMP
• Réseaux — WIF, SWI, ROU
• Tablettes — TAB
• Smartphones — SMA
• Autres — tous les types restants
• VM — machines virtuelles (table dsi_hwvm)

Cycle de vie (statuts)

Les transitions de statut mettent automatiquement à jour les dates associées :

• Passage en PROD → renseigne dtrun (date de mise en production)
• Passage en MTAIN → renseigne dtmaintain
• Passage en END → renseigne dtunset (date de mise hors service)
• Retour en STOCK → efface dtrun

Informations gérées sur un matériel

Identification

• Nom du matériel (lbhw)
• Type (tphard)
• Numéro de série / tag (idtag)
• Numéro de série Windows (win_serial)
• Numéro d'immobilisation (lbimmo)

Affectation

• Entité rattachée (idc)
• Adresse / localisation (idaddr, lbwhere)
• Type d'utilisation (tpusage) — visible uniquement pour les types FIX et POR :
  • PERSO (défaut) : poste attribué à une personne
  • KIOSQUE : poste kiosque — l'utilisateur principal et les utilisateurs secondaires sont retirés
• Utilisateur principal (iduser_master) — masqué si type d'utilisation = KIOSQUE
• Utilisateurs secondaires (table dsi_hw_users)

Matériel

• Fabricant (idhw_sel)
• Modèle (idhw_model)
• Processeur (tpproc)
• RAM en Go (nbram)
• Stockage en Go (nbdd)
• Type de disque (tpdd)
• Système d'exploitation (idos)
• Suite bureautique (tpof)

Dates

• Achat (dtbuy)
• Garantie constructeur (dtwar)
• Garantie batterie/licence cloud (dtwarbat)
• Mise en production (dtrun)
• Maintenance (dtmaintain)
• Hors service (dtunset)
• Dernier contrôle (dtcheck)
• Dernier inventaire OCS (last_inventory_at)

Garantie

• Texte garantie constructeur (txwar)
• Texte garantie batterie (txwarbat)
• URL garantie (via fabricant)

Commentaires & recommandations

• Commentaire libre (txcomment)
• Recommandation (tpreco)
• Détail recommandation (txreco)
• Champs libres 1 et 2 (lib1, lib2)

Alertes automatiques

Le système analyse chaque matériel et génère des alertes sur :

Utilisateurs rattachés

Un matériel peut avoir :

• Un utilisateur principal (iduser_master) — affiché directement dans la liste
• Des utilisateurs secondaires — via la table dsi_hw_users

La modale de gestion des utilisateurs rattachés permet :

• D'ajouter / retirer des utilisateurs secondaires
• De promouvoir un utilisateur secondaire en utilisateur principal (l'ancien principal est automatiquement rétrogradé en additionnel)
• De gérer les "utilisateurs fantômes" : utilisateurs supprimés du système ou utilisateurs externes (nommés manuellement, sans compte), modifiables via un formulaire dédié
• D'envoyer un mail de demande de remise de matériel à un utilisateur

L'interface distingue visuellement l'utilisateur principal (affiché dans une carte dédiée en haut de la modale) des utilisateurs additionnels (listés dans le tableau en dessous).

Seuls certains types de matériels peuvent recevoir des rattachements utilisateurs : LIG, FIX, POR, TAB, SMA, TEL, VID, IMP, SCR.

Comptes proposés au rattachement

Le sélecteur (utilisateur principal comme additionnels) propose les comptes non supprimés de l'entité mère du matériel, pour les types de compte suivants (cf. Personnes) :

Les utilisateurs déjà rattachés au matériel (principal ou additionnels) sont retirés de la liste. Un utilisateur sans compte dans l'application se rattache via le bouton Utilisateur externe.

Historique des rattachements

Chaque action de rattachement ou de détachement est tracée dans l'historique du matériel :

Ces entrées remontent dans l'onglet "Historique" de la fiche matériel. Les changements sur iduser_master apparaissent également dans la section "Affectations" de l'historique.

Tickets rattachés

Depuis la fiche matériel, on peut consulter les tickets liés à ce matériel (via CustomerAskAttach, idmodelement=810001). La modale affiche :

• Titre, sujet, statut, priorité
• Dates d'ouverture et de résolution

Intégration OCS (inventaire)

Les matériels peuvent être synchronisés automatiquement depuis OCS Inventory. En cas de synchronisation :

• Le champ idocs est renseigné
• Certains champs ne sont plus modifiables manuellement (processeur, RAM, disque, OS, etc.)
• last_inventory_at est mis à jour à chaque inventaire

Affichage des données OCS sur la fiche matériel

La fiche matériel (see/81000101) affiche les données OCS directement depuis la base OCS via le connecteur Store v3 (ocs_inventory). La résolution se fait par idtag (plus fiable que idocs) :

1. Recherche dans bios.SSN = idtag (matériels physiques avec numéro de série)
2. Fallback sur hardware.NAME = idtag trié par LASTDATE DESC (VMs ou matériels sans SSN)

La section est affichée uniquement si le tenant possède une instance OCS active (StoreInstance avec connector.code = 'ocs_inventory', is_active = true). Elle présente un tableau Logiciels listant nom, version et date d'installation des logiciels installés.

Intégrations API fabricants

Pour Lenovo et Dell, le système peut récupérer automatiquement les données de garantie via leurs APIs en renseignant le numéro de série :

• Date d'expédition
• Modèle
• Dates de garantie constructeur et batterie/licence cloud

Création depuis la fiche adresse

Depuis la fiche d'une adresse (module 13040101), l'onglet Matériels affiche le parc matériel lié à cette adresse et permet de créer un nouveau matériel directement sans quitter la page. Le formulaire de création s'affiche dans le bouton du tableau, avec l'entité et l'adresse pré-sélectionnées.

Actions en masse (Bulk actions)

Disponibles sur une sélection de matériels (max 50) :

• Changer le statut — met à jour le statut et les dates associées
• Transférer — déplace vers une autre entité/adresse, avec gestion des utilisateurs associés
• Modifier les statuts VM — met à jour le statut des VMs sélectionnées. Le statut mtain (maintenance) supporte une période datée : date de début obligatoire, date de fin optionnelle. Depuis la fiche VM (module 810901), le bouton "Modifier le statut" recharge la page entière après succès (callbackMode=reload). Depuis le tableau en masse (HardwareVmWire), il rafraîchit uniquement le TableWire via un événement Livewire (hardware-vm-refresh).

Vue prestataire (Clients)

Les prestataires (partenaires) peuvent accéder à une vue consolidée du parc de leurs clients via l'onglet "Clients" (/hardware/clients). Cette vue agrège les données de plusieurs tenants avec le nom du client affiché.

Machines virtuelles

Les VMs sont gérées dans un onglet dédié avec leur propre modèle (DsiHwvm) et leurs propres champs spécifiques :

• Type de virtualisation (tpvm)
• Hébergeur (tpheb, idheb)
• OS VM (tposvm)
• Adresse IP (lbip)
• Politique de sauvegarde (lbpolsave)
• Criticité (tpcrit)
• Nombre de CPU (nbcpu)
• Début de maintenance (dtmaintain)
• Fin de maintenance (dtmaintain_end, facultative)

Cycle de vie VM

Les VMs ont leur propre cycle de vie, distinct des statuts des matériels physiques :

Le statut est déterminé automatiquement selon les dates renseignées : dtend → out, dtmaintain → mtain, dtprod → run, sinon build.

Mini-menu fiche VM (810901ctl)

La fiche formulaire VM (/mod/81090101/update/{id}) affiche un mini-menu contextuel en mode update, modidel 01, via resources/views/hook/custom/ctl/810901ctl.blade.php.

Droits d'accès

L'accès au module est contrôlé par le module 81000101 (matériels) et 81090101 (VMs).

Les profils à accès limité peuvent être restreints à certaines entités via idlimit_profile.

Fiche matériel (vue See)

La fiche matériel (/mod/81000101/see/{idhw}) affiche :

• Carte identité : icône du type, nom, statut, utilisateur principal avec date de validation, dates clés (inventaire, modification, achat, mise en service, garantie, rebut, archivage)
• Informations principales : ID, type, reconditionnement, S/N, fabricant, modèle, OS, processeur, RAM, disque, IP, suite bureautique
• Localisation : entité, adresse (avec lien Google Maps), emplacement libre — affichée uniquement si renseignée
• Contact : téléphone et e-mail — affiché uniquement si renseigné
• Historique des utilisateurs : timeline des rattachements/détachements, affichée uniquement pour les types pouvant être rattachés et si l'historique est non vide
• Informations OCS : tableau Logiciels (nom, version, date d'installation) — affiché uniquement si le tenant a une instance OCS active (Store v3) et que idtag permet de résoudre le matériel dans OCS
• Addins : commentaires, images, documents, liens

Hooks formulaire

Comportement du formulaire (hook/810001.form.php)

Lors de la création ou mise à jour d'un matériel (modidel 01) :

• Contrôle d'accès : vérifie que l'utilisateur peut accéder à l'entité (idc) via AccessHelper::checkCustomerAccess
• Utilisateur archivé : si un iduser_master est renseigné et que l'utilisateur a une dtdel, une alerte danger est créée automatiquement
• Affichage conditionnel des champs utilisateur :
  • Si iduser_master renseigné → affiche les champs iduser_master, dtcheck, lbname_master, lbmail_master (en update) ou seulement iduser_master (en création)
  • Si seulement lbname_master renseigné (utilisateur fantôme) → comportement similaire sans les champs mail
  • Si aucun utilisateur → masque tous les champs utilisateur (iduser_master, dtcheck, lbname_master, lbmail_master, text__21)

Comportement avant contrôleur (hook/810001.ctlbefore.php)

• Redirige les actions home et print vers /hardware (pas de page d'accueil dédiée)
• En mode création modale : désactive le retour standard (returnFinalExit = true) et injecte du JavaScript pour recharger le tableau DataTable et afficher une confirmation SweetAlert

Hook vue formulaire (resources/views/hook/810001view.blade.php)

Injecté automatiquement dans le formulaire via @include('hook.building.content').

En mode création (si idtag renseigné) — appel AJAX automatique vers l'API fabricant :

• Lenovo (idhw_sel == 2) : remplit modèle, dates de garantie constructeur/batterie et date d'achat
• Dell (idhw_sel == 1) : remplit modèle, date d'achat et garantie constructeur (S/N sans tirets)

En mode mise à jour :

• Affiche les nav-pills si définies
• Écoute l'événement Livewire reload-page pour forcer un rechargement de page (utilisé après certaines actions en modale)

Confirmation passage en mode KIOSQUE :

• Lorsqu'un matériel avec un utilisateur principal est soumis en mode KIOSQUE, une alerte SweetAlert s'affiche au moment du clic sur le bouton d'enregistrement
• En cas de confirmation : le formulaire est soumis, l'utilisateur principal et tous les utilisateurs secondaires (table dsi_hw_users) sont retirés
• En cas d'annulation : la soumission est bloquée, le formulaire reste en état d'édition

Mini-menu de la fiche formulaire (resources/views/hook/custom/ctl/810001ctl.blade.php)

En mode update, affiche un mini-menu contextuel avec :

• Dernier inventaire OCS : badge coloré (vert < 2 mois, orange 2–12 mois, rouge > 12 mois) avec lien vers la fiche see
• Dernière modification : lien vers l'historique du matériel
• Renommer le matériel : génère automatiquement un nom normalisé {idref_7chars}-{type1char}{idhw}
• Valider la remise : envoie un e-mail de confirmation si iduser_master est défini mais pas encore validé (dtcheck absent) ; affiche un badge de confirmation si déjà validé
• Gestion des utilisateurs : ouvre la modale Livewire hardware.modal.rattached-users avec compteur d'utilisateurs rattachés (visible uniquement si le type supporte le rattachement, statut ≠ END, et type d'utilisation ≠ KIOSQUE)
• Tickets rattachés : ouvre la modale Livewire hardware.modal.rattached-tickets avec compteur (visible uniquement si tickets > 0)
• Vérifier la garantie : lien externe vers l'URL garantie du fabricant (si renseignée dans DsiHwSel.urlwarranty), copie le S/N dans le presse-papier
• Transférer le matériel : ouvre la modale Livewire hardware.transfer-hardware (admins locaux uniquement)
• TeamViewer : lien de prise en main distante si iddist renseigné et distribution = TW