README: document the webhook error net, the OC timeouts, and the missing reconciliation
ci/woodpecker/push/woodpecker Pipeline was successful
ci/woodpecker/push/woodpecker Pipeline was successful
This commit is contained in:
1 parent
9c53e5e727
commit
32e744d9ee
1 file changed
+12
-1
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user