پروژه خود را منتشر کنید

اگر دکمه Publish یا Update عبارت "Your Cloud Balance is insufficient to publish" یا "Your Cloud Balance is insufficient to update" را نشان می‌دهد، کیف پول Cloud شما خالی شده است.

برای رفع این مشکل:

1. به Settings > Cloud & AI بروید تا موجودی فعلی خود را بررسی کنید.

2. Top up now را انتخاب کنید و به کیف پول Cloud خود وجه اضافه کنید.

3. به پنل Publish برگردید و دوباره تلاش کنید.

توجه: کیف پول Cloud شما از اعتبارهای اشتراک شما جدا است. کیف پول Cloud هزینه خدمات میزبانی و استقرار را تأمین می‌کند، در حالی که اعتبارهای اشتراک برای گفتگوهای عامل AI استفاده می‌شوند.

1. نمای مصرف فضای ذخیره‌سازی را بررسی کنید و بزرگ‌ترین چت‌ها، پروژه‌ها، و فایل‌ها را شناسایی کنید.
2. هر چیزی را که ممکن است بعداً نیاز داشته باشید دانلود یا پشتیبان‌گیری کنید.
3. فقط موارد غیرضروری را حذف کنید. اگر حذف چت گزینه حذف داده‌های دیسک مرتبط را ارائه می‌دهد، فقط پس از اطمینان از اینکه حذف آن داده‌ها بی‌خطر است آن گزینه را انتخاب کنید.
4. صفحه را تازه‌سازی کنید و تأیید کنید که فضای ذخیره‌سازی در دسترس افزایش یافته است.
5. به Publish برگردید و یک بار دیگر تلاش کنید.

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

منتظر بمانید تا اسکن امنیتی کامل شود، سپس پیش از انتشار هر مورد علامت‌گذاری‌شده را بررسی کنید.

1. انتخاب کنید Resolve All و رفتار تحت تأثیر را بررسی کنید. مشکلات مربوط به افشای اسرار، احراز هویت، مجوزها، داده‌های کاربر، یا دسترسی خارجی ناامن را پیش از استفاده در محیط production برطرف کنید.
2. اگر ممکن است یک secret افشا شده باشد، آن را از پروژه حذف کنید و پیش از انتشار، آن را از طریق ارائه‌دهنده مربوطه تعویض کنید.
3. اسکن را دوباره اجرا کنید و جریان تحت تأثیر را تأیید کنید.
4. استفاده کنید Publish Anyway فقط زمانی از آن استفاده کنید که یک بازبین مسئول، ریسک باقی‌مانده و غیرحیاتی را درک کرده و بپذیرد. دلیل آن را ثبت کنید و از دور زدن یک ریسک حل‌نشده در سایت production خودداری کنید.

اگر نمی‌توانید تأثیر یک یافته را تعیین کنید، آن را منتشر نکنید. با پشتیبانی یا مسئول امنیت خود تماس بگیرید و متن یافته و شواهد پاک‌سازی‌شده را ارائه دهید.

1. URL محیط production پلتفرم و دامنه سفارشی را جداگانه آزمایش کنید. همچنین صفحه ریشه را با صفحه مشخص یا مسیر API که دچار خطا می‌شود مقایسه کنید.
2. کد وضعیت دقیق، URL کامل، زمان و منطقه زمانی، و اینکه خطا دائمی است یا متناوب را ثبت کنید.
3. آخرین وضعیت استقرار را بررسی کنید و ببینید آیا یک تغییر اخیر در dependency، environment variable، پایگاه داده، یا سرویس خارجی با شروع خطا هم‌زمان بوده است یا نه.
4. خطاهای مرتبط Console و Network را ثبت کنید.

اگر خطا ادامه داشت، با پشتیبانی تماس بگیرید و مراحل بازتولید، نسخه تحت تأثیر، و اطلاعات عیب‌یابی پاک‌سازی‌شده را ارسال کنید. پیش از ارسال HAR، خروجی فرمان، یا اسکرین‌شات، کوکی‌ها، هدرهای Authorization، توکن‌ها، پارامترهای query محرمانه، داده‌های شخصی، و اطلاعات پرداخت را حذف کنید.

