Blame

ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1
> **DRAFT** — under teacher review.
2
3
# What Is an Entity? (It's Not Just a Person)
4
5
Hamilton College · Year 12 · 2026
6
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
7
On context diagrams and data flow diagrams, students frequently draw only the humans they can think of — *"Student"*, *"Teacher"* — and miss every external system their software talks to. Missing an entity is a rubric error at every level above 3–4, because the rubric rewards *"relationships between the existing system, entities and data flows"*.
8
9
> [!TIP]
10
> If your context diagram only has *people* as entities, you've almost certainly missed half of them. Every login, every email, every external API your project touches is its own entity.
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
11
12
---
13
14
## The VCAA definition
15
16
> **Entity** — the users or external systems that interact with the system being created.
17
18
Two words matter: **users** (human roles) and **external systems** (non-human). Both go on your context diagram as rectangles.
19
20
---
21
22
## Types of entity — with examples
23
24
| Type | What it is | VCE SAT examples |
25
|---|---|---|
26
| **Human user (primary)** | The person the software is primarily built for | Student, Teacher, Administrator |
27
| **Human user (secondary)** | A person affected by the system's outputs | Parent, School Principal |
28
| **External software system** | An API, platform, or service your system sends data to or receives data from | Google Calendar API, Payment Gateway, Email Server |
29
| **External data source** | A data feed or file system outside your application boundary | School database, CSV import, Government open data |
30
31
---
32
33
## A quick test: is it an entity?
34
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
35
::: success
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
36
Ask three questions:
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
37
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
38
1. Does it send data **into** my system, or receive data **out** of it?
39
2. Is it **outside** the boundary of the software I am building?
40
3. Is it a **distinct role or system** (not an internal component of my software)?
41
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
42
If all three answers are *"yes"* — it is an entity. Add it to your diagram.
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
43
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
44
If it is *inside* your system (a function you are writing, a class in your code, a database table your code owns) — it is **not** an entity. It belongs on the DFD as a process or data store.
45
:::
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
46
47
---
48
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
49
::: danger
50
**Commonly missed entities — by project type**
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
51
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
52
These are the entities students most often miss. Check whether *any* apply to your project before submitting.
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
53
54
| Project type | Commonly missed entity | Why it is missed |
55
|---|---|---|
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
56
| Any project with login | Authentication provider (e.g. Google OAuth) | Students think login is *"inside"* their app |
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
57
| Any project that emails users | Email server / SMTP service | Students don't model outgoing system calls |
58
| School management tool | Admin user or IT department | Students only think about the primary user |
59
| App using external data | External database or API (e.g. weather API) | Students model the API as a feature, not an entity |
60
| App with notifications | Push notification service | Treated as internal, but it is external |
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
61
:::
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
62
63
---
64
65
## User stories → entities: the reliable method
66
67
Your `data-collection-plan.md` user stories are the best source of entities. For each story:
68
69
- **"As a [role]"** → that role is probably an entity (if they interact with your system directly).
70
- **"I want [goal] so that [benefit]"** → what external systems does achieving this goal require? Each one is a candidate entity.
71
72
Work through every user story before finalising your context diagram.
73
74
---
75
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
76
::: info
77
**Why VCAA cares**
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
78
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
79
The C2-2 rubric at **5–6** requires *"illustrates the relationships between the existing system, entities and data flows"*. *"Some errors or omissions exist"* is still acceptable at 5–6. But at **9–10**, *"no errors, inconsistencies or omissions exist"* — a missing entity **is** an omission, and omissions cost you the top band.
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
80
cfcd0d lisa 2026-04-28 16:18:08
C02: add OtterWiki blocks to remaining 3 pages for visual rhythm Brings the rest of /sd/C02 in line with Context Diagram, Data Collection Methods, and Excalidraw Starters (which already use blocks). CD vs DFD: - TIP at top: count-the-circles quick test - DANGER blocks wrap each 'common mistakes' section (CD + DFD) - SUCCESS block for the mental check before submit - INFO block for the rubric stake (Why VCAA cares) Explaining vs Describing: - TIP at top: circle every 'because' in your plan - SUCCESS block highlights the explaining-sentence formula - DANGER block wraps the common traps - INFO block for Why VCAA cares (examiner-asks-follow-up framing) What Is an Entity: - TIP at top: only-people = missed half - SUCCESS block for the 3-question entity test - DANGER block wraps commonly-missed-entities table - INFO block for Why VCAA cares (5-6 vs 9-10 omissions)
81
The most common C2-2 omission flagged in past years: the **email server or notification service** that every project needs but few students draw.
82
:::
ef4237 lisa 2026-04-25 22:18:29
Add C02 wiki content (DRAFT) — landing page, key-concept pages, Resources Builds out C02 (Data Collection & Analytical Diagrams). Adds C02-home, 3 new key-concept pages (DRAFT for teacher review tomorrow), external resource rows in C02-Resources.md, and a Hub link to C02-home. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
83
84
---
85
86
## See also
87
88
- [Context Diagram vs Data Flow Diagram](/sd/C02/Context%20Diagram%20vs%20Data%20Flow%20Diagram)
89
- C02 Resources: [external reading and videos](/sd/Resources/C02-Resources)
90
91
---
92
93
← Back to [VCE Software Development Hub](/sd/VCE%20Software%20Development%20Hub)