Serpens

Architecture

Three views of the room

Conceptual, logical, and physical. The summary under the drawings is the same Summary section kept in the repository.

Conceptual

A visitor reads a lesson, answers a check, and may open Python Tutor. The documents sit beside that path.

VisitorReads, then answersLessonsStart page and /furtherOne program eachChecksAnswered on the pageGraded in the browserDocumentsVision, architectureRelease notesPython Tutorpythontutor.comOnly after Try it

Logical

Lesson files feed two pages. Each page grades a check and builds a Python Tutor link. The documents feed the reading pages.

Lesson fileslessons.ts, further.tsChapter, program, checksdocs markdownSummary sectionThree Mermaid viewspackage.jsonVersion chipCHANGELOG.mdLesson pages/ the short path/furtherReading pages/language/vision, /architecture/releasesFull changelogCheck graderCompares the choiceShows the explanationPython Tutor linkPython 3.11The same snippet

Physical

A static host stores the files. The browser grades checks. Python Tutor runs a program only after Try it.

Static hostFiles from the site rootHTML, CSS, JSNext.js static exporthero-bg.jpgA pythonNo interpreterNo account, no databaseBrowser tabWhere a check is gradedLesson pagesStart and /furtherChecksThe answer stays hereNothing storedRefresh keeps the lessonsPython Tutorpythontutor.comPython 3.11Runs the snippetOnly on Try itThe snippet leaveswhen the visitor asksfilesTry it

Serpens is a static Next.js site. The short path lives in content/lessons.ts and renders on /. The later lessons live in content/further.ts and render on /further. The browser compares a chosen answer with the lesson's answer and shows the explanation. Try it builds a link to Python Tutor and does not run anything here.

/language is a reading page: origins, comparisons, reasons to choose the language, and where it is used. /vision and /architecture read the Summary section of the two documents at build time. /releases renders CHANGELOG.md. The header chip reads the version from package.json.

Hosting is a static export. The files are served from the site root, so the build does not prefix assets. There is no database and no paid API. The pictures on the architecture page are the conceptual, logical, and physical views. The Mermaid diagrams later in this document are the same three views, and they change together.