Kiosk Mode Setup and Usage

1. Overview

Kiosk mode transforms a tablet or computer into a self-service check-in station where students can mark their attendance for classes. This streamlines the check-in process, reduces instructor workload, and empowers students to take ownership of their attendance.

2. Prerequisites

Before setting up kiosk mode, ensure you have:

• ✓OWNER role (required to activate kiosk mode)
• ✓Classes created and scheduled (see Class Scheduling Guide)
• ✓Students enrolled in classes (see Student Enrollment Guide)
• ✓Dedicated device (tablet, computer, or kiosk station with touch screen recommended)
• ✓Stable internet connection (for real-time attendance recording)

3. Understanding Kiosk Mode

Kiosk mode is a specialized interface designed for student self-service check-in at your martial arts club.

When to Use Kiosk Mode

• •High-Volume Classes: Classes with many students where manual attendance takes too long
• •Multiple Concurrent Classes: When several classes run simultaneously and instructors can't mark attendance for all
• •Student Empowerment: Teaching students responsibility by having them check themselves in
• •Instructor Focus: Allowing instructors to focus on teaching rather than administrative tasks

How Kiosk Mode Works

1. 1.Instructor activates kiosk mode on a dedicated device
2. 2.System displays classes within 15-minute check-in window
3. 3.Student selects their class from the list
4. 4.Student selects their name from enrolled students
5. 5.Student taps "Check In" button
6. 6.System creates PRESENT attendance record and shows confirmation
7. 7.For AUTOMATIC_CLASS_BASED classes, stripe is automatically awarded

4. Setting Up Kiosk Mode

Follow these steps to set up kiosk mode for the first time:

Step 1: Prepare Your Device

1. 1.Choose a dedicated device (tablet or computer) for kiosk mode
2. 2.Connect the device to a stable internet connection
3. 3.Position the device in an accessible location (e.g., near the entrance)
4. 4.Consider mounting the device or using a stand for stability

Step 2: Activate Kiosk Mode

1. 1.Log in to DojoMaster with your OWNER account
2. 2.Navigate to Dashboard → Kiosk → Activate Kiosk Mode
3. 3.Click the "Activate Kiosk Mode" button
4. 4.You'll be prompted to set up an exit PIN (see next section)

Step 3: Set Up Exit PIN

1. 1.Enter a secure PIN (4-20 characters) in the "PIN" field
2. 2.Re-enter the same PIN in the "Confirm PIN" field
3. 3.Click "Set PIN and Activate" to save and activate kiosk mode
4. 4.Alternatively, click "Skip for Now" to activate without a PIN (not recommended for security)

5. Kiosk Mode Security

Kiosk mode includes several security features to protect your club's data and prevent unauthorized access.

PIN Protection

• •Encrypted Storage: PINs are hashed using bcrypt with 10 rounds before storage
• •Exit Protection: Only users with the correct PIN can exit kiosk mode
• •No Bypass: Students cannot exit kiosk mode without the PIN
• •PIN Length: Minimum 4 characters, maximum 20 characters

Access Control

• •OWNER-Only Activation: Only club owners can activate kiosk mode
• •Session-Based: Kiosk session persists only while browser is open
• •Limited Functionality: Students can only check in, not access other features
• •Club-Specific: Kiosk mode only shows classes and students from your club

Data Protection

• •Duplicate Prevention: System prevents duplicate check-ins for same student/class/date
• •Enrollment Validation: Only enrolled students appear in class rosters
• •Real-Time Sync: Attendance records are created immediately in the database
• •Audit Trail: All check-ins are logged with timestamps and student information

6. Student Check-In Process

Once kiosk mode is activated, students can check themselves in using this simple process:

Step-by-Step Check-In

1. 1.
   View Available Classes

   The kiosk displays all classes within the 15-minute check-in window. Classes are sorted by day of week and start time.

2. 2.
   Select Your Class

   Tap on the class you're attending. The class card shows the class name, start time, end time, and day of week.

3. 3.
   Select Your Name

   After selecting a class, a list of enrolled students appears. Tap on your name to select yourself. The system shows your preferred name if you have one set.

4. 4.
   Tap "Check In"

   A large green "Check In" button appears. Tap it to complete your check-in.

