EN
Toutes les applications

§ Application / Opérations sur le terrain

Créer une carte d'opérations sur le terrain pour l'énergie avec React et unmap

Comment l'application Opérations sur le terrain d'unmap est construite : bons de travail et équipes, un cycle des tâches simulé, des itinéraires qui disent quand ils s'arrêtent avant le site et, avec les modules, les couches énergie de l'Alberta, la recherche de puits et les terres légales.

Ouvrir l'applicationCode source

Opérations sur le terrain est une carte pour le travail de terrain d'un exploitant énergétique canadien. Filtrez les bons de travail par catégorie et par statut, lisez-les sous leur équipe, faites avancer une tâche dans son cycle, tracez l'itinéraire de la base à un site et activez ou désactivez des couches de contexte. Avec les modules activés, elle ajoute les vraies couches énergie de l'Alberta, la recherche de puits par UWI ou permis, l'identification au clic et les terres légales. L'application est en ligne à apps.unmap.dev/field-operations avec les deux modules activés, et son code source est un projet Next.js autonome que vous pouvez cloner et exécuter avec votre propre clé.

L'exploitation est synthétique et l'application le dit : la base, les équipes, les dix sites autour de Drayton Valley, en Alberta, et leurs bons de travail sont inventés, aucun site n'est un vrai puits, pipeline ou installation, et le cycle est simulé. La carte, les itinéraires et les couches de contexte sont unmap en direct, tout comme, avec les modules, les couches énergie et les terres légales. Celles-ci viennent de la passerelle et ne sont jamais copiées dans le dépôt.

Ce qu'elle fait

  • Bons de travail et équipes : recherche par numéro ou titre, filtres par catégorie et par statut, et lecture sous chaque équipe, priorité haute d'abord.
  • Un cycle simulé : planifié, affecté, sur place, terminé, une étape à la fois, chaque étape consignée et indiquée comme simulée.
  • Des itinéraires qui disent où ils s'arrêtent : l'itinéraire routier de la base à un site, en voiture. Un chemin de bail ou une plateforme ne figure souvent pas dans le réseau routier : quand l'itinéraire s'arrête à la route la plus proche plutôt qu'au site, l'avertissement ENDPOINT_RELOCATED de l'API s'affiche à côté, avec la distance.
  • Couches de contexte : terres autochtones, limites municipales et aires protégées, chacune activable.
  • Avec le module Énergie : puits, pipelines, installations et tenures de la Couronne de l'Alberta, recherche de puits par UWI ou permis, et identification au clic. Seules les couches énergie dont le catalogue consigne la redistribution comme autorisée sont affichées.
  • Avec le module Terres légales (inclus dans Énergie) : recherche de terres légales et grille de l'arpentage des terres du Dominion.

Les modules, par réglage

Un seul réglage, NEXT_PUBLIC_UNMAP_ADDONS, indique les modules de la clé du déploiement. Vide, l'application fonctionne en mode exemple : bons de travail, itinéraires et couches gratuites fonctionnent, et chaque fonction d'un module indique le module requis sans rien appeler. Réglez-le à energy, legal-land ou les deux quand votre clé a le module. L'application publique fonctionne avec les deux : toutes les fonctions des modules y sont en direct.

Construite à partir du registre, sans modification

La carte, les légendes de couches, la recherche de puits et de terres légales, la fenêtre d'identification, la ligne d'itinéraire et les repères sont des éléments du registre copiés tels quels. Installer les mêmes pièces dans votre projet tient en une commande :

npx @unmap/cli add map layer-legend energy-popup well-search legal-land-search route-line marker-popup map-controls

Ce qu'elle ne fait pas

  • De vraies opérations. Aucune donnée de client, industrielle ou opérationnelle, et aucune vraie équipe n'est affectée ni avisée.
  • La conformité. Elle ne prétend à aucune conformité opérationnelle, réglementaire ou de sécurité.
  • Toutes les routes. Les routes d'hiver, les chemins de ressources et les chemins de bail privés ne sont pas routables : le dernier tronçon jusqu'au site peut ne pas figurer sur l'itinéraire.

L'exécuter vous-même

Il vous faut Git, Node.js 24, pnpm et une clé de navigateur du tableau de bord qui autorise http://localhost:3206.

git clone --depth 1 https://github.com/unmap-dev/field-operations.git
cd field-operations
pnpm install --frozen-lockfile
cp .env.example .env.local

Réglez NEXT_PUBLIC_UNMAP_KEY dans .env.local sur votre clé, et NEXT_PUBLIC_UNMAP_ADDONS si votre clé a un module, lancez pnpm dev et ouvrez localhost:3206. L'exploitation est livrée dans data/work-orders.sample.json; parseOperation() dans lib/work-orders.ts vérifie votre propre fichier. La page des surcouches énergie couvre les couches, et l'exemple de carte énergie couvre leur composition.