Aide-mémoire
Utilisez cet aide-mémoire lorsque vous connaissez déjà le produit et voulez retrouver rapidement la bonne action. La page est conçue pour l’écran et pour l’export PDF depuis le navigateur.
Workflow quotidien
| Besoin | Action / fichier | Notes |
|---|---|---|
| Installer | npm install | À lancer après checkout ou changement de dépendances. |
| Démarrer localement | npm run dev | Lance le Worker avec Wrangler pour les tests locaux. |
| Valider | npm run check | Construit et vérifie les artefacts runtime avant déploiement. |
| Déployer | git push | GitHub et Cloudflare publient le Worker automatiquement. |
Dépôts
| Surface | Dépôt | Déploie vers |
|---|---|---|
| Redirecteur | vanityURLs/code | https://VanityURLs.link |
| Documentation | vanityURLs/website | https://www.VanityURLs.link |
| Sorties générées | build/, src/ | Ne pas modifier directement. |
Fichiers clés
| Fichier | Utilisation | Responsable |
|---|---|---|
custom/v8s-links.txt | Liste des redirections éditée à la main. | Instance |
custom/v8s-site-config.json | Marque, contacts, langues, fuseau horaire. | Instance |
custom/v8s-policies.json | Domaines permis, domaines bloqués, politique de mots-clés. | Instance |
defaults/ | Baseline produit copiée ou fusionnée par le build. | Produit |
Format d'un lien
| Champ | Exemple | Notes |
|---|---|---|
| Slug | docs | Segment public. Gardez-le lisible et durable. |
| Cible | https://example.com/docs | URL de destination après contrôles de politique. |
| État | active | Détermine si la redirection doit résoudre. |
| Métadonnées | title, owner, notes | Aide la revue, l'audit, le tableau de bord et le transfert. |
Horaires
| Besoin | Syntaxe | Notes |
|---|---|---|
| Cible temporaire | @schedule | Indentez les blocs sous la ligne du lien. |
| Fuseau horaire | America/Toronto | Utilisez les noms IANA acceptés par le runtime. |
| Liens exacts | /launch | Les horaires s'appliquent aux liens exacts, pas aux namespaces splat. |
| Repli | Cible de la ligne | La cible normale reste utilisée hors des fenêtres horaires. |
Comportement
| Entrée | Comportement | À vérifier |
|---|---|---|
| Slug actif connu | Redirige vers la cible. | Confirmez la cible et la politique. |
| Slug inactif ou expiré | Affiche la page de statut correspondante. | Revoyez l'état, les dates et le registre généré. |
| Destination bloquée | Ne redirige pas. | Vérifiez la politique source et la blocklist générée. |
| Chemin inconnu | Retourne le comportement introuvable. | Vérifiez le slug et les routes générées. |
Personnaliser
| Objectif | Utiliser | Éviter |
|---|---|---|
| Changer les liens | custom/v8s-links.txt | Modifier build/v8s.json. |
| Marquer les pages | custom/v8s-site-config.json | Copier les templates complets sans besoin. |
| Surcharger des assets | custom/public/ | Changer les defaults produit pour une instance. |
| Changer le Worker | scripts/workers/ | Modifier le src/ généré. |
Dépannage
| Symptôme | Vérifier | Correctif probable |
|---|---|---|
| OK localement, pas en ligne | Action GitHub et statut de déploiement Worker. | Poussez, attendez le déploiement, retestez. |
| Lien absent | build/v8s.json généré. | Corrigez la ligne source, puis rebuildez. |
| Mauvaise langue | Langues configurées et surcharges localisées. | Ajoutez la page localisée ou utilisez le fallback. |
| Horaire surprenant | Fuseau horaire opérateur et fenêtre de dates. | Utilisez des noms IANA explicites. |
Comparaisons rapides
| Choix | À utiliser quand | À retenir |
|---|---|---|
defaults/ | Vous changez la baseline produit pour toutes les instances. | À revoir comme comportement produit. |
custom/ | Vous changez une instance déployée. | Meilleur endroit pour les changements opérateur. |
| Slug exact | Le chemin public doit résoudre vers une seule destination connue. | Supporte le comportement horaire. |
| Namespace splat | Un préfixe stable doit transmettre des chemins imbriqués. | À éviter pour les redirections sensibles au temps. |