Knowledge Achievements — Learning Tracker

Reference documentation for the Knowledge Achievements badge system on ResistanceZero: a learning-journey tracker that awards engineering knowledge badges as users engage with calculators, virtual labs, and technical articles. This page documents the badge categories, the progress state model, and which tools and articles trigger each badge — it is a navigational reference hub with no calculation engine.

Type Learning Tracker Domain Knowledge & Development Engine None — reference only

▶ Open Knowledge Achievements

01 Purpose & scope

The Knowledge Achievements tracker is a gamified learning-progress system layered on top of the ResistanceZero engineering toolkit. Each time a user completes a meaningful interaction — running a calculator with real inputs, completing a virtual-lab scenario, or reading a full technical article — the system awards a domain badge that accumulates in a persistent progress profile stored client-side.

Badges are organised by engineering pillar (Cooling, Power, Fire Safety, Standards, Sustainability, Finance, Operations) and by proficiency level (Explorer, Practitioner, Specialist, Expert). The state model is append-only: once a badge is earned it is never revoked. Progress is stored in localStorage under the key rz_achievements as a JSON array of earned badge IDs with ISO 8601 timestamps.

02 What this hub links to

Knowledge Achievements Tracker — live badge dashboard: earned badges, progress by pillar, next badge recommendations
DC Solutions Hub — all calculators, labs, and articles that award badges
Technical Manuals Index — methodology manuals (reading a full manual awards a Practitioner badge in that domain)
Technical Journal — technical articles (completing an article awards Explorer or Practitioner badges)
Standards LTC Virtual Lab — lab completion awards Standards Specialist badge

No calculation engine on this page. This is a curated navigation hub — it aggregates articles and tools; it performs no calculation. For calculation methodology, see the linked calculator manuals above.

03 Badge state model & references

State storage — localStorage.rz_achievements: JSON array of { id, awardedAt, source } objects. Append-only; never mutated or deleted by the system.
Badge ID format — {pillar}-{level} e.g. cooling-explorer, fire-specialist, power-expert. Pillar codes: cooling | power | fire | standards | sustainability | finance | ops.
Progress tiers — Explorer (1 interaction), Practitioner (3 interactions in pillar), Specialist (complete a methodology manual + lab), Expert (complete full pillar suite including advanced calculator).
Awarding triggers — Calculator run with non-default inputs (min 3 fields changed), virtual-lab scenario completion, full article scroll (≥80% read), methodology manual page visit ≥90 s dwell.
No server-side component — all badge state is client-local. Authenticated users (Supabase session) may sync to profiles.achievements JSONB column via the save-achievements RPC (planned feature). See standarization/AUTH_STANDARD.md.