chore(rewrite-v2): Ground-up rewrite of Python Italy Telegram Bot ("Electus")

[Copilot]

Complete replacement of the legacy fork-based codebase with a clean Python 3.14/uv rewrite. Named Electus (Matrix × Python theme), Italian-first UX.

Core architecture

• src/python_italy_bot/ — single installable package via pyproject.toml
• Repository pattern — dual Repository (sync) / AsyncRepository (async) abstract interfaces in db/base.py; in-memory default, asyncpg PostgreSQL when DATABASE_URL is set
• Handler → Service → Repository layering; handlers are thin wires, business logic lives in services/

Features

• Captcha flow — new member restricted on join → DMs bot the secret command found in assets/regolamento.md → bot unrestricts; globally-verified users skip captcha in subsequent chats
• Moderation — /ban, /unban, /mute, /unmute, /report, @admin mention; global ban propagated across all registered chats
• Spam detection — per-user rate window + message-hash deduplication with auto-delete
• Group settings — per-chat custom welcome message via /setwelcome / /resetwelcome
• Owner tools — /announce broadcast to all registered chats, /ping health check
• /id — returns chat ID + caller user ID

Persistence

8 PostgreSQL tables (schema.sql): pending_verifications, verified_users, bans, mutes, reports, group_settings, globally_verified_users, bot_chats, global_bans. Zero-config in-memory backend requires no schema.

Configuration

All settings via env vars; .env.example provided. Key vars: TELEGRAM_BOT_TOKEN, DATABASE_URL, CAPTCHA_SECRET_COMMAND, BOT_OWNER_ID, MAIN_GROUP_ID, LOCAL_GROUP_IDS, RULES_URL.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.