تجهيز مشروعك للبيع: ملفات التسليم والتوثيق والديمو
تجهيز المشروع للبيع هو العمل اللي بتعمله قبل ما تنشر الإعلان: تنظّف الكود، وتكتب ملفات التسليم (Handoff وHandover وDocumentation)، وتجهّز ديمو شغّال وصور واضحة، وتجرّب التركيب على بيئة نظيفة. المشروع المجهّز بينباع أسرع وبسعر أفضل، وبيوفّر عليك أسئلة وخلافات كثيرة بعد الصفقة. هالمقال دليل عملي مرتّب بالخطوات، مع قوالب جاهزة تقدر تنسخها وتعبّيها.
كل مشروع على بزانيس إله ديمو حي وصفحة بتوضّح بالضبط شو بتستلم. هالوضوح مش صدفة، هو نتيجة تجهيز كويس من البائع. والمشتري اللي بيفتح الإعلان بيحكم بأول دقيقتين: هل هالبائع منظّم؟ هل الشغل جاهز؟ أي تفصيل ناقص بيتحوّل لسؤال، وكل سؤال بيأخّر الصفقة أو بيخسّرك المشتري.
تجهيز المشروع للبيع: الصورة الكاملة
قبل التفاصيل، خلينا نشوف الخريطة. التجهيز بيمر بسبع مراحل، وكل مرحلة إلها ناتج واضح.
المراحل السبع
| المرحلة | شو بتعمل | الناتج |
|---|---|---|
| 1. التنظيف | تحذف الزائد وتشيل الأسرار من الكود | مشروع نظيف |
| 2. الاختبار | تركّب وتشغّل على بيئة نظيفة | تأكيد إنه بيشتغل |
| 3. التوثيق | تكتب README وDocumentation | ملفات شرح |
| 4. ملفات التسليم | تكتب Handoff وHandover | ملفات نقل |
| 5. الديمو | تجهّز نسخة حية للتجربة | رابط ديمو |
| 6. المواد البصرية | لقطات وفيديو قصير | صور الإعلان |
| 7. الإعلان | تكتب الوصف والخيارات | صفحة المشروع |
كم بياخد كل مرحلة؟
الوقت بيختلف، بس بشكل عام: التنظيف والاختبار هم الأكتر مفاجآت، لأنك بتكتشف مشاكل ما كنت منتبه لها. التوثيق وملفات التسليم بياخدوا وقت بس عملهم مرة وحدة بينفع لكل مشتري. والديمو والمواد البصرية بتحتاج صبر وذوق.
لا تستعجل بالإعلان
أكبر خطأ إنك تنشر الإعلان وبعدين تجهّز. أول مشتري بيجي رح يلاقيك مش جاهز، وبتخسر فرصة الانطباع الأول. جهّز، وبعدين انشر. وللتفاصيل عن كتابة الإعلان نفسه شوف كتابة إعلان المشروع.
المرحلة الأولى: تنظيف المشروع
المشتري بيستلم كل شي، فاللي بيكون مخفي عندك ممكن يطلع قدامه. نظّف قبل ما يشوفه حدا.
أسرار ومفاتيح
- ابحث بالكود عن مفاتيح API وكلمات سر وروابط قواعد بيانات مكتوبة بشكل مباشر.
- انقلها لملف إعدادات (مثلًا ملف بيئة) واستبدل القيم بأمثلة فاضية.
- لو انكتبت مرة بسجل التعديلات القديم، غيّر المفتاح نفسه، لأن حذفه من الكود الحالي ما بيمنع ظهوره بالتاريخ.
- أنشئ ملف مثال للإعدادات فيه أسماء المتغيرات بدون قيم.
ملفات وبيانات زايدة
- احذف الملفات المؤقتة، ونسخ التجارب، والمجلدات المكررة.
- شيل أي بيانات حقيقية: مستخدمين، رسائل، فواتير، صور شخصية.
- نظّف قاعدة البيانات من بيانات الاختبار الحساسة، وجهّز نسخة بيانات تجريبية بدلها.
- احذف التعليقات الشخصية أو الملاحظات اللي ما بتناسب المشتري.
مكتبات وتراخيص
اعمل قائمة بالمكتبات الأساسية وترخيص كل واحدة. تأكد إن ولا وحدة بتمنع البيع التجاري أو بتفرض شروط ما ينفع تنتقل للمشتري. وإذا استعملت صور أو خطوط أو أيقونات من مصادر خارجية، تأكد إن ترخيصها بيسمح باستعمالها بمنتج مباع.
قائمة تنظيف سريعة
- لا مفاتيح أو كلمات سر بالكود.
- لا بيانات مستخدمين حقيقية.
- لا ملفات مؤقتة.
- قائمة مكتبات وتراخيصها.
- الأصول (صور وخطوط) مرخّصة.
- تعليقات الكود مناسبة ومهنية.
المرحلة الثانية: اختبار التركيب على بيئة نظيفة
أكتر جملة بيسمعها البائع من المشتري: «عندي بيشتغل بس عندك لا». لتتفادى هالجملة، جرّب بنفسك قبل التسليم.
كيف تختبر
- جهّز بيئة نظيفة: جهاز افتراضي، أو حاوية، أو حساب مستخدم جديد.
- نزّل المشروع بالطريقة اللي رح تسلّمها للمشتري (أرشيف أو مستودع).
- اتبع ملف README حرفيًا، خطوة بخطوة، بدون أي معرفة مسبقة.
- سجّل أي خطوة تعثّرت فيها أو احتجت تخمّن فيها.
- صلّح الملف أو الكود وأعد المحاولة.
- كرّر لحد ما تمشي كل الخطوات بدون تدخل.
ما بتفحصه
- التثبيت من الصفر.
- تشغيل المشروع.
- إنشاء حساب إداري أول مرة.
- تسجيل الدخول والمسارات الأساسية.
- تغيير الاسم والشعار والألوان.
- ربط خدمة خارجية واحدة على الأقل (دفع، إيميل، إشعارات).
- بناء نسخة الإنتاج.
جرّب على إصدارات مختلفة
لو مشروعك بيعتمد على نسخة معينة من لغة أو إطار، اذكرها بوضوح. المشتري ممكن يكون عنده نسخة ثانية، وهاد بيعطّل المشروع. اكتب النسخ المختبرة بدقة بملف التسليم.
المرحلة الثالثة: توثيق الكود
التوثيق مش رفاهية. هو اللي بيحوّل «كود شغّال عند صاحبه» لـ«منتج ينباع».
على ثلاثة مستويات
1. ملف README: نظرة سريعة. شو المشروع، المتطلبات، التثبيت، التشغيل، الاختبار.
2. توثيق داخلي: تعليقات بالأماكن الحرجة، وملف بيشرح بنية المجلدات والمفاهيم الأساسية.
3. Documentation.html: دليل كامل منسّق، فيه شرح للميزات وكيفية التخصيص والإعدادات وأمثلة.
ماذا توثّق بالتحديد
- بنية المشروع: شو بكل مجلد، وين نقطة البداية.
- الإعدادات: كل متغير، شو بيعمل، شو القيم الممكنة.
- قاعدة البيانات: جداول رئيسية وعلاقاتها، وكيف تتهيأ.
- التكاملات: كل خدمة خارجية، وكيف تتربط.
- التخصيص: كيف يغيّر الهوية واللغة واللون.
- النشر: خطوات رفع المشروع للإنتاج.
- الأخطاء الشائعة: مشاكل متوقعة وحلولها.
لا توثّق كل شي
التوثيق الزايد بيصير قديم بسرعة. وثّق القرارات والمفاهيم، مش كل سطر. المشتري بيقدر يقرأ الكود، بس ما بيقدر يقرأ «ليش» اخترت هالطريقة. وهالـ«ليش» هو اللي بتكتبه.
المرحلة الرابعة: ملف Handoff.md
Handoff هو الملف الأهم بالتسليم. بيجاوب سؤال واحد: «شو بستلم وكيف بشغّله؟». بزانيس بتتعامل مع هالملف كجزء معتاد من التسليم، وهو أول شي بيفتحه المشتري.
محتويات Handoff المقترحة
- نبذة: اسم المشروع وفكرته بجملتين.
- المحتويات: قائمة الملفات والمجلدات الرئيسية المسلّمة.
- التقنيات: لغات، أطر، قاعدة بيانات، إصدارات.
- المتطلبات: استضافة، ذاكرة، خدمات خارجية.
- خطوات التشغيل: من الصفر لحد ما يشتغل.
- الإعدادات: ملف البيئة وشرح كل متغير.
- الحسابات التجريبية: بيانات دخول الديمو (غير حقيقية).
- التخصيص: كيف تغيّر الاسم والشعار واللغة.
- المعروف والمحدود: مشاكل معروفة أو ميزات غير مكتملة.
- التواصل: كيف يسألك المشتري عن شي.
قالب جاهز لـHandoff
Handoff: اسم المشروع
[نبذة]
جملتان عن المشروع ولمن هو.
## شو بتستلم
- مجلد الكود: ...
- قاعدة البيانات: ...
- ملفات التصميم: ...
- التوثيق: ...
## التقنيات
- اللغة والإطار وإصداراتها: ...
- قاعدة البيانات: ...
## المتطلبات
- الاستضافة: ...
- خدمات خارجية: ...
## خطوات التشغيل
1. ...
2. ...
3. ...
## الإعدادات
- اسم المتغير: شو بيعمل
## ما هو مشمول وما هو غير مشمول
- مشمول: ...
- غير مشمول: ...
## معروف ومحدود
- ...
## التواصل
- ...
نصائح لكتابة Handoff جيد
- اكتبه كأنك بتشرح لزميل ذكي ما بيعرف المشروع.
- كل خطوة تشغيل لازم تكون قابلة للتنفيذ حرفيًا.
- لا تفترض إن المشتري بيعرف شي من خارج الملف.
- اذكر ما هو غير مشمول بوضوح، لأن هاد أقوى مانع للخلافات.
المرحلة الخامسة: ملف Handover.md
Handover بيختلف عن Handoff. Handoff عن التشغيل التقني، وHandover عن نقل الحسابات والملكيات: مين بيستلم شو، وإيمتى، وكيف.
ما بيغطيه Handover
| العنصر | شو بينتقل | كيف | مين المسؤول |
|---|---|---|---|
| الدومين | ملكية الدومين | نقل لحساب المشتري عند المسجّل | الطرفين |
| الاستضافة | الحساب أو المشروع | نقل أو إعادة نشر | البائع ثم المشتري |
| قاعدة البيانات | نسخة وبيانات | تصدير واستيراد | البائع |
| خدمات خارجية | حسابات الإيميل والدفع والإشعارات | إنشاء حسابات جديدة أو نقل | المشتري غالبًا |
| الحسابات الاجتماعية | صفحات ومعرّفات | نقل الصلاحيات | الطرفين |
| المتجر (لو تطبيق) | التطبيق المنشور | نقل بين حسابات المطوّرين | الطرفين |
| ملفات التصميم | مصادر الصور والشعارات | تسليم الملفات | البائع |
الترتيب الزمني
اكتب جدول بسيط: اليوم الأول كذا، اليوم الثاني كذا. مين بيعمل، ومتى، وكيف بنتأكد إنه تم. وحدد شو بيصير لو تأخر أحد الطرفين.
كلمات السر والمفاتيح
لا تكتبها بالملف نفسه. اكتب مكانها «بتتسلّم بطريقة آمنة منفصلة». سلّمها بعد تأكيد الدفع، واطلب من المشتري يغيّرها فور الاستلام. وكل مفتاح كان باسمك لازم يتجدّد باسم المشتري.
مثال على سطر Handover
«الدومين: مسجّل عند [اسم المسجّل]. بيتم نقله لحساب المشتري بعد الفحص النهائي، خلال [مدة متفق عليها]. المسؤول عن بدء النقل: البائع.»
وبالنسبة للتطبيقات، نقل التطبيق بين حسابات المطوّرين له خطوات خاصة، وبتلاقيها بمقال بيع تطبيق. ولو الدومين جزء من الصفقة، صفحة الدومينات على بزانيس بتوفّر البحث والتسجيل والتجديد التلقائي للمشاريع.
المرحلة السادسة: Documentation.html
Documentation.html هو الدليل الكامل. بيكون صفحة واحدة أو أكتر تنفتح بالمتصفح، منسّقة، فيها بحث أو فهرس. مش لازم يكون معقّد.
لماذا HTML؟
- بيفتح عند أي مشتري بدون برامج إضافية.
- بتقدر تحط صور ولقطات وأكواد منسّقة.
- بيبان احترافي.
- قابل للتحديث والمشاركة.
بنية مقترحة
- البداية السريعة: من التنزيل لحد التشغيل بخمس دقائق.
- المفاهيم: شرح الأدوار والكيانات الأساسية بالمشروع.
- الإعداد: كل الإعدادات بجدول.
- التخصيص: تغيير الهوية والنصوص واللغات.
- التكاملات: ربط الخدمات الخارجية.
- النشر: رفع المشروع للإنتاج.
- الصيانة: نسخ احتياطي، تحديث، مراقبة.
- الأسئلة الشائعة: أكتر الأسئلة تكرارًا.
- استكشاف الأخطاء: مشاكل وحلول.
كيف تكتبه بسرعة
ما تبدأ من صفحة فاضية. اجمع أسئلتك الخاصة اللي سألتها لنفسك وقت التطوير، وأجوبة الأشخاص اللي جرّبوا المشروع، وحوّلها لأقسام. وكل ما حدا يسألك سؤال جديد بعد البيع، أضف الجواب للدليل.
المرحلة السابعة: ديمو المشروع
الديمو هو أقوى أداة بيع عندك. المشتري ما بيقدر يلمس مشروعك من نص، لكن بيقدر يجرّبه بخمس دقايق.
شو بيعمل الديمو الجيد
- سريع الدخول: بدون تسجيل معقّد. حساب تجريبي جاهز أو دخول مباشر.
- بيانات واقعية: مش فاضي ولا مليان نصوص عشوائية. بيانات بتبين المشروع وهو شغّال.
- يغطي الرحلة الأساسية: المشتري بيشوف من الدخول لحد الإنجاز.
- آمن: بدون بيانات حقيقية ولا مفاتيح حقيقية.
- مستقر: ما بيعطّل بعد كم دقيقة.
إعادة ضبط الديمو
لو الديمو بيسمح للزوار بتعديل بيانات، جهّز آلية تعيد ضبطه دوريًا لحالته الأصلية، وإلا بيتخرّب. وحدّ من الصلاحيات الخطرة بوضع الديمو: حذف، تغيير كلمة السر، إرسال رسائل حقيقية.
ديمو بلوحتين
للمشاريع اللي فيها واجهة للمستخدم ولوحة إدارة، جهّز دخول لكل واحدة. المشتري بيحب يشوف الجهتين. مثلًا مشروع إلمنيو، منيو رقمي ذكي وإدارة مطعم بمسح QR واحد، بيستفيد من ديمو بيوري تجربة الزبون ولوحة صاحب المطعم.
ديمو لمشاريع من نوع مختلف
- تطبيقات الجوال: رابط نسخة تجريبية أو ملف تثبيت أو فيديو شاشة. وبالنسبة للنقل والنشر شوف بيع تطبيق.
- أدوات الذكاء الاصطناعي: نموذج جاهز بمدخلات تجريبية، مثل مشروع كيدزي اللي بيطلّع كرتون جديد كل يوم لقناة أطفال على يوتيوب، وفيه نتيجة بتنشاف.
- سكربتات ولوحات: حساب إداري تجريبي وبيانات واقعية.
- مشاريع بلا واجهة: توثيق API مع أمثلة واضحة.
استضافة الديمو
بتقدر تستضيف الديمو على Bzanes Cloud، اللي فيها حد مجاني لكل مشروع وخطط شهرية. اطّلع على صفحة الاستضافة لتفاصيلها.
المرحلة الثامنة: الصور والفيديو والمواد البصرية
مشتري بيقارن بين عدة مشاريع بدقايق. اللي بيوقف عينه هو اللي بيفتح الصفحة.
لقطات الشاشة
- 4 إلى 6 لقطات لأهم الشاشات.
- مرتبة حسب رحلة المستخدم.
- بجودة عالية وبدون بيانات حقيقية.
- فيها جزء من لوحة الإدارة.
- متناسقة بالحجم والتصميم.
فيديو قصير
فيديو من 30 إلى 90 ثانية بيوري المشروع شغّال: دخول، عملية أساسية، نتيجة. بدون موسيقى مزعجة، وبشرح بسيط. الفيديو بيوفّر على المشتري أسئلة كتير، وبيناسب خصوصًا المشاريع المعقّدة.
صورة الغلاف والشعار
صورة غلاف واضحة بتعبّر عن فكرة المشروع، وشعار بسيط. لو ما في شعار، لا تحط شي مزيّف. صورة نظيفة أفضل من تصميم ضعيف.
شرح كل ميزة بسطر
لكل ميزة رئيسية، جملة وحدة: شو بتعمل، وليش مفيدة. مش «نظام متكامل وقوي» بل «بيسجّل الحجز ويبعت تذكير للزبون قبل الموعد بساعتين».
قالب README بسيط
ملف README هو أول شي بيقرأه المشتري، وهو كمان أول ما بيقرأه المطوّر اللي بيشتغل عليه بعدين. هاد قالب مقترح:
اسم المشروع
وصف بجملة وحدة.
## المتطلبات
- إصدار اللغة أو الإطار
- قاعدة البيانات
- أي أداة بناء
## التثبيت
1. نزّل المشروع.
2. انسخ ملف الإعدادات المثال وعبّيه.
3. ثبّت التبعيات.
4. جهّز قاعدة البيانات.
## التشغيل
- أمر التشغيل للتطوير
- أمر البناء للإنتاج
## الدخول الأول
- كيف تنشئ الحساب الإداري
## بنية المجلدات
- مجلد كذا: شو فيه
## مشاكل شائعة
- المشكلة: الحل
كل قسم من هدول بيجاوب سؤال بيتكرر. وإذا ما عرفت تكتب قسم، فهاد مؤشر إن في جزء من المشروع مش واضح حتى لإنت، وبيستاهل ترتيب.
مثال على «مشاكل شائعة»
اكتب المشاكل اللي واجهتها بنفسك وإنت بتطوّر: خطأ بالصلاحيات على مجلد، نسخة قديمة من لغة بتسبب خطأ، متغير نسيت تعبّيه. كل مشكلة بحلّها بسطرين بتوفّر على المشتري ساعة بحث.
جدول زمني مقترح لأسبوعين تجهيز
لو عندك مشروع شغّال بس مش مجهّز للبيع، هاد جدول واقعي (تقريبي):
| اليوم | المهمة |
|---|---|
| 1 | مراجعة المشروع وقائمة الأسرار والملفات الزايدة |
| 2 | تنظيف الكود والبيانات، وتجهيز ملف الإعدادات المثال |
| 3 | اختبار التركيب على بيئة نظيفة وتسجيل المشاكل |
| 4 | إصلاح المشاكل وإعادة الاختبار |
| 5 | كتابة README ومسودة Handoff |
| 6 | كتابة Handover وقائمة الحسابات |
| 7 | راحة أو مراجعة |
| 8 | تجهيز الديمو وبياناته |
| 9 | اختبار الديمو وإعداد إعادة الضبط |
| 10 | كتابة Documentation.html |
| 11 | لقطات الشاشة والفيديو القصير |
| 12 | كتابة الإعلان وتوثيق الملكية |
| 13 | مراجعة نهائية بالقائمة |
| 14 | النشر |
هالجدول بيتغير حسب مشروعك، بس فكرته إنك ما تحاول تعمل كل شي بيوم وحد، وتقسّم الشغل لمراحل واضحة. ولو مشروعك صغير، ممكن ينضغط لأيام قليلة.
قالب Handover كامل
Handover: اسم المشروع
## الحسابات والملكيات
### الدومين
- المسجّل: ...
- طريقة النقل: ...
- موعد النقل: بعد انتهاء فترة الفحص
### الاستضافة
- المزوّد: ...
- طريقة النقل: نقل الحساب أو إعادة النشر
### قاعدة البيانات
- النوع: ...
- التسليم: نسخة مصدّرة وملف استيراد
### الخدمات الخارجية
- الإيميل: ...
- الدفع: ...
- الإشعارات: ...
- التخزين: ...
### حسابات المنصات
- ...
## الجدول الزمني
1. بعد تأكيد الدفع: تسليم الكود والملفات
2. خلال فترة الفحص: مساعدة المشتري بالتشغيل
3. بعد القبول: نقل الدومين والحسابات
## ما بيتسلّم بطريقة آمنة منفصلة
- كلمات السر والمفاتيح (مش بهالملف)
## بعد النقل
- المشتري بيغيّر كل كلمات السر والمفاتيح
- البائع بيحذف أي وصول خاص عنده
آخر نقطتين مهمتين بالأمان: بعد النقل، المشتري بيغيّر كل شي، والبائع بيسحب أي وصول كان عنده. هيك ما بيضل لك مفتاح على مشروع مش إلك.
أمان قبل التسليم
المشتري بيثق فيك بشغل ما بيعرف كل تفاصيله. خليك أمين.
أمور لازم تتأكد منها
- ما في أبواب خلفية: أي حساب إداري أو كود دخول خاص بك لازم يتشال.
- ما في اتصالات مخفية: كود بيرسل بيانات لسيرفر عندك أو لخدمة تتبّع ما اتفقتوا عليها.
- ما في مفاتيح حية: كل المفاتيح بالكود تجريبية أو متغيّرة.
- قاعدة بيانات مجهّزة: حساب إداري افتراضي بكلمة سر مؤقتة، والمشتري بيغيّرها.
- تحديثات الأمان الأساسية: حدّث المكتبات اللي فيها ثغرات معروفة وخطيرة إذا بتقدر بأمان.
مبدأ «لا مفاجآت»
أي شي بيفتحه المشتري ويستغرب منه بيضر بثقته. لو في جزء غير عادي (مثلًا خدمة بتتواصل مع طرف ثالث)، اكتبه بصراحة بـHandoff. الشفافية بتحميك أكتر من الصمت.
ما لازم تعمله بعد التسليم
احتفظ بنسخة من اللي سلّمته (مش لاستعمالها، بل للمرجعية لو صار خلاف). وسجّل المراسلات المهمة. ولا تحتفظ بوصول لحسابات المشتري إلا بإذن واضح ومؤقت لمساعدته.
مثال واقعي: قبل التجهيز وبعده
مطوّر عنده نظام حجز لمراكز العناية، شغّال عنده منذ سنة. قرر يبيعه.
قبل التجهيز
- الكود فيه مفاتيح دفع حقيقية بملف الإعدادات.
- ما في README، والخطوات بذاكرته.
- قاعدة البيانات فيها بيانات زبائن حقيقيين.
- الديمو هو نفس النظام الحي بحساب إداري حقيقي.
- ما في لقطات، بس رابط الموقع.
لو عرض هيك، أول مشتري جاد رح يسأل: كيف أركّبه؟ ليش في بيانات حقيقية؟ وين التوثيق؟ والإجابات بتكلّف أيام.
بعد التجهيز
- المفاتيح بملف مثال فاضي، والحقيقية انتقلت.
- README وHandoff وHandover وDocumentation مكتوبين.
- قاعدة بيانات تجريبية بدل الحقيقية.
- ديمو مستقل بحسابين (زبون وإدارة) وبإعادة ضبط يومية.
- ست لقطات وفيديو قصير.
- إعلان واضح فيه شو مشمول وشو لا.
والنتيجة أسئلة أقل، وثقة أعلى، وصفقة أسرع. وهاد بالضبط الفرق بين مشروع «موجود» ومشروع «جاهز للبيع». ولو كان عندك نظام مشابه، شوف نماذج مثل موعدي المعروضة على بزانيس لتشوف كيف بيتقدّم مشروع بهالنوع.
ما بيسأله المشتري وقت الفحص
المشتري على بزانيس عنده 72 ساعة ليفحص التسليم بعد استلامه، وإذا في مشكلة الفلوس بتضل محجوزة لحد ما تنحل. معرفتك بالأسئلة المتوقعة بتخلّيك تجهّز الأجوبة مسبقًا.
أسئلة الفحص الأكتر تكرارًا
- هل الكود كامل؟ هل في ملفات ناقصة؟
- هل بيشتغل حسب ما يظهر بالديمو؟
- هل الخطوات بملف التسليم دقيقة؟
- هل الحسابات والمفاتيح انتقلت؟
- هل في ثغرات أو مفاتيح مكشوفة؟
- هل التوثيق كافي للاستمرار بدونك؟
- هل المشروع مطابق للوصف بالإعلان؟
جهّز نفسك
- حافظ على نسخة مطابقة لما سلّمته.
- جاوب بسرعة خلال فترة الفحص.
- لو المشتري لقى مشكلة حقيقية، اعتذر وصلّحها بسرعة.
- لو الشكوى خارج الاتفاق، أجب بهدوء وبالرجوع للإعلان وملفات التسليم.
الخلاصة: كل ما كان مكتوب بوضوح، قلّت النزاعات. للتفاصيل عن الشراء الآمن عبر الوسيط شوف الشراء الآمن عبر الوسيط.
تجهيز المشروع للتركيب المجاني
الترخيص الموسّع على بزانيس بيشمل تركيب مجاني اختياري، يعني المنصة بترفع المشروع للمشتري. وهاد بيعني إن المشروع لازم يكون قابل للتركيب بخطوات واضحة من طرف ثالث مش بس منك.
شو بيسهّل التركيب
- أمر تثبيت واضح: أمر أو سكربت بيجهّز كل شي.
- ملف إعدادات مثال: بيعرف الفريق شو لازم ينعبّى.
- قاعدة بيانات قابلة للاستيراد: ملف جاهز بدون تعقيد.
- ما في اعتماد على جهازك: مسارات ثابتة أو أدوات خاصة.
- وصف البيئة المطلوبة: نسخ اللغات والأدوات، والإضافات المطلوبة.
اختبر كأنك الفريق
اطلب من صديق مطوّر، أو جرّب بنفسك على حساب جديد، تركيب المشروع حسب ملفاتك فقط. إذا نجح بدون ما تتدخل، المشروع جاهز لتركيب مجاني. وإذا احتاج تدخلك، كمّل التوثيق. ولاحظ إن كل ساعة بتوفّرها بالتوثيق بتتحوّل لمشتري راضي وتقييم موثّق إيجابي، والتقييم هو اللي بيجيب المشتري التالي.
ما علاقة هالشي بالسعر؟
مشروع سهل التركيب بيخلّي الترخيص الموسّع أسهل بالتقديم، وبيحميك من التزامات خفية. أما مشروع صعب التركيب فبيخلّيك تقضي وقت بالتركيب أو بتخسر مشترين. والتركيب جزء من القيمة اللي بتعرضها، فاعتبره جزء من جودة المنتج مش عبء إضافي.
التوثيق وإثبات الملكية
المشتري بيحب يتأكد إنك صاحب المشروع. بزانيس بتوفّر توثيق ملكية: بتحط ملف verify-bzanes.txt أو سطر meta بموقعك، والمشروع الموثّق بياخد شارة وبيطلع أول. هاد جزء من التجهيز، لأنه بيرفع الثقة بدون كلام.
وبالنسبة للدخل، لو المشروع بيحقق إيراد، فربط مفتاح Stripe مقيّد للقراءة بس بيخلّي المنصة تزامن الإيراد كل 15 دقيقة وتطلّع شارة دخل موثّق. معظم المشاريع حاليًا قبل الإطلاق، فهاد مش مطلوب منها. وما تحط أي رقم دخل ما بتقدر تثبته.
للتفاصيل الكاملة شوف توثيق ملكية المشروع وصفحة التوثيق.
تجهيز المشروع حسب نوعه
كل نوع مشروع إله تفاصيل زيادة بالتجهيز.
موقع أو متجر
- نسخة احتياطية كاملة (ملفات وقاعدة بيانات).
- ملف شرح الإضافات والقوالب المستعملة وتراخيصها.
- معلومات الاستضافة والدومين وشهادة الأمان.
- لو في تحسين لمحركات البحث، سجل التعديلات.
تطبيق جوال
- الكود وملفات البناء.
- مفاتيح التوقيع أو ترتيب التوقيع عند المتجر.
- قائمة الخدمات المربوطة بالحساب (إشعارات، تسجيل دخول، دفع).
- شرح نقل التطبيق بين الحسابات.
نظام أو SaaS
- بنية السيرفر وقاعدة البيانات.
- خطوات النشر والتحديث.
- المهام المجدولة والخدمات الخلفية.
- مراقبة الأخطاء وتسجيل الأحداث.
مشروع ذكاء اصطناعي
- المفاتيح اللي بتعتمد عليها الخدمة، وكيف يبدّلها المشتري. بزانيس بتوفّر Bzanes AI: مفتاح واحد لأكثر من 500 موديل ومتوافق مع OpenAI SDK، لو حبيت المشتري يستعمل نفس الواجهة، شوف موديلات الذكاء الاصطناعي وشرح الواجهة.
- الأوامر والقوالب المستعملة (prompts) وأين تتعدّل.
- حدود الاستعمال والكلفة التقريبية للتشغيل بشكل عام بدون أرقام.
كلمة أخيرة عن التجهيز
التجهيز مش مجرد واجب قبل البيع، هو استثمار بيرجع لك بكل صفقة. ملفات التسليم اللي كتبتها مرة وحدة بتخدمك مع كل مشتري، والديمو اللي جهّزته بيشتغل لك ليل نهار بدون ما تكون موجود، والتوثيق بيقلّل أسئلة الدعم لحد كبير. ولو قررت تبيع أكتر من مشروع، رح تلاحظ إن التجهيز الثاني أسرع بكثير من الأول، لأنك بتعيد استعمال نفس القوالب والقوائم وطريقة التفكير.
أخطاء شائعة بتجهيز المشروع
- تسليم الكود بدون ملف تشغيل. المشتري بيضيّع أيام.
- مفاتيح باسمك داخل الكود. المشروع بيتوقف بعد انتهاء حسابك.
- ديمو بيانات فاضية. ما بيبين المشروع.
- ديمو بدون إعادة ضبط. بيتخرّب بعد زوّار قليلين.
- توثيق قديم. بيشرح نسخة سابقة من المشروع.
- لقطات شاشة ببيانات حقيقية. مشكلة خصوصية.
- ما ذكرت المكتبات وتراخيصها. مفاجأة قانونية للمشتري.
- اختبرت على جهازك فقط. الكود بيعتمد على إعدادات محلية.
- ما كتبت شو غير مشمول. أول سبب للخلاف.
- تأجيل التجهيز لما يجي مشتري. بتخسر الانطباع الأول.
قائمة فحص نهائية قبل العرض
- الكود نظيف وبدون أسرار.
- بيشتغل على بيئة نظيفة بحسب README.
- Handoff.md مكتوب ومجرّب.
- Handover.md فيه جدول نقل الحسابات.
- Documentation.html جاهز.
- ديمو حي شغّال وآمن وفيه بيانات واقعية.
- لقطات وفيديو قصير.
- قائمة المكتبات والتراخيص.
- ملكية المشروع موثّقة.
- الإعلان مكتوب بوضوح فيه شو مشمول وشو لا.
- خطّة السعر والتفاوض.
- استعداد للرد خلال فترة الفحص.
الخطوة بعد التجهيز
بعد ما يخلص التجهيز، بتصير جاهز للعرض والتفاوض. اكتب إعلان واضح، ووثّق الملكية، وجهّز نفسك للأسئلة وعروض الأسعار. بزانيس بتخلّي المشتري يبعت عرض سعر على أي خيار، وتقدر ترد بسعر خاص أو باقة مخصّصة، وهاد مشروح بمقال التفاوض على بيع المشروع.
وإذا بدك تفهم الإطار الأوسع، ارجع لـدليل بيع المشروع الإلكتروني، ولو بتفكر تبيع الكود أكتر من مرة، شوف بيع سورس كود.
اعرض مشروعك وهو جاهز
مشروع مجهّز بالكامل بيحكي عن نفسه: ديمو يشتغل، وملفات واضحة، وتسليم منظّم. اعرض مشروعك للبيع على بزانيس، وخلي المشتري يشوف الشغل المرتب من أول دقيقة. وللتعرف على خطوات المنصة، شوف صفحة كيف بتشتغل بزانيس.
أسئلة شائعة
شو الملفات اللي لازم أجهزها قبل ما أبيع مشروعي؟
الملفات المعتادة على بزانيس ثلاثة: Handoff.md بيشرح شو بيستلم المشتري وكيف يشغّله، وHandover.md لنقل الحسابات والوصول، وDocumentation.html للتوثيق الكامل. ويضاف لهم الكود النظيف وملف README وديمو يشتغل.
شو الفرق بين Handoff وHandover؟
Handoff بيجاوب «شو أستلم وكيف أشغّله»، يعني الكود والتشغيل والإعدادات. Handover بيجاوب «كيف تنتقل الحسابات والملكيات»، يعني الدومين والاستضافة والخدمات الخارجية وبيانات الدخول. الأول تقني للتشغيل، والتاني إداري للنقل.
لازم يكون عندي ديمو حي للمشروع؟
عمليًا نعم. كل مشروع على بزانيس إله ديمو حي بتجرّبه قبل الشراء، وهاد بيرفع ثقة المشتري بشكل كبير. الديمو بيوفّر أسئلة كثيرة وبيخلّي المشتري يقرر بسرعة.
كيف بوثّق الكود بدون ما أضيّع وقت كتير؟
وثّق القرارات مش كل سطر: بنية المشروع، كيف يتشغّل، وين الإعدادات، كيف تغيّر الهوية، وشو الأجزاء الحساسة. ملف README واضح ودليل تركيب بيغطوا أغلب الأسئلة. وللتفاصيل الأعمق استعمل Documentation.html.
هل أسلّم كلمات السر والمفاتيح مع الملفات؟
لا تكتبها بالملفات العامة أو بالكود. سلّمها بطريقة آمنة ومنفصلة بعد تأكيد الدفع، ورتّب نقل الحسابات بملف Handover. وبعد التسليم، اطلب من المشتري يغيّر كل كلمات السر والمفاتيح.
شو بصير لو نسيت ملف مهم وقت التسليم؟
عند البيع عبر المنصة، المشتري بيفحص التسليم خلال 72 ساعة، وإذا في مشكلة الفلوس بتضل محجوزة لحد ما تنحل. لهيك الأفضل تسلّم الناقص بسرعة، وتجهّز قائمة تحقق من قبل لتتجنب هالموقف.
كم وقت بياخد تجهيز المشروع للبيع؟
بيعتمد على حجم المشروع وحالته. مشروع نظيف وموثّق بيحتاج أيام قليلة للتجهيز النهائي، ومشروع غير مرتب ممكن يحتاج أسابيع. ابدأ بالتجهيز قبل ما تعلن، مش بعد ما يجي مشتري.