Skip to content

Add private per-child learning map and logbook - #15

Open
baditaflorin wants to merge 2 commits into
withmarbleapp:mainfrom
baditaflorin:codex/child-progress-explorer
Open

Add private per-child learning map and logbook#15
baditaflorin wants to merge 2 commits into
withmarbleapp:mainfrom
baditaflorin:codex/child-progress-explorer

Conversation

@baditaflorin

@baditaflorin baditaflorin commented Jul 11, 2026

Copy link
Copy Markdown

Summary

This contribution turns the taxonomy into a browser-only learning companion while keeping all learner data private and separate from the dataset.

  • add a dependency-free graph explorer for all 1,590 concepts and 3,221 prerequisite edges
  • add versioned profiles with independent progress for multiple children
  • ask for a child name once and substitute it automatically into all 1,590 assessment prompts
  • support not-started, learning, known, and evidence-assessed states
  • add search, subject, age, and known-concept filters, including dim/hide/only modes
  • add a gamified Logbook view with learning points, next adventures, subject journeys, a searchable status ledger, and a chronological activity trail
  • add profile rename, deletion, and confirmed progress reset controls

Architecture

The explorer is a static ES-module application with no build step or runtime dependencies. Taxonomy loading/indexing, canvas rendering, recommendation and logbook calculations, and local profile persistence are separate modules.

The persistence schema migrates existing version 1 profiles to version 2 and retains the latest 500 activity events per profile. Everything stays under the browser-only localStorage key marble-taxonomy:learner-profiles. A server-backed adapter can replace this module later without changing graph or taxonomy code.

Recommendations only surface concepts whose hard prerequisites are complete, prioritizing topics already in progress and concepts unlocked by mastery.

Live demo

https://baditaflorin.github.io/os-taxonomy/explorer/

Verification

  • npm test — 11 passing tests covering multi-profile isolation, migration, persistence, chronological activity, assessment preservation, reset, progress summaries, subject journeys, prerequisite-aware recommendations, logbook filters, graph indexes, and prompt substitution
  • npm run validate — existing validation passes for 1,590 topics, 3,221 dependencies, 3,261 standards, and 183 clusters
  • manually verified the Graph and Logbook flows, name-once management, automatic prompt personalization, learning and known transitions, activity history, search/filter behavior, reload persistence, desktop layout, mobile layout, and browser console output

@baditaflorin baditaflorin changed the title Add private per-child progress tracking explorer Add private per-child learning map and logbook Jul 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant