significa.co

Situs Web yang signifikan

Ini adalah repositori dengan kode sumber untuk situs web Signifikan, sarang kami sendiri di web. Kami menemukan itu sebuah karya seni, tetapi tentu saja kami bias.

Jika Anda merasa menarik, menginspirasi atau mempelajari sesuatu darinya, pastikan untuk meninggalkan bintang ️

Arsitektur

Kami mengembangkan situs web ini menggunakan SVELTE + SVELTEKIT , dan pustaka UI khusus @significa/svelte-ui yang diterbitkan di bawah signifikansi/signifikansi-ui-ui

Untuk mencapai semua fitur, kami memanfaatkan beberapa layanan eksternal:

• CMS - StoryBlok: Di sinilah kami mengkonfigurasi situs web, membangun halaman, menyimpan dan melayani aset.
• Bucket Penyimpanan - AWS S3: Digunakan untuk menyimpan lampiran, diunggah melalui formulir kontak.
• Email Dispatcher - AWS SES: Digunakan untuk mengirim email pemberitahuan.
• NoSQL Database - AWS Dynamo DB: Dimaksudkan untuk menyimpan dan mengambil gambar telur "Seggs" yang digambar oleh pengguna kami.
• Form Submission Database - Gagasan: Kami membuat entri baru pada database NOTION ketika seseorang mengirimkan formulir. Dengan cara ini kita dapat menjaga semuanya di ruang terpusat.

Situs web ini di -host di Vercel, dan digunakan melalui alur kerja Github Actions. Semua validasi integrasi kontinu (CI) juga dibuat melalui tindakan Gihub.

Kami memiliki tiga lingkungan yang berbeda untuk situs web:

• local-development bagi pengembang untuk mengembangkan dan menguji kode mereka di mesin mereka;
• staging dibatasi ke cabang main dan penyebaran pratinjau (permintaan tarik);
• production digunakan saat rilis diterbitkan.

Ini berarti bahwa seluruh infrastruktur memiliki versi untuk setiap lingkungan. Termasuk kunci dan integrasi yang berbeda dan integrasi: sumber daya AWS, aplikasi gagasan, database, dll.

Begini cara semuanya terhubung (panah mewakili inisiator permintaan):

Berkontribusi

Pengembangan proyek ini mengikuti peta jalan internal. Oleh karena itu kami biasanya hanya terbuka untuk perbaikan dan perbaikan bug yang tidak memiliki dampak besar dalam fitur atau pengaturan proyek.

Persyaratan

• Instal versi node yang ditentukan dalam file .nvmrc (menggunakan manajer versi node favorit Anda).

• Dapatkan pengembangan lokal .env menggunakan 1Password-secrets: 1password-secrets local pull . Atau buat satu dengan berdasarkan contoh di .env.example .

• Pasang dependensi dengan npm install (atau npm ci untuk Lockfile Frozen).

Perkembangan

• Mulailah server pengembangan: npm run dev
• Format Otomatis Kode: npm run format

Pengujian dan sering

• npm run validate
• npm run test

Penyebaran dan rilis

Lingkungan pementasan dibatasi ke cabang main , setiap tambahan baru untuk cabang ini, menciptakan penyebaran baru untuk pementasan.

Untuk menggunakan versi baru untuk produksi, buat rilis yang sesuai dengan SEMVER di GitHub (diawali dengan v , misalnya: vX.XX ), itu akan digunakan secara otomatis untuk produksi

Untuk membuat perbaikan panas:

• Check-out ke rilis terbaru git checkout vX.XX ;
• Buat Chanch git checkout -b hotfix/XXXX ;
• Buat PR ke main , dapatkan persetujuan, dan gabungkan;
• Buat rilis baru berdasarkan cabang perbaikan hot Anda. Gunakan cabang release/xxx untuk memperbaiki batch bersama -sama.

Lisensi

Materi ini dilisensikan di bawah lisensi AGPL, memungkinkan Anda untuk remix, belajar, dan bereksperimen dengannya secara bebas.

Namun, harap dicatat bahwa ini bukan proyek sumber terbuka tradisional; Ini lebih akurat digambarkan sebagai sumber yang tersedia . Sesuai dengan lisensi AGPL, redistribusi kode sumber di bawah lisensi yang sama, dengan atribusi dengan penulis asli, adalah wajib. Karena perangkat lunak hanya dapat ditawarkan melalui jaringan, kode sumber harus diungkapkan dengan benar.

Kami tidak memberikan dukungan untuk proyek ini, dan replikasi atau rebranding sangat tidak dianjurkan. Namun, kami mendorong Anda untuk mengeksplorasi dan mengambil inspirasi dari cara kami membangun situs web kami.