اگر استقرار شما timeout می‌شود یا سایت زنده موقتاً در دسترس نیست:

1. بررسی کنید که آیا هم زیردامنه Prod پلتفرم و هم Preview در دسترس نیستند، یا فقط یکی از آن‌ها.

2. صفحه خطای فعلی را باز نگه دارید — مکرراً روی Publish کلیک نکنید.

3. بررسی کنید که آیا اخیراً dependencyها، نقاط ورود راه‌اندازی، یا اتصال‌های پایگاه داده را تغییر داده‌اید، چون این تغییرات می‌توانند بر استقرار اثر بگذارند.

اگر مشکل ادامه داشت، با پشتیبانی تماس بگیرید و این موارد را اضافه کنید:

- پیوند پروژه و URL زنده

- زمان خطا و منطقه زمانی شما

- شماره نسخه و اسکرین‌شات صفحه خطا

- اینکه آیا Preview به‌طور عادی کار می‌کند

- اینکه آیا اخیراً dependencyها، ورودی راه‌اندازی، یا اتصال پایگاه داده را تغییر داده‌اید

اگر پنل Publish عبارت "latest" را با دکمه غیرفعال نشان می‌دهد، یا روی "Building" گیر کرده است:

1. مکرراً روی Publish کلیک نکنید — این کار سرعت را بیشتر نمی‌کند و ممکن است وظایف build تکراری ایجاد کند.

2. چند دقیقه صبر کنید و صفحه را تازه‌سازی کنید.

3. اگر پس از تازه‌سازی وضعیت تغییر نکرد، با پشتیبانی تماس بگیرید.

هنگام تماس با پشتیبانی، موارد زیر را اضافه کنید:

- پیوند چت

- اسکرین‌شات کامل از پنل Publish (شامل URL صفحه، شماره نسخه، و وضعیت دکمه)

- زمان وقوع و منطقه زمانی شما

- شماره نسخه‌ای که اکنون نمایش داده می‌شود

- اینکه در کدام مرحله عبارت "Building" شروع به نمایش کرد یا دکمه غیرفعال شد

1. بررسی کنید که آیا تصویر در App Viewer، در سایت منتشرشده، یا در هر دو جا وجود ندارد.
2. انتخاب کنید App Viewer را یک بار دوباره بارگذاری کنید. اگر مشکل فقط در سایت زنده است، تأیید کنید که آخرین نسخه منتشر یا به‌روزرسانی شده است.
3. به Agent بگویید کدام صفحه، کدام تصویر باید نمایش داده شود، و تصویر در اصل از کجا آمده است. از آن بخواهید بررسی کند که پروژه فعلی هنوز از نام و محل درست تصویر استفاده می‌کند.
4. اگر تصویر اصلی حذف یا تغییر نام داده شده است، تصویر موردنظر را دوباره بارگذاری یا انتخاب کنید، سپس صفحه را دوباره آزمایش کنید.
5. اگر تصویر از App Storage یا سرویس متصل دیگری استفاده می‌کند، تأیید کنید که سرویس موردنظر متصل است و فایل هنوز در آنجا وجود دارد.

اگر تصویر هنوز بارگذاری نمی‌شود، با Atoms Support تماس بگیرید و Chat Link, ، URL صفحه تحت تأثیر، نام یا منبع تصویر، و یک اسکرین‌شات را ارسال کنید. پیوندهای دسترسی خصوصی، گذرواژه‌ها، کلیدها، یا توکن‌ها را ارسال نکنید.

اگر بسته self-host صادرشده با موفقیت دانلود می‌شود اما اجرا نمی‌شود:

1. README موجود در بسته export را برای نیازمندی‌های محیط و مراحل راه‌اندازی بررسی کنید.

