Bangun dengan berani, terbitkan dengan aman.

Tahu apa yang dimiliki Studio

Portal Studio memiliki shell yang menghadap pelanggan: Halaman, penempatan komponen, tanda tangan, perilaku responsif, navigasi, footer, presentasi identitas, perjalanan tiket dan rilis. Pusat Bantuan berisi bahasa, kategori, dan isi artikel. Studio mengkonsumsi konten itu melalui jembatan yang dilindungi; ini tidak pernah menciptakan toko artikel kedua.

kesiapan lengkap sebelum membangun dalam-dalam

1. Buka Portal Studio→Mulai→Kesadaran.
2. Konfirmasikan alamat Canonical Portal dan buka dalam tab terpisah.
3. Atur logo, ikon peramban, ikon sentuh, gambar sosial, dan warna tema.
4. Konfirmasi Bahasa-bahasa Pusat Bantuan; ubah otoritas bahasa di Pusat Bantuan, bukan Studio.
5. Atur navigasi dan footer perusahaan global.
6. Pilih sebuah perjalanan tiket dan konfigurasi setidaknya satu bentuk permintaan.
7. Jaga setidaknya satu tanda aman dalam metode aktif dan meninjau penemuan identitas.
8. Jalankan Kualitas dan buat jabat tangan pratilik yang ditandatangani.
9. Buat rilis pertama yang diatur setelah setiap butir blocking jelas.

Persentase kesiapan dihitung dari data area kerja yang disimpan dan keadaan pratinjau. Memilih rute butir langsung ke panel pemiliknya.

Bangun halaman dan daerah yang dapat digunakan ulang

1. Buka Bangun Halaman → dan pilih suatu halaman sistem yang dilindungi atau buat sebuah laman gubahan.
2. Atur rute, judul, mode akses dan perilaku lokal. Rute sistem yang dilindungi tidak dapat dihapus.
3. Buka Komponen, filter oleh pekerjaan atau kedewasaan, dan menempatkan komponen dalam slot yang kompatibel.
4. Gunakan inspektur untuk isi, penampilan, pengikatan, visibilitas dan aksesibilitas.
5. Gunakan pola yang dapat digunakan ulang untuk struktur yang berulang; jaga organisasi atau perbedaan merek dalam variantika.
6. Simpan draft dan latihan loading, kosong, error, tamu dan sinyal-dalam keadaan di pratilik.

Mendesain satu navigasi dan kaki untuk setiap rute

1. Buka Build→Navigasi & kaki.
2. Buat link desktop yang diurut dan nested atau mega- menu grup; konfirmasi keyboard dan perilaku mobile.
3. Atur footer perusahaan: merek, tautan berkelompok, kontak, sosial, kepercayaan, newsletter, link hukum, lokal dan status.
4. Gunakan audiens dan kondisi lokal hanya di mana diperlukan; URLs, rute dan ID tidak pernah diterjemahkan.
5. Pratilik personas publik, pelanggan, dan organisasi di widget mobile, tablet, dan desktop.

Pratilik perjalanan nyata, bukan satu layar bahagia

1. Pilih dukungan tamu, menandatangani tiket, penagihan perawatan, organisasi atau pengetahuan handoff.
2. Bertukar personas, organisasi, peran dan bahasa Pusat Bantuan.
3. Inspeksi ponsel, besar mobile, tablet, laptop, desktop, lebar dan ultrawide breakpoint.
4. Periksa warisan, overridden dan nilai reset; hindari duplikasi breakpoint yang tidak perlu.
5. Jalankan papan tik, RTL, reduced- gerak, memuat, kosong, tidak tersedia dan hak negara.
6. Gunakan Lab Uji untuk aksesibilitas, muatan, rute, pengikatan dan perender penemuan sebelum ulasan.

Operate a Zendesk-level Bantuan Pusat tanpa isi duplikat

