billing-service/README.md

billing-service

billing-service is the v1 minute-delta and replay-safe writer for the Cloud Network Billing & Control Plane.

It pulls the latest normalized snapshot from xray-exporter, computes deltas from cumulative counters, and writes idempotent usage and billing facts into the existing accounts.svc.plus PostgreSQL schema.

Endpoints

• POST /v1/jobs/collect-and-rate
• POST /v1/jobs/reconcile
• GET /healthz
• GET /v1/status

Documentation

• docs/README.md - documentation index and verification notes
• docs/architecture.md - deployment and data-flow diagrams
• docs/api.md - task API surface and upstream/downstream boundaries
• sql/billing-service-schema.sql - bootstrap/reference DDL aligned with the current accounts.svc.plus accounting schema