diff --git a/README.md b/README.md index 9387ba5..295f67f 100644 --- a/README.md +++ b/README.md @@ -72,6 +72,23 @@ guest per recipient ever; the inviter must be an active member; an existing portal row under the recipient address is refused. Guests are subscribed to the newsletter and invited to NOTHING else (no Loomio, no Matrix). +**Member self-serve invitations (trial gate).** `POST /broker/guests` (the +member-dashboard broker identity — a guest identity fails it) lets a MEMBER +invite a guest from their dashboard: `{"email", "name"}`. The same guards run +BEFORE anything is created (`guest_request_guard`: everything above, plus the +recipient is never a `MANUAL_MEMBERS` address or an already-pending request, +and the inviter's rolling window counts pending + approved REQUESTS too). +With `GUEST_AUTO_APPROVE` **off** (the default) the request lands PENDING in +the `guest_requests` table and the operator approves or rejects it from the +panel — `GET /admin/guest-requests` (queue + ledger, pending vs approved in +one view), `POST /admin/guest-requests/{id}/approve` (fires the full guest +pipeline above; every guard re-runs and a moved-state refusal is recorded on +the request) or `.../reject`. The recipient is contacted only on approval; +the inviting member sees pending/not-approved in their own trail via +`GET /broker/guests`. With `GUEST_AUTO_APPROVE=1` a member's request +provisions immediately — flipping the gate is an env change, not a code +change. + **Sweep safety.** `reconcile_memberships()` never deactivates a guest for lacking an OC contribution. A guest lapses only by its own rules, handled by `reconcile_guest_lifecycles()` inside the sweep: credits spent out (LiteLLM's