photoncloud-monorepo/creditservice/README.md

39 lines
1.2 KiB
Markdown

# CreditService
`creditservice` is a minimal reference service that proves PhotonCloud 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.