2. تأیید کنید که محیط runtime شما با نیازمندی‌ها مطابقت دارد (نسخه OS، نسخه Docker، نسخه Node.js).

3. فرمان راه‌اندازی را اجرا کنید و خروجی کامل را برای پیام‌های خطا بررسی کنید.

اگر مشکل ادامه داشت، با پشتیبانی تماس بگیرید و این موارد را اضافه کنید:

- نسخه export و زمان دانلود

- نسخه OS و Docker در حال اجرا

- فرمان کامل اجراشده و خروجی کامل

- اسکریپت یا مسیر API ناموفق

- روش استقرار مورد انتظار

مهم: یک نمونه پیکربندی پاک‌سازی‌شده پیوست کنید، اما گذرواژه‌ها، secretها، یا توکن‌ها را وارد نکنید.

App Viewer و سایت منتشرشده مراحل متفاوتی از پروژه شما را نشان می‌دهند. ذخیره یک تغییر ظاهری، به‌تنهایی سایت زنده را به‌روزرسانی نمی‌کند.

1. در Design, ، Save را انتخاب کنید و منتظر بمانید تا وظیفه فعلی Agent یا build تمام شود.
2. Open انتشار. انتشار از آخرین نسخه پروژه استفاده می‌کند؛ در پنل Publish انتخاب‌گر نسخه وجود ندارد.
3. انتخاب کنید انتشار برای اولین انتشار یا Update برای انتشار بعدی. صبر کنید تا پنل عبارت Up to date.
4. را نشان دهد. سایت زنده را در یک زبانه جدید باز کنید و یک بار آن را دوباره بارگذاری کنید.
5. اگر نشانی پیش‌فرض Atoms تغییر را نشان می‌دهد اما دامنه سفارشی نه، به‌جای انتشار مکرر همان نسخه، اتصال دامنه را بررسی کنید.

اگر سایت زنده هنوز نسخه اشتباه را نشان می‌دهد، با Atoms Support تماس بگیرید و Chat Link, تماس بگیرید و URL زنده، نسخه‌ای که قصد انتشار آن را داشتید، زمان و منطقه زمانی، و اسکرین‌شات‌های App Viewer و سایت زنده را ارسال کنید.

1. ریسک فوری را مهار کنید. اگر انتشار باعث افشای داده حساس یا رفتار ناامن شده است، App Status را باز کنید و از Pause برای یک برنامه واجد شرایط Atoms Cloud یا از Unpublish برای حذف دسترسی عمومی استفاده کنید. اگر ریسک فعالی وجود ندارد، از ایجاد قطعی غیرضروری خودداری کنید.
2. دامنه تحت تأثیر، زمان انتشار، نسخه فعلی، نسخه موردنظر، و اثر تجاری را ثبت کنید.
3. پس از توقف وظیفه فعلی agent، Versions را باز کنید، آخرین نسخه سالم شناخته‌شده را انتخاب کنید، و Restore this version.
4. را انتخاب کنید. نسخه بازیابی‌شده را در Preview بررسی کنید، از جمله جریان‌های حیاتی ورود، پرداخت، و داده، سپس آن را Publish یا Update کنید.

بازیابی یک نسخه پروژه ممکن است تغییرات پایگاه داده production یا اقدامات خارجی را معکوس نکند. برای شبیه‌سازی rollback، داده‌های production را بازنویسی یا حذف نکنید. اگر داده‌ها، اعتبارنامه‌ها، پرداخت‌ها، یا تغییرات مخرب درگیر هستند، فوراً با پشتیبانی تماس بگیرید.

1. وظیفه فعلی agent را متوقف کنید یا منتظر بمانید؛ تا زمانی که کار متعارض فعال است، نمی‌توان یک نسخه را بازیابی کرد.
2. Versions را باز کنید، آخرین نسخه سالم شناخته‌شده را پیدا کنید، و Restore this version.
3. را انتخاب کنید. پروژه بازیابی‌شده را در Preview بررسی کنید و جریان‌های حیاتی‌ای را که تغییر کرده‌اند آزمایش کنید.
4. فقط پس از درست بودن نتیجه Preview، آن را Publish یا Update کنید.

