SpiralClass
A scheduling, payments and video platform for independent teachers of any
subject. It runs in production at spiralclass.com
on live payment rails, with a teacher and her students using it, and this
repository is the whole of it.
A teacher signs up, sets her availability, publishes a booking page, and sells
packages of classes. Her students buy a package, book slots against it, join
the lesson in the browser, and get homework and materials afterwards. She gets
paid — either by card through her own Stripe account, or by Wise transfer
against instructions the platform generates and reconciles. Nobody installs
anything.
The real teacher dashboard, captured locally from the
/demo fixture. The public page draws the
production component from invented data rather than opening a demo account
(D-142). No real person, class or figure
appears in it.
Where to start
[!NOTE]
How this repository was built. SpiralClass was built by one person working
with AI coding agents; most of the code was agent-written under review. The
public history starts from a sanitised working-tree snapshot
(why); every change since lands here
as a pull request.
Why this repository is public
It is published as an honest record of how one engineer builds and runs a
payments-handling, video-carrying SaaS product alone: the architecture, the
decisions, the things that went wrong, and the mechanisms built so they would
not go wrong twice. The engineering decisions in
docs/decisions/ are the most useful thing here —
several of them reverse an earlier one and say why.
No code was simplified, staged or rewritten for presentation. What you are
reading is what serves production. The decision log is curated, and says so:
records were removed before publication, numbers were never reused, and
the index says which groups went and why.
This is a live system, and it is also small: a solo-built product with a
customer base measured in individuals, not thousands. There is no team, no
on-call rotation, and no uptime SLA. The engineering is sized for correctness
and for one person being able to hold it in their head — not for scale it does
not have.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
