How orionsheep/wordlink works
WordLink is a vocabulary workspace centered on a typed word-neighborhood graph, with quizzes, reading, ambient study, custom word books, community notes, and AI features around it. The graph shows the documented user-facing stages and sampled API-to-service relationships; database-backed behavior is summarized where the excerpts show Prisma use. The README also describes a separate WordLink-Edge training and evaluation pipeline. Some UI-to-route and unsampled feature wiring is not shown, so those connections are omitted rather than inferred.
Main entry points: prisma.ts PostgreSQL Data · articles/route.ts Article Recommendations · libraries/route.ts Library Listing API · chat/route.ts AI Tutor Chat
Components 24
Word Study
- Vocabulary Workspace
src/app/study/page.tsx - Word Data Access
src/lib/data.ts - Word Graph API
src/app/api/fission/route.ts - Word Graph View
src/components/PanelFissionGraph.tsx - Quiz Experience
src/app/quiz/page.tsx - Quiz Recording API
src/app/api/quiz/record/route.ts - Word Memory Model
src/lib/memory.ts
Reading and Ambient
- Article Recommendations
src/app/api/articles/route.ts - Reading Recommender
src/lib/reader-engine/recommender.ts - Graded Reader
src/app/read/[id]/page.tsx - Ambient Mode
src/components/ambient/AmbientScreen.tsx - Soundscape Engine
src/components/ambient/SoundScapeEngine.ts - Background Music
src/components/ambient/BackgroundMusicEngine.ts
Libraries and Notes
- Library Listing API
src/app/api/libraries/route.ts - Library Data
src/lib/data.ts - Community Notes API
src/app/api/notes/route.ts
Identity and Data
- Session and Auth
src/lib/auth.ts - PostgreSQL Data
src/lib/prisma.ts
AI and Model
- AI Tutor Chat
src/app/api/ai/chat/route.ts - AI Gateway
src/lib/ai/gateway.ts - Learning Passport
src/app/api/ai/passport/route.ts - SFT and DPO Pipeline
model_training/run_pipeline.py - Model Benchmark
model_training/04_evaluate_benchmark.py
Other components
- Learner
Connections 30
- Learner → Vocabulary Workspace: studies in
README.md - Vocabulary Workspace → Word Graph API: loads graph data
README.md - Word Graph API → Word Data Access: reads word links
README.md - Vocabulary Workspace → Word Graph View: renders graph
README.md - Learner → Quiz Experience: takes quizzes
README.md - Quiz Recording API → Word Memory Model: updates memory
src/app/api/quiz/record/route.ts - Quiz Recording API → PostgreSQL Data: persists results
src/app/api/quiz/record/route.ts - Learner → Graded Reader: reads articles
README.md - Graded Reader → Article Recommendations: requests articles
README.md - Article Recommendations → Session and Auth: gets session
src/app/api/articles/route.ts - Article Recommendations → Reading Recommender: scores candidates
src/app/api/articles/route.ts - Article Recommendations → PostgreSQL Data: reads due words
src/app/api/articles/route.ts - Learner → Ambient Mode: enters ambient mode
README.md - Ambient Mode → Soundscape Engine: plays soundscape
README.md - Ambient Mode → Background Music: plays background music
- Learner → Library Listing API: browses word books
README.md - Library Listing API → Library Data: lists system books
src/app/api/libraries/route.ts - Library Listing API → Session and Auth: checks session
src/app/api/libraries/route.ts - Library Listing API → PostgreSQL Data: reads user books
src/app/api/libraries/route.ts - Learner → Community Notes API: shares word notes
- Community Notes API → Session and Auth: gets session
src/app/api/notes/route.ts - Community Notes API → PostgreSQL Data: reads and writes notes
src/app/api/notes/route.ts - Learner → AI Tutor Chat: asks tutor
README.md - AI Tutor Chat → Session and Auth: gets session
src/app/api/ai/chat/route.ts - AI Tutor Chat → AI Gateway: streams completion
src/app/api/ai/chat/route.ts - AI Tutor Chat → PostgreSQL Data: stores sessions
src/app/api/ai/chat/route.ts - Learner → Learning Passport: views learning report
README.md - Learning Passport → AI Gateway: generates narrative
src/app/api/ai/passport/route.ts - Learning Passport → PostgreSQL Data: aggregates study metrics
src/app/api/ai/passport/route.ts - SFT and DPO Pipeline → Model Benchmark: evaluates model
README.md