MIL-002 Lecture Steps
Metadata
| Key |
Value |
| ID |
MIL-002 |
| CrossReference |
BC-001 |
| Language |
en |
| Domain |
it |
Version History
| Date |
Status |
Author |
Reviewer |
Change |
Commit |
| 2026-11-06 |
Accepted |
Jens Tirsvad Nielsen |
AI as stand-in for S01 |
Initial version |
42b3a09 |
Purpose
Decide whether the Day 55 lecture material (routes, URL variables, HTML rendering, decorators) is implemented, tested and readable, so the final game can reuse it.
Deliverable
One small module per lecture step under src/higher_lower/lectures/, each runnable on its own, with the assignment's function names, plus pytest tests for each.
Go / No-Go Criteria
| # |
Criterion (objectively checkable) |
Go |
No-Go |
| 1 |
The URL-path step serves /, /bye and /username/<name> with debug mode available |
Yes |
No |
| 2 |
The HTML step returns an <h1> with inline CSS, a paragraph and an image |
Yes |
No |
| 3 |
make_bold, make_emphasis and make_underlined wrap text in <b>, <em> and <u> |
Yes |
No |
| 4 |
is_authenticated runs the function only for a logged-in User, using *args and **kwargs |
Yes |
No |
| 5 |
Tests for every step pass |
Yes |
No |
| 6 |
Docstrings use Doxygen comments |
Yes |
No |
Dependencies
| Depends on |
Reason |
| MIL-001 |
Needs the project skeleton and constants |
Traceability
| Business Case objective / KPI / user story |
Reference |
| Objectives 3 and 4 |
BC-001 |
Ownership
| Role |
Stakeholder ID (SA) |
| Owner |
S01 |
| Approving reviewer |
S01 |
Target Date
2026-11-10 — follows MIL-001 within the Business Case's few-day effort.
Tasks
| # |
Task |
Summary |
Needs its own Use Case/User Story? |
Reference |
| 1 |
Implement URL paths and variable routes step |
Build the lecture's Flask app with routes /, /bye and /username/<name> (with a converter such as <int:number>), runnable in debug mode, so S02 can see how Flask parses URL paths. |
No |
|
| 2 |
Implement HTML rendering step |
Return an <h1> with inline CSS centring, a paragraph and images (a still image and a GIF with a width attribute) from a route, showing that Flask returns HTML strings. |
No |
|
| 3 |
Implement make_bold, make_emphasis and make_underlined |
Write the three decorators with the assignment's names and apply them to the /bye route, so HTML tags are added without repeating them in each function. |
No |
|
| 4 |
Implement is_authenticated with *args and **kwargs |
Write the User class and the is_authenticated decorator that reads the first positional argument, so a blog post can be created only by a logged-in user. |
No |
|
| 5 |
Test the lecture steps with pytest |
Write pytest tests with the Flask test client for each step, with no network access, so the behaviour is proven. |
No |
|
