Blame

32da77 lisa 2026-04-27 19:40:38
Add C02 Context Diagram wiki page Anchored to C022-Lesson-Context-Diagram.md. Embeds Mark O'Meara (VCE) and Christopher Kalodikis (HSC) videos as Watch-first. Reuses Sales Order System worked example as ASCII art.
1
> **DRAFT** — under teacher review.
2
3
# Context Diagram
4
5
Hamilton College · Year 12 · 2026
6
7
A context diagram is the **highest-level** view of your software system: one shape for the whole system, the external entities it talks to, and the named data flows between them. Nothing inside, nothing extra. It is the diagram that defines the **scope** of what you are building — and it is the foundation every later diagram (Level-1 DFD, use case) must stay consistent with.
8
9
---
10
11
## Watch first (≈5 min total)
12
13
{{Video|src=https://www.youtube.com/watch?v=PKWCogQ8v7U}}
14
15
*Mark O'Meara (Geelong High School) — 1½-min VCE-targeted revision. Frames the context diagram as a **Level 0 DFD** using the Yourdon-DeMarco notation you'll use in C2-2. Watch for: one circle in the middle, entities outside, no internals.*
16
17
{{Video|src=https://www.youtube.com/watch?v=fWNrc6GNK14}}
18
19
*Christopher Kalodikis (Maximum Education, HSC) — 3-min overview building the intuition. Watch for: the **purpose** (showing inputs/outputs at a glance), why every external entity must have at least one labelled flow, and what counts as "external".*
20
21
---
22
23
## Why a context diagram
24
25
Think of it as a **satellite view** of your software. You can see the system's outline and everything crossing its boundary, but not what's happening inside.
26
27
It does four jobs:
28
29
- **Defines scope** — what's part of your system, and what isn't
30
- **Identifies stakeholders** — every external entity that interacts with the system
31
- **Visualises data exchanges** — every input and output, named
32
- **Anchors later diagrams** — your Level-1 DFD must show the same entities and flows
33
34
If you can't draw a clean context diagram for your project, you don't yet know what you're building.
35
36
---
37
38
## The three elements
39
40
| Element | Symbol | Rules |
41
|---|---|---|
42
| **The system** | One circle (Yourdon-DeMarco) | Exactly **one** — the whole system. Named after the system itself (e.g. *Sales Order System*, *Library Loans*). |
43
| **External entities** | Rectangles outside the circle | People, organisations, or other systems that interact with yours. Examples: *Customer*, *Administrator*, *Payment Gateway*, *Email Server*. |
44
| **Data flows** | Labelled arrows | Every arrow names the **specific data** crossing the boundary. Direction shows whether data goes in or out. |
45
46
What's **not** allowed on a context diagram:
47
48
- More than one process circle (that's a DFD — see [Context Diagram vs Data Flow Diagram](Context%20Diagram%20vs%20Data%20Flow%20Diagram.md))
49
- Data stores (no parallel-line rectangles at this level)
50
- Arrows between two entities (every flow must touch the system circle)
51
52
---
53
54
## Worked example: Sales Order System
55
7a13b1 lisa 2026-04-27 19:58:04
Context Diagram: replace ASCII worked example with mermaid ASCII layout was inaccurate due to text-grid limits. Mermaid flowchart renders the Yourdon-DeMarco notation cleanly and matches existing wiki precedent (C01 Problem-Solving Methodology).
56
```mermaid
57
flowchart LR
58
M[Managers]
59
E[Employees]
60
C[Customers]
61
S(("Sales Order<br/>System"))
62
63
M -->|New Employee| S
64
S -->|Employee Lists| M
65
S -->|Vendor & Product-vendors| M
66
E -->|Updates Employee| S
67
E -->|Product & Category| S
68
C -->|Customer details| S
69
C -->|Order & Order-line| S
70
S -->|Order & Order-line| C
71
S -->|Order Invoices| C
32da77 lisa 2026-04-27 19:40:38
Add C02 Context Diagram wiki page Anchored to C022-Lesson-Context-Diagram.md. Embeds Mark O'Meara (VCE) and Christopher Kalodikis (HSC) videos as Watch-first. Reuses Sales Order System worked example as ASCII art.
72
```
73
74
**Read it like this:**
75
76
- **The system** (centre): *Sales Order System*
77
- **External entities**: *Managers*, *Employees*, *Customers* — all rectangles outside the circle
78
- **Data flows**:
79
- **Managers → System**: New Employee
80
- **System → Managers**: Employee Lists, Vendor and Product-vendor info
81
- **Employees → System**: Updates Employee, Product and Category
82
- **Customers → System**: Customer details, Order and Order-line
83
- **System → Customers**: Order Invoices
84
85
Notice what is **not** shown: how the system stores employees, how it validates an order, how it produces an invoice. Those are internal — they belong on the Level-1 DFD, not here.
86
87
---
88
89
## How to draw one
90
91
1. **Name the system.** What are you building? That name goes inside the single circle.
92
2. **List external entities.** Who or what interacts directly with the system? Include only **direct** interactions — if Entity A only talks to Entity B (and never to your system), A doesn't belong here.
93
3. **Name every data flow.** Walk through each entity in turn: what specific data does it send in? What does the system send back? Use specific labels (*"payment details"*, not *"information"*).
94
4. **Check completeness.** Every entity should have at least one arrow connecting it to the system. Every arrow should be labelled. No entity should connect directly to another entity.
95
96
---
97
98
## Most common mistakes
99
100
1. **Drift toward a DFD** — adding a second circle (e.g. "Verify User") inside the system. If there's more than one circle, it's no longer a context diagram.
101
2. **Unlabelled arrows** — *"data"* or *"info"* is not a label. Name the actual data.
102
3. **Entity-to-entity arrows** — every flow must touch the system. If two entities exchange data without your system involved, that exchange isn't on this diagram.
103
4. **Missing entities** — forgetting downstream systems (email server, payment gateway, reporting tool) that your system sends data to.
104
5. **Inventing detail** — showing data stores or internal logic. Save those for the Level-1 DFD.
105
106
---
107
108
## Self-check
109
9287c9 lisa 2026-04-27 20:34:08
Context Diagram: add click-to-reveal answers in Self-check Use OtterWiki spoiler blocks (>!) so students attempt each MCQ before revealing the answer + a one-sentence rationale.
110
Test yourself before moving on. Answer in your head first, then click the spoiler to check.
32da77 lisa 2026-04-27 19:40:38
Add C02 Context Diagram wiki page Anchored to C022-Lesson-Context-Diagram.md. Embeds Mark O'Meara (VCE) and Christopher Kalodikis (HSC) videos as Watch-first. Reuses Sales Order System worked example as ASCII art.
111
9287c9 lisa 2026-04-27 20:34:08
Context Diagram: add click-to-reveal answers in Self-check Use OtterWiki spoiler blocks (>!) so students attempt each MCQ before revealing the answer + a one-sentence rationale.
112
**1.** Which of these is **not** a component of a context diagram?
113
*(a) process · (b) entity · (c) data flow · (d) data store*
32da77 lisa 2026-04-27 19:40:38
Add C02 Context Diagram wiki page Anchored to C022-Lesson-Context-Diagram.md. Embeds Mark O'Meara (VCE) and Christopher Kalodikis (HSC) videos as Watch-first. Reuses Sales Order System worked example as ASCII art.
114
9287c9 lisa 2026-04-27 20:34:08
Context Diagram: add click-to-reveal answers in Self-check Use OtterWiki spoiler blocks (>!) so students attempt each MCQ before revealing the answer + a one-sentence rationale.
115
>! **(d) data store.** Data stores belong on the Level-1 DFD, not the context diagram. At Level 0 the whole system is a single black box — its internal storage is hidden.
32da77 lisa 2026-04-27 19:40:38
Add C02 Context Diagram wiki page Anchored to C022-Lesson-Context-Diagram.md. Embeds Mark O'Meara (VCE) and Christopher Kalodikis (HSC) videos as Watch-first. Reuses Sales Order System worked example as ASCII art.
116
9287c9 lisa 2026-04-27 20:34:08
Context Diagram: add click-to-reveal answers in Self-check Use OtterWiki spoiler blocks (>!) so students attempt each MCQ before revealing the answer + a one-sentence rationale.
117
**2.** In a context diagram, which statement is correct?
118
*(a) Entities can connect directly to other entities · (b) Data flows can only connect entities to the system process · (c) Multiple processes can be shown · (d) All flows must be unidirectional*
119
120
>! **(b) Data flows can only connect entities to the system process.** Every arrow must touch the system circle. Entity↔entity flows are never allowed; (c) describes a DFD, not a context diagram; (d) is false — a flow can be bidirectional if data moves both ways.
121
122
**3.** You're drawing a context diagram for a Library Management System. How should *"borrowing a book"* appear?
123
*(a) An entity labelled "Borrowing" · (b) A process inside the system · (c) A data flow labelled "Book borrowing request" from Borrower to the system · (d) A rectangle showing the book collection*
124
125
>! **(c) A data flow labelled "Book borrowing request" from Borrower to the system.** Borrowing is an *action*, not an entity or a thing. On a context diagram, actions surface as labelled data flows. (b) would be a process — but the context diagram has only one process (the whole system).
32da77 lisa 2026-04-27 19:40:38
Add C02 Context Diagram wiki page Anchored to C022-Lesson-Context-Diagram.md. Embeds Mark O'Meara (VCE) and Christopher Kalodikis (HSC) videos as Watch-first. Reuses Sales Order System worked example as ASCII art.
126
127
---
128
129
## See also
130
131
- [Context Diagram vs Data Flow Diagram](Context%20Diagram%20vs%20Data%20Flow%20Diagram.md) — when you move to Level 1, what changes and what stays the same
132
- [What Is an Entity](What%20Is%20an%20Entity.md) — entities aren't only people; non-human systems count
133
- [Excalidraw Diagram Starters](Excalidraw%20Diagram%20Starters.md) — pre-framed canvases for rehearsing all three diagrams under timed conditions