docs: clarify full-tunnel deployment IDs — same account is fine (#126)

Vahidlazio flagged that the README's full-mode quick-start read as
"you need 3-12 separate Google accounts," which is wrong — you need
3-12 deployment IDs, which can all live on one Google account (each
"New deployment" produces its own ID). Going multi-account only
buys daily-quota headroom; the pipeline depth itself scales fine on
one account up to Apps Script's simultaneous-execution ceiling.

Also rewrites the accompanying recipe into three concrete tiers
(solo / small group / large group) instead of waving vaguely at a
range.

Closes #126. Also obsoletes my earlier analysis on #61 where I told
@Feiabyte that same-account multi-deployment "does not give
throughput" — that was wrong; it does, because simultaneous Apps
Script executions aren't bottlenecked by a per-deployment limit
until you pile up more than ~30 concurrent executions per account,
which 12 deployments don't come close to. Posting a correction on
#61 separately.
This commit is contained in:
therealaleph
2026-04-24 17:34:37 +03:00
parent a05fc5d612
commit fe84db0fe0
+4 -1
View File
@@ -290,7 +290,10 @@ More deployments = more concurrent batches = lower per-session latency. Each bat
### Quick start
1. Deploy [`CodeFull.gs`](assets/apps_script/CodeFull.gs) to 312 Google accounts (same steps as `Code.gs`, but use the full-mode script that forwards to your tunnel-node)
1. Deploy [`CodeFull.gs`](assets/apps_script/CodeFull.gs) as **312 Web App deployments** (same steps as `Code.gs`, but use the full-mode script that forwards to your tunnel-node). You can create multiple deployments on a single Google account — each "New deployment" produces its own ID. Going multi-account only matters for the daily quota (each Google account gets its own 20 000 `UrlFetchApp` calls/day on the free tier / 100 000 on Workspace); the pipeline depth itself scales fine on one account up to Apps Script's simultaneous-execution ceiling. Rule of thumb:
- **Solo use** → 36 deployments on one account is plenty
- **Shared with ~3 people** → 6 deployments on one account, bump to multi-account only if you start hitting quota alerts
- **Shared with a group** → one account per heavy user (each with 12 deployments) is the clean scaling path
2. Deploy the [tunnel-node](tunnel-node/) on a VPS
3. Set `"mode": "full"` in your config with all deployment IDs: