Waypoints, Corridor et Déviation

Surveillance géographique du moteur V2 : 9 types de lieux répertoriés, détection d'entrée/sortie par rayon, séquence de mission forward-only, corridor comme polygone GeoJSON, déviation avec métriques et arrêts. 22 cas d'usage.

A. Detection de Waypoint 9 cas

Étape 7 du pipeline (detectWaypoint). Chaque position acceptée est testée contre tous les waypoints du tenant. Distance haversine vers le centre ; comparaison au radius_m.

Matching forward-only sur un aller-retour

La mission Douala→Garoua→N'Djamena→Garoua→Douala : mêmes waypoints physiques à des positions de séquence différentes. Le moteur ne matche que vers l'avant.

Les 9 types de waypoint

Arbre de décision : autorisation d'arrêt

B. Corridor et Déviation 13 cas

Étape 8 du pipeline (detectCorridorDeviation). Le corridor est un polygone GeoJSON chargé dans BatchContext.corridorPolygons. Test de containment via @turf/boolean-point-in-polygon (ray-casting JS, ~0.01ms/position). Distance maximale via @turf/point-to-line-distance.

Schémas de données

waypoints

CREATE TABLE waypoints (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID REFERENCES tenants(id),  -- NULL = waypoint système
    name            TEXT NOT NULL,
    position        GEOGRAPHY(Point, 4326) NOT NULL,
    radius_m        INTEGER NOT NULL,
    waypoint_type   TEXT NOT NULL CHECK (waypoint_type IN (
        'city', 'rest_area', 'border', 'port', 'fuel_station',
        'warehouse', 'checkpoint', 'custom', 'depot'
    )),
    source          TEXT NOT NULL DEFAULT 'manual'
                    CHECK (source IN ('manual', 'discovered')),
    confirmed       BOOLEAN NOT NULL DEFAULT true,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
-- Index spatial pour requetes ST_DWithin
CREATE INDEX waypoints_position ON waypoints USING GIST (position);

waypoint_visits

CREATE TABLE waypoint_visits (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    vehicle_id      UUID NOT NULL REFERENCES vehicles(id),
    waypoint_id     UUID NOT NULL REFERENCES waypoints(id),
    mission_id      UUID REFERENCES missions(id),

    trip_id             UUID REFERENCES trips(id),
    mission_waypoint_id UUID REFERENCES mission_waypoints(id),

    state           TEXT NOT NULL CHECK (state IN ('inside', 'exited')),
    entered_at      TIMESTAMPTZ NOT NULL,
    exited_at       TIMESTAMPTZ,
    entry_position  GEOGRAPHY(Point, 4326),
    exit_position   GEOGRAPHY(Point, 4326),
    duration_seconds INTEGER,

    stop_count          INTEGER,
    total_stop_seconds  INTEGER,
    distance_within_m   NUMERIC(10,1),

    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
-- Une visite active par waypoint par véhicule
CREATE UNIQUE INDEX waypoint_visits_one_active
    ON waypoint_visits (vehicle_id, waypoint_id)
    WHERE state = 'inside';

corridor_deviations

CREATE TABLE corridor_deviations (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id       UUID NOT NULL REFERENCES tenants(id),
    vehicle_id      UUID NOT NULL REFERENCES vehicles(id),
    mission_id      UUID NOT NULL REFERENCES missions(id),

    state           TEXT NOT NULL CHECK (state IN
                        ('active', 'returned', 'abandoned')),
    started_at      TIMESTAMPTZ NOT NULL,
    ended_at        TIMESTAMPTZ,

    exit_position   GEOGRAPHY(Point, 4326),
    return_position GEOGRAPHY(Point, 4326),
    max_distance_from_corridor_m NUMERIC(10,1),

    distance_m          NUMERIC(10,1),
    duration_seconds    INTEGER,
    stop_count          INTEGER,
    exit_speed_kmh      NUMERIC(5,1),

    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

Automates d'état

Visite de waypoint

Déviation de corridor

Règles cles

Performance (Decision D-corridor-pure-engine)

Configuration (tenant_event_config)

Source : pipeline.md steps 7-8, state-machines.md 3.4-3.5, config.md 11.2, schemas.md 2.4-2.7