Worked example · Computer Science · Year 8

Reading a brief for a canteen ordering app

LNF: Literacy → Reading → Reading strategies

What this is

A complete, secure Year 8 answer, annotated so you can see which success criterion each part meets. It is also the answer key. The brief has 8 must requirements, 3 should requirements and 2 could requirements. Pupils may argue that Welsh and English is a must in a bilingual school: accept this if they give that reason. The most common mistake is listing background facts, such as “820 pupils”, as requirements.

Step 1: skim for gist

QuestionAnswer
Who is the client?Mrs Bethan Lloyd, the canteen manager at Ysgol Cwm Ogwr.
What does she want?An app for pupils to order lunch in the morning and collect it.
What problem will it solve?The lunch queue is too long, so some pupils have little time to eat or miss lunch.

First sentences of paragraphs usually carry the main idea, so skimming them is enough for the gist. Evidences criterion 1.

Step 2: scan for details

QuestionAnswerParagraph
How many pupils are in the school?820P1
What time do orders close?10:30P3
How many extras can one pupil order?Up to 2P3
What is the most a free school meals deal can be worth?£2.60P4
When does the kitchen need its list?10:35P7
When should the first version be ready?By EasterP8

Numbers and times stand out on the page, so they are quick to scan for. Giving the paragraph proves where the fact came from. Evidences criterion 2.

Step 3: close reading

MustShouldCould
Work on school tablets and pupils’ phones (P2)
Close orders at 10:30 (P3)
Allow 1 main and up to 2 extras (P3)
Show each price and the total before confirming (P3)
Check the dinner account has enough money (P4)
Let free school meals pupils order a deal up to £2.60 without paying (P4)
Show vegetarian, vegan and the 14 allergens on every item (P5)
Give the kitchen a count of each item per sitting at 10:35 (P7)
Be quick and easy to use, especially for Year 7 (P6)
Work in Welsh and English (P6)
Show the most popular meals each week (P7, “I would like”)
Show photos of the food (P6)
Save a favourite order (P6)

(b) Background: the school has 820 pupils and two sittings at 12:10 and 12:50 (P1). 64 pupils missed lunch last term (P1). The programmer still needs these facts: the app must cope with up to 820 orders a day, and it must know which sitting each pupil is in so the kitchen list can be split.

The client’s own words decide the column: must, should, would be nice, I would like. The answer explains why background still matters to the design. Evidences criteria 3 and 4.

Step 4: inputs, processes and outputs

InputsProcessesOutputs
Pupil log-in or name
Main meal choice
Up to 2 extras
Language choice
Confirm button
Check the time is before 10:30
Check no more than 2 extras
Add up the total
Check the account balance
Check free school meals and the £2.60 limit
Count each item per sitting
Menu with prices and allergen labels
Total before confirming
“Order accepted” or an error message
Kitchen list at 10:35
Weekly popular meals report

Each process is a check or a calculation the code will have to do. This is the bridge from reading to programming.

Step 5: questions for the client

(a) “easy to use” (P6): easy for whom, and how will we know? “The budget is small” (P8): how much money is there? “extras” (P3): is fruit, yoghurt and a drink the full list?

(b)

  1. What should happen if a pupil orders a meal and is then absent: do they get their money back?
  2. Can a pupil change or cancel an order before 10:30?
  3. What should the app do if a free school meals pupil chooses items that add up to more than £2.60?

(c) The Year 10 pupil says their phone is on 5% by lunchtime. New idea: the app must not depend on the phone at collection time, so the counter should find the order by name or a printed list, not by showing a code on the phone.

Every question is about a gap in the brief, not something already answered in it. Part (c) reads the pupil comments for an idea the client did not mention. Evidences criterion 5.

Step 6: the requirements checklist (model)

  1. The app runs on the school tablets and on pupils’ phones.
  2. The app stops taking orders at 10:30.
  3. The app lets a pupil choose 1 main meal and no more than 2 extras.
  4. The app shows the price of each item and the total before the pupil confirms.
  5. The app refuses an order if the dinner account does not have enough money.
  6. The app lets a free school meals pupil order a meal deal up to £2.60 without paying.
  7. The app labels every item as vegetarian or vegan where true, and lists any of the 14 allergens it contains.
  8. The app produces a count of each item for each sitting at 10:35.
  9. The app can be switched between Welsh and English.
  10. The app shows the most popular meals for each week.
  11. A Year 7 pupil can place an order in under 1 minute (to be agreed with the client).
  12. The app could show a photo of each item and let a pupil save a favourite order.

Every item starts “The app”, is short, and can be tested with a yes or no. Item 11 turns the vague “quick and easy” into something measurable and flags that the client must agree it. Evidences criterion 6.

If you finish early: answers

Why this response is secure