autoreg-skills-max: initial public release (restored, redacted, hardened)

2026-10-20 02:16:32 +03:00
commit f58eafeb48
565 changed files with 60064 additions and 0 deletions
--- a/skills/conol-automation/references/dashboard-multi-reg.md
+++ b/skills/conol-automation/references/dashboard-multi-reg.md
@@ -0,0 +1,124 @@
+# Dashboard + Multi-Reg System
+
+New components added 2026-07-30 for the Conol pool distribution package.
+
+## Architecture additions
+
+```
+conol_autoreg/
+├── dashboard_server.py   # FastAPI live dashboard (15 KB) — port 9988
+├── multi_reg.py           # Multi-threaded parallel registration (20 KB)
+├── start_all.bat          # Unified launcher with menu (3.3 KB)
+├── chrome_cdp.bat         # Chrome CDP launcher (667 B)
+├── config.example.json    # Template config for distribution (734 B)
+├── requirements.txt       # Python dependencies
+└── README.md              # User-facing guide (3 KB)
+```
+
+## Dashboard (port 9988)
+
+FastAPI server with dark HTML interface, auto-refresh every 3s.
+
+**API endpoints:**
+- `GET /api/status` — full pool + gateway status
+- `GET /api/accounts` — account list
+- `GET /api/queue` — email queue
+- `POST /api/queue/add` — add email to queue (JSON body: `{email, password}`)
+- `POST /api/reload` — signal gateway to reload accounts
+- `GET /api/queue/clear` — clear queue
+
+**HTML interface features:**
+- Stats cards: Alive, Dead, Total Credits, Avg Credits, Reg Today, Gateway
+- Full account table with credits bars
+- Email queue section with add form
+- Action buttons: Refresh, Start Registration, Farm Quests, Reload Gateway
+
+**Startup:**
+```bash
+python dashboard_server.py
+# → http://127.0.0.1:9988
+```
+
+## Multi-Threaded Registration (multi_reg.py)
+
+Reads `email_queue.jsonl`, registers N accounts per email in parallel.
+
+**Usage:**
+```bash
+python multi_reg.py 3 2
+#  3 = accounts per email
+#  2 = max parallel threads
+```
+
+**Flow per email:**
+1. Uses Chrome CDP via Playwright (`connect_over_cdp`)
+2. `asyncio.Semaphore` controls concurrency
+3. Per account: signup → recaptcha → send verification → IMAP wait → verify → login
+4. Saves cookies → appends to `conol_accounts_pool.jsonl`
+5. After registration: auto-farms all 6 quests
+6. Updates `email_queue.jsonl` status: `queued` → `registering` → `registered` → `quests_done`
+
+**Gmail verification** runs in `ThreadPoolExecutor` (parallel across clients):
+```python
+loop.run_in_executor(None, wait_for_verify_link_sync, gmail_addr, gmail_app, alias, since_epoch)
+```
+
+## Unified Launcher (start_all.bat)
+
+Single `.bat` with 9-option menu:
+1. Start Gateway (9999)
+2. Start Dashboard (9988)
+3. Start BOTH + Chrome CDP
+4. Start Multi-Reg (from email queue)
+5. Start ALL (Gateway + Dash + CDP)
+6. Register N accounts (manual)
+7. Farm Quests (all accounts)
+8. Check Status / Health
+9. Kill All
+
+Auto-checks: Python installed, deps available, config.json valid, Chrome CDP running, gateway alive.
+
+## Distribution Package
+
+For giving to other people:
+
+1. They copy `conol_autoreg` folder (minus your `config.json`)
+2. Copy `config.example.json` → `config.json`, fill their gmail + app password
+3. Install deps: `pip install fastapi uvicorn httpx playwright requests pyyaml`
+4. Install Chromium: `playwright install chromium`
+5. Run `start_all.bat`
+6. Dashboard opens at `http://127.0.0.1:9988`
+7. Add emails via dashboard form → run multi_reg
+
+## FastAPI Pitfall: Request Body Parsing
+
+```python
+# ❌ WRONG — FastAPI treats `request: dict` as query parameter
+@app.post("/api/queue/add")
+async def queue_add(request: dict):
+    email = request.get("email")  # → None!
+
+# ✅ CORRECT — use `from fastapi import Request` + await request.json()
+from fastapi import FastAPI, HTTPException, Request
+
+@app.post("/api/queue/add")
+async def queue_add(request: Request):
+    body = await request.json()
+    email = body.get("email")  # → works!
+```
+
+**Reason:** FastAPI only auto-parses JSON body into Pydantic models or when using `Body()`. A bare `dict` type annotation is treated as a query parameter, not a body parameter. The `Request` object's `.json()` method gives direct access.
+
+## Port Conflict Resolution (Windows)
+
+When a process dies but leaves port occupied:
+
+```bash
+# Find PID on port
+netstat -ano | grep 9988
+
+# Kill via PowerShell (taskkill fails in git-bash)
+powershell -Command "Stop-Process -Id <PID> -Force"
+```
+
+Do NOT use `taskkill //PID` in git-bash — syntax fails. Use PowerShell `Stop-Process` instead.