Ferrugo

Architecture

Three views of the span

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 the playground. The documents sit beside that path.

VisitorReads, then answersLessonsStart page and /furtherOne program eachChecksAnswered on the pageGraded in the browserDocumentsVision, architectureRelease notesRust playgroundplay.rust-lang.orgOnly after Try it

Logical

Lesson files feed two pages. Each page grades a check and builds a playground 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 explanationPlayground linkEdition 2024The same snippet

Physical

A static host stores the files. The browser grades checks. The Rust playground compiles a program only after Try it.

Static hostferrugo.aathira-services.comHTML, CSS, JSNext.js static exporthero-bg.jpgRusted iron bridgeNo compilerNo account, no databaseBrowser tabWhere a check is gradedLesson pagesStart and /furtherChecksThe answer stays hereNothing storedRefresh keeps the lessonsPlaygroundplay.rust-lang.orgrustcStable, edition 2024Only on Try itThe snippet leaveswhen the visitor asksfilesTry it

Ferrugo 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 the official Rust playground and does not compile 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 free static export on GitHub Pages at ferrugo.aathira-services.com. The domain serves the files from its root, so the build does not prefix assets with /Ferrugo. 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.