docs: handbook, diagrams and guides brought up to 2026-10-02

Browse Source

- technical-handbook: question packs instead of subscriptions, real
  hearts with the new wait screen (screenshot), math-only tutor and what
  is charged (new 9-7), admin cancel/refund, Bazaar planId, account
  deletion, 59 endpoints, 779 tests, 14 apps, status and open decisions.
- Diagrams redrawn: use-case (buy a pack, refunds), data model
  (QuestionCredit, HeartsPass, Profile.birth_date), pack payment sequence.
- The PDF is now built from the Markdown by docs/build_handbook.py
  (pandoc + Chrome, font in docs/assets); the hand-made HTML it used to
  come from was not in the repo and had been lost.
- architecture, operations, security-before-production (item 13 closed),
  ai-cost-and-guardrails and README follow the same changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

...

This commit is contained in:

Zareian

2026-10-02 23:10:50 +03:30

parent 8a4753bd15

commit 7683920b0b

13 changed files with 196 additions and 55 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

BIN

docs/images/technical-handbook/relational-model-er.png

Binary file not shown.

Side by Side Swipe Overlay Before Width:  |  Height:  |  Size: 346 KiB After Width:  |  Height:  |  Size: 365 KiB

BIN

docs/images/technical-handbook/scenario-subscription-payment.png

Binary file not shown.

Side by Side Swipe Overlay Before Width:  |  Height:  |  Size: 226 KiB After Width:  |  Height:  |  Size: 224 KiB

BIN

docs/images/technical-handbook/screenshot-06-no-hearts.jpg Normal file

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 147 KiB

BIN

docs/images/technical-handbook/use-case-model.png

Binary file not shown.

Side by Side Swipe Overlay Before Width:  |  Height:  |  Size: 212 KiB After Width:  |  Height:  |  Size: 214 KiB