# Concepts clés de StreetUp

StreetUp organise la gestion du patrimoine et des opérations terrain autour de plusieurs notions fondamentales. Comprendre leurs rôles et leurs distinctions permet d'optimiser l'utilisation de la plateforme.

---

## 1. Vue d'ensemble du cycle de vie

L'écosystème StreetUp s'articule autour du cycle suivant :
1. **Patrimoine** (`Asset`) : Les équipements physiques présents sur le terrain.
2. **Constat & Diagnostic** (`Observation` / `Inspection`) : Ce que l'on signale à chaud ou ce que l'on contrôle de manière formelle.
3. **Travaux & Maintenance** (`Intervention` / `Projet`) : L'action corrective ou préventive menée sur le terrain.
4. **Recette & Conformité** (`Contrôle`) : La vérification formelle de la bonne réalisation des travaux.
5. **Cadre financier & Logistique** (`Commande` / `Stock` / `Équipe`) : Les marchés, pièces et ressources mobilisés.

---

## 2. Définitions et distinctions des éléments clés

### 📍 Asset (Équipement / Patrimoine)
- **Définition** : Élément physique géolocalisé du domaine public (ex: panneau de signalisation, candélabre, potelet, ouvrage GIEP, emplacement vélo).
- **Rôle** : Servir de référence centrale pour l'historique de tous les constats, interventions et contrôles associés.

### 👁️ Observation (Signalement spontané)
- **Définition** : Constat rapide "à chaud" ou alerte spontanée sur le terrain.
- **Acteurs** : Agents de voirie, observateurs, citoyens.
- **Exemple** : *"Signalement d'un dépôt sauvage ou d'un potelet plié dans une rue."*
- **Distinction** : Une observation est un événement ponctuel et spontané, contrairement à une inspection qui est formalisée.

### 🔍 Inspection (Évaluation de conformité / Diagnostic)
- **Définition** : Évaluation structurée de l'état ou de la conformité d'une cible (Asset, Localisation ou Intervention) à un instant T.
- **Acteurs** : Observers, prestataires techniques, experts.
- **Exemple** : *"Contrôle visuel de l'état d'un ouvrage de drainage ou mesure électrique d'un candélabre."*
- **Distinction** : Une inspection ne modifie pas directement l'équipement sur le terrain ; elle produit un diagnostic (conforme / non conforme / endommagé) qui peut déclencher une intervention.

### 🛠️ Intervention (Action de travaux / Maintenance)
- **Définition** : Action de terrain corrective ou préventive visant à réparer, entretenir ou remplacer un équipement.
- **Acteurs** : Régie interne, prestataires de travaux.
- **Exemple** : *"Réparation d'un nid de poule", "Remplacement d'une lanterne de signalisation".*
- **Distinction** : L'intervention est l'action physique de travaux, alors que l'inspection est le diagnostic et le contrôle est la vérification.

### ✅ Contrôle (Réception & Recette des travaux)
- **Définition** : Vérification formelle de l'exécution des travaux visant à valider la qualité et à prononcer la réception d'un chantier.
- **Acteurs** : Contrôleurs travaux, gestionnaires de contrats.
- **Exemple** : *"Procès-verbal de réception des réfections de chaussée d'un marché."*
- **Distinction** : Le contrôle intervient **après** la réalisation des travaux pour valider leur conformité contractuelle et autoriser la facturation.

### 📁 Projet (Chantier d'envergure / Regroupement)
- **Définition** : Regroupement thématique, géographique ou temporel de plusieurs interventions.
- **Exemple** : *"Réaménagement de l'avenue de la Gare (comprenant 15 interventions de voirie, signalisation et éclairage)".*

### 💶 Commande (Cadre budgétaire & Marché)
- **Définition** : Ordre de service ou bon de commande rattaché à un marché/contrat qui encadre financièrement les travaux.

---

## 3. Tableau comparatif synthétique

| Concept | Nature | Déclencheur | Objectif principal |
| :--- | :--- | :--- | :--- |
| **Asset** | Patrimoine physique | Création / Inventaire | Identifier l'équipement géolocalisé |
| **Observation** | Signalement à chaud | Spontané | Alerter sur un dysfonctionnement ou une anomalie |
| **Inspection** | Diagnostic formalisé | Planifié ou terrain | Évaluer l'état de conformité d'une cible à un instant T |
| **Intervention** | Action de travaux | Suite à alerte / programme | Réparer, remplacer ou entretenir l'équipement |
| **Contrôle** | Vérification qualité | Post-travaux | Valider la conformité de l'intervention et procéder à la réception |
| **Projet** | Regroupement de travaux | Cadrage opérationnel | Piloter un chantier comportant plusieurs interventions |
| **Commande** | Cadrage financier | Cadrage contractuel | Gérer les bons de commande et budgets des marchés |

---

## 4. Relations particulières : Inspection vs Intervention vs Contrôle

### Dualité entre `Inspection` et `Intervention`
1. **L'Inspection d'une Intervention (Suivi qualité)** : Une inspection peut cibler une intervention réalisée (ex: vérification à J+30 de la tenue d'une réparation).
2. **L'Intervention comme Cadre de Mission d'Inspections** : Une intervention de type *"mission d'inspection"* sert de conteneur administratif et financier (bon de commande, prestataire assigné) pour réaliser une campagne de $N$ inspections sur le terrain (ex: campagne annuelle de contrôle des ouvrages GIEP).

### Différence entre `Inspection` et `Contrôle`
- **L'Inspection** évalue la conformité d'un **équipement (Asset)** ou d'une **zone (Location)**, ou assure un suivi technique.
- **Le Contrôle** évalue la réalisation de la **prestation de travaux (Intervention)** en vue de sa validation administrative et financière par le gestionnaire.