1. Buat kategori, bagian, artikel, terjemahan, lampiran, dan templat dalam Pusat Bantuan.
2. Aktifkan bahasa di sana; siput lokal, pencarian, feed, SEO dan artikel krom mengikuti otoritas yang sama.
3. Di Studio, pencarian pengetahuan tempatan, jaringan sumber daya kategori, feed, akordion topik, artikel, tabel isi, umpan balik, terkait dan komponen sebelumnya / berikutnya.
4. Atur tampilan, populer dan baru-baru ini; gunakan saran kontekstual dalam arus tiket.
5. Pratilik hasil-tidak, artikel panjang, lampiran, umpan balik, watch / subscription dan handoff tiket.
6. Verifikasi rute lokal yang bersih, kanonikal / pantulan, data terstruktur dan cache invalidasi setelah publikasi.

Atur sinyal-dalam aman

1. Buka Identitas & organisasi→Identitas dan paling tidak satu tanda-di jalur yang diaktifkan.
2. Pilih metoda baku, kebijakan pendaftaran, durasi sesi, SSO-Domain penegakan dan penemuan perilaku.
3. Tambahkan penyedia dengan ruas routing visual: tipe, domain, prioritas, presentasi, diaktifkan dan diverifikasi keadaan. Rahasia tetap dalam subsistem identitas.
4. Untuk SCIM, aktifkan provisioning, salin secara tepat area kerja titik akhir dan putar token. Simpan satu-waktu token di IDP.
5. Peta menyatakan dan organisasi keanggotaan, kemudian uji menciptakan, memperbarui, anggota kelompok dan penonaktifan dengan penyewa tes.
6. Tamu yang paling terkenal, pelanggan, delegasi dan negara-negara terblokir sebelum publikasi.

Atur lengkap perjalanan dukungan

1. Pilih bentuk langsung, wizard, pencarian-pertama, hub atau service-desk entry.
2. Buat bentuk permintaan yang dinamai, penuh versi dengan bagian dan label ruas yang dapat diakses.
3. Membangun kondisi visual, routing, SLA dan langkah persetujuan; canggih JSON adalah untuk meninjau pengembang hanya perubahan.
4. Atur daftar, detail, benang, timeline, lampiran, persetujuan, SLA dan balas permukaan.
5. Uji pencarian tamu, menandatangani permintaan, visibilitas organisasi, upload kegagalan, pemberitahuan email dan defleksi pengetahuan.
6. Simpan draft; hanya terbitkan setelah adaptor rute dan jalur pemberitahuan melewati preflight.

Pindahkan melalui rilis diatur

1. Jalankan validasi dan Lab Tes. Perbaiki memblokir temuan; catat peringatan yang diijinkan dengan konteks.
2. Tambahkan catatan rilis dan review permintaan. Mengulangi komentar pada path halaman / titik stabil.
3. Pendatang memeriksa diff, perjalanan pratilik, perubahan izin dan bukti.
4. Mengpublikasi atau menjadwalkan melalui latar belakang pekerja, meninggalkan Studio tidak membatalkan pekerjaan yang dapat dipertahankan.
5. Perhatikan perkembangan, kesehatan dan ID korelasi. Berhenti / coba lagi hanya dari kontrol pekerjaan.
6. Verifikasi rute kritis, identitas, tiket dan pengetahuan. Kembali ke rilis sebelum dapat diubah bila diperlukan.

Migrasi dengan bukti dan jalan kembali

1. Pilih cetak biru penyedia dan buat suatu run kering.
2. Ulasan yang ditemukan, nilai-nilai yang belum dipetakan, jumlah konten dan tangkapan paritas visual.
3. Lengkap pemetaan aman dan rerun diff terstruktur.
4. Terapkan ke draft, comending counts dan pratinjau setiap perjalanan yang dilindungi.
5. Rekam penerimaan yang resmi; jangan menimpa rilis saat ini diterbitkan selama impor.
6. Terbitkan melalui pemerintahan dan tetap laporkan migrasi, rilis ID dan titik rollback bersama-sama.

Panjangkan kontrak, bukan contoh

