How Richmack Arithmetic became an indefinitely progressing math platform with Flask, Docker, D2 architecture diagrams, Playwright screenshots, and automated deployment.

Building Richmack Arithmetic: Infinite Progression, Playwright, and D2 Architecture

Richmack Arithmetic has evolved from a fixed twelve-module math application into an indefinitely progressing learning platform with automated deployment, architecture-as-code, and live production documentation.

Unlimited Progression

The original curriculum contained twelve modules. The new progression model keeps those twelve core skills but repeats them across unlimited levels.

Level 1: Modules 1–12
Level 2: Modules 1–12
Level 3: Modules 1–12
Level N: Modules 1–12

Internally, module IDs continue sequentially, so existing student progress remains compatible while progression can continue indefinitely.

Unlimited level progression

Production Architecture

Richmack Arithmetic runs as a deployed Flask application behind NGINX and Docker, with SQLite handling student progress and GitHub Actions handling deployment.

Richmack Arithmetic architecture

The live application is available at:

https://richmath.richmackos.com

CI/CD Pipeline

Changes pushed to the main GitHub branch move through the deployment workflow and into the production environment.

Richmack Arithmetic CI/CD pipeline

This creates a repeatable path from local development to production deployment.

Live Product Documentation with Playwright

Playwright is used to capture screenshots directly from the deployed application.

Student Dashboard

Student dashboard

Module Lesson

Module lesson

Parent Portal

Parent portal

Administration

Admin portal

The screenshots are captured from the live production application rather than from mockups.

Architecture as Code

The architecture diagrams are maintained as D2 source files inside the repository. This keeps the system design version-controlled alongside the application source.

The result is a documentation pipeline where architecture diagrams, live application screenshots, source code, and deployment automation all evolve together.

Production Validation

The Playwright documentation run also exposed a production edge case involving historical score records containing null values. That issue was fixed and the production routes were verified again.

The main authenticated routes now return HTTP 200:

/dashboard
/module/1
/parent
/admin

What Changed

Richmack Arithmetic now includes:

unlimited 12-module level progression
scaling arithmetic difficulty
Flask application architecture
Docker deployment
NGINX reverse proxying
AWS Lightsail hosting
GitHub Actions deployment
D2 architecture diagrams
Playwright production screenshots
parent and admin reporting
automated documentation assets

The application no longer stops after the first twelve modules. Students can continue into Level 2, Level 3, Level 100, and beyond.