
The Problem Space
Self-directed learners struggle to build coherent roadmaps across complex technical topics without getting lost in unstructured search results or out-of-order tutorials.
Technologies & Tools
Architectural Highlights
- End-to-end streaming token pipeline using Server-Sent Events with graceful reconnection
- Normalized relational schema enforcing milestone dependency trees
- Zero-CLS loading states with optimistic UI updates and localStorage cache fallback
Key Architectural Decisions
Server-Sent Events over WebSockets for Stream Delivery
Chose SSE because communication is unidirectional (server to client) during curriculum generation. SSE runs cleanly over HTTP/2, requires no socket server maintenance, and reconnects automatically without custom heartbeat protocols.
Prisma Schema with Cascade Invalidation for Curriculum Modules
Modelled modules, lessons, and quizzes with foreign-key cascading to guarantee database referential integrity when users regenerate individual sections.
Challenges Faced
Built a lightweight stream chunk reassembly buffer that parses partial JSON tokens safely without crashing mid-stream parsing.
Implemented debounced optimistic client updates paired with batched upsert transactions on the PostgreSQL backend.