كراسة الشروط والمواصفات التقنية: لماذا تنحرف 80% من مشاريع الويب بدونها

«لنبدأ في البرمجة، سنُحدّد التفاصيل تدريجياً.» هذه على الأرجح أغلى جملة في صناعة الرقمي. في كودينغ آرت، رأينا الكثير من المشاريع تصل إلى مكتبنا بعد مزود أول قال نعم لكل شيء دون أن يكتب شيئاً — النتيجة: 60 000 يورو مُنفقة، ستة أشهر تأخّر، صفر سطر قابل للتسليم. كراسة الشروط والمواصفات التقنية ليست أوراقاً بيروقراطية. إنها العمود الفقري الذي يُحدّد ما إذا كان مشروعك سينتهي بـ 12 000 يورو أو 80 000 يورو.

كراسة الشروط مقابل المواصفات التقنية: لا تخلطوا بينهما#

كثير من الشركات الصغيرة والمتوسطة تخلط بين الوثيقتين. لكنهما أداتان متمايزتان ومتكاملتان، لكل واحدة جمهور مستهدف مختلف.

كراسة الشروط عقد أخلاقي بينكم وبين المزوّد: تُجمّد النطاق وتُقدّم قاعدة للنقاش في حال الخلاف. المواصفات التقنية دليل تنفيذ للمطورين: تمنع كل واحد من تفسير الحاجة بشكل مختلف.

5 مخاطر تنفجر بدون كراسة شروط#

1. انحراف النطاق: بدون حدود مكتوبة، كل اجتماع يُضيف «مجرد ميزة صغيرة» — والميزانية تنفجر بـ 40 إلى 200٪.
2. عروض أسعار غير قابلة للمقارنة: 3 وكالات تُتصل بها بدون كراسة شروط مشتركة = 3 عروض مبنية على 3 فرضيات مختلفة. تُقارنون التفاح بالبرتقال.
3. نزاع قانوني وقت التسليم: «أردتُ هذا» مقابل «لم تقولوا ذلك أبداً» — بدون كراسة شروط موقّعة، القاضي يقرّر بالإحساس.
4. إعادة تطوير مُكلفة: 3 أشهر بعد الإطلاق، تُدركون أن حالة استخدام حرجة لم تُفكَّر فيها أبداً. التكلفة: 2 إلى 5 أضعاف التكلفة الأولية لإضافتها بعد الإنتاج.
5. إحباط الفريق: مطورون مُحبَطون من إعادة عمل الميزة نفسها 5 مرات لأن التوقعات تطفو — يزداد دوران العمل، تنهار الجودة.

ما يجب أن تحتوي عليه كراسة شروط جيّدة#

كراسة شروط فعّالة لا تحتاج لأن تكون كتلة من 80 صفحة. لمشروع PME (5 000 إلى 50 000 يورو)، 8 إلى 15 صفحة مكتوبة جيداً كافية. إليكم البنية التي نوصي بها عملاءنا وتُغطّي 95٪ من مشاريع الويب/الجوال.

1. السياق والأهداف

من أنتم (النشاط، الحجم)، ما هي المشكلة المهنية التي يسعى المشروع لحلّها، ما هي مؤشرات النجاح القابلة للقياس (مثلاً: «زيادة المبيعات عبر الإنترنت بنسبة 30٪ في 12 شهراً»). بدون هذا القسم، المزوّد يُصمّم في الفراغ.

2. أهداف المستخدمين

Personas (2 إلى 4 كحد أقصى)، مستوى النضج الرقمي، الأجهزة المستخدمة (mobile-first أم desktop؟)، قيود إمكانية الوصول (WCAG؟)، اللغات المطلوبة.

3. النطاق الوظيفي

قائمة شاملة بالميزات المتوقعة، مُصنّفة كـ «must-have» (MVP)، «should-have» (V1.1)، «could-have» (V2). هذه هي النقطة الأكثر حرجاً: ما ليس مكتوباً هنا ليس في عرض السعر.

4. المحتوى والهوية

من يُقدّم النصوص والصور والفيديوهات؟ هل توجد هوية بصرية حالية؟ إذا لا، هل يجب على الوكالة إنشاؤها (احسبوا 2 000 إلى 8 000 يورو إضافية)؟

5. القيود التقنية

استضافة مفروضة (GDPR؟ HDS؟ سيادة UE/MA؟)، stack إلزامي (SI موروث)، تكاملات طرف ثالث (CRM, ERP، دفع، mobile money)، متطلبات SEO، أداء متوقّع (Lighthouse 90+؟ Core Web Vitals أخضر؟).

