README: document the webhook error net, the OC timeouts, and the missing reconciliation
ci/woodpecker/push/woodpecker Pipeline was successful

This commit is contained in:
inference-admin committed 2026-11-13 20:05:23 +00:00
1 parent 9c53e5e727
commit 32e744d9ee
1 file changed
+12 -1
+12 -1
View File
@@ -30,7 +30,18 @@ LibreChat ──→ Member Portal ──→ LiteLLM ──→ backend
## The three responsibilities
1. **Webhook handler** (`POST /webhook/opencollective`) — listens for Open
Collective membership events and activates/deactivates members.
Collective membership events and activates/deactivates members. The same
endpoint carries credit-pack purchases, so a failure here can cost a member
money: it answers **503** (retryable) with an ERROR line naming the exception
when anything unexpected escapes, and **401** when the URL token is wrong —
that status means the webhook URL and `WEBHOOK_TOKEN` disagree, so it is
never swallowed by the error net. Any OC read it makes has an explicit
timeout and one retry (`_oc_graphql_post`); until 2026-11-13
`fetch_all_member_nodes` used httpx's 5-second default and a slow page became
an unhandled 500 on a paid purchase. The durable backstop — reconciling PAID
credit packs against `credit_ledger` on a schedule — is not built yet; see
the app repo's issue *"Backstop: reconcile PAID credit packs against the
ledger"*.
2. **Key injector** (`/v1/*`) — reads the member's email from the
`X-User-Email` header, looks up their LiteLLM key, and forwards the
request to the gateway with that key.