stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

docs consolidation

Browse Source
This commit is contained in:
StellaOps Bot
2025-12-24 21:45:46 +02:00
parent 4231305fec
commit 43e2af88f6
76 changed files with 2887 additions and 796 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/33_333_QUOTA_OVERVIEW.md
View File

@@ -40,7 +40,7 @@ the CLI/UI introduce a delay, detailed below.*
| Step | Operation | Typical latency |
| ---- | ------------------------------------------------------------------------------ | ------------------------------------ |
| 1 | `key = sha256(ip)` *or* `sha256(tid)` | < 0.1 ms |
| 2 | `count = INCR quota:<key>` in Redis (24 h TTL) | 0.2 ms (Lua) |
| 2 | `count = INCR quota:<key>` in Valkey (24 h TTL) | 0.2 ms (Lua) |
| 3 | If `count > limit` → `WAIT delay_ms` | first 30 × 5 000 ms → then 60 000 ms |
| 4 | Return HTTP 429 **only if** `delay > 60 s` (should never fire under free tier) | — |
@@ -91,7 +91,7 @@ docker run --rm \
<details>
<summary>Does the quota differ offline?</summary>
> No. Counters are evaluated locally in Redis; the same limits apply even
> No. Counters are evaluated locally in Valkey; the same limits apply even
> without Internet access.
</details>
@@ -99,7 +99,7 @@ docker run --rm \
<details>
<summary>Can I reset counters manually?</summary>
> Yes – delete the `quota:*` keys in Redis, but we recommend letting them
> Yes – delete the `quota:*` keys in Valkey, but we recommend letting them
> expire at midnight to keep statistics meaningful.
</details>