docs: Add README for utilization-metering-consumer service (#755)

bjcoombs · web-flow · commit 93ba5597f4be · 2026-02-05T21:27:04.000Z
* docs: Add comprehensive README for utilization-metering-consumer service Add service-level documentation for utilization-metering-consumer following the same pattern as other Meridian services. Update services/README.md to link to the new documentation. Key additions: - Service overview and architecture diagrams - HTTP endpoints and domain model - Kafka configuration and consumed topics - Utilization instruments and billing patterns - Prometheus metrics and alerting recommendations - Deployment, monitoring, and troubleshooting guides - Error handling patterns and autoscaling configuration The documentation covers the centralized consumer design that transforms audit events from all 6 domain services into utilization measurements for tenant-zero position keeping (platform billing). * fix: Correct Universal Asset System documentation link path The Universal Asset System documentation is located in docs/prd/, not docs/architecture/. Update the reference link to point to the correct path. Resolves review comment from PR #755. * fix: Upgrade Go to 1.25.7 to address crypto/tls vulnerability (GO-2026-4337) Upgrade Go from 1.25.6 to 1.25.7 to fix vulnerability GO-2026-4337: "Unexpected session resumption in crypto/tls" This vulnerability affects TLS session handling in the standard library and impacts multiple components: - Database connections (PostgreSQL) - HTTP/gRPC servers (Gateway, all services) - OAuth token introspection - Redis connections - Test containers Changes: - go.mod: Update Go version to 1.25.7 - Dockerfile: Update base image to golang:1.25.7-bookworm - Dockerfile.dev: Update base image to golang:1.25.7-bookworm - GitHub workflows: Update go-version to 1.25.7 across all CI jobs Reference: https://pkg.go.dev/vuln/GO-2026-4337 Resolves: Go Vulnerability Check failure in CI * fix: Complete Go 1.25.7 upgrade across all files Complete the Go version upgrade to address GO-2026-4337 by updating remaining files that reference Go versions: Workflow files: - .github/workflows/claude.yml: Update project facts text - .github/workflows/schema-validation.yml: Update go-version Documentation: - docs/adr/0006-tilt-local-development.md: Update example output - docs/guides/new-bian-service-checklist.md: Update Dockerfile example Service Dockerfiles (10 files): - services/current-account/cmd/Dockerfile - services/financial-accounting/cmd/Dockerfile - services/gateway/cmd/Dockerfile - services/internal-bank-account/cmd/Dockerfile - services/market-information/cmd/Dockerfile - services/party/cmd/Dockerfile - services/payment-order/cmd/Dockerfile - services/position-keeping/cmd/Dockerfile - services/tenant/cmd/Dockerfile - services/utilization-metering-consumer/cmd/Dockerfile All Go version references now consistently point to 1.25.7. Based on: PR #757 file changes --------- Co-authored-by: Ben Coombs <bjcoombs@users.noreply.github.com>
diff --git a/.github/workflows/benchmarks.yml b/.github/workflows/benchmarks.yml
@@ -27,7 +27,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Set up buf
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -31,7 +31,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Set up buf
diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml
@@ -51,8 +51,8 @@ jobs:
             IMPORTANT: Today's date is ${{ steps.date.outputs.current_date }}.
 
             Key project facts:
-            - This project uses Go 1.25.6 (latest stable release)
-            - Go 1.25.6 is a valid version - do not question or flag it
+            - This project uses Go 1.25.7 (latest stable release)
+            - Go 1.25.7 is a valid version - do not question or flag it
             - Architecture: BIAN-compliant microservices
             - Stack: Go, Protocol Buffers, gRPC, Kubernetes
             - Security: All security scans must remain BLOCKING (never suggest making them non-blocking)
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
@@ -64,7 +64,7 @@ jobs:
       if: matrix.language == 'go'
       uses: actions/setup-go@v6
       with:
-        go-version: '1.25.6'
+        go-version: '1.25.7'
         cache: true
 
     # Set up buf for protobuf generation (pinned version for reproducibility)
diff --git a/.github/workflows/migrations.yml b/.github/workflows/migrations.yml
@@ -35,7 +35,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Install Atlas CLI
@@ -80,7 +80,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Install Atlas CLI
@@ -241,7 +241,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Install Atlas CLI
diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
@@ -28,7 +28,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Set up buf
@@ -98,7 +98,7 @@ jobs:
     - name: Set up Go
       uses: actions/setup-go@v6
       with:
-        go-version: '1.25.6'
+        go-version: '1.25.7'
         cache: true
 
     - name: Set up buf
diff --git a/.github/workflows/quality.yml b/.github/workflows/quality.yml
@@ -38,7 +38,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Set up buf
diff --git a/.github/workflows/schema-validation.yml b/.github/workflows/schema-validation.yml
@@ -33,7 +33,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25'
+          go-version: '1.25.7'
           cache: true
 
       - name: Install protoc
diff --git a/.github/workflows/security.yml b/.github/workflows/security.yml
@@ -25,7 +25,7 @@ jobs:
     - name: Set up Go
       uses: actions/setup-go@v6
       with:
-        go-version: '1.25.6'
+        go-version: '1.25.7'
         cache: true
 
     - name: Set up buf
@@ -51,7 +51,7 @@ jobs:
     - name: Set up Go
       uses: actions/setup-go@v6
       with:
-        go-version: '1.25.6'
+        go-version: '1.25.7'
         cache: true
 
     - name: Set up buf
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -22,7 +22,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v6
         with:
-          go-version: '1.25.6'
+          go-version: '1.25.7'
           cache: true
 
       - name: Set up buf
diff --git a/Dockerfile b/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/Dockerfile.dev b/Dockerfile.dev
@@ -1,7 +1,7 @@
 # audit-worker - Development Dockerfile for Tilt Live Update
 # Uses Debian bookworm for CGO support (required by confluent-kafka-go/librdkafka)
 
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies for CGO (librdkafka)
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/docs/adr/0006-tilt-local-development.md b/docs/adr/0006-tilt-local-development.md
@@ -548,7 +548,7 @@ Provided scripts make onboarding easy:
 
 # Output:
 
-# ✓ Go 1.25.3 installed
+# ✓ Go 1.25.7 installed
 
 # ✓ Docker running
 
diff --git a/docs/guides/new-bian-service-checklist.md b/docs/guides/new-bian-service-checklist.md
@@ -576,7 +576,7 @@ Create a multi-stage Docker build.
 
 ```dockerfile
 # Stage 1: Build
-FROM golang:1.25-alpine AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 ARG VERSION=dev
 ARG COMMIT=unknown
diff --git a/go.mod b/go.mod
@@ -1,6 +1,6 @@
 module github.com/meridianhub/meridian
 
-go 1.25.5
+go 1.25.7
 
 require (
 	ariga.io/atlas-provider-gorm v0.6.0
diff --git a/services/README.md b/services/README.md
@@ -369,7 +369,8 @@ The Utilization Metering Consumer is a centralized Kafka consumer for platform b
 - **HPA scaling** based on Kafka consumer lag (1-5 replicas)
 - **Tenant-zero isolation** for platform billing data
 
-See [services/utilization-metering-consumer/k8s/README.md](utilization-metering-consumer/k8s/README.md) for deployment details.
+See [services/utilization-metering-consumer/README.md](utilization-metering-consumer/README.md) for full
+documentation and [k8s/README.md](utilization-metering-consumer/k8s/README.md) for deployment details.
 
 ## Service-Owned Client Libraries
 
diff --git a/services/current-account/cmd/Dockerfile b/services/current-account/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/financial-accounting/cmd/Dockerfile b/services/financial-accounting/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/gateway/cmd/Dockerfile b/services/gateway/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/internal-bank-account/cmd/Dockerfile b/services/internal-bank-account/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/market-information/cmd/Dockerfile b/services/market-information/cmd/Dockerfile
@@ -4,7 +4,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go dependencies
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/party/cmd/Dockerfile b/services/party/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/payment-order/cmd/Dockerfile b/services/payment-order/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/position-keeping/cmd/Dockerfile b/services/position-keeping/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/tenant/cmd/Dockerfile b/services/tenant/cmd/Dockerfile
@@ -3,7 +3,7 @@
 # Uses distroless base image (~2MB) enabled by pure-Go franz-go Kafka client
 
 # Build stage
-FROM golang:1.25.6-bookworm AS builder
+FROM golang:1.25.7-bookworm AS builder
 
 # Install build dependencies
 RUN apt-get update && apt-get install -y --no-install-recommends \
diff --git a/services/utilization-metering-consumer/README.md b/services/utilization-metering-consumer/README.md
diff --git a/services/utilization-metering-consumer/cmd/Dockerfile b/services/utilization-metering-consumer/cmd/Dockerfile
