Skip to content

USER-GUIDE.md

Latest commit

 

History

History
230 lines (154 loc) · 7.95 KB

USER-GUIDE.md

File metadata and controls

230 lines (154 loc) · 7.95 KB
Raw

User Guide — Development Process Navigator

Live App: <YOUR_AMPLIFY_URL>

This guide covers both roles. Jump to your section:

Getting Started

Creating an Account

  1. Open the app and choose your role — Student or Instructor
  2. Click Register
  3. Fill in your email, password (min 8 chars, include a letter and number), and display name

Students:

  • If your instructor gave you a Join Code, enter it to auto-enroll in their class
  • You can skip this and join later from the dashboard

Instructors:

  • You need an Instructor Access Code from your department administrator

Logging In

  1. Select your role (Student or Instructor)
  2. Enter your email and password
  3. You'll be taken to your dashboard automatically

Password Requirements

  • Minimum 8 characters
  • At least one letter and one number

Instructor Guide

Dashboard

After logging in you'll land on the Instructor Dashboard which shows:

  • Your active exercises (with Exercise IDs and copy buttons)
  • Quick stats (enrolled students, submissions)
  • Quick access to Roster, Results, and Live Session

Creating an Exercise

  1. Go to Exercises in the sidebar (or click New Exercise on the dashboard)
  2. Click New Exercise
  3. Choose a starting template — use Real Estate Development to get a pre-built set of activities
  4. Customise activities and phase mappings:
    • Activities: The cards students will drag and place (title + description)
    • Phases: The columns students sort activities into
    • Weights: How many points each activity earns when placed in each phase (0–100)
  5. Click Apply (or Publish) to create a live exercise with a unique Exercise ID

Tip: Activities can have weight in more than one phase — a card placed correctly in multiple phases still earns credit.

Managing Your Roster

Go to Roster in the sidebar.

Option 1 — Join Code:

  1. Click Generate Join Code
  2. Share the code (e.g. ASU-2026) with students
  3. Students enter the code when registering — they're auto-enrolled

Option 2 — Invite by Email:

  1. Click Invite Student
  2. Enter their email address
  3. They'll appear in your roster once they register

Assigning an Exercise

After publishing an exercise:

  1. On the Dashboard, find the exercise card
  2. Click Assign — a modal shows the Exercise ID and instructions
  3. Copy the Exercise ID and share it with students
  4. Enrolled students will also see it automatically in their My Exercises list

Viewing Results

Go to Results in the sidebar.

  • Exercise Results tab: Per-student scores for each exercise (Attempt 1, Attempt 2, change, status)
  • Student Histories tab: Individual student full attempt history
  • Score Trends tab: Class performance over time

Use Download Report (CSV) to export results for gradebook entry.

Student Guide

Dashboard

After logging in you'll see your Student Dashboard with:

  • Exercises available to you (from enrolled instructors)
  • Recent scores
  • Quick access to History and Scores

Starting an Exercise

Option A — From your dashboard:

  1. Click Start on any exercise card in My Exercises

Option B — Using an Exercise ID:

  1. Go to Current Exercise in the sidebar
  2. Enter the Exercise ID your instructor gave you
  3. Click Go

Option C — Direct link: Your instructor may share a direct link: <YOUR_AMPLIFY_URL>/student/exercise?id=<exercise-id>

Playing the Exercise

The exercise board has two panels:

Left panel — Activity Cards:

  • All activities to be placed
  • Filter by category: All / People / Task / Test
  • Shows remaining unplaced cards

Right panel — Phase Columns:

  • One column per phase (e.g. Planning, Due Diligence, Construction, Operations)
  • Drag a card from the left and drop it into the correct phase column
  • A card can go into multiple phases if it belongs in more than one

Controls:

  • Drag to place: Pick up a card from the left, drop into a phase column
  • Drag to move: Pick up a placed card from a column, drop into a different column or drag back to the left panel to remove
  • × button: Remove a card from a phase column
  • Save Draft: Saves your current progress without submitting
  • Submit: Available when all 26 cards are placed (counter shows 26 / 26 placed)

Submitting

  1. Place all activity cards into phase columns
  2. The Submit button activates when XX / XX placed shows all cards placed
  3. Click Submit
  4. You'll immediately see your score and per-card feedback

Understanding Your Score

After submitting you'll see:

  • Overall score (0–100%)
  • Phase Breakdown: For each phase, which cards were correct (✓), partially correct (◐), or wrong (✗)
    • ✓ Green — placed in the primary phase for this activity
    • ◐ Orange — placed in a phase with partial credit
    • ✗ Red — placed in a phase with no credit
  • Reflection prompt: A targeted question about your weakest placement

Resubmitting

After your first submission:

  1. Review the feedback — cards are still movable if locked = false
  2. Adjust placements based on the feedback
  3. Click Resubmit for your final attempt

Important: You only get two attempts. After resubmitting the exercise is locked and no further changes are possible.

Saving a Draft

Click Save Draft at any time to save your current placements without submitting. When you return to the exercise later, your draft will be loaded automatically.

Viewing History

Go to My History in the sidebar to see:

  • All exercises you've attempted
  • Score for each attempt
  • Whether a submission is final
  • Click Details to see the full per-card breakdown

Scores Overview

Go to My Scores to see a summary chart of all your scores across all exercises.

Help & Tutorial

Built-in Tutorial

Click the ? Tutorial button in the top-right corner of any page.

  • Students see the Student guide
  • Instructors see both the Instructor and Student guides

Contextual Help Icons

Look for the ⓘ icon throughout the app — hover over it for a quick explanation of that feature.

Where to find these guides

  • Tutorial button: top-right corner of the navbar (visible when logged in)
  • Help link: bottom of the sidebar navigation

FAQ

Q: I entered the wrong Exercise ID — what do I do?
Go back to the exercise selection page and enter the correct ID. If you started the exercise with the wrong ID, you can return to the dashboard and try again.

Q: I accidentally placed a card in the wrong phase — can I move it?
Yes — drag it to the correct column, or click the × button to return it to the activity pool on the left.

Q: Can I leave mid-exercise and come back?
Yes — click Save Draft before leaving. Your placements will be saved. When you return, they'll load automatically.

Q: I submitted but want to change my answers before resubmitting — can I?
Yes, as long as the exercise isn't locked. After the first submission you can still move cards around before clicking Resubmit. After resubmitting, the exercise locks permanently.

Q: I don't see any exercises in My Exercises — why?
You may not be enrolled in an instructor's class yet. Ask your instructor for a join code and enter it in your profile, or have them invite you by email.

Q: The Submit button is greyed out — why?
All activity cards must be placed in at least one phase before you can submit. Check the counter (e.g., 24 / 26 placed) — scroll through the activity list to find any remaining unplaced cards.

Q: My session expired — what do I do?
Log out and log back in. Sessions use Cognito JWTs which expire after a set period.

Arizona State University · W.P. Carey School of Business · ASU AI Cloud Innovation Center