Mulailah dari arsitektur yang sudah jelas, bukan dari repositori kosong.

Arsitektur secara ringkas

Empat tahap dengan arah dependensi satu arah. Dua tahap tengah adalah basisnya; tahap pertama dan terakhir milik Anda.

1. Stage 1

   Data situs, konten, dan aset

   Identitas, navigasi, bahasa, konten Markdown, dan ilustrasi — masukan milik adopter, tervalidasi sebelum apa pun membacanya.

2. Stage 2

   Lingkungan turunan Foundation

   Konsep domain yang tidak bergantung pada framework serta layanan aplikasi yang mengorkestrasinya, tanpa impor framework sendiri.

3. Stage 3

   Penyajian, perutean, dan titik integrasi

   Rute, komposisi tata letak, metadata, dan pabrik adaptor yang mengikat pemesanan, pertanyaan, peta, dan analitik dari konfigurasi.

4. Stage 4

   Penerapan

   Build yang mengutamakan generasi statis, diterapkan dari repositori Anda sendiri ke akun hosting Anda sendiri.

Arah dependensi ditegaskan oleh pengujian, bukan diasumsikan: inti tidak boleh mengimpor React, Next.js, atau lapisan luar, dan lapisan aplikasi tidak boleh masuk ke adaptor konkret.

ARCHITECTURE.md di repositori

Konfigurasi, atau kode

Batas inilah inti proyek ini. Sebagian besar keputusan spesifik bisnis adalah data; perluasan yang nyata adalah kode, dan Foundation menyatakan dengan jelas mana yang mana.

Kontrak rekayasanya

Apa yang dipegang proyek ini — dan apa yang ia menolak untuk klaim.

• Konfigurasi tervalidasi ketat

  Satu skema, kunci tak dikenal ditolak, kegagalan yang bisa ditindaklanjuti, dan konfigurasi hanya dapat dibaca melalui loader.

• Batas heksagonal

  Inti yang murni, port dan layanan aplikasi, adaptor di balik pabrik, dan rute framework yang tipis.

• Penegakan dependensi

  Pengujian arsitektur menelusuri pohon sumber dan gagal pada impor yang dilarang, sehingga diagramnya tidak dapat menjauh dari kodenya.

• Komposisi yang mengutamakan server

  React Server Components dan generasi statis sebagai standar, dengan interaktivitas klien hanya pada komponen yang membutuhkannya.

• Verifikasi di browser nyata

  Matriks browser tanpa antarmuka yang disertakan menguji lebar desktop, tablet, dan seluler, interaksi papan tombol dan penunjuk, gerak yang dikurangi, serta skema gelap — dan menggagalkan proses jika ada assertion yang gagal.

• Gerbang arsitektur dan unit

  Pengujian batas dan unit berjalan bersama pemeriksaan aset, pemeriksaan tipe, lint, dan build produksi.

• Disiplin klaim kemampuan

  Klaim kemampuan yang didokumentasikan diperiksa terhadap catatan proyek sendiri tentang apa yang sudah diterapkan dan diverifikasi, sehingga klaim tidak bisa melampaui buktinya.

• Model peningkatan yang jujur

  Karena konfigurasi, konten, dan aset Anda berada di luar inti aplikasi, peningkatan platform dapat diserap alih-alih menimpa pekerjaan Anda.

Di mana Foundation berhenti

Pembagian kepemilikan yang sama, dinyatakan secara teknis. Foundation sengaja berhenti sebelum kompleksitas operasional bisnis dan menyediakan titik integrasi ke layanan mana pun yang Anda pilih.

Perluasan bekerja dari luar ke dalam: penyedia baru adalah adaptor plus cabang pabrik dan entri enumerasi skema, sedangkan tipe konten atau bahasa baru adalah data. Kemampuan yang benar-benar baru adalah pekerjaan platform.

Alur adopsi

Delapan tahap. Repositori memegang detail tingkat perintah — ini bentuk pekerjaannya.

1. 1

   Dapatkan Foundation

   Klon atau fork repositori publik.

2. 2

   Pasang dan jalankan

   Pasang dependensi dan jalankan situsnya secara lokal.

3. 3

   Konfigurasi

   Tetapkan identitas, bahasa, fitur, dan pilihan penyedia.

4. 4

   Tulis konten dan aset

   Tulis halaman Anda dan gantikan peran aset merek.

5. 5

   Hubungkan penyedia

   Arahkan titik integrasi ke layanan yang benar-benar Anda pakai.

6. 6

   Validasi

   Jalankan gerbang proyek sendiri secara lokal.

7. 7

   Terapkan

   Build dan terapkan dari repositori dan akun Anda sendiri.

8. 8

   Pelihara dan tingkatkan

   Serap perbaikan dari hulu tanpa menimpa materi Anda.

Panduan di repositori mencakup setiap tahap, termasuk penanganan masalah.

Dokumentasi yang otoritatif

GitHub adalah sumber teknis kanonis. Situs web ini merangkum; repositori yang menginstruksikan.

• Repository

  Kode lengkap, lisensinya, dan pernyataan proyek sendiri tentang apa yang ia dan bukan ia.

• README.md

  Apa proyek ini, mulai cepat, susunan repositori, dan posisi lisensinya.

• ARCHITECTURE.md

  Gaya arsitektur, batas, arah dependensi, dan pola integrasi.

• CUSTOMIZING.md

  Panduan pengguna hilir dan referensi konfigurasi lengkap.

• DEPLOYMENT.md

  Runbook peluncuran dan daftar periksa setelah penerapan.

• BRAND_ASSETS.md

  Kontrak penukaran aset merek: setiap peran grafis yang dapat digantikan.

• Panduan

  Prosedur adopsi, penyesuaian, merek, konten, peningkatan, validasi, penerapan, dan penanganan masalah.

Setiap tujuan di atas adalah tautan ke repositori publik, tempat dokumen-dokumen itu dipelihara.