chore: Revert supergraph.yaml (#6402)

Author: HyeockJinKim

configs/graphql/README.md

@@ -9,7 +9,7 @@ We use [The Guild's Hive Gateway](https://the-guild.dev/graphql/hive/docs/gatewa
 ## Files
 
 - `gateway.config.ts`: Hive Gateway configuration (host, port, subgraph endpoints, metrics)
-- `supergraph.yaml`: Rover CLI configuration for composing subgraphs
+- `supergraph.yaml`: **Rover CLI configuration** for composing multiple subgraph schemas into a unified supergraph schema
 - `router.yaml`: Legacy Apollo Router configuration (kept for reference)
 
 ## Gateway Configuration
@@ -36,18 +36,27 @@ The federated graph consists of two subgraphs:
 
 ## Schema Updates
 
-Hive Gateway loads the composed supergraph schema from `docs/manager/graphql-reference/supergraph.graphql`.
+### Supergraph Composition with Rover
 
-When subgraph schemas are modified, regenerate the supergraph using Rover (Apollo Federation CLI):
+Hive Gateway loads the composed supergraph schema from `docs/manager/graphql-reference/supergraph.graphql`. This unified schema is generated by composing multiple subgraph schemas using **Rover**, the Apollo Federation CLI tool.
+
+The `supergraph.yaml` file is the Rover configuration that defines:
+- **Subgraph names**: Identifiers for each subgraph (`graphene`, `strawberry`)
+- **Routing URLs**: HTTP endpoints for each subgraph service
+- **Schema file locations**: Local paths to each subgraph's GraphQL schema
+
+When subgraph schemas are modified, regenerate the supergraph using Rover:
 
 ```bash
 # From project root
 rover supergraph compose --config configs/graphql/supergraph.yaml > docs/manager/graphql-reference/supergraph.graphql
 ```
 
-The `supergraph.yaml` file defines:
-- Subgraph names and routing URLs
-- Schema file locations for each subgraph
+This command:
+1. Reads the subgraph configurations from `supergraph.yaml`
+2. Loads and validates each subgraph schema from the specified file paths
+3. Composes them into a unified federated supergraph schema
+4. Outputs the result to `docs/manager/graphql-reference/supergraph.graphql`
 
 After regenerating the supergraph, restart the gateway container:
 

configs/graphql/supergraph.yaml

@@ -0,0 +1,27 @@
+# Rover Supergraph Composition Configuration
+#
+# This file is used by Apollo Rover CLI to compose multiple subgraph schemas
+# into a unified supergraph schema for GraphQL Federation.
+#
+# Usage:
+#   rover supergraph compose --config configs/graphql/supergraph.yaml > docs/manager/graphql-reference/supergraph.graphql
+#
+# After regenerating the supergraph schema, restart the gateway:
+#   docker compose -f docker-compose.halfstack-main.yml restart backendai-half-apollo-router
+#
+# For more information, see:
+#   - configs/graphql/README.md
+#   - https://www.apollographql.com/docs/rover/commands/supergraphs
+
+subgraphs:
+  # Legacy GraphQL API (Graphene-based)
+  graphene:
+    routing_url: http://host.docker.internal:8091/admin/gql
+    schema:
+      file: ../../docs/manager/graphql-reference/schema.graphql
+
+  # New GraphQL API (Strawberry-based) with WebSocket subscription support
+  strawberry:
+    routing_url: http://host.docker.internal:8091/admin/gql/strawberry
+    schema:
+      file: ../../docs/manager/graphql-reference/v2-schema.graphql