Repository navigation
Per-account quota poller + /quota schema {accounts, aggregate, legacy} #6
Description
Quota poller + /quota multi-account
What to build
Per-account quota poller (tối ưu phụ — failover ở ticket 3 vẫn là cơ chế chính):
- Poll quota mỗi acc (tái dùng code snapshot trong routes-quota.ts) mỗi ~5 phút với jitter (acc không poll cùng lúc),
timeoutriêng,lastPolledAtper acc. - Poll fail ≠ exhausted: lỗi poll chỉ log + đánh stale, không đổi health.
- Tách bạch expiry:
tokenExpiresAt(JWT) vsquotaExpiresAt(entitlement) — không gộp. - Poller feed
remainingUnitsvào pool (cho option most-remaining-quota).
/quota schema cố định — không đổi shape theo số acc:
{
accounts: [{ id: ..., label: ..., status: healthy, remainingUnits: 100, lastPolledAt: 0 }],
aggregate: { accountCount: 2, healthyCount: 1 },
legacy: { balances: [], claimablePlans: [], ... }
}legacy= top-level fields cũ của primary account (ổn định, KHÔNG phụ thuộc round-robin). Primary không có →legacynull có chủ đích.- Chỉ tính tổng ở
aggregatekhi cùng unitType + phạm vi; đánh dấu stale khilastPolledAtcũ. auth listthêm cột status/quota từ pool/poller (phần bị tách khỏi ticket CLI).
Acceptance criteria
- Poller poll đúng N acc với jitter, không burst đồng thời
- Poll fail → log + stale, acc KHÔNG bị đánh exhausted
-
tokenExpiresAtvàquotaExpiresAttách bạch trong response -
/quotavới 1 acc và 2 acc trả cùng shape (consumer cũ không vỡ) -
legacyổn định theo primary kể cả khi round-robin đang dùng acc khác -
aggregatechỉ cộng khi cùng unitType; stale được đánh dấu -
auth listhiện status + quota per acc
Activity
longphamdev commentedon Nov 9, 2026
#6 hoàn thành. Commits:
abd519a(poller + /quota schema),6e6b7b6(thiết kế nền),b72e980(auth list).Acceptance theo review:
consecutiveFailures++; poll thành công heal expired/exhausted (poller là probe chính){accounts[], aggregate, legacy}— cùng shape 1 hay 2 acc;legacytheo primary giữ nguyên field cũ; poll fail →legacyStale: true; aggregate ghi rõaccountsReporting/accountsTotal+ unit check;tokenExpiresAt≠quotaExpiresAt; không credential trong response (test assert)auth list: status + quota, userId che bớt, không in keyLưu ý: e2e với 2 acc thật chưa chạy được (acc thứ hai quota rỗng) — sẽ chạy khi có quota. Header
x-zcode-account+ phân phối đã có unit tests.Frontier: #2 (CLI accounts) — worktree t2 đã sync tới HEAD.
longphamdev commentedon Nov 9, 2026
Hoàn thành đầy đủ 6 acceptance criteria. Suite 1222/0 local, 1223/0 container.
feat(auth): AccountPool module — runtime state machine, round-robin, …
feat(quota): per-account poller + fixed /quota multi-account schema (#6)
feat(cli): auth list with status/quota per account (#6)
feat(cli): auth login --add/--label + auth remove (#2)