Ga stevig bouwen en publiceer veilig.

Weet wat Studio bezit

Portal Studio bezit de klantgerichte shell: pagina's, componentenplaatsing, merktekens, responsief gedrag, navigatie, footer, identiteitspresentatie, ticketreizen en releases. Het Help Center bezit talen, categorieën, secties en artikelinhoud. Studino verbruikt die inhoud via een beschermde brug; het creëert nooit een tweede artikelenopslag.

Volledige gereedheid voor het diep bouwen

1. Openen Portal Studio → Start → Klaarheid.
2. Bevestig het canonieke poortadres en open dit in een apart tabblad.
3. Stel het logo, browser pictogram, touch picton, sociale afbeelding en themakleur in.
4. Bevestig Help Center talen; verander taal autoriteit in Helpcentrum, niet Studio.
5. Navigatie en de wereldwijde ondernemingsvoetballer instellen.
6. Kies een ticketreis en configureer ten minste één aanvraagformulier.
7. Houd ten minste één veilige inlogmethode actief en beoordeel identiteitsvinding.
8. Voer Kwaliteit uit en stel de ondertekende preview handshake vast.
9. Maak de eerste gecontroleerde release nadat elk blokkerend item duidelijk is.

Het paraatheidspercentage wordt berekend op basis van opgeslagen werkruimtegegevens en previewstatus. Het selecteren van een item routes direct naar het eigen paneel.

Pagina's en herbruikbare secties bouwen

1. Openen Bouwen → Pagina's en selecteer een beschermde systeempagina of maak een aangepaste pagina.
2. Stel de route, titel, toegangsmodus en locale gedrag in. Beschermde systeemroutes kunnen niet worden verwijderd.
3. Openen Componenten, filteren op taak of volwassenheid en plaats een component in een compatibele slot.
4. Gebruik de inspecteur voor inhoud, uiterlijk, binding, zichtbaarheid en toegankelijkheid.
5. Gebruik herbruikbare patronen voor herhaalde structuren; houd organisatie- of merkverschillen in varianten.
6. Sla de ontwerp- en oefenbelasting, leeg, fout, gast-en ingelogde staten in preview.

Ontwerp één navigatie en voettekst voor elke route

1. Openen Bouwen → Navigatie- en voettekst.
2. Maak bestelde desktop links en geneste of mega-menugroepen; bevestig toetsenbord en mobiel gedrag.
3. Configureer de enterprise footer: merk, gegroepeerde links, contact, social, trust, nieuwsbrief, juridische links, locale en status.
4. Gebruik de lokale en publieksvoorwaarden alleen waar nodig; URLs, routes en ID's worden nooit vertaald.
5. Preview publieke, klant en organisatie persona's op mobiele, tablet-en desktop breedtes.

Voorbeeld echte reizen, niet één gelukkig scherm

1. Kies gastenondersteuning, ingetekend ticket, facturatie zorg, organisatie of kennis overdracht.
2. Wissel van personages, organisatie, rol en Help Center taal.
3. Inspecteer mobiele, grote mobiel, tablet, laptop, desktop, brede en ultrabrede breekpunten.
4. Controleer erfelijke, overridde en reset waarden; vermijd onnodig breakpoint duplicatie.
5. Start toetsenbord, RTL, verminderde beweging, laden, leeg, niet beschikbaar en toestemming staat.
6. Gebruik Test Lab voor toegankelijkheid, lading, route, binding en render bevindingen vóór beoordeling.

Een Zendesk-niveau Helpcentrum bedienen zonder dubbele inhoud

1. Creëer categorieën, secties, artikelen, vertalingen, bijlagen en templates in Hulpcentrum.
2. Taal daar inschakelen; gelokaliseerde kogels, zoeken, feeds, SEO en artikel chroom volgen dezelfde autoriteit.
3. Plaats in Studio kennis zoeken, categorie/bron rasters, feeds, topic accordeon, artikel, inhoudstabel, feedback, gerelateerde en vorige / volgende componenten.
4. Configureer aanbevolen, populaire en recente feeds; gebruik contextuele suggesties in ticketstromen.
5. Voorbeeld geen resultaten, lange artikelen, bijlagen, feedback, horloge / abonnement en ticket overdracht.
6. Controleer schone lokale routes, canonieke/hreflang, gestructureerde data en cache ongeldig na publicatie.

Inloggen veilig instellen

