چرا سایت استودیو را Static-First ساختیم

سایت infolange در زمان Build ساخته می‌شود و فقط یک endpoint واقعی سمت سرور دارد. این یادداشت معماری، دلیل‌ها و هزینه‌های این انتخاب را توضیح می‌دهد.

۲ دقیقه مطالعه

صفحه‌ای که برای نمایش یک متن ثابت به اجرای کد سمت سرور در هر بازدید نیاز ندارد، نباید چنین کدی داشته باشد. این جمله ساده، پایه معماری این سایت است: همه صفحات عمومی در زمان Build تولید می‌شوند و خروجی نهایی به‌صورت فایل ایستا روی Cloudflare Workers منتشر می‌شود.

چه چیزی در زمان Build ساخته می‌شود

خانه، خدمات، پروژه‌ها، محصولات، متن‌باز، یادداشت‌ها و صفحات جزئیات همه از داده‌های ساختاریافته داخل مخزن ساخته می‌شوند. یعنی هنگام Build:

  • هر پروژه اعتبارسنجی می‌شود و Slug تکراری یا لینک نامعتبر باعث توقف ساخت می‌شود.
  • فهرست پروژه‌های متن‌باز فقط از مواردی ساخته می‌شود که مجوزشان تأیید شده است.
  • نقشه سایت، Canonical و متادیتای هر صفحه یک‌بار تولید و ثابت می‌شود.

نتیجه این است که در هر بازدید، هیچ کوئری پایگاه داده، هیچ فراخوانی API و هیچ رندر سمت سروری برای محتوای عمومی اجرا نمی‌شود.

تنها بخش پویا

فرم تماس به یک endpoint واقعی نیاز دارد؛ چون باید ورودی را در سمت سرور اعتبارسنجی کند، از سوءاستفاده جلوگیری کند و ارسال را انجام دهد. این endpoint روی همان Worker اجرا می‌شود و فقط همان مسیر پویا است.

این تفکیک مهم است: «استاتیک» به معنای نبود قابلیت پویا نیست؛ به معنای محدود کردن پویایی به جایی است که واقعاً لازم است.

هزینه‌های این انتخاب

Static-First رایگان نیست. هزینه‌های واقعی:

  1. تازگی محتوا: هر تغییر محتوا نیاز به Build و انتشار دارد. برای سایت استودیو که محتوای آن هفته‌ای چند بار تغییر نمی‌کند، این هزینه کوچک است.
  2. داده لحظه‌ای: اگر بعداً شمارنده ستاره‌های GitHub یا وضعیت زنده لازم شود، باید یا در زمان Build دریافت شود یا با یک endpoint کوچک و کش‌شده انجام شود.
  3. فرم و تعامل: هر قابلیت پویا باید جداگانه طراحی و آزمون شود؛ نمی‌توان انتظار داشت که «به‌خاطر داشتن سرور» هر چیزی را بعداً اضافه کرد.

چرا Cloudflare Workers و نه سرور اختصاصی

انتشار فایل‌های ایستا روی Workers Static Assets به معنای نبود سرور برای وصله امنیتی، مدیریت فرایند یا ظرفیت‌سازی است. دامنه، HTTPS و کش در همان لایه‌ای انجام می‌شود که فایل‌ها سرو می‌شوند. برای این اندازه از سایت، این ساده‌ترین معماری قابل اتکاست.

قاعده‌ای که از این پروژه می‌ماند

پیش از اضافه کردن هر لایه، باید بتوان به یک سؤال پاسخ داد: «اگر این لایه نباشد، چه چیزی واقعاً کار نمی‌کند؟» اگر پاسخ روشن نبود، آن لایه هنوز لازم نیست.

ادامه

یادداشت‌های دیگر

۲ دقیقه مطالعه

راست‌به‌چپ در سطح سیستم، نه وصله آخر

چند تصمیم عملی برای طراحی و پیاده‌سازی رابط فارسی که بعداً به بازنویسی نیاز پیدا نکند؛ از توکن‌های فاصله تا ترکیب متن فارسی و لاتین.

۱ دقیقه مطالعه

مجوز را از مخزن حدس نزنیم

نگاهی به تفاوت GPL-3.0-only و GPL-3.0-or-later و اینکه چرا وجود فایل LICENSE برای توصیف دقیق مجوز کافی نیست.

شروع گفت‌وگو

پروژه‌ای در ذهن دارید؟

مسئله را بفرستید؛ اگر محدوده روشن باشد، مسیر پیشنهادی و برآورد اولیه را برمی‌گردانیم.