Documentation

Hub

Money Quiz Architecture

A complete, dated architecture reference for the Money Quiz product as it exists in production today. Covers:

01

01. System overview

This section is the orientation for engineers new to the system. It defines the three actors, the network topology, and the key concepts the rest of the document assumes.

02

02. Tenancy model

How tenancy works at every layer: database, gateway, public app, dashboard, WordPress bridge. Every per-tenant feature uses one of the patterns described here.

03

03. Format taxonomy

The five canonical Money Quiz formats, their IDs, slugs, URLs, aliases, scoring paths, and how to add a new one. Reflects the post-rename state as of 2026-05-18 (C-phase complete).

04

04. Configuration schema

The full Postgres schema for every per-tenant configurable surface. Reflects state after migration 0009 (2026-05-19).

05

05. Configuration flow

How a config change in the dashboard reaches the running quiz, and how long it takes.

06

06. Scoring + calibration

How archetype scores are computed, calibrated, and finalised across all five formats. Reflects post-D-phase state (2026-05-19) where calibration parity is achieved end-to-end.

07

07. Quiz app runtime

How the public quiz Next.js app (`moneyquiz-app`) resolves the tenant, applies theming, threads brand identity through client components, and serves the 5 formats. As of v1.6.6 (2026-05-19).

08a

08a. Analytics — MMC WordPress

The customer-facing analytics surface that Ilana uses today. Lives entirely in MMC's WordPress, sourced from a webhook + GA4. Pre-dates the CoachPilot platform analytics — the two coexist.

08b

08b. Analytics — CoachPilot platform

The platform-side analytics surface in the CoachPilot dashboard. Today: aggregate KPIs across all tenants. Planned: per-tenant Sessions drilldown.

09

09. MMC ↔ CoachPilot bridge

How MMC's WordPress site and the CoachPilot gateway talk to each other. Two directions, two secret patterns, one shared protocol.

10

10. Deployment

Image taxonomy, registry conventions, kubectl recipes, and rollout patterns. Everything you need to ship a change.

11

11. Operations

Runbooks for routine operations and incident recovery. Read this when something breaks.

12

12. Security

Authentication, authorization, secrets, audit, and Swiss data-protection considerations.

13

13. Open / deferred

What's not done, what's intentionally postponed, what the future-work backlog looks like. Updated 2026-05-19.

Roadmap

Money Quiz Roadmap

A prioritised, dated backlog of work remaining on the Money Quiz platform after the 2026-05-19 bundle (Tracks B, C, D, A, plus polish + post-shipment fixes). Each item has: