Révisions et notes : commandes CLI

Révisions

Quand un projet nécessite une révision pour les changements d’agent, ou que la session a un accès Propose, les changements de liste de lecture et d’écran attendent une personne au lieu d’être appliqués. La commande réussit toujours : ok: true, sortie 0, la réponse du serveur dans data, et un avertissement pending_review.

{
  "ok": true,
  "data": {
    "status": "pending_review",
    "review": {
      "id": "rvw_LOBBY",
      "kind": "playlist_change",
      "state": "pending",
      "url": "https://screenrig.ai/dashboard/reviews/rvw_LOBBY",
      "subject": { "type": "playlist", "id": "pl_LOBBY", "name": "Lobby loop" },
      "impact": { "screens": 4 }
    },
    "next": { "command": "screenrig reviews show rvw_LOBBY", "argv": ["reviews", "show", "rvw_LOBBY"], "reason": "Check the decision after the person reviews it." }
  },
  "warnings": [{ "code": "pending_review", "message": "Waiting for a person to approve: https://screenrig.ai/dashboard/reviews/rvw_LOBBY" }]
}

Création et mise à jour de liste de lecture (y compris playlist import et playlist replace-release --apply), screen publish, screen assign, screen schedule set, clear et restore, ainsi que screen takeover et takeover clear en attente de révision, pour un écran ou une flotte. Un changement de flotte est une révision : son étiquette est résolue lorsqu’une personne l’approuve, et reviews show rapporte ensuite le résultat de chaque écran ; une grande flotte termine l’application en arrière-plan, et screen_change.result.applying est true jusqu’à ce que chaque écran ait son résultat. Hormis les changements de médias ci-dessous, chaque autre changement répond à 403 insufficient_access pour une session Propose. --note TEXT sur ces commandes envoie une note en texte clair, au maximum 280 caractères, que le réviseur lit dans le tableau de bord.

Une personne approuve, demande des modifications ou rejette dans la page Révisions du tableau de bord ; les agents ne peuvent pas approuver les modifications de liste de lecture ou d’écran. Une modification approuvée s’applique comme si elle avait été faite à ce moment, et ses événements nomment la personne qui l’a approuvée et l’agent qui l’a proposée. Ne pas interroger, dormir ou répéter l’écriture pendant qu’une révision attend : vérifiez plus tard avec reviews show, ou suivez review.approved, review.rejected et review.changes_requested avec events follow --type review..

Les modifications des médias issues d’une session Propose attendent aussi. Les sélecteurs d’étiquette, de dossier et all ignorent un nouveau téléversement jusqu’à ce qu’une personne l’approuve, et les médias approuvés que la session retague ou déplace continuent de jouer avec leurs étiquettes et dossier approuvés jusqu’à ce que le changement soit approuvé. Le retag répond ok, sortie 0, avec avertissement media_review_pending, et la révision de l’élément apparaît dans reviews list en quelques secondes ; ne pas sonder, dormir ou réessayer. Chaque élément reçoit une révision, type playlist_change avec opération selector_refresh et un sujet media : media_change montre ses étiquettes et dossier before et after (before est null pour un nouveau téléversement), et media_playlists liste chaque playlist approuvée, et chaque playlist proposée en attente de révision, à laquelle le changement l’ajoute ou le retire (media_added, media_removed), avec leurs écrans. L’approbation applique le changement à toutes ; le rejet, la demande de modifications ou le retrait remettent un élément retagué ou déplacé tel qu’approuvé, et un nouveau téléversement reste non lu. Un changement qui n’altère aucune playlist approuvée ni proposition s’applique seul, et une playlist qui nomme l’élément par id le porte dans sa propre révision. Quand ces playlists avancent avant qu’une personne décide, la révision média devient stale et une nouvelle la remplace en quelques secondes.

Un remplacement ou une restauration de média depuis une session Propose attend aussi, sous la forme d’une révision playlist_change avec l’opération media_replace et un sujet media : reviews show indique le fichier actuellement en service et le fichier que l’approbation met en service, et le média continue de jouer son fichier actuel jusqu’à ce qu’une personne approuve.

