How to do an assignment, with a complete example

1 · How the course is graded · 100 marks

The full course specification, in the ETEC T-104 structure: course specification. توصيف المقرر كاملاً: توصيف المقرر.

How the assignment points become 30 marks. The nine assignments give 44 rubric points in total (4 + 8 × 5). Your assignment mark is your points ÷ 44 × 30. Each 5-point assignment is therefore worth about 3.4 marks of the course, so none of them is small.

The Python build in Assignments 3–9 is marked inside each assignment's 5 points (the second rubric row). Running the tests is a separate rubric row, TESTS RUN: it is required, and longer writing does not replace it. The micro-viva is a short check of that same work, not a separate exam.

2 · The nine steps, in pictures الخطوات التسع بالصور

Each card opens the picture of that step. اضغط على أي خطوة لترى صورتها الحقيقية.

1. 1📖15 minPrepareLecture, the two readings, the five practice questionsاحضر المحاضرة، اقرأ المصدرين، وحلّ الأسئلة الخمسة
2. 2🔑1 minOpenOpen it with your Student ID, in the same browser every timeافتح الواجب برقمك الجامعي، ومن نفس المتصفح دائماً
3. 3✍️20 minPart AFIT · artifact · BOUND · ACT + EVIDENCE, 120–180 wordsاكتب حكمك الأول: المشكلة، المهمة، الحدود، القرار والدليل
4. 4🐍30 minBuildPlan, complete the code, write 3+ tests, Runاكتب الخطة، أكمل الكود، 3 اختبارات على الأقل، ثم Run
5. 5🔒1 minCommitReview & commit Part A: it becomes read-onlyثبّت الجزء A: يصبح للقراءة فقط
6. 6📋2 minNew evidenceIt opens on the page right after you commit. Read itيظهر الدليل الجديد في الصفحة مباشرة بعد التثبيت: اقرأه
7. 7🔄10 minPart BBoundary status, then RETAIN / REVISE / REPLACE and whyهل تغيّر قرارك؟ اختر وبرّر، ثم اكتب القرار النهائي
8. 8🖊️2 minSignDeclare AI use, type your name, tick the boxصرّح بالذكاء الاصطناعي، اكتب اسمك، وضع العلامة
9. 9✅3 minSubmitPrint / PDF, then upload the PDF in Blackboardصدّر PDF وارفعه في Blackboard

Show the pictures of each step اعرض صور الخطوات

Step 2 · Open the assignment

الخطوة 2 · افتح الواجب

1. 1Type your Student IDاكتب رقمك الجامعي
2. 2Tick the pledgeضع علامة على التعهد
3. 3Open assignmentاضغط Open assignment

Step 3 · Part A: read the case, then FIT

الخطوة 3 · الجزء A: اقرأ الحالة، ثم FIT

1. 1Read the case: only these facts countاقرأ الحالة: الحقائق المكتوبة فقط هي المعتمدة
2. 2FIT: the problem that decides the caseFIT: ما المشكلة التي تحكم القرار؟

Step 3 · Part A: the other four fields

الخطوة 3 · الجزء A: بقية الحقول

1. 3The chapter artifact (TRACE, TEST, …)مهمة الفصل (TRACE أو TEST …)
2. 4BOUND: when your claim stops holdingBOUND: متى يتوقف حكمك عن الصحة؟
3. 5ACT: what to do now, and who owns itACT: ماذا تفعل الآن ومن المسؤول؟
4. 6EVIDENCE: what someone else can checkEVIDENCE: ما الدليل الذي يستطيع غيرك فحصه؟

Step 4 · The Python build

الخطوة 4 · البناء البرمجي

1. 1Write a short plan firstاكتب خطة قصيرة أولاً
2. 2Complete the code and write 3+ testsأكمل الكود واكتب 3 اختبارات على الأقل
3. 3Run my tests and the course checksاضغط Run لتشغيل الاختبارات

Step 4 · Read your build record

الخطوة 4 · اقرأ سجل البناء

1. 1Your micro-viva change requestطلب التعديل الخاص بك للمقابلة القصيرة
2. 2Your own tests: ✗ means fix code or testاختباراتك: ✗ تعني أصلح الكود أو الاختبار
3. 3Course checks: the rule from the taskفحوصات المقرر: قواعد الواجب
4. 4“Not caught”: add a test for this bug«not caught»: أضف اختباراً يكشف هذا الخطأ

Step 5 · Commit Part A

الخطوة 5 · ثبّت الجزء A

1. 1Review & commit Part A: freezes Part A, it is not submissionReview & commit يثبّت الجزء A، وهو ليس تسليماً

Step 6 · The new evidence opens on the page

الخطوة 6 · الدليل الجديد يظهر في الصفحة

1. 1Read the new evidence: it appears right after you commitاقرأ الدليل الجديد: يظهر مباشرة بعد التثبيت
2. 2Part B starts here, on the same pageالجزء B يبدأ هنا في نفس الصفحة

Step 7 · Part B: REFIT

الخطوة 7 · الجزء B: المراجعة

1. 1What happened to your boundary?ماذا حدث لحدود حكمك؟
2. 2RETAIN, REVISE or REPLACEأبقِ، عدّل، أو استبدل القرار
3. 3Defend the choice from the new evidenceبرّر اختيارك من الدليل الجديد
4. 4The final decision another person can act onالقرار النهائي الذي ينفّذه غيرك

Step 8 · Declare AI and sign

الخطوة 8 · التصريح والتوقيع

1. 1AI use, or “No AI used.”استخدام الذكاء الاصطناعي، أو «No AI used.»
2. 2Type your nameاكتب اسمك
3. 3Tick: you reviewed it and take responsibilityضع علامة: راجعت العمل وأتحمّل مسؤوليته