بازیابی نسخه پروژه لزوماً رکوردهای پایگاه داده production، تغییرات schema، environment variableها، پرداخت‌ها، ایمیل‌ها، یا سایر اقدامات خارجی را به عقب برنمی‌گرداند. اگر انتشار داده‌های production را تغییر داده یا نسخه هدف در دسترس نیست، متوقف شوید و با پشتیبانی تماس بگیرید و هر دو شماره نسخه، دامنه تحت تأثیر، و نتیجه موردنیاز برای حفظ داده را ارائه دهید.

Pause و Unpublish دو اقدام متفاوت هستند:

Pause (فقط پروژه‌های Atoms Cloud):

- برنامه برای بازدیدکنندگان در دسترس نخواهد بود.

- منابع سرور همچنان تخصیص‌یافته باقی می‌مانند و صورتحساب ادامه دارد.

- می‌توانید هر زمان از App Status برنامه را از سر بگیرید.

Unpublish (همه پروژه‌ها):

- وب‌سایت کاملاً آفلاین می‌شود. هر کسی که از URL منتشرشده استفاده می‌کند دسترسی را از دست می‌دهد.

- برای پروژه‌های Atoms Cloud، منابع سرور آزاد می‌شوند.

- می‌توانید بعداً دوباره پروژه را منتشر کنید، اما تا آن زمان بازدیدکنندگان به آن دسترسی نخواهند داشت.

برای حذف موقت با راه‌اندازی سریع از Pause استفاده کنید. برای حذف کامل سایت از Unpublish استفاده کنید.

اگر مرورگر شما "too many redirects" را نشان می‌دهد یا صفحه بدون نمایش محتوا مدام دوباره بارگذاری می‌شود:

1. زیردامنه پیش‌فرض Prod پلتفرم را امتحان کنید (نه دامنه سفارشی خودتان) تا مشخص شود آیا حلقه redirect ناشی از پیکربندی دامنه است یا خود برنامه.
2. اگر زیردامنه پیش‌فرض Prod کار می‌کند، تنظیمات DNS دامنه سفارشی و ثبت‌کننده دامنه خود را برای قوانین redirect که ممکن است با پلتفرم تداخل داشته باشند بررسی کنید.
3. کش مرورگر خود را پاک کنید یا در یک پنجره Incognito آزمایش کنید تا redirectهای کش‌شده را رد کنید.

اگر مشکل ادامه داشت، با پشتیبانی تماس بگیرید و این موارد را اضافه کنید:

- URL کامل که حلقه redirect را نشان می‌دهد

- اینکه آیا زیردامنه پیش‌فرض Prod قابل دسترسی است

- نام دامنه و ارائه‌دهنده DNS

- اسکرین‌شات کامل خطا

اگر برنامه شما در Preview کار می‌کند اما در production به دلیل environment variableهای خالی یا مفقودشده از کار می‌افتد:

1. بررسی کنید که environment variable پیش از آخرین انتشار ذخیره شده یا بعد از آن. اگر بعد از آن ذخیره شده، باید دوباره منتشر کنید تا تغییر اعمال شود.
2. تأیید کنید که متغیر برای محیط درست تنظیم شده است (Development در برابر Production).
3. بررسی کنید که آیا پیام خطای سرویس پایین‌دستی سرنخی می‌دهد — برای مثال، "unauthorized" اغلب یعنی یک کلید API در آن محیط خالی یا نادرست است.

اگر مشکل ادامه داشت، با پشتیبانی تماس بگیرید و این موارد را اضافه کنید:

- پیوند پروژه یا URL زنده

- نام کلید تحت تأثیر و اینکه مشکل در کدام محیط است

- خطای کامل از سرویس پایین‌دستی

- یک اسکرین‌شات پاک‌سازی‌شده از صفحه پیکربندی

