compose.yaml

# Local development stack: Postgres with pdbq's fixture schema, pdbq serving
# GraphQL, and gqlgate exposing it as REST. Run from the repo root:
#
#   docker compose up
#
# No ports are published here — create a compose.override.yaml (gitignored,
# picked up automatically) mapping them to whatever fits your local setup.
services:
  db:
    # PostGIS-enabled image so the fixture schema's spatial table works.
    image: postgis/postgis:16-3.4
    environment:
      POSTGRES_USER: pdbq
      POSTGRES_PASSWORD: pdbq
      POSTGRES_DB: pdbq
    volumes:
      - ./db/init:/docker-entrypoint-initdb.d:ro
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U pdbq"]
      interval: 2s
      timeout: 2s
      retries: 15

  pdbq:
    image: ghcr.io/suprbdev/pdbq:latest
    depends_on:
      db:
        condition: service_healthy
    environment:
      PDBQ_DATABASE_URL: postgres://pdbq:pdbq@db:5432/pdbq
      PDBQ_RLS_ENABLED: "false" # dev stack; see pdbq's docs/rls.md for production
      PDBQ_SERVER_GRAPHIQL: "true"
      PDBQ_ERRORS_DETAIL: dev
      PDBQ_LOG_LEVEL: info

  gqlgate:
    image: suprbdev/gqlgate:latest
    build:
      context: .
    depends_on:
      - pdbq
    environment:
      GQLGATE_UPSTREAM_URL: http://pdbq:8080
      # Empty introspects pdbq at boot; pdbq's watch mode plus SIGHUP or
      # GQLGATE_SCHEMA_POLL__INTERVAL keeps the routes current.
      GQLGATE_SCHEMA_PATH: ""
      GQLGATE_LOG_LEVEL: debug
      GQLGATE_SERVER_OPENAPI_TITLE: "gqlgate over pdbq"
      # Scalar runs in the browser, so both of these are *host* URLs: the
      # browser cannot resolve a compose service name. They must agree with the
      # ports published in compose.override.yaml, so both are driven from .env
      # rather than written twice.
      GQLGATE_SERVER_OPENAPI_SERVER__URL: http://localhost:${GQLGATE_PORT:-8081}
      # Let the Scalar origin call the data endpoints, not merely read the
      # document.
      GQLGATE_SERVER_CORS__ORIGINS: http://localhost:${SCALAR_PORT:-8082}

  scalar:
    image: scalarapi/api-reference:latest
    depends_on:
      - gqlgate
    environment:
      API_REFERENCE_CONFIG: >-
        {"url":"http://localhost:${GQLGATE_PORT:-8081}/openapi.json"}