3 Commits

Author	SHA1	Message	Date
Zareian	e5d2427560	keep one env example instead of two ... دو فایلِ نمونه یعنی دو جا که باید هم‌زمان به‌روز بمانند، و همان چیزی بود که قبلاً باعث شد نمونه عقب بماند و کسی که سرور را بالا می‌آورد نداند چه بنویسد. حالا یک فایل، هم برای ماشینِ محلی هم برای سرور. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-13 21:15:42 +03:30
Zareian	eaa4b761dd	stop a deploy from silently blocking the frontend or leaving 0000 open ... سه حالتِ خراب که هیچ‌کدام در لاگِ سرور ردی نمی‌گذارند و فقط وقتی کشف می‌شدند که یک آدم از بیرون اپ را دستی امتحان کند. CORS_ALLOWED_ORIGINS فقط از env خوانده می‌شد و با DEBUG روشن به localhost محدود می‌ماند. یعنی بک‌اندِ کاملاً سالم، ولی مرورگر همه‌ی درخواست‌های math.tadrisino2.ir را بلاک می‌کند — خطایی که سمتِ سرور دیده نمی‌شود و فقط در کنسولِ مرورگر پیداست. origin های شناخته‌شده حالا پیش‌فرضِ داخلِ کدند تا یک متغیرِ فراموش‌شده اتصال را نشکند؛ env همچنان بازنویسی‌شان می‌کند. /api/health حالا warnings هم می‌دهد. مهم‌ترینش: با DEBUG روشن روی سرورِ عمومی، DEV_MASTER_OTP یعنی هر کسی با کدِ 0000 می‌تواند به‌جای هر شماره‌ای وارد شود. این تا امروز فقط با خواندنِ تنظیماتِ سرور معلوم می‌شد، و ما به سرور دسترسی نداریم. allowedOrigins هم برگردانده می‌شود تا مشکلِ CORS از بیرون قابلِ تشخیص باشد. deploy.sh قبل از دست زدن به دیتابیس متغیرهای لازم را بررسی می‌کند و با پیامِ روشن می‌ایستد، به‌جای اینکه وسطِ کار بشکند و 502 بدهد. .env.production.example همان‌ها را یک‌جا مستند می‌کند. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-13 20:46:23 +03:30
Zareian	cbe9b63dc4	make a deploy observable and one command instead of a checklist ... بالا آوردنِ نسخه‌ی جدید تا الان چند کارِ دستی به ترتیبِ درست بود (pull، نصبِ وابستگی‌ها، مهاجرت، استاتیک، ری‌استارت) و فراموش شدنِ هر کدام اپ را می‌خواباند با خطایی که از بیرون فقط «502 Bad Gateway» دیده می‌شد. همین الان هم سرور دقیقاً به همین دلیل خوابیده: کامیتِ ac1b1af پکیجِ django-cors-headers را اضافه کرد، و بدونِ pip install جنگو با ModuleNotFoundError بالا نمی‌آید. deploy.sh همه را به ترتیب و idempotent انجام می‌دهد. pip install همیشه اجرا می‌شود، نه فقط وقتی requirements عوض شده — تشخیصِ «عوض شده یا نه» خودش یک جای فراموش‌شدنیِ دیگر است. آخرِ کار خودش سلامت را بررسی می‌کند و اگر بالا نیامده باشد علت‌های رایج را چاپ می‌کند، به‌جای اینکه کسی بعداً از بیرون کشفش کند. GET /api/health وضعیت را بدونِ احراز و بدونِ SSH بیرون می‌دهد: دیتابیس، مهاجرت‌های اعمال‌نشده، کش، و شمارشِ پایه/درس/سوال روی همان سرور. مهم‌ترینش مهاجرتِ اعمال‌نشده است — حالتی که اپ ظاهراً بالا می‌آید و بعد زیرِ بارِ واقعی با خطای ستونِ ناموجود می‌شکند. عمداً هیچ سکرتی برنمی‌گرداند، فقط بله/خیرِ «تنظیم شده». ۵۰۳ برمی‌گرداند وقتی دیتابیس/کش/مهاجرت خراب است تا پایشِ خودکار بتواند رویش حساب کند؛ نبودِ محتوا خرابی حساب نمی‌شود ولی گزارش می‌شود. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-13 20:28:59 +03:30