- اینکه پیکربندی پیش از انتشار ذخیره شده یا بعد از آن

مهم: فقط نام کلیدها را ارائه دهید. مقادیر محرمانه، گذرواژه‌ها، یا توکن‌ها را ارسال نکنید.

یافته‌ها ممکن است از عبارت‌های مشابه استفاده کنند در حالی که به مکان‌های متفاوتی اشاره دارند. عبارت مشابه لزوماً به معنی تکراری بودن نتایج نیست.

1. نام یافته و مکانی را که برای هر نتیجه نشان داده شده مقایسه کنید.
2. به‌جای نادیده گرفتن عبارت تکراری، هر مکان منحصربه‌فرد را بررسی کنید.
3. اگر چند یافته یک علت ریشه‌ای مشترک دارند، آن علت را برطرف کنید و سپس هر مکان را دوباره بررسی کنید.
4. اسکن امنیتی را دوباره روی نسخه به‌روزشده اجرا کنید.

اگر همان یافته و همان مکان هنوز بیش از یک بار ظاهر می‌شود، با Atoms Support تماس بگیرید و Chat Link, تماس بگیرید و زمان اسکن و منطقه زمانی، تعداد یافته‌ها، و یک اسکرین‌شات ویرایش‌شده را ارسال کنید. هر گذرواژه، کلید، توکن، یا اطلاعات حساس دیگری را که ممکن است در یک یافته ظاهر شود حذف کنید.

یک اسکن کامل‌شده بدون یافته گزارش‌شده، بررسی مفیدی است، اما نمی‌تواند تضمین کند که هر مشکل امنیتی یا runtime پیدا شده است. اسکن نسخه انتخاب‌شده پروژه را بررسی می‌کند؛ برنامه شما همچنان باید به همان روشی که کاربران واقعی از آن استفاده می‌کنند آزمایش شود.

پیش از انتشار، مسیرهای مهم در برنامه خود را آزمایش کنید، از جمله ورود، نقش‌های کاربری، دسترسی به داده‌های خصوصی، پرداخت‌ها، و سرویس‌های متصل. برای نقش‌های مختلف از حساب‌های آزمایشی جداگانه استفاده کنید و تأیید کنید که هر حساب فقط به اطلاعات و اقداماتی که برای آن در نظر گرفته شده دسترسی دارد.

اگر یک مشکل production پیدا کردید که می‌تواند حساب‌ها، داده‌های خصوصی، پرداخت‌ها، یا اعتبارنامه‌ها را افشا کند، ابتدا استفاده از قابلیت تحت تأثیر را متوقف کنید یا دسترسی به آن را محدود کنید. هر اعتبارنامه‌ای را که ممکن است افشا شده باشد تعویض کنید، سپس با Atoms Support تماس بگیرید و Chat Link, تماس بگیرید و نسخه تحت تأثیر، مراحل بازتولید مشکل، زمان و منطقه زمانی، و یک اسکرین‌شات ویرایش‌شده را ارسال کنید. خودِ اعتبارنامه افشاشده را به اشتراک نگذارید.

اگر اسکن گزارش می‌دهد که یک اقدام فقط-مدیر ممکن است بدون محافظت باشد، تا زمانی که تأیید نکرده‌اید کاربران غیرمجاز نمی‌توانند از آن استفاده کنند، یافته را حل‌نشده در نظر بگیرید. پنهان کردن یک دکمه مدیر کافی نیست اگر هنوز بتوان آن اقدام را از راه دیگری درخواست کرد.

1. یافته را باز کنید و اقدام یا مکانی را که نام می‌برد شناسایی کنید.
2. تصمیم بگیرید کدام نقش‌های واردشده باید مجاز به استفاده از آن اقدام باشند.
3. از Agent بخواهید هنگام درخواست اقدام، مجوز کاربر را بررسی کند، نه فقط هنگام نمایش دکمه.
4. اقدام را در حالت خروج از حساب، با یک حساب آزمایشی عادی، و با یک حساب آزمایشی مدیر مجاز آزمایش کنید.
5. تأیید کنید که تلاش‌های ردشده هیچ داده خصوصی‌ای را آشکار نمی‌کنند و هیچ تغییری ایجاد نمی‌کنند، سپس اسکن امنیتی را دوباره اجرا کنید.

