feat: rebuild PyBot as a professional Discord platform v2.0.0

.dockerignore

@@ -0,0 +1,16 @@
+.git
+.github
+.env
+.venv
+venv
+__pycache__
+.pytest_cache
+.ruff_cache
+data
+*.db
+*.db-shm
+*.db-wal
+*.log
+tests
+README.md
+docs

.env.example

@@ -0,0 +1,23 @@
+# Discord Developer Portal -> Bot -> Token
+DISCORD_TOKEN=replace-me
+
+# Opcional: guild de desarrollo para sincronizar slash commands inmediatamente.
+# Si queda vacío, los comandos se sincronizan globalmente.
+DEV_GUILD_ID=
+
+# Persistencia local de configuración y recordatorios.
+DATABASE_PATH=data/pybot.db
+
+# INFO, DEBUG, WARNING, ERROR
+LOG_LEVEL=INFO
+
+# true para sincronizar comandos al iniciar.
+SYNC_COMMANDS=true
+
+# No es necesario para los slash commands actuales.
+# Activarlo exige habilitar Message Content Intent en Discord Developer Portal.
+ENABLE_MESSAGE_CONTENT_INTENT=false
+
+BOT_STATUS=Usá /ayuda
+CURRENCY_API_BASE_URL=https://dolarapi.com/v1
+HTTP_TIMEOUT_SECONDS=8

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: |
+            requirements.txt
+            requirements-dev.txt
+
+      - name: Install dependencies
+        run: python -m pip install --upgrade pip && pip install -r requirements-dev.txt
+
+      - name: Ruff
+        run: ruff check .
+
+      - name: Compile
+        run: python -m compileall -q main.py pybot
+
+      - name: Tests
+        run: pytest -q

.gitignore

@@ -1,8 +1,41 @@
-nuevaenv/*
-myenv/*
-/nuevaenv/*
-/myenv/*
+# Environment and secrets
 .env
-docker-compose.yml
-/docker-compose.yml
-Dockerfile
+.env.*
+!.env.example
+
+# Virtual environments
+.venv/
+venv/
+env/
+myenv/
+nuevaenv/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Local data / persistence
+data/
+*.db
+*.db-shm
+*.db-wal
+
+# IDE / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Build artifacts
+build/
+dist/
+*.egg-info/

CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+Todos los cambios relevantes de PyBot se documentan en este archivo.
+
+El versionado sigue [Semantic Versioning](https://semver.org/).
+
+## [2.0.0] — 2026-08-23
+
+### Added
+
+- arquitectura modular basada en Cogs;
+- slash commands como interfaz principal;
+- configuración tipada por variables de entorno;
+- persistencia SQLite con `aiosqlite`;
+- configuración por servidor para bienvenida, despedida, mod-log y autorol;
+- self roles con allowlist administrativa;
+- recordatorios persistentes;
+- moderación con timeout, untimeout, kick, ban, purge y slowmode;
+- validaciones de permisos y jerarquías;
+- auditoría de acciones de moderación;
+- consulta asíncrona de cotizaciones mediante DolarAPI;
+- encuestas, elección aleatoria, dados, moneda y Google Maps;
+- error handler global para application commands;
+- una única `aiohttp.ClientSession` administrada por lifecycle;
+- Dockerfile;
+- CI para Python 3.11 y 3.12;
+- Ruff, compile checks y pytest;
+- tests de configuración, parsing de duración y persistencia;
+- documentación de arquitectura, comandos, despliegue y seguridad;
+- `CONTRIBUTING.md` y `.env.example`.
+
+### Changed
+
+- `discord.py` actualizado de 2.3.2 a 2.7.1;
+- entrypoint movido a `main.py`;
+- proceso Heroku/Procfile cambiado de `web` a `worker`;
+- el bot deja de depender del parsing de mensajes libres para sus funciones centrales;
+- `Message Content Intent` pasa a ser opcional y deshabilitado por defecto;
+- la consulta de dólar deja de usar `requests` síncrono;
+- roles por reacción reemplazados por self roles explícitos y seguros;
+- README reescrito como guía completa de producto e ingeniería.
+
+### Removed
+
+- implementación monolítica antigua de `bot.py`;
+- `events.py` legacy;
+- `wsgi.py` obsoleto;
+- bytecode `__pycache__` versionado;
+- dependencias antiguas/no utilizadas como `requests`, `youtube-dl` y paquetes transitivos fijados manualmente.
+
+### Security
+
+- token exclusivamente desde entorno;
+- `.env` ignorado;
+- permisos mínimos documentados;
+- controles de jerarquía para moderación y roles;
+- Message Content Intent no requerido en operación estándar.

CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contribuir a PyBot
+
+## Flujo recomendado
+
+1. Crear una rama desde `main`.
+2. Mantener cada cambio enfocado en un dominio.
+3. Agregar o actualizar tests cuando corresponda.
+4. Ejecutar lint y tests localmente.
+5. Abrir PR explicando problema, solución y validación.
+
+## Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-dev.txt
+cp .env.example .env
+```
+
+En Windows PowerShell:
+
+```powershell
+.\.venv\Scripts\Activate.ps1
+Copy-Item .env.example .env
+```
+
+## Calidad
+
+Antes del PR:
+
+```bash
+ruff check .
+python -m compileall -q main.py pybot
+pytest -q
+```
+
+## Arquitectura
+
+- Los comandos deben vivir en el Cog del dominio correspondiente.
+- No crear una `ClientSession` por request/comando.
+- No usar librerías HTTP síncronas dentro de coroutines.
+- El acceso SQLite debe pasar por `Database`.
+- No leer variables de entorno directamente desde Cogs; usar `Settings`.
+- Las acciones destructivas deben validar permisos y jerarquía.
+- Evitar habilitar intents privilegiados si una feature no los necesita.
+
+## Nuevos comandos
+
+Al agregar un comando:
+
+- usar slash commands;
+- escribir `description` clara;
+- usar tipos de Discord cuando corresponda (`Member`, `Role`, `TextChannel`);
+- aplicar rangos con `app_commands.Range`;
+- aplicar checks de permisos;
+- responder `ephemeral=True` cuando la información sea administrativa o sensible;
+- documentarlo en `docs/COMMANDS.md`.
+
+## Persistencia
+
+Los cambios de esquema deben ser compatibles con instalaciones existentes. `CREATE TABLE IF NOT EXISTS` es suficiente para tablas nuevas, pero cambios de columnas deben tratarse como migraciones explícitas en futuras versiones.
+
+## Commits
+
+Se recomienda Conventional Commits:
+
+```text
+feat: add ticket system
+fix: prevent role hierarchy escalation
+docs: explain production deployment
+test: cover reminder parser
+refactor: isolate external API client
+```
+
+## Seguridad
+
+No incluir tokens reales, IDs privados innecesarios, `.env`, databases ni dumps de servidores en commits o fixtures.

Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN python -m pip install --upgrade pip && pip install -r requirements.txt
+
+COPY . .
+RUN mkdir -p /app/data
+
+CMD ["python", "main.py"]

LICENCE → LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

Procfile

@@ -1 +1 @@
-web: python3.9 bot.py
+worker: python main.py