5. 5.
   View Confirmation

   A success message appears showing your name and class. The confirmation auto-dismisses after 3 seconds, or you can tap "Close" to dismiss it immediately.

7. The 15-Minute Time Window

By default, kiosk mode only displays classes that are within 15 minutes of their start time. This prevents confusion and ensures students check in for the correct class.

How the Time Window Works

Manual Class Selection

If no classes appear in the automatic list (e.g., outside the 15-minute window), kiosk mode displays a "Show All Classes" button. This allows students to manually select from all active classes, regardless of the time window.

8. Managing Kiosk Sessions

Learn how to start, monitor, and end kiosk sessions effectively.

Starting a Kiosk Session

1. 1.Log in to DojoMaster with your OWNER account on the kiosk device
2. 2.Navigate to Dashboard → Kiosk → Activate Kiosk Mode
3. 3.Click "Activate Kiosk Mode" (or enter your PIN if already set up)
4. 4.The kiosk interface appears, ready for student check-ins

Monitoring Kiosk Activity

• •Real-Time Updates: The kiosk interface updates automatically as classes enter/exit the 15-minute window
• •Check Attendance Records: View attendance records in the Attendance section of your dashboard (on a different device)
• •Monitor from Dashboard: You can monitor check-ins in real-time from your instructor dashboard while kiosk mode runs
• •Session Persistence: Kiosk session remains active as long as the browser window stays open

Ending a Kiosk Session

1. 1.Click the "Exit Kiosk Mode" button in the top-right corner of the kiosk interface
2. 2.Enter your exit PIN in the modal that appears
3. 3.Click "Exit" to confirm
4. 4.You'll be redirected to your dashboard

9. Kiosk Mode Display and Interface

The kiosk interface is designed for simplicity and ease of use, with large touch-friendly buttons and clear visual hierarchy.

Interface Components

Design Features

• •Touch-Optimized: Large buttons and cards designed for easy tapping on touch screens
• •Full-Screen: Kiosk mode uses the entire screen with no distractions
• •Clear Visual Hierarchy: Important elements are larger and more prominent
• •Color-Coded Feedback: Green for success, red for errors, blue for information
• •Responsive Layout: Works on tablets, computers, and kiosk stations
• •Dark Mode Support: Automatically adapts to device's dark mode setting

10. Integration with Attendance and Stripes

Kiosk mode check-ins are fully integrated with DojoMaster's attendance tracking and stripe awarding systems.

Attendance Recording

When a student checks in through kiosk mode:

1. 1.An attendance record is created with status PRESENT
2. 2.The record includes the class, student, current date, and timestamp
3. 3.The student's attendance rate is recalculated: (PRESENT + LATE) / total records
4. 4.The student's current streak is updated (consecutive PRESENT/LATE records)
5. 5.The attendance record appears immediately in the Attendance section of your dashboard

Automatic Stripe Awarding

For classes configured with the AUTOMATIC_CLASS_BASED stripe award model:

• •One stripe is automatically awarded when the student checks in (status PRESENT)
• •The stripe is linked to the student's current belt rank
• •Stripe progression follows the configured sort order (1, 2, 3, etc.)
• •The student's grading readiness percentage is recalculated
• •No stripe is awarded for LATE, ABSENT, or EXCUSED statuses (only PRESENT)

11. Common Pitfalls and Troubleshooting

Here are solutions to common issues you might encounter with kiosk mode:

12. Related Features

Kiosk mode works together with other DojoMaster features:

13. Next Steps

Now that you understand kiosk mode:

1. 1.Prepare your device: Choose a dedicated tablet or computer for kiosk mode and position it in an accessible location
2. 2.Set up your exit PIN: Create a secure 4-20 character PIN to protect kiosk mode exit
3. 3.Activate kiosk mode: Navigate to Dashboard → Kiosk → Activate Kiosk Mode and follow the setup process
4. 4.Test the check-in process: Have a few students test the check-in process to ensure everything works smoothly
5. 5.Train your students: Show students how to use kiosk mode and explain the check-in process
6. 6.Monitor attendance records: Regularly check attendance records to ensure kiosk check-ins are working correctly