اگر یک حساب غیرمجاز هنوز می‌تواند از آن اقدام استفاده کند، قابلیت تحت تأثیر را منتشر نکنید. با Atoms Support تماس بگیرید و Chat Link, تماس بگیرید و متن یافته، نسخه تحت تأثیر، و در صورت ناتوانی در رفع آن، یک اسکرین‌شات ویرایش‌شده را ارسال کنید.

HTTPS از اطلاعات هنگام انتقال بین کاربر و سرویس محافظت می‌کند. اگر اسکن یک مشکل HTTPS گزارش می‌دهد، از متن دقیق یافته برای شناسایی نشانی، منبع، callback، یا پیکربندی دامنه تحت تأثیر استفاده کنید.

1. یافته را باز کنید و مکان و نشانی دقیقی را که گزارش می‌کند یادداشت کنید.
2. از Agent بخواهید آن اتصال مشخص را با نشانی امنی که ارائه‌دهنده آن پشتیبانی می‌کند جایگزین کند، یا پیکربندی دامنه مرتبط را اصلاح کند.
3. اگر سرویس خارجی معادل امنی را مستند نکرده است، هشدارهای گواهی را نادیده نگیرید و نشانی را کورکورانه تغییر ندهید.
4. مسیر کاربری تحت تأثیر را دوباره آزمایش کنید و تأیید کنید که هیچ گذرواژه، توکن، جزئیات پرداخت، یا اطلاعات خصوصی از طریق اتصال ناامن ارسال نمی‌شود.
5. اسکن امنیتی را دوباره روی نسخه به‌روزشده اجرا کنید.

اگر یافته مربوط به یک دامنه سفارشی یا گواهی‌ای است که نمی‌توانید آن را اصلاح کنید، با Atoms Support تماس بگیرید و Chat Link, تماس بگیرید و URL تحت تأثیر، متن یافته، زمان و منطقه زمانی، و یک اسکرین‌شات ویرایش‌شده را ارسال کنید.

Row Level Security, یا RLS, یک قابلیت Supabase است که کنترل می‌کند هر کاربر کدام ردیف‌های پایگاه داده را می‌تواند بخواند یا تغییر دهد. این یافته فقط زمانی مرتبط است که پروژه از Supabase استفاده کند و اسکن جدولی را شناسایی کند که قوانین دسترسی آن نیاز به بازبینی دارد.

1. یافته را باز کنید و جدولی را که نام می‌برد شناسایی کنید.
2. یادداشت کنید چه کسانی باید بتوانند داده‌های آن جدول را مشاهده، اضافه، ویرایش، یا حذف کنند.
3. از Agent بخواهید کم‌مجوزترین سیاست‌های Supabase را که از آن مسیرهای کاربری پشتیبانی می‌کنند ایجاد کند.
4. در حالت خروج از حساب و با یک حساب آزمایشی جداگانه برای هر نقش آزمایش کنید. تأیید کنید که هر حساب فقط به ردیف‌ها و اقداماتی که برای آن در نظر گرفته شده دسترسی دارد.
5. پس از اعمال سیاست‌ها، اسکن امنیتی را دوباره اجرا کنید.

برای رفع هشدار، RLS را غیرفعال نکنید و به همه کاربران دسترسی ندهید. پیش از ایجاد تغییری که ممکن است بر داده‌های موجود اثر بگذارد، طرح را تأیید کنید و در صورت لزوم یک نسخه پشتیبان یا export امن نگه دارید. هرگز کلیدهای Supabase یا اعتبارنامه‌های پایگاه داده را در Chat یا اسکرین‌شات‌ها به اشتراک نگذارید.