Skip to content

Course class 0.2: what an MES is, and what it is not - #254

Merged
kalwei merged 1 commit into
mainfrom
feat/course-draft2-class-02
Nov 15, 2026
Merged

kalwei merged 1 commit into
mainfrom
feat/course-draft2-class-02

Conversation

@kalwei

@kalwei kalwei commented Nov 15, 2026

Copy link
Copy Markdown
Contributor

What

The second class of the course, draft 2, as a scene file, its lines in course.toml, and tests.

  • scripts/scenes/course/01-02-what-an-mes-is-and-is-not.toml is shaped like 0.1's: a scratch cutlery plant on 127.0.0.1:8040 at 10x. The camera rolls once stacking order WO-STACK07-0001 has completed.
    • Hook: a whiteboard card ("Line FORK1, day shift", with rough counts), then the live floor.
    • Idea: a card with the office system (ERP) above, the machines (PLC / SCADA) below and the MES between them. A second card gives the three things it is not: not the ERP, not the historian, not a spreadsheet.
    • On the screen: the four tiles, then one order followed all the way round: the order detail, its machine, the ERP outbox, and its own workorder.completed line in the audit trail.
    • What it refuses: Watched under the machine cards, a few percent on a plant minutes old. The rest of the window is unknown, counted neither as running nor as stopped.
    • You now know: the three outcomes.
  • scripts/course/course.toml gets 0.2's three outcomes and its scene. Nothing else in the file changes.
  • tests/test_class_0_2_places_the_mes_between_the_office_and_the_machines.py has 15 tests. They check that the scene parses and names 0.2 by label, runs 4–6 minutes, and walks the five parts in order. They also check that every goto is a page the app serves, the badge is there, no caption, card or note carries a date, the plant is on loopback and not on a port somebody else runs, and the know card matches the outcomes word for word.
  • tests/test_a_lesson_is_filmed_into_the_course_tree_and_touches_nothing_else.py used 0.2 as its example of a class with empty outcomes. That one assert now reads the class's own three lines.

Why

The course outline orders the classes 0.1 → 0.2 → 1.3. 0.1 was merged in #251; this is the next class.

How it was checked

  • I looked at every page on a scratch plant before filming and fixed three frames:
    • The outbox's last 20 rows are all machine-state messages, so the caption says so and the facts row stays in view.
    • The audit page filters to workorder.completed and scrolls to the order's own line.
    • The Watched cards sat under the sticky header.
  • Filmed with record-scene.py at 1280×720. Take 2 is 334.4 s (5:34) and has no audio. The badge is in 6,688 of 6,688 mp4 frames and the corner check is clean.
    • I looked at all ten stills. Take 1's order still had the order's figures under the sticky header, and take 2 brings the panel back below it.
  • --course regenerated: 7 modules, 25 lessons, exactly 0.1 and 0.2 recorded. The draft-1 folders and 0.1's folder were checksummed before and after: 58 files, unchanged.
  • The class tests, the record-scene tests and the fast suite pass, except one failure that is not from this change. test_the_calibration_the_supervisor_records_is_on_the_gauges_own_register also fails on clean main when the local date and the UTC date differ (here, after 18:00 Central).
  • namegrep over the diff: 0 hit(s) over 3333 names.

No product code changes.

🤖 Generated with Claude Code

The scene for the second class of draft 2, filmed on a scratch cutlery
plant on loopback at 10x: the whiteboard the MES replaces, the three
layers (the office system above, the machines below, the MES between),
the three things it is not, the four tiles, one stacking order followed
from release to its machine and back up to the outbox and the audit
trail, and the word Watched as the honest beat.

course.toml gets 0.2's three outcomes and its scene, nothing else. The
lesson-tree test that used 0.2 as its example of empty outcomes now
reads the class's own three lines.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: scottkalw <scottkalwei@gmail.com>
@github-actions

Copy link
Copy Markdown

Thanks for the first pull request. Checks: every commit signed off (git commit -s), ruff and pytest green, and the house-rules checklist in the template. The maintainer reviews within a few days.

@kalwei
kalwei merged commit 26fb3f3 into main Nov 15, 2026
28 checks passed
@kalwei
kalwei deleted the feat/course-draft2-class-02 branch November 15, 2026 02:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant