# CreditService

`creditservice` is a minimal reference service that proves UltraCloud can integrate vendor-specific quota and credit control with platform auth and gateway admission.

It is intentionally not a full billing product.

## What this proves

- a vendor-specific credit or quota service can be built in-tree
- the service can authenticate against Photon IAM
- the service can participate in gateway and control-plane admission flows
- the service can persist state in Photon-supported backends

## Supported scope

- quota checks
- credit reservations, commits, and releases
- tenant-aware auth integration
- gateway-facing admission control hooks

## Explicit non-goals

- invoicing
- tax handling
- discounts and pricing catalogs
- finance-grade ledger completeness
- full metering platform ownership

## Test expectation

The main proof should come from cluster-level VM validation in `nix/test-cluster`, not from expanding `creditservice` into a larger product surface.

Concrete proof path:

```bash
nix run ./nix/test-cluster#cluster -- fresh-smoke
```

That flow boots node06 with `apigateway`, `nightlight`, and `creditservice`, and validates that `creditservice` starts in the IAM-integrated cluster path.