Step 9 · Export and submit

الخطوة 9 · صدّر وسلّم

1. 4Print / PDF, check the file, upload it in BlackboardPrint / PDF، راجع الملف، ثم ارفعه في Blackboard

Step 9 · In Blackboard: one item

الخطوة 9 · في Blackboard: خانة واحدة فقط

Assignment N · Chapter X
Upload your final PDF here, before the deadline. That is all.
ارفع ملف PDF النهائي هنا قبل الموعد. هذا كل شيء.

3 · Worked example: Part A مثال محلول

Each card: ✓ a strong answer and ✗ a weak one for the same field. في كل بطاقة: ✓ إجابة قوية، و✗ إجابة ضعيفة تخسر الدرجة. The whole strong Part A is about 160 words.

Weak answers lose credit because nothing in them is specific to the case, nothing can be checked, and the boundary cannot be observed. الإجابة الضعيفة عامة، ولا يمكن فحصها، وحدودها غير قابلة للملاحظة.

4 · The Python build: try it here

This practice build works exactly like the one in Assignments 3–9. Try the starter first and read the failures, then complete it. The full example solution is below the build.

A good build plan (2–3 sentences)

def can_borrow(student, item):
    try:
        loans = student["loans"]
        if type(loans) is not int or loans < 0:
            return False
        return item["available"] is True and loans < LIMIT and student["overdue"] is False
    except (KeyError, TypeError):
        return False   # fail-safe default: anything we cannot read is refused

def test_normal_loan_is_allowed():
    assert can_borrow({"id": "s1", "loans": 0, "overdue": False}, {"id": "cam-3", "available": True})

def test_third_item_is_refused():
    assert can_borrow({"id": "s1", "loans": 2, "overdue": False}, {"id": "cam-3", "available": True}) is False

def test_overdue_student_is_refused():
    assert can_borrow({"id": "s1", "loans": 0, "overdue": True}, {"id": "cam-3", "available": True}) is False

def test_broken_record_is_refused_not_crashed():
    assert can_borrow({}, {"id": "cam-3", "available": True}) is False

How to read the build record

• ✓ / ✗ under “Your tests”: your own tests. A ✗ there means your code or your test is wrong. Fix one of them.
• ✓ / ✗ under “Course checks”: the rule from the task. Each ✗ says what failed, for example “a student at the limit must be refused”.
• “Known bugs … not caught”: your tests pass, but they would also pass on a buggy version. Add a test that would fail on that bug. Example: delete test_overdue_student_is_refused above and run again; the record says “not caught: an overdue item is ignored”.
• Micro-viva change request: the change you may be asked to make in front of your instructor. Practise it: if you wrote the code yourself, it takes a minute.
• If you cannot fix a failure before the deadline, keep the record and explain the failure honestly in your text. That still earns partial credit; hiding it does not.

5 · New evidence (STRESS) and REFIT

After you commit Part A, the new evidence opens on the page. It is a new fact that tests your boundary. For the practice case, imagine this:

Boundary status

REFIT · RETAIN, REVISE or REPLACE

A well-justified RETAIN earns the same credit as a change. Example: if the evidence had said the copy never failed, RETAIN with that reason is correct.

Final engineering decision record (2–3 sentences)

6 · Declare AI use, sign and submit

AI help is allowed when you declare it. You remain responsible: in the micro-viva you must explain and change your own code.

1. Type your name for human review and tick the attestation.
2. Select Print / PDF (or Download final editable .md if asked), and open the file to check it.
3. Submit the final file in Blackboard before the deadline. Exporting on the site is not submission.

7 · Assignments 6–9: three new things الواجبات 6–9: ثلاثة أشياء جديدة

Same steps, same 5 points. The examples use the practice case, not your assignments. نفس الخطوات ونفس الدرجة. الأمثلة على الحالة التدريبية وليست على واجباتك.

A · What AI may do in each step أ · دور الذكاء الاصطناعي في كل خطوة

✓ “My build says KeyError: 'loans'. What does this error mean?” Then you fix it. ✗ “Write reserve_minutes and three tests for it.”

B · Critique the AI draft ب · انقد مسودة الذكاء الاصطناعي

For each claim in the draft: find the supplied fact that supports it, contradicts it, or says nothing, and write your verdict. This counts inside FIT; then write your own answer.

لكل ادعاء في المسودة: ابحث عن الحقيقة المعطاة التي تدعمه أو تنقضه، واكتب حكمك. هذا جزء من FIT، ثم اكتب إجابتك أنت.

C · The in-class check ج · التحقق في المحاضرة

In-class check · AI-Free. In the lecture after the deadline you answer two short questions on paper, with no devices, about your own submission: a small change to your code (which test fails, and why) and one new fact (does your decision change?). It takes about 10 minutes. Both answers correct: your assignment mark stands. One correct: your mark is halved. Neither: a two-minute conversation with the instructor decides the mark. If you miss that lecture with an accepted excuse, the check is done in office hours. This applies the ownership rule on every assignment: your written work and your own explanation must agree.

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

Two sample questions on the practice build. Answer first, then open:

Prepare: read your submission once more, run your tests and know which test catches which bug, and say your BOUND in one sentence. Declare: name the tool, the steps, what you changed and what you rejected, or write “No AI used.”

استعد: اقرأ ما سلّمته، وشغّل اختباراتك واعرف أي اختبار يكشف أي خطأ، وقل حدود قرارك في جملة. صرّح: اذكر الأداة والخطوات وما غيّرته وما رفضته، أو اكتب “No AI used.”

8 · Questions students ask أسئلة الطلاب