6. التخطيط والميزانية

تاريخ الإطلاق المرغوب (ولماذا: حدث، موسم، قيد قانوني؟)، الميزانية التقريبية (لا تكذبوا — ميزانية مخفية تؤدّي دائماً إلى عرض سعر خارج الموضوع)، شروط الدفع (الجدول، الدفعات المُقدَّمة).

7. معايير الاستلام والضمان

أي اختبارات تُصادق التسليم؟ كم دورة تصحيح مشمولة؟ ما مدة الضمان (30، 60، 90 يوماً)؟ ماذا يحدث إذا حدث خطأ حرج بعد الإطلاق؟

ما يجب أن تحتوي عليه وثيقة المواصفات التقنية الجيّدة#

المواصفات التقنية يكتبها فريق التطوير بعد التحقق من كراسة الشروط، قبل أول سطر كود. تُحوّل «الماذا» إلى «الكيف». على مشروع ويب نموذجي، احسبوا 5 إلى 20 صفحة.

• بنية البرمجيات: monolith مقابل microservices، فصل front/back، خيارات تقنية مبرّرة.
• نماذج البيانات: مخطط قاعدة البيانات، العلاقات، الفهارس الحرجة، قيود السلامة.
• عقود API: endpoints، payloads، أكواد الخطأ، المصادقة (JWT, OAuth, session؟)، rate limiting.
• الأمن: مكان تخزين الأسرار، التشفير في الراحة وفي النقل، إدارة الجلسات، anti-CSRF/XSS، خطة في حال التسرّب.
• الاستضافة والنشر: مراكز البيانات، التوسّع الأفقي/العمودي، CDN، النسخ الاحتياطي (RPO/RTO)، المراقبة.
• استراتيجية الاختبارات: unit، تكامل، E2E، حمل، إمكانية وصول — ما تغطية الهدف (60٪، 80٪؟).
• خطة الإطلاق في الإنتاج: feature flags، blue-green / canary، rollback تلقائي في حال شذوذ.
• التوثيق: أين وكيف يُحفَظ (Notion, Confluence, README في الـ repo؟).

7 أخطاء نراها أكثر شيوعاً#

1. الخلط بين كراسة الشروط وbrief تجاري: brief مبيعات من صفحتين لا يُعتبر كراسة شروط.
2. سرد 200 ميزة بدون أولويات: إذا كان كل شيء P0، لا شيء P0. حد أقصى 15 ميزة «must-have» لـ MVP.
3. نسيان تدفقات الخطأ: «ماذا يفعل المستخدم عندما يفشل الدفع؟» — جواب نادراً ما يُكتب، مصدر 30٪ من أخطاء الإنتاج.
4. بدون wireframes: وصف مسار مستخدم بدون wireframe يعني طلب 3 تفسيرات مختلفة.
5. ميزانية سرّية: رفض إعطاء نطاق يؤدّي دائماً إلى عرض سعر مُبالَغ فيه أو ناقص، أبداً متوافق.
6. بدون معايير قابلة للقياس: «الموقع يجب أن يكون سريعاً» لا يعني شيئاً. «Lighthouse 90+ على الصفحة الرئيسية, LCP < 2 ث» هو معيار قابل للقياس.
7. عدم مراجعة كراسة الشروط من قِبل تقني مستقل: المحامي يُراجع العقد، الطبيب يُراجع الوصفة — كراسة شروطكم تستحق مراجعة محايدة من CTO خارجي (200-500 يورو، عائد استثمار ضخم).

كم تكلّف كتابة كراسة شروط جدية؟#

ثلاثة خيارات متاحة حسب نضجكم ووقتكم المتاح.

كيف ترافق كودينغ آرت عملاءها في هذه المرحلة#

قبل توقيع عرض السعر حتى، نُقدّم ورشة تأطير مجانية (ساعة ونصف عبر فيديو أو حضورياً في أكادير). نخرج منها بصفحة تلخيص تُصادق أو لا على وجاهة المضي قُدماً. إذا تابعنا، نبني معاً كراسة شروط في أسبوعين كحد أقصى، ويكتب lead techs لدينا المواصفات التقنية بالتوازي منذ التوقيع. النتيجة: لا مفاجأة سيئة بعد أول سبرينت، ومهلة تسليم مُحترمة على 92٪ من مشاريعنا 2024-2026.