Calendrier de maintenance

Un client qui prévoit une campagne veut savoir quand votre site sera en maintenance — pas venir vérifier la page chaque semaine. La page de statut annonçait une fenêtre ponctuelle dans les 24 heures ; elle ne disait rien de « tous les dimanches de 3 h à 4 h », alors que c'est précisément ce qu'il veut savoir. Le calendrier déroule les deux — la fenêtre ponctuelle et la règle récurrente — sur un horizon, et les écrit au format iCalendar.

Ce que PostShip fait

Les fenêtres viennent des réglages de maintenance du projet : une fenêtre ponctuelle (début, fin, raison) et une règle hebdomadaire (jours, heure de début, heure de fin, fuseau, raison). Le calendrier les déroule sur 30 jours, dans l'ordre, 12 occurrences au plus — un agenda de douze dimanches suffit à comprendre la règle.

La règle hebdomadaire est déroulée jour par jour dans son fuseau : chaque jour coché donne une fenêtre qui commence ce jour-là à l'heure de début ; si l'heure de fin est avant l'heure de début, la fenêtre finit le lendemain (23 h → 2 h). Les heures locales passent par le même convertisseur que les formulaires — c'est lui qui connaît l'heure d'été. Une fenêtre commencée la veille au soir et qui court encore ce matin est incluse.

Sur la page de statut

Quand au moins une fenêtre est prévue, la page publique affiche une section Maintenances prévues avec les cinq prochaines occurrences et le lien « Ajouter à mon agenda (.ics) ». Une fenêtre en cours prime sur les composants : le titre de la page devient « Maintenance en cours », avec la raison (ou « Intervention planifiée. »), parce que quelqu'un se tient derrière cette interruption et c'est ce que le lecteur doit lire d'abord. Une fenêtre ponctuelle qui commence dans les 24 heures est annoncée en tête de page.

La section n'existe pas quand rien n'est prévu : afficher « pas de maintenance » serait une promesse que la page ne peut pas tenir.

Le flux .ics

À l'adresse postship.fr/s/votre-adresse/maintenance.ics. Google Agenda, Outlook et Apple Calendrier lisent tous un flux iCalendar : les fenêtres apparaissent dans l'agenda du client, mises à jour à chaque relecture. Chaque occurrence a un identifiant stable (l'adresse de la page et l'heure de début) : un agenda qui relit le flux met à jour l'événement au lieu de le dupliquer. Le calendrier s'appelle « Maintenances — votre titre », chaque événement « Maintenance — votre titre », avec la raison en description quand il y en a une.

Même règle que le fil RSS : rien de plus que ce que la page montre, et la même réponse (« introuvable ») pour une adresse inconnue et une page non publiée. Le flux est mis en cache dix minutes.

Régler

Projet → Paramètres → Règles.

• Fenêtre de maintenance : un début, une fin, une raison. Pendant la fenêtre, les alertes se taisent et le badge affiche « maintenance » plutôt que « passing ».
• Maintenance récurrente : cochez les jours, indiquez l'heure de début et de fin, le fuseau, une raison. « Lundi à vendredi » se coche en cinq clics. Décochez tous les jours pour retirer la règle.

Rien à faire sur la page de statut elle-même : elle lit les mêmes réglages. Pour que vos clients voient le calendrier, la page doit être publiée.

Ce qui déclenche une alerte

Rien depuis le calendrier. C'est l'inverse : pendant une fenêtre annoncée, les alertes du projet sont retenues — voir Maintenance pour ce qui se tait exactement et ce qui est rattrapé après.

Limites et plans

Disponible sur tous les plans, avec la page de statut. Aucune limite propre : 30 jours d'horizon, 12 occurrences, 5 affichées sur la page.

Dépannage

Pourquoi le flux .ics est-il vide ?

Aucune fenêtre ne tombe dans les 30 prochains jours : une fenêtre ponctuelle passée n'est plus listée, et une règle récurrente sans jour coché n'existe pas. Le fichier est valide, il ne contient simplement aucun événement.

Pourquoi mon agenda affiche-t-il la fenêtre avec une heure de décalage ?

La règle est déroulée dans le fuseau choisi dans les réglages, et les heures sont écrites en UTC dans le flux, comme la norme l'exige. Vérifiez le fuseau de la règle — pas celui de votre compte — surtout autour d'un changement d'heure.

Pourquoi la page de statut ne montre-t-elle que cinq fenêtres alors que la règle est hebdomadaire ?

La page affiche les cinq prochaines pour rester courte ; le flux .ics en porte jusqu'à douze. Un client qui veut la suite s'abonne au flux.