Didactopus/.update_readmes/20260314_132051__230-didact...

44 lines
1.4 KiB
Markdown

# Didactopus Pack + Persistence Prototype
This update connects the learner-facing prototype to:
- **real pack-shaped data files**
- **pack compliance / attribution manifests**
- **persistent learner state** via browser local storage
- a small **Python pack export utility** that converts a Didactopus-style pack directory
into a frontend-consumable JSON bundle
## What is included
### Frontend
- topic/domain selection from real pack files
- first-session onboarding from pack metadata
- recommendation cards driven by live learner state
- mastery-map progress from pack concepts and persisted learner records
- milestone/reward feedback
- transparent "why this is recommended" explanations
- compliance/provenance display from pack manifest
- persistent learner state across reloads via local storage
### Backend-adjacent tooling
- `pack_to_frontend.py` converts:
- `pack.yaml`
- `concepts.yaml`
- `pack_compliance_manifest.json`
into a bundle suitable for the learner UI
## Why this matters
This gets Didactopus closer to a usable human-facing system:
- the UI is no longer a static mock
- packs are loadable artifacts
- learner progress persists between sessions
- provenance/compliance data can be shown from real manifests
## Next likely step
Add a real API layer so that:
- learner state is persisted outside the browser
- evaluator runs produce evidence automatically
- multiple users can work against the same pack registry