1. Openen Identiteit & organisaties → Identiteit en minstens één aanmeldpad ingeschakeld houden.
2. Kies standaardmethode, registratiebeleid, sessieduur, SSO-domein handhaving en ontdekking gedrag.
3. Voeg providers toe met visuele routeringsvelden: type, domeinen, prioriteit, presentatie, ingeschakelde en geverifieerde staat. Geheimen blijven in het identiteitssubsysteem.
4. Voor SCIM, inschakelen provisioning, kopieer het exacte werkblad eindpunt en draai de token. Bewaar de eenmalige token in de IdP.
5. Kaart claims en organisatie lidmaatschap, vervolgens testen maken, bijwerken, groep lidmaatschap en deactivering met een test huurder.
6. Preview gast, klant, gedelegeerde organisatie en geblokkeerde staten voor publicatie.

Stel de volledige ondersteuningsreis samen

1. Selecteer direct formulier, wizard, zoek-eerste, hub of service-desk ingang.
2. Maak een vernoemd, geversieerd aanvraagformulier met secties en toegankelijke veldlabels.
3. Bouw visuele condities, routering, SLA en goedkeuringsstappen; geavanceerde JSON is alleen voor beoordeelde wijzigingen van de ontwikkelaar.
4. Configureren lijst, detail, draad, tijdlijn, bevestiging, goedkeuring, SLA en antwoord oppervlakken.
5. Test gastenopzoeken, ingelogde verzoeken, organisatie zichtbaarheid, upload falen, e-mail notificatie en kennisverlegging.
6. Sla een concept op; publiceer alleen na de routeadapter en het meldingspad voor vlucht.

Door een gecontroleerde release gaan

1. Voer validatie en testlab. Fix blokkerende bevindingen; bevestig toegestane waarschuwingen in context.
2. Voeg release notes en aanvraag beoordeling. Recensies commentaar op stabiele pagina / node paden.
3. De ontwikkelaars inspecteren de diff, preview reizen, toestemming wijzigingen en bewijs.
4. Publiceren of schema via de achtergrond werknemer. Vertrekken Studio annuleer geen duurzame baan.
5. Let op de voortgang, gezondheid en correlatie ID. Stop/rust alleen van functiecontrole.
6. Controleer kritieke routes, identiteit, tickets en kennis. Rol terug naar een onveranderlijke voorafgaande release indien nodig.

Migreren met bewijs en een weg terug

1. Selecteer de blauwdruk van de provider en maak een droge run.
2. Bekijk ontdekte instellingen, ongemappeerde waarden, content counts en visuele pariteit vangt.
3. Volledige veilige mappings en herrun de gestructureerde diff.
4. Pas een ontwerp toe, combineer de tellingen en bekijk elke beschermde reis.
5. Record geautoriseerde acceptatie; nooit de huidige gepubliceerde release tijdens import overschrijven.
6. Publiceer via governance en houd het migratierapport, laat ID- en rollbackpunt samen.

Verleng contracten, geen sjablonen

Een veilige uitbreiding registreert een stabiel componenttype en schema, verklaart machtigingen en gegevensbehoeften, rendert via de canonieke compiler, en levert deterministische armaturen/tests. Niet opvragen willekeurige tabellen, injecteer editor JavaScript in het publieke Portal, maak een ander artikel repository of omzeil de release gate.

Een onderdeelpakket definiëren

Gebruik een kleine naamruimte ID en semantische versie. Geef beide compatibiliteit eigenschappen weergegeven omdat pakket inspectie en beveiligingsvalidatie uitvoeren onafhankelijke controles.

{
  "schema_version": 1,
  "id": "acme.support_health",
  "slug": "acme-support-health",
  "name": "Support health",
  "version": "1.0.0",
  "entry": "renderer.php",
  "renderer": "server",
  "server_renderer": "renderer.php",
  "public_renderer": "public.js",
  "schema": {
    "type": "object",
    "properties": {
      "heading": {"type": "string", "maxLength": 120},
      "showSla": {"type": "boolean", "default": true}
    },
    "additionalProperties": false
  },
  "permissions": ["tickets.read"],
  "data_scopes": ["tickets.mine"],
  "accessibility": {
    "landmark": "section",
    "nameFrom": "heading",
    "emptyState": true,
    "errorState": true
  },
  "performance": {"max_js_bytes": 12000, "max_css_bytes": 8000},
  "performance_budget": {"js": 12000, "css": 8000, "requests": 0}
}

Knoopvorm

