Architecture de Showly

L'architecture publique de Showly décrit le cycle de livraison sur lequel les clients peuvent compter. Le fournisseur cloud, la région, la topologie réseau, les noms de ressources et les frontières entre services internes sont des détails d'implémentation qui ne font pas partie de cette documentation.

Cycle de livraison

1. Connecter un espace de travail. Une personne connecte un site et décide quels membres, jetons d'API et clients MCP peuvent y accéder.
2. Préparer une modification. Un agent ou une intégration ne lit que le contexte autorisé par ses portées, propose un plan et envoie les fichiers modifiés.
3. Créer un Aperçu privé. Showly construit la modification dans un environnement isolé, exécute les vérifications demandées et renvoie une URL d'Aperçu protégée. La version En ligne actuelle ne change pas.
4. Réviser et approuver. Une personne examine l'Aperçu, les différences et les résultats. Les espaces dotés de politiques d'approbation doivent les satisfaire avant la publication.
5. Publier En ligne. Showly publie la version révisée et inscrit l'action dans l'historique d'audit. Les versions antérieures restent disponibles pour la restauration selon la conservation et les limites du forfait.

flowchart LR
  accTitle: Architecture de livraison Showly
  accDescr: Les membres de l'équipe, agents et automatisations utilisent des accès à portée limitée. Les modifications passent par l'autorisation de l'espace, un Aperçu privé, l'approbation humaine, la publication En ligne et l'historique des versions.

  subgraph access["Surfaces d'accès"]
    direction TB
    member["Membre de l'équipe"] --> web["Showly Web"]
    agent["Agent"] --> mcp["Outils MCP"]
    automation["Automatisation"] --> api["API REST"]
  end

  subgraph workspace["Frontière de l'espace"]
    direction TB
    auth["Autorisation par portée"]
    change["Plan et fichiers de modification"]
    preview["Aperçu privé et vérifications"]
    gate{"Confirmation ou approbation humaine"}
    auth --> change --> preview --> gate
  end

  subgraph delivery["Livraison gérée"]
    direction TB
    live["Site En ligne"]
    versions["Historique des versions"]
    live --> versions
    versions -->|"Restaurer"| live
  end

  web --> auth
  mcp --> auth
  api --> auth
  gate -->|"Approuvé"| live
  gate -->|"Modifications demandées"| change

Frontières du produit

Frontière de l'espace de travail. Les sites, déploiements, jetons, rôles et enregistrements d'audit appartiennent à un espace. Les requêtes sont autorisées pour cet espace avant tout retour ou changement de données.

Frontière de l'Aperçu. Un Aperçu est séparé du site En ligne et son accès est contrôlé. Créer ou mettre à jour un Aperçu ne le publie pas.

Frontière de publication. Les actions qui modifient la production nécessitent une confirmation explicite ou le processus d'approbation de l'espace. Un agent ne peut pas contourner ce contrôle.

Frontière de version. Chaque publication pointe vers une version révisée précise. Une restauration sélectionne une version antérieure plutôt que de modifier directement le résultat En ligne.

Authentification et audit

• Les personnes utilisent l'application web Showly avec leur session utilisateur.
• Les scripts utilisent des jetons d'accès personnels ; les agents utilisent des jetons MCP à portée limitée.
• Les jetons sont limités à l'espace, aux ressources et aux actions autorisés.
• Les agents et intégrations ne reçoivent pas les identifiants d'hébergement de Showly.
• Les actions de lecture, construction, publication, restauration et suppression sont enregistrées lorsque la surface concernée les prend en charge.

Consultez Portées et jetons MCP et RBAC et approbations pour le contrat public d'autorisation.

Hébergement et localisation des données

Showly est un service géré. Le fournisseur cloud, la région, l'organisation du réseau, la technologie de stockage et la topologie des services peuvent changer sans modifier l'API publique ni le processus de livraison.

N'utilisez pas le code du dépôt, les métadonnées de réponse, les enregistrements DNS ou d'anciens documents pour déduire un lieu d'hébergement contractuel. Si votre organisation a des exigences de résidence des données, réglementaires ou de cloud propre, confirmez les options disponibles auprès de Showly avant d'intégrer des données de production.

Modes de déploiement

Showly prend en charge les sorties statiques et certaines applications rendues côté serveur. Les modes et capacités actifs peuvent varier selon l'espace et l'environnement ; utilisez les capacités de cible renvoyées par le produit comme référence. Showly gère l'infrastructure sous-jacente, qui n'est pas une surface de configuration client.

Pour continuer

• Manifeste du site — le contrat de construction et d'exécution contrôlé par le client.
• Aperçus et publication — le processus Aperçu et En ligne.
• RBAC et approbations — les règles d'accès, de confirmation et d'approbation.