مولّد اختبار الحالات الحدية: حوّل وصف ميزة إلى مصفوفة اختبار كاملة قبل كتابة الكود
لماذا تهم هذه المطالبة
Engineering teams that start coding directly from a short ticket typically discover 30-40% of their real edge cases only after a customer hits one in production. On a feature that touches money and inventory, each edge case that ships unhandled turns into a support escalation, an engineering fire drill, a reconciliation headache for finance, and in the worst cases — like the double-refund or stale-pricing scenarios above — direct, hard-to-reverse financial loss. Finding these gaps on paper during planning costs minutes; finding them in production after a customer or auditor does costs hours of firefighting plus the trust damage of a visibly broken checkout flow.
فيم نستخدمها
A backend engineer is about to implement a new bulk order cancellation endpoint for an e-commerce API — one function call that touches payment refunds, inventory restocking, and customer notifications at once. The ticket describes the happy path in two sentences. Before writing a single line of code, the engineer runs this prompt against the feature description to surface every edge case, race condition, and integration failure the implementation needs to handle.
المطالبة
Role: Act as a senior software engineer and QA architect with deep experience in test design and failure-mode analysis for production systems. Context: I am about to implement the following feature or function, and I want a complete picture of what could go wrong before I write any code. Feature description or function signature: [PASTE FEATURE DESCRIPTION OR FUNCTION SIGNATURE HERE] Language/framework: [E.G. "PYTHON WITH FASTAPI", "TYPESCRIPT WITH NODE.JS"] Edge cases I've already planned for: [LIST THEM, OR WRITE "NONE YET"] Domain constraints or sensitivities: [E.G. "TOUCHES PAYMENT PROCESSING", "MUST BE IDEMPOTENT", "RUNS ACROSS MULTIPLE WORKERS", OR "NONE"] Task: Produce a complete test matrix for this feature, organized into these six categories: 1. Happy path - the 1-3 cases representing normal, expected usage 2. Boundary conditions - empty inputs, maximum sizes, zero/negative values, type edge cases 3. Invalid/malformed input - what a malicious or confused caller might send 4. State and concurrency edge cases - what happens if this runs twice, runs concurrently, or runs when upstream state changes mid-execution 5. Integration failure points - what happens when each external dependency (database, API, queue, cache) times out, errors, or returns a malformed response 6. Silent failure risks - cases where the code might succeed technically but produce the wrong result without throwing an error For each test case, give: a one-line description, the specific input/state that triggers it, and the expected correct behavior. Constraints: Do not give generic testing advice - every case must be specific to the actual feature described above. Flag the 3-5 cases you consider highest risk if left untested, with a one-sentence reason why. If the feature touches money, user data, or irreversible actions, call that out explicitly and treat those paths with extra scrutiny. Output Format: Present the test matrix as a numbered list within each of the six categories above. After the full matrix, add a short "Top 5 Risks If Skipped" section ranking the highest-priority gaps.
النتيجة
Feature: Bulk order cancellation endpoint (cancels up to 50 orders in one call, triggers payment refunds, restocks inventory, sends customer notifications).
1. Happy Path
- Cancel 3 valid, unshipped orders belonging to the requesting user → all 3 refunded, restocked, and notified successfully.
- Cancel a single order via the bulk endpoint with a 1-item array → behaves identically to the single-cancel endpoint.
2. Boundary Conditions
- Empty order ID array submitted → should return a 400 with a clear message, not a silent no-op.
- Exactly 50 order IDs (the stated max) → should succeed; 51 should be rejected with a specific "limit exceeded" error, not a generic 500.
- Duplicate order ID appears twice in the same request → should be deduplicated and refunded once, not twice.
3. Invalid/Malformed Input
- Order ID belonging to a different user → must be rejected per-item with a 403 in the response, not fail the entire batch or silently skip it without telling the caller.
- Order ID that doesn't exist → per-item 404, batch should still process the valid remaining items.
- Order already shipped or already cancelled → reject with a specific status explaining why, don't attempt a double-refund.
4. State and Concurrency
- Same cancellation request submitted twice in rapid succession (double-click/retry) → must not issue two refunds for the same order (idempotency key required).
- Order gets shipped by the warehouse system in the few hundred milliseconds between validation and the cancellation transaction committing → must detect the state change and reject that specific item rather than cancelling a now-shipped order.
5. Integration Failure Points
- Payment refund API times out after inventory has already been restocked → must not leave the order in a state where inventory was returned but the customer wasn't refunded; needs compensating transaction or saga pattern.
- Notification service is down → cancellation and refund must still complete; notification failure should queue for retry, not roll back the whole operation.
- Inventory service returns a malformed response (missing SKU field) → must fail that item explicitly rather than assuming restock succeeded.
6. Silent Failure Risks
- Refund amount calculated using stale cached pricing data instead of the price actually paid → technically "succeeds" but refunds the wrong amount.
- Partial batch success returns HTTP 200 without clearly itemizing which orders failed → caller assumes everything succeeded when some didn't.
Top 5 Risks If Skipped
- Double refund on retry - direct financial loss, highest priority, very likely to occur in production given client-side retry logic.
- Refund/restock partial failure (no compensation) - creates permanently inconsistent state between payment and inventory systems.
- Race condition with warehouse shipping - customer receives a cancelled-but-shipped order, becomes a support and trust issue.
- Wrong refund amount from stale pricing - silent, hard to detect, directly costs money either to the business or the customer.
- Ambiguous partial-success response - causes downstream systems or the frontend to misreport order status to the customer.
معظم المهندسين لا يتجاهلون الحالات الحدية بسبب الإهمال. يتجاهلونها لأن تذكرة الميزة تصف المسار السعيد في جملتين، والعقل يملأ الباقي بتخيل أن الميزة تعمل بشكل صحيح. هذا البرومبت موجود لإجبار نقطة انطلاق مختلفة: بدلًا من السؤال "ماذا يجب أن يفعل هذا"، يسأل "ما هي الطرق المحددة التي يتعطل بها هذا"، ويُبنى هذا السؤال بشكل يجعل الإجابة قابلة للاستخدام فعليًا كخطة اختبار، لا قائمة غامضة من المخاوف.
لماذا ست فئات بدلًا من قائمة مفتوحة واحدة
برومبت بسيط مثل "اذكر الحالات الحدية لهذه الدالة" يميل إلى إنتاج حفنة من سيناريوهات فحص القيم الفارغة الواضحة ثم التوقف، لأن لا شيء يُلزم النموذج بالنظر إلى أنماط الفشل الأصعب. تقسيم الطلب إلى المسار السعيد، والشروط الحدية، والمدخلات غير الصالحة، والحالة/التزامن، وأعطال التكامل، ومخاطر الفشل الصامت ينجح لأن كل فئة تستهدف سببًا جذريًا مختلفًا لأخطاء الإنتاج. الشروط الحدية تمسك أخطاء الحساب الزائد/الناقص بواحد وأخطاء النوع. التزامن يمسك الأخطاء التي تظهر فقط تحت حركة مرور حقيقية، لا في اختبار يدوي واحد. نقاط أعطال التكامل تمسك فرضية أن قاعدة البيانات أو واجهة الدفع البرمجية ستستجيب دائمًا بشكل نظيف. مخاطر الفشل الصامت -الحالات التي يعمل فيها الكود دون خطأ لكنه يُنتج نتيجة خاطئة- هي أصعب فئة يمكن التفكير فيها دون توجيه، وغالبًا الأكثر تكلفة لاكتشافها لاحقًا، وهو السبب الدقيق الذي يجعل البرومبت يبرزها كفئة مستقلة بدلًا من تركها تضيع داخل "أخرى".
لماذا يطلب البرومبت تحديدًا، لا نصيحة عامة
قوائم فحص الاختبار العامة ("اختبر المدخلات الفارغة"، "اختبر النصوص الخالية") متوفرة في أي كتاب تعليمي لضمان الجودة ولا تضيف قيمة كبيرة. الشرط القائل بأن "كل حالة يجب أن تكون خاصة بالميزة الفعلية الموصوفة" هو ما يحوّل هذا من محاضرة نظرية عن الاختبار إلى خطة فعلية للدالة التي أمامك -يُلزم النموذج بالتفكير في ما تفعله عملية إعادة تخزين المخزون وإصدار الاسترداد وإرسال الإشعارات ببعضها تحديدًا عندما تحدث خارج الترتيب أو تفشل جزئيًا، بدلًا من سرد فئات مجردة بلا محتوى.
لماذا ينتهي الناتج بقائمة مخاطر مرتبة، لا مصفوفة مسطحة فقط
مصفوفة اختبار من 20-30 عنصرًا مفيدة لجولة ضمان جودة، لكن ليس لكل عنصر العواقب نفسها، والمهندس المنشغل الذي يواجه موعدًا نهائيًا يحتاج لمعرفة أي 3-5 حالات غير قابلة للتفاوض حتى لو تم تأجيل البقية إلى تذكرة متابعة. إنهاء الناتج بقسم "أهم 5 مخاطر عند التجاهل"، كل واحدة بسبب من جملة واحدة، يحوّل قائمة شاملة إلى أداة فرز أولويات -الفرق بين وثيقة لا يقرؤها أحد قبل الإطلاق ووثيقة تغيّر فعليًا ما يُبنى أولًا.
من يجب أن يستخدم هذا، وفي أي وقت
يحقق هذا البرومبت أكبر فائدته على الميزات ذات العواقب الحقيقية لإغفال حالة حدية: أي شيء يتعلق بالدفع أو المخزون أو المصادقة أو بيانات لا يمكن تصحيحها بسهولة بعد وقوع الأمر. شغّله في اللحظة التي تبدأ فيها عادةً كتابة الكود، وأعطه التذكرة الفعلية أو توقيع الدالة، وعامل الناتج كقائمة تحقق للعمل عليها -أو تسليمها مباشرة لمن يكتب الاختبارات.