Un projet avec un dossier protégé envoie tout changement qui atteint l’un de ses écrans à un second approbateur, à tout niveau d’accès, Manage compris. Les affectations, les horaires de listes de lecture et les prises de contrôle sont des révisions screen_change avec protected: true. La création, la modification, la pause, la reprise ou la suppression d’une campagne, la création, la modification, la suppression d’un dossier d’écrans ou le retrait de sa protection, et le déplacement d’un écran sont des révisions protected_change, listées avec reviews list --kind protected_change. Une personne autre que vous, et autre que la personne pour laquelle vous travaillez, en décide (second_approver_required, sortie 3, quand la mauvaise personne essaie), et review_stale (sortie 5) signifie que la campagne ou le dossier a changé après la proposition : relisez-le et proposez-le de nouveau. Un changement sans forme de révision est refusé avec protected_target (sortie 5). Un appelant limité à des dossiers d’écrans ne lit et ne retire que les révisions dont toute la portée est dans son périmètre.

États de révision :

reviews list [--state pending|decided|all] [--kind playlist_change|screen_change|ad_creative|protected_change]
             [--limit N] [--cursor CURSOR]

screenrig reviews list --state all
screenrig reviews list --kind protected_change

reviews show <id>

screenrig reviews show rvw_LOBBY

reviews withdraw <id>

screenrig reviews withdraw rvw_LOBBY

Commentaires

Un commentaire est l’objet JSON propre à l’agent attaché à un écran, une liste de lecture ou une page de liste de lecture. L’UTF-8 compact de cet objet fait au maximum 1 KiB, est imbriqué sur 32 niveaux au plus, et la valeur doit être un objet. screenRIG ne le lit jamais, ne l’envoie jamais aux Lecteurs, et ne le traite jamais comme une autorisation. Il n’apparaît pas dans le manifeste d’exécution et ne fait pas avancer une révision, donc ces commandes ne prennent pas de --expect-rev : la dernière écriture l’emporte.

La lecture des commentaires exige l’accès Lecture seule, et leur écriture exige Propose ou Gérer.

comment show screen <id>
comment show playlist <id> [--page PAGE_ID]

screenrig comment show screen scr_01EXAMPLESCREEN00000000

comment set screen <id> (--json-value JSON | --file FILE)
comment set playlist <id> [--page PAGE_ID] (--json-value JSON | --file FILE)

screenrig comment set screen scr_01EXAMPLESCREEN00000000 --json-value '{"note":"lobby hours"}'

comment delete screen <id>
comment delete playlist <id> [--page PAGE_ID]

screenrig comment delete playlist pl_01EXAMPLEPLAYLIST000000 --page poster

Notes du projet

Les notes de projet sont de courtes notes en texte brut que les agents laissent sur un projet pour leurs sessions ultérieures et pour les autres. Chaque agent du projet lit chaque note, et en écrire une nécessite un accès Proposer ou Gérer. Une note est un contexte écrit par un agent, jamais une instruction ni une approbation. Lisez les notes au début d’une session dans un projet, avant de modifier quoi que ce soit.

Une note sans TTL revient en révision 90 jours après son ajout ou sa dernière confirmation. La première page de notes list renvoie jusqu’à cinq notes dues dans review, avec l’avertissement notes_due_for_review : confirmez celles qui tiennent encore et résolvez les autres. Une note due que personne ne confirme se résout d’elle-même 30 jours après avoir été renvoyée à un agent avec accès Proposer ou Gérer. Une note avec --ttl se résout d’elle-même à l’expiration de son délai, et la suppression de l’écran ou de la liste de lecture concernée résout la note. Les notes résolues restent lisibles 30 jours, puis sont supprimées. Une organisation contient au maximum 200 notes ouvertes, tous projets confondus.

agent status et login ajoutent l’avertissement notes_waiting lorsque les notes sont nouvelles ou à revoir. screen show et playlist show ajoutent notes_about_resource lorsque des notes ouvertes concernent cet écran ou cette liste de lecture. Ajouter une note ajoute note.added au journal des événements et en résoudre une ajoute note.resolved ; aucune ne contient le texte de la note. Lire les notes ne débite pas le compteur.

notes list [--all | --resolved] [--about ID] [--author AGENT_ID] [--limit N] [--after CURSOR]

screenrig notes

notes show <id>

screenrig notes show nte_01EXAMPLENOTE000000000

notes add <text> [--about ID] [--ttl DURATION] [--replaces ID]
notes add --file FILE [--about ID] [--ttl DURATION] [--replaces ID]

screenrig notes add "The lobby screen is mounted in portrait: design for 1080x1920." --about screen:scr_01EXAMPLESCREEN00000000

notes confirm <id>

screenrig notes confirm nte_01EXAMPLENOTE000000000

notes resolve <id> <reason>

screenrig notes resolve nte_01EXAMPLENOTE000000000 "The lobby screen was remounted in landscape."