User Story - Virtual Tutor // Production and Supply Chain Management: Interactive Tool for Programming Simple Heuristics

[dias-altay]

Is your feature request related to a problem?

This user story is valid for Production and Supply Chain Management course

As Stefan, I want an interactive tool to implement simple heuristics and interpret the results using intuitive interfaces like Jupyter notebooks, so that I can master coding concepts with guided feedback.

---

Description:

Stefan is studying Production and Supply Chain Management and needs to understand and implement heuristic approaches to optimization problems. He wants a tool that guides him in coding simple heuristics and helps him interpret the results. The tool should provide feedback on his implementation and allow him to visualize outputs through intuitive interfaces, such as Jupyter notebooks.

Describe the solution you'd like

Acceptance Criteria:

Programming Environment:

1. Interactive Code Editor:

   • The tool provides an embedded coding environment directly within Moodle, with:
     • Syntax highlighting.
     • Autocompletion for common coding constructs.
     • Error detection and debugging suggestions.

2. Code Templates:

   • Predefined code templates are available for common heuristics, such as:
     • Greedy algorithms.
     • Local search techniques.
     • Metaheuristics like simulated annealing or genetic algorithms (optional for advanced levels).

Feedback Mechanism:

1. Code Validation:

   • The tool checks Stefan’s code for logical and syntactical errors.
   • It highlights errors with explanations and suggestions for correction.

2. Result Interpretation:

   • After execution, the tool provides:
     • Visualization of heuristic performance (e.g., convergence graphs).
     • Metrics such as solution quality and computational time.
   • The e-tutor offers insights into why the heuristic succeeded or failed in specific cases.

User Experience:

1. Intuitive Interface:

   • The coding interface is user-friendly and provides real-time syntax highlighting.
   • Results are presented visually, such as through charts, graphs, or animations.

2. Seamless Integration with Jupyter Notebooks:

   • Stefan can export his heuristic implementations and results to Jupyter notebooks for further exploration or reporting.

3. Accessibility:

   • The tool works on both desktop and mobile devices.
   • It is accessible within the Moodle environment.

---

Technical Requirements:

1. Interactive Coding Platform:

   • The tool supports a lightweight coding environment within Moodle.
   • It integrates with Python-based libraries for heuristics (e.g., NumPy, SciPy).

2. Real-Time Feedback and Validation:

   • The system validates code as Stefan writes, highlighting errors dynamically.

3. Visualization Capabilities:

   • Results are presented in an interactive and visually engaging manner.

4. Moodle Integration:

   • The tool is seamlessly embedded in Moodle, syncing progress and results with the Moodle gradebook.

5. Scalability and Performance:

   • The platform supports multiple users coding and running heuristics simultaneously with minimal latency.

Describe alternatives you've considered

No response

Additional context

Definition of Done (DoD):

• The interactive tool for programming simple heuristics has been implemented, and all acceptance criteria are met.
• Stefan can write and execute heuristic algorithms with guided assistance.
• Feedback and validation mechanisms work correctly, providing actionable insights for errors.
• Visualization of results and Jupyter notebook integration function as intended.
• The tool integrates seamlessly with Moodle, syncing progress and results.
• The feature has been successfully tested on multiple devices and browsers.
• Accessibility requirements are met, ensuring usability for all students.
• Documentation for the tool, including user guides and Moodle integration instructions, is complete.
• The product owner and QA team have approved the feature.