Last updated: 2026-07-31
These define what Project G-Code can do better than a PDF, video playlist, or generic quiz app.
-
Wrong-path preview Learner picks a code or block; the app shows the expected motion/state beside the mistaken motion/state. Acceptance: learner can see why the wrong answer would move or behave differently.
-
Educational crash/alarm preview Add four to six dangerous beginner mistake patterns with consequence feedback. Acceptance: learner sees what the code could do to the part, tool, coordinate system, or print job without turning the app into a machine panel.
-
Workpiece/state panel Show a simple educational state: the active tool or nozzle, position, units, feed rate, spindle speed or temperature, and active mode where relevant. Acceptance: state changes reflect the learner's selected code block.
-
Mistake bank with lesson link-back Every missed concept links back to the source lesson or explanation. Acceptance: the learner can jump from a weak spot to the exact concept in one tap.
-
Correction rewrite after a miss Status: completed. Wrong answers now require an active correction before progression. Acceptance met: the learner recalls the correction instead of only reading feedback.
These reduce guessing and improve retention.
-
Job-first lesson framing Status: completed for every CNC lesson, with a regression guard for new lessons.
-
Beginner checkpoints Add short checkpoints for safety-critical concepts such as units, coordinates, rapid moves, offsets, canned cycles, homing, temperatures, and end commands. Acceptance: the next lesson stays locked until the learner demonstrates the checkpoint correctly.
-
Weak-spot retry queue First miss of the day should surface in practice before normal review. Acceptance: streaks and other rewards cannot hide unresolved weak spots.
-
Today's line Status: completed with one track-specific free-recall line drawn only from completed lessons. One small daily card asks the learner to read or write exactly one useful G-code line. Acceptance: the line is short, track-specific, and recall-focused.
-
Question variety without answer leakage Keep mixing multiple-choice, fill-in-the-blank, matching, true-or-false, select-the-code, and order-the-block prompts. Acceptance: examples support understanding but do not reveal the answer before the learner attempts the question.
Improve reliability and mobile usability after P1 and P2 are stable.
- Mobile safe-area handling for bottom nav, lesson footer, and practice cards.
- Light theme contrast fixes for theory blocks, disabled text, and code panels.
- Code Bank and Reference collection: learned-code filters, important codes, exact-match search, and lesson link-back. Status: learned filtering, automatic unlocks, persistence, progress counts, and track separation are complete.
- Practice hub polish: daily drill, mistake repair, code bank, mixed review, and clear locked/ready states.
- Lightweight rewards and ranks: milestone moments that reinforce recall without becoming noisy gamification.
- Startup/loading screen cleanup: keep the accepted boot-rig style and remove unused legacy loading CSS when safe.