{
  "id": "node-support-health",
  "type": "custom.acme_support_health",
  "props": {"heading": "Support health", "showSla": true},
  "bindings": {"requests": {"source": "tickets.mine", "limit": 5}},
  "responsive": {"mobile": {"padding": "16px"}, "desktop": {"padding": "24px"}},
  "conditions": [{"field": "identity.signed_in", "operator": "equals", "value": true}],
  "a11y": {"label": "Support health"}
}

• ID's blijven stabiel bij bewerkingen en migraties.
• Eigenschappen verwerpen zwart veld en onveilig HTML.
• Elke data-gebonden weergave definieert laden, leeg, toestemming en hertryable-error uitvoer.
• Container onderdelen noemen hun slots; bladeren kunnen niet willekeurige kinderen accepteren.
• Mark volwassenheid eerlijk: geplande blokken, beta waarschuwt, GA vereist volledig bewijs.

Toestemmingsveilige DTO's gebruiken

1. Kies een bestaande stippel-ID zoals tickets.mine, knowledge.featured of customer.profile.
2. Alleen velden die door de geversieerde DTO zijn opgegeven, bind. Onbekende bronnen falen met data_source.unknown.
3. Passeer de reeds toegestane Portal-context; accepteer nooit werkruimte/klantidentiteit van een niet vertrouwde eigenschap.
4. Lijstlimieten worden geklemd aan1–100. Normaliseren paginatie, locale en zoekwaarden.
5. Als een nieuwe bron onvermijdelijk is, voeg dan zijn stabiele definitie, veilige mapping, machtigingen, leeg gedrag en preview armatuur samen.

{
  "success": true,
  "source": "tickets.mine",
  "contract_version": 1,
  "items": [
    {"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
  ]
}

Blijf binnen de vertrouwensgrenzen

{
  "success": false,
  "error": {
    "code": "studio.permission_denied",
    "message": "You do not have permission to publish the Portal.",
    "retryable": false,
    "correlation_id": "ps_…",
    "meta": {"capability": "publish"}
  }
}

Inspecteren, installeren en upgraden atomair

1. Zet component.json bij de ZIP-wortel en houd elk pad relatief.
2. Controleer eerst. De installatie kapt archieven op 500 de vermeldingen en 25 MB extractie; beveiligingsvalidatie voegt onafhankelijke limieten toe.
3. Controleer de verwachte SHA-256 en pakketondertekening in het releaseproces.
4. Installeer in een map met versie. Mutateer nooit een geïnstalleerde versie op zijn plaats.
5. Geef eigenschappenmigraties voor het breken van schema wijzigingen en behoud onbekende compatibiliteit velden.
6. Open de component in een concept, voer elke staat/zichthaven/persoonsa armatuur uit en publiceer deze via governance.
7. Rollback activeert de voorafgaande onveranderlijke component/document-vrijgave; behoudt het reproduceerbaarheidsbewijs.

Bewijs de extensie op dezelfde release hash

php tools/portal_studio_certify.php --source-only --json
php tools/test_portal_studio_contract.php
php tools/test_portal_one_renderer.php
php tools/test_portal_studio_engineer.php
php tools/test_portal_component_contracts.php
php tools/test_portal_one_renderer.php
php tools/test_portal_shell_contract.php
php tools/test_portal_knowledge_contract.php
node node_modules/@playwright/test/cli.js test tests/e2e/portal-studio-shell-visual-contract.spec.js tests/e2e/portal-custom-code-runtime.spec.js

Bronpoorten zijn noodzakelijk, niet voldoende. Voeg database/migratie, real-browser visueel, identiteit-provider, autorisatie-isolatie, toegankelijkheid, prestaties, wachtrij/cron, mail/attachment, backup / restore en implementatie bewijs toe aan dezelfde onveranderlijke release hash. Onbekend vereist bewijsmateriaal moet de release mislukken.

• Eenheid: schema, sanering, DTO-vorm, omstandigheden, migraties en getypte storingen.
• Contract: laad/leeg/fout/succes, looptijd, slots, bindingen en pariteit van één partij.
• Browser: toetsenbord, focus, semantiek, RTL, zoom/reflow, verminderde beweging en elk breekpunt.
• Beveiliging: kruis-werkruimte sondes, vervalste acties, pakketaanvallen, preview spoofing en geheime lekkage.
• Operaties: duurzame vooruitgang, vertrek/terugkeer, stoppen/intreden/hervatten, scheduler hartslag en terugrol.

Problemen oplossen door status- en correlatie-ID