Ekstensi yang aman mendaftarkan tipe komponen dan skema yang stabil, mendeklarasikan perizinan dan kebutuhan data, merender melalui kompiler kanonikal, dan persediaan deterministik fixtures / tests. Jangan kueri tabel sewenang-wenang, suntikkan penyunting JavaScript ke dalam Portal publik, membuat repositori artikel lain, atau bypass gerbang rilis.

Tentukan suatu paket komponen

Gunakan huruf kecil ID namespace dan versi semantik. Siapkan nama properti kompatibilitas yang ditampilkan karena pemeriksaan paket dan validasi keamanan melakukan pemeriksaan independen.

{
  "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}
}

Bentuk node

{
  "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 tetap stabil di seluruh edits dan migrasi.
• Properti menolak ruas yang tidak dideklarasikan dan tidak aman HTML.
• Setiap tampilan data-terikat mendefinisikan pemuatan, kosong, izin dan keluaran galat retryable-.
• Komponen kontainer menamakan slot mereka; daun tidak dapat menerima anak-anak sewenang-wenang.
• Mark kedewasaan jujur: blok perencanaan, beta memperingatkan, GA membutuhkan bukti penuh.

Gunakan permissi- aman DTOs

1. Pilih ID bertitik-titik yang ada seperti tickets.mine, knowledge.featured atau customer.profile.
2. Bid hanya bidang dideklarasikan dengan DTO verdinged nya. Sumber tidak diketahui gagal dengan data_source.unknown.
3. Pass already-authorted Portal context; jangan pernah terima area kerja / identitas pelanggan dari properti yang tidak terpercaya.
4. Batas daftar dijepit ke1–100 Normalize pagination, lokal dan nilai pencarian.
5. Jika sumber baru tidak dapat dihindari, tambahkan definisi stabil, pemetaan yang aman, hak akses, perilaku kosong dan fixture pratilik bersama-sama.

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

Tetap di dalam batas kepercayaan

{
  "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"}
  }
}

Inspeksi, instal dan upgrade secara atom

1. Taruh component.json di akar ZIP dan menjaga setiap jalur relatif.
2. Jalankan inspeksi pertama. 500 masukan dan 25 MB diekstrak; validasi keamanan menambah batas independen.
3. Verifikasi sha- yang diharapkan 256 dan tanda tangan paket dalam proses rilis.
4. Pasang ke direktori berversi. Jangan pernah mutasikan versi yang terpasang di tempat.
5. Menyediakan migrasi properti untuk melanggar perubahan skema dan mempertahankan bidang kompatibilitas yang tidak diketahui.
6. Buka komponen dalam draft, jalankan setiap konfigurasi / tampilan negara / persona dan terbitkan melalui pemerintahan.
7. Rollback mengaktifkan rilis komponen / dokumen immutable sebelumnya; pertahankan bukti reproduksinya.

Buktikan ekstensi pada hash rilis yang sama

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

Gerbang sumber diperlukan, tidak cukup. Lampirkan basis data / migrasi, visual peramban, penyedia identitas, otorisasi, aksesibilitas, performa, antrian / cron, surat / lampiran, backup / mengembalikan dan penyebaran bukti ke hash rilis yang tak dapat diubah. Bukti yang tak dikenal harus gagal dilewatkan.

• Unit: skema, sanitasi, bentuk DTO, kondisi, migrasi dan kegagalan mengetik.
• Kontrak: loading / empty / error / sukses, kedewasaan, slot, binding dan satu-renderer parity.
• Peramban: papan ketik, fokus, semantik, RTL, zoom / reflow, mengurangi gerak dan setiap breakpoint.
• Keamanan: probe area kerja, aksi palsu, serangan paket, pemintalan pratilik dan kebocoran rahasia.
• Operasi: kemajuan tahan lama, tinggalkan / kembali, stop / coba lagi / lanjutkan, penjadwalan detak jantung dan rollback.

Masalah yang dilakukan oleh ID negara dan korelasi