Awesome-omni-skill r2-transfer-service-playbook

Manage changes to the R2 transfer pipeline (Python service, Cloudflare Workers, PHP logger) with mandatory validations, allowlists, and regression checks.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/devops/r2-transfer-service-playbook" ~/.claude/skills/diegosouzapw-awesome-omni-skill-r2-transfer-service-playbook && rm -rf "$T"

manifest: skills/devops/r2-transfer-service-playbook/SKILL.md

source content

R2 Transfer Service Playbook

Portée

Utilise ce skill lorsqu'une tâche touche :

```
services/r2_transfer_service.py
```
```
email_processing/orchestrator.py
```
(section delivery_links / r2_url)
```
deployment/cloudflare-worker/*
```

deployment/public_html/config_api.php

deployment/public_html/test-direct.php

, pages de test R2

Pré-requis

ENV obligatoires :

R2_BASE_URL

R2_FETCH_TOKEN

ALLOWED_R2_DOMAINS

Virtualenv

/mnt/venv_ext4/venv_render_signal_server

pour les scripts/tests.

Accès au déploiement Cloudflare Workers (wrangler).

Workflow

Analyse des dépendances
- Confirmer la présence des ENV ci-dessus.
- Vérifier les allowlists (Dropbox/FromSmash/SwissTransfer) avant toute nouvelle source.
Mises à jour Python
- Toujours valider les domaines via
```
is_allowed_domain
```
  .
- Injecter le header
```
X-R2-FETCH-TOKEN
```
  pour chaque requête Worker.
- Conserver les logs sans PII et retour fallback
```
raw_url
```
  en cas d'échec.
Workers Cloudflare
- Garder le mode fetch avec timeout 120s pour Dropbox
```
/scl/fo/
```
  .
- Mettre à jour
```
httpMetadata.contentDisposition
```
  pour préserver le nom de fichier.
- Exécuter
```
wrangler deploy --dry-run
```
  (documenter la sortie).
PHP Logger / Diagnostics
- Assurer que
```
config_api.php
```
  continue d'écrire les paires
```
source_url
```
  /
```
r2_url
```
  .
- Tester
```
deployment/public_html/test-direct.php
```
  pour valider le flux complet.
Tests & validation
- Lancer le helper
```
./.cline/skills/r2-transfer-service-playbook/test_r2_worker.sh
```
  .
- Compléter si besoin avec des tests ciblés sur les nouvelles sources.
Documentation & Memory Bank
- Mettre à jour
```
docs/processing/file-offload.md
```
  ou section dédiée R2.
- Ajouter une entrée dans la Memory Bank si de nouvelles sources sont supportées.

Ressources

```
test_r2_worker.sh
```
: active le venv, exécute les tests R2 et vérifie la page de test PHP.

Conseils

En cas de nouvelle plateforme de fichiers, créer un helper dédié (normalisation URL, validation).
Limiter les retries côté Worker, gérer les erreurs HTTP explicitement.
Garder les scripts de cleanup alignés (expiration 24h par défaut).