portal: add admin endpoint to grant a held credit pack to a member

Held credit packs (purchases by non-members) could previously only be
refunded or auto-granted when the SAME email/slug later became a member.
A purchase made on another account's behalf therefore had no admin path
and forced a hand-edit of money state.

Add POST /admin/held-credits/{hold_id}/grant with body {email}: applies
the hold to a specified member account in one transaction (balance +
ledger + hold -> granted), idempotent on reference held:<hold_id>.
This commit is contained in:
inference-bot committed 2026-11-05 03:45:14 +00:00
1 parent ed1e361b14
commit e103e6779b
1 file changed
+100
+100
View File
@@ -3227,6 +3227,106 @@ async def admin_held_refund(hold_id: int, request: Request):
return {"status": "refunded", "id": hold_id} return {"status": "refunded", "id": hold_id}
@app.post("/admin/held-credits/{hold_id}/grant")
@limiter.limit("20/minute")
async def admin_held_grant(hold_id: int, request: Request):
"""Apply a held credit pack to a specified member account.
Body: {"email": "member@..."} — the member account that should receive the
held credits. This covers purchases made by someone other than the member
(e.g. a credit pack bought on another account's behalf), which the
provisioning-time auto-grant cannot match because it keys on the buyer's
own email/slug.
Atomic and idempotent: the balance update and the ledger insert happen in
one transaction, and the hold is flipped `held` → `granted` in the same
transaction. The ledger reference is `held:<hold_id>` (the same shape the
provisioning-time auto-grant uses), so a re-run cannot double-apply.
"""
_verify_admin_token(request)
body = await request.json()
email = (body.get("email") or "").strip().lower()
if not email:
raise HTTPException(400, "Missing email")
conn = get_db()
row = conn.execute(
"SELECT id, slug, email, name, amount, oc_reference, status "
"FROM held_credits WHERE id = ?",
(hold_id,),
).fetchone()
if not row:
conn.close()
raise HTTPException(404, "Held credit not found")
if row[6] != "held":
conn.close()
raise HTTPException(409, f"Held credit already {row[6]}")
dest = conn.execute(
"SELECT active FROM members WHERE LOWER(email) = ?", (email,)
).fetchone()
if not dest:
conn.close()
raise HTTPException(404, f"No member account for {email}")
if not dest[0]:
conn.close()
raise HTTPException(409, f"Member {email} is not active; refusing")
amount = float(row[4] or 0.0)
reference = f"held:{hold_id}"
if credit_reference_exists(reference):
conn.close()
raise HTTPException(409, f"Credit already recorded for {reference}")
buyer = row[2] or row[1]
buyer_name = row[3] or row[1]
reason = (
f"credit pack (${amount:.2f}) bought by {buyer} ({buyer_name}); "
f"held credit transferred to this member account at the operator's "
f"instruction (hold #{hold_id}, oc:{row[5] or ''})"
)
# One transaction: flip the hold, move the balance, write the audit row.
cur = conn.execute(
"UPDATE held_credits SET status = 'granted', resolved_at = datetime('now') "
"WHERE id = ? AND status = 'held'",
(hold_id,),
)
if cur.rowcount != 1:
conn.close()
raise HTTPException(409, "Held credit already resolved")
conn.execute(
"UPDATE members SET credit_balance = MAX(0, COALESCE(credit_balance, 0) + ?) "
"WHERE LOWER(email) = ?",
(amount, email),
)
conn.execute(
"INSERT INTO credit_ledger (email, delta, reason, reference) VALUES (?, ?, ?, ?)",
(email, amount, reason, reference),
)
new_balance = conn.execute(
"SELECT credit_balance FROM members WHERE LOWER(email) = ?", (email,)
).fetchone()[0]
conn.commit()
conn.close()
applied = await sync_team_budget_from_balance(email)
logger.info(
"Held credit #%s ($%.2f) from %s granted to %s (balance %s)",
hold_id, amount, buyer, email, new_balance,
)
return {
"status": "granted",
"hold_id": hold_id,
"email": email,
"credits_added": amount,
"credit_balance": float(new_balance),
"reference": reference,
"oc_reference": row[5],
"team_budget": applied,
}
# Operator accounts — shown under a separate "admin" status in the panel and # Operator accounts — shown under a separate "admin" status in the panel and
# excluded from the member counts. They're infrastructure accounts (the SSO # excluded from the member counts. They're infrastructure accounts (the SSO
# owner and the bot), not dues-paying members. # owner and the bot), not dues-paying members.