coulomb/fin-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add per-client billing basis export

Browse source
This commit is contained in:
tegwick 2026-08-11 14:39:48 +02:00
parent b75ad06b3a
commit fcec177ded
10 changed files with 506 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

8
README.md
View file

@ -25,6 +25,7 @@ uv run finhub ledger import cloud tests/fixtures/cloud-costs.csv
uv run finhub ledger set-price --client acme --application portal --instance prod-01 --period 2026-07 --amount 100 --source agreement-2026-01
uv run finhub ledger margins
uv run finhub ledger allocations
uv run finhub ledger billing-basis
uv run finhub evaluate
uv run finhub evidence --seed-fixtures
uv run finhub serve
@ -78,6 +79,13 @@ and provenance remain visible. Deterministic largest-remainder rounding makes
all target amounts plus the explicit unattributed residual reconcile exactly
to booked cost.
`ledger billing-basis` produces an idempotent client-period reporting artifact.
Each record includes the current price and revision, direct and allocated cost,
margin, financial-fact/correction IDs, allocation/revision IDs, and non-secret
provenance. Residuals, non-client targets, and client costs without a price are
explicit exceptions. The artifact carries a mandatory disclaimer and never
assigns invoice numbers, performs bookkeeping, or requests/tracks payment.
## Related Workplans
- `the-custodian/workplans/CUST-WP-0025-fos-hub-bootstrap.md` — umbrella