البدء السريع

لا تحتاج إلى تعلّم كل Agent أو وضع أو مصطلح تقني قبل أن تبدأ. سير العمل الأساسي أبسط بكثير: أخبر Atoms بما تريده، وتحقق مما أنشأه، وأجرِ التغييرات، واختبره، وانشره عندما يصبح جاهزًا.

يستخدم هذا الدليل موقعًا بسيطًا لمقهى كمثال، لكن الدورة نفسها تنطبق على صفحة هبوط أو لوحة معلومات أو أداة داخلية أو فكرة تطبيقك الخاصة.

تغطي هذه الخطوات مشروع ويب لسطح المكتب بعد تسجيل الدخول. تستخدم المشاريع المحمولة مسارًا منفصلًا للبناء والتوزيع على الأجهزة المحمولة.

قبل النشر، انتظر حتى يكتمل البناء الحالي، وتأكد من أن لديك صلاحية النشر، وأكّد أن المشروع في حالة خمول، وتحقق من توفر موارد المشروع المطلوبة مثل الرصيد أو التخزين. إذا كان Publish غير متاح، فتحقق من إصدار المشروع، والصلاحيات، وشروط الموارد قبل إعادة المحاولة. كما أن المشاريع التي تستخدم البيانات أو الأسرار أو رسائل البريد الإلكتروني أو الذكاء الاصطناعي أو المدفوعات أو الخدمات المتصلة الأخرى تحتاج أيضًا إلى فحوصات الإنتاج الخاصة بها قبل المشاركة.

صف ما تريده

ابدأ في مربع Prompt وصف النتيجة التي تريدها بلغة عادية. لا تحتاج إلى كتابة مواصفات تقنية أو إخبار Atoms بكيفية برمجته.

عادةً ما يوضح أول Prompt مفيد ما الذي تبنيه، والأقسام أو الميزات الرئيسية، والتوجه البصري، وأي شيء مهم على الأجهزة المحمولة.

إذا كنت قد وجدت بالفعل شيئًا في عالم التطبيقات قريبًا مما تريده، فيمكنك أيضًا البدء بعمل ريمكس لذلك المشروع بدلًا من البدء من الصفر.

تحقق من النتيجة الأولى

ينشئ Atoms المشروع ويبني إصدارًا أوليًا. عندما يصبح جاهزًا، افتح عارض التطبيقات وتفقد النتيجة قبل طلب المزيد من التغييرات.

قم بمراجعة سريعة أولًا. أنت لا تحاول العثور على كل مشكلة صغيرة بعد. تحقق مما إذا كان Atoms قد فهم الفكرة الرئيسية.

• هل الأقسام والميزات الرئيسية موجودة؟
• هل يتطابق التخطيط العام مع ما طلبته؟
• هل تستجيب الأزرار والروابط والفلاتر أو التفاعلات المهمة الأخرى؟
• هل هناك أي شيء مفقود أو معطل أو مختلف بوضوح عما قصدته؟

يمكنك معاينة التطبيق في وضعي الكمبيوتر والجوال، لذا تحقق من التجربة على أكثر من حجم شاشة قبل المتابعة.

أجرِ التغييرات

تعامل مع الإصدار الأول كنقطة بداية. أخبر Agent بما تريد تغييره بلغة واضحة، ثم تحقق من النتيجة مرة أخرى.

عادةً ما تكون الطلبات الصغيرة والمحددة أسهل في المراجعة من تغيير كل شيء دفعة واحدة.

بالنسبة إلى التغييرات المرئية، يمكنك تعديل العناصر مباشرةً في عارض التطبيقات أو وصف التغيير إلى Agent. إذا كان لديك لقطة شاشة أو تصميم أو ملف أو مرجع آخر تريد من Atoms اتباعه، فارفعه ووجّه Agent إليه.

عندما يتعطل شيء ما: إذا كان هناك شيء معطل فعلًا بدلًا من كونه مختلفًا فقط عن تفضيلك، فاستخدم Fix Bug أو أخبر Agent بدقة ما الخطأ وأين يحدث.

إذا استمر الفشل: توقف عن تكرار الطلب نفسه بعد إعادة محاولة مركزة واحدة. سجّل الخطوة المتأثرة، وما الذي توقعته، وما الذي حدث، وما الذي جربته بالفعل، ورابط مشروع قابل للمشاركة أو لقطة شاشة. إذا كنت مستخدمًا مدفوعًا ولديك مشكلة في الحساب أو الفوترة أو منصة Atoms، فافتح مركز مساعدة Atoms، واختر دعم Atoms ضمن استكشاف الموارد، ثم حدد اتصل بنا. أما مستخدمو الباقة المجانية أو من يبحثون عن إرشادات المنتج العامة واستكشاف الأخطاء وإصلاحها، فليبدؤوا بمركز المساعدة أو Ask Assistant أو مجتمع Atoms.

اختبر قبل أن تنشر

قبل أن ترسل التطبيق إلى أي شخص، اقضِ بضع دقائق في استخدامه كما لو كنت زائرًا حقيقيًا. إجراء اختبار سريع الآن أسهل بكثير من شرح رابط معطل بعد مشاركته.

• انقر على كل زر ورابط مهم.
• جرّب الأجزاء التفاعلية، مثل الفلاتر أو النماذج أو القوائم أو التنقل.
• تحقق من عرضي الكمبيوتر والجوال.
• ابحث عن نص مقصوص أو متداخل أو مفقود أو يصعب قراءته.
• تأكد من أن رحلة المستخدم الرئيسية تعمل من البداية إلى النهاية.

إذا كان تطبيقك يعتمد على بيانات مخزنة أو إجراءات خلفية، فاختبرها أيضًا. يمكن لـ Atoms استخدام سحابة Atoms أو الاتصال عبر ربط Supabase لقدرات مثل تخزين البيانات، والأسرار، ورسائل البريد الإلكتروني، واستدعاءات الذكاء الاصطناعي، والمدفوعات.

قبل النشر، أزل الأسرار وكلمات المرور وTokens والمعلومات الشخصية وبيانات الاختبار الخاصة من أي شيء يمكن للزوار رؤيته. أكّد ما إذا كان يجب أن يكون المشروع Public أو Private، واختبر الرابط المباشر باستخدام الحساب المقصود. إذا كان التطبيق يستخدم مدفوعات حقيقية أو رسائل بريد إلكتروني أو بيانات مخزنة أو خدمات متصلة، فتحقق من إجراءات الإنتاج تلك بشكل منفصل قبل المشاركة.

انشر

عندما تبدو المعاينة صحيحة وتعمل التفاعلات الرئيسية، انقر على Publish في الزاوية العلوية اليمنى من المحرر.

ينشئ النشر رابطًا مباشرًا تعتمد إمكانية الوصول إليه على مستوى الظهور الذي تختاره. يمكن فتح Public عبر الرابط وقد يظهر في Discover. أما Private فهو مرئي للمالك فقط وقد يكون مقيّدًا حسب الباقة. حدّد مستوى الظهور المقصود قبل المشاركة، واختبر الرابط باستخدام الحساب المقصود.

النشر هو اللحظة التي يتحول فيها مشروعك إلى شيء يمكن للآخرين فتحه فعليًا. واصل التطوير داخل المشروع، لكن تحقق دائمًا من الإصدار المباشر بشكل منفصل بعد النشر.

تحقق من التطبيق المباشر

افتح الرابط المنشور بنفسك قبل مشاركته. أكّد أن مستوى الظهور المحدد Public أو Private يمنح الجمهور المقصود إمكانية الوصول؛ استخدم نافذة خاصة أو الحساب المقصود لاختباره.

• افتح الرابط في علامة تبويب جديدة أو نافذة خاصة باستخدام الحساب أو سياق الوصول المطابق للجمهور المقصود.
• أكّد أن الصفحة تُحمّل وتعرض الإصدار الذي توقعته.
• كرر أهم النقرات أو التفاعلات.
• تحقق من الصفحة على هاتف إذا كان زوار الجوال مهمين لتطبيقك.

إذا وجدت مشكلة، فارجع إلى المشروع، وأجرِ التغيير، واختبر المعاينة مرة أخرى، ثم حدّث الإصدار المباشر.

حدّث بعد إجراء التغييرات

لا يتوقف تطبيقك عن التغيير لمجرد أنك نشرته مرة واحدة. واصل تحسينه داخل المشروع كلما احتجت إلى ذلك.

بعد النشر الأول، يتحول زر Publish إلى Update. انقر على Update عندما تريد دفع التغييرات الجديدة إلى الإصدار المباشر.

بعد التحديث، افتح الرابط المنشور مرة أخرى وتحقق منه. يمنحك ذلك دورة بسيطة قابلة للتكرار:

صف → تحقق → غيّر → اختبر → انشر → تحقق → حدّث

هذا هو سير العمل الأساسي في Atoms. قد تضيف التطبيقات الأكثر تعقيدًا بيانات أو مصادقة أو تكاملات أو نطاقات مخصصة أو عدة Agents، لكن دورة البناء تبقى كما هي.