updated GraphQL examples

Author: jirivrany

docs/graphQL_examples.md

@@ -1,6 +1,73 @@
 # GraphQL examples for testing
-## Exact segment type with specific data
-```GraphQL
+## 1. Segments
+### All Segments
+```graphql
+query AllSegments {
+  segment_list {
+    id
+    name
+    network_label
+    status
+    segment_type
+    segment_type_display
+    install_date
+    termination_date
+    comments
+  }
+}
+```
+### Segment detail
+```graphql
+query SegmentDetails($id: ID!) {
+  segment(id: $id) {
+    id
+    name
+    network_label
+    status
+    segment_type
+    segment_type_display
+    provider {
+      id
+      name
+    }
+    provider_segment_id
+    provider_segment_name
+    provider_segment_contract
+    site_a {
+      id
+      name
+    }
+    location_a {
+      id
+      name
+    }
+    site_b {
+      id
+      name
+    }
+    location_b {
+      id
+      name
+    }
+    type_specific_data
+    has_type_specific_data
+    has_path_data
+    path_length_km
+    path_source_format
+    path_notes
+    comments
+  }
+}
+```
+Variable must be set
+```json
+{
+  "id": 10
+}
+```
+
+### Exact segment type with specific data
+```graphql
 query DarkFiber {
   segment_list(
     filters: {
@@ -16,3 +83,192 @@ query DarkFiber {
   }
 }
 ```
+### Complex filtering - Active dark fiber segments with path data
+```graphql
+query ActiveDarkFiberWithPaths {
+  segment_list(
+    filters: {
+      segment_type: { exact: "dark_fiber" },
+      status: { exact: "active" },
+      has_path_data: true
+    }
+  ) {
+    id
+    name
+    segment_type_display
+    has_path_data
+    path_length_km
+    path_source_format
+  }
+}
+```
+### Segments with path geometry data 
+Heavy load - with all paths in GeoJSON
+```graphql
+query SegmentsWithPaths {
+  segment_list(
+    filters: {
+      has_path_data: true
+    }
+  ) {
+    id
+    name
+    has_path_data
+    path_length_km
+    path_coordinates
+    path_bounds {
+      xmin
+      ymin
+      xmax
+      ymax
+    }
+    path_geometry_geojson
+  }
+}
+```
+
+## 2. Service paths
+### Get all service paths with their segments
+```graphql
+query AllServicePaths {
+  service_path_list {
+    id
+    name
+    status
+    kind
+    segments {
+      id
+      name
+      segment_type
+      status
+    }
+    comments
+  }
+}
+```
+### Get a specific service path with detailed segment information
+```graphql
+query ServicePathDetails($id: ID!) {
+  service_path(id: $id) {
+    id
+    name
+    status
+    kind
+    segments {
+      id
+      name
+      segment_type
+      segment_type_display
+      provider {
+        name
+      }
+      site_a {
+        name
+      }
+      site_b {
+        name
+      }
+      path_length_km
+      has_path_data
+    }
+    comments
+  }
+}
+```
+Variable must be set
+```json
+{
+  "id": 10
+}
+```
+### Filtering - active core service paths 
+```graphql
+query ActiveCore {
+  service_path_list(
+    filters: {
+      status: { exact: "active" },
+      kind: { exact: "core" }
+    }
+  ) {
+    id
+    name
+    status
+    kind
+    segments {
+      id
+      name
+    }
+  }
+}
+```
+## 3. Circuit Mapping
+### Get all segment-circuit mappings
+```graphql
+query SegmentCircuitMappings {
+  segment_circuit_mapping_list {
+    id
+    segment {
+      id
+      name
+      segment_type
+    }
+    circuit {
+      id
+      cid
+      provider {
+        name
+      }
+    }
+  }
+}
+```
+### Get circuits for a specific segment
+```graphql
+query CircuitsForSegment($segmentId: ID!) {
+  segment_circuit_mapping_list(
+    filters: {
+      segment: { id: $segmentId }
+    }
+  ) {
+    id
+    circuit {
+      id
+      cid
+      provider {
+        name
+      }
+      status
+    }
+  }
+}
+```
+Variable must be set
+```json
+{
+  "segmentId": 10
+}
+```
+### Get segments for a specific circuit
+```graphql
+query SegmentsForCircuit($circuitId: ID!) {
+  segment_circuit_mapping_list(
+    filters: {
+      circuit: { id: $circuitId }
+    }
+  ) {
+    id
+    segment {
+      id
+      name
+      segment_type
+      status
+    }
+  }
+}
+```
+Variable must be set
+```json
+{
+  "circuitId": 10
+}
+```