← Back to Documentation Home

User Documentation

For: School Administrators, Operators, and End Users

This guide covers daily usage of RMT Attendance System. Perfect for SaaS customers who receive login credentials and start using immediately.

New User? You should have received:
  • System URL (e.g., yourdomain.com/login)
  • Email address for login
  • Password
  • Your role (Admin or Operator)

Getting Started

First Login

Step 1: Access the System

  1. Open your web browser (Chrome, Firefox, Safari, or Edge recommended)
  2. Navigate to your system URL provided by administrator
  3. You'll see the login page

Step 2: Login

  1. Enter your email address
  2. Enter your password
  3. Optional: Check "Remember Me" to stay logged in
  4. Click "Login" button
First Time Login: It's recommended to change your password immediately!
  • Click your name in top-right corner
  • Select "Profile" or "Change Password"
  • Enter new secure password

Dashboard Overview

After login, you'll see the main dashboard with:

Statistics Cards (Top Row)

Charts & Analytics

Recent Activity

Navigation Menu (Left Sidebar)

Student Management

Adding a New Student

Method 1: Manual Entry (Individual Student)

  1. Click "Students" in the sidebar menu
  2. Click the "Add New Student" button (usually green button at top-right)
  3. Fill in the student information form:
    Field Required? Description
    Student ID ✅ Required Unique identifier (e.g., 2024001, SCI001)
    Name ✅ Required Full student name
    Email Optional Student email address
    Phone Optional Contact number
    Gender Optional Select Male or Female
    Class Optional Class/Form/Year (e.g., Form 5A, Grade 12)
    Program Optional Stream/Program (e.g., Science, Arts, Engineering)
    Address Optional Student's address
  4. Click "Save" button
  5. Success! QR code is automatically generated
  6. You'll be redirected to student details page where you can view/print the QR code
QR Code Auto-Generated! Every student gets a unique QR code immediately after creation. No extra steps needed!

Bulk Import from Excel

Add multiple students at once using Excel file:

Step 1: Download Template

  1. Go to Students page
  2. Click "Import Students" button
  3. Click "Download Template" link
  4. Save the Excel file to your computer

Step 2: Fill in Student Data

  1. Open the downloaded Excel file
  2. You'll see these columns:
    • Column A: Student ID (Required) - Must be unique
    • Column B: Name (Required) - Full name
    • Column C: Email (Optional)
    • Column D: Phone (Optional)
    • Column E: Gender (Optional) - "male" or "female" only
    • Column F: Class (Optional)
    • Column G: Program (Optional)
    • Column H: Address (Optional)
  3. Fill in your student data (one student per row)
  4. Do not modify or delete the header row!
  5. Save the file
Important Excel Import Rules:
  • Student ID must be unique (no duplicates)
  • Maximum 1000 students per import
  • Use .xlsx or .xls format only
  • Gender must be exactly "male" or "female" (lowercase)
  • Don't add extra columns

Step 3: Upload and Import

  1. Back in the system, click "Choose File"
  2. Select your filled Excel file
  3. Click "Import" button
  4. System validates the data
  5. If successful, all students are imported with QR codes generated automatically
  6. If errors, you'll see specific error messages (e.g., "Row 5: Student ID already exists")

Viewing Student List

The student list page shows all students in a table with powerful search and filter options:

Search Features:

Actions for Each Student:

Editing Student Information

  1. Find the student in the list
  2. Click "Edit" button
  3. Modify any field as needed
  4. Click "Update"
  5. Changes saved immediately
Note: If you change the Student ID, a new QR code will be generated. The old QR code will no longer work.

Viewing Student Details

Click "View" button to see:

Print Individual QR Code:

  1. Go to student details page
  2. Click "Show QR Code" or "Print QR"
  3. QR code displays in full-page format with:
    • Student name
    • Student ID
    • Large, scannable QR code
  4. Use browser print (Ctrl+P / Cmd+P)
  5. Print on A4 paper

Print QR Codes in Bulk:

  1. Go to Students page
  2. Click "Print QR Codes" button
  3. Select students using checkboxes (or "Select All")
  4. Click "Print Selected"
  5. QR codes display in 4x2 grid format (8 QR codes per A4 page)
  6. Each code includes:
    • Student name
    • Student ID
    • Scannable QR code
  7. Print (Ctrl+P / Cmd+P)
Printing Tips:
  • Use white paper, avoid colored paper
  • Print in portrait orientation
  • Use good quality printer for clear codes
  • Laminate QR cards for durability
  • Test scan before distributing to students

Deactivating Students

To temporarily disable a student without deleting:

  1. Edit the student
  2. Uncheck "Active" checkbox
  3. Save changes

Result: Inactive students cannot check in. QR scan will show error message.

Use cases:

QR Scanner Guide

The QR Scanner is the fastest way to record attendance.

Accessing the Scanner

Method 1: From Dashboard

  1. Click "Scanner" in the sidebar menu

Method 2: Direct URL (for Kiosk)

  1. Bookmark this URL: https://yourdomain.com/scanner
  2. Use on dedicated tablet/computer for scanning station

First-Time Setup

Step 1: Unlock Scanner (if PIN enabled)

Step 2: Grant Camera Permission

  1. Browser will ask: "Allow camera access?"
  2. Click "Allow"
  3. Camera feed appears
  4. Permission is remembered for future visits
Camera Not Working?
  • Site must use HTTPS (secure connection with padlock icon)
  • Check browser permissions in address bar
  • Close other apps using camera (Zoom, Skype, etc.)
  • Try different browser (Chrome recommended)

How to Scan (Step-by-Step)

Complete Check-in Process:

  1. Student Approaches
    • Student presents QR code (card/printout/phone screen)
  2. Position QR Code
    • Hold QR code 15-30cm from camera
    • Keep it steady and flat
    • QR code should fill about 50% of frame
    • Ensure good lighting
  3. Automatic Detection
    • System detects QR code automatically (1-2 seconds)
    • Beep sound (if enabled)
    • Student information appears on screen:
      ✅ Student Found!
      
      Name: Ahmad bin Ali
      ID: 2024001
      Class: Form 5A
      Program: Science Stream
  4. Select Menu
    • Available menus display with images and prices
    • Click desired menu item
    • Example options:
      🍽️ Select Your Menu:
      
      [ Nasi Lemak - RM 5.00 ]
      [ Fried Rice - RM 4.50 ]
      [ Mee Goreng - RM 4.00 ]
  5. Confirm
    • Click "Submit" button
    • Or wait for auto-submit (if configured)
  6. Success!
    • Green success message appears:
      ✅ Attendance Recorded!
      
      Ahmad bin Ali
      Nasi Lemak - Breakfast
      8:45 AM
    • Message auto-dismisses after 3 seconds
  7. Ready for Next Student
    • Scanner resets automatically
    • Next student can scan immediately

⏱️ Average Time: 3-5 seconds per student!

Understanding Meal Types

The system automatically detects meal type based on current time:

Meal Type Time Range Example
Breakfast 6:00 AM - 10:59 AM 8:30 AM → Breakfast
Lunch 11:00 AM - 2:59 PM 12:45 PM → Lunch
Dinner 3:00 PM - 11:59 PM 6:30 PM → Dinner

Common Scanner Errors & Solutions

❌ "Student Not Found"

⚠️ "Already Checked In"

❌ "Student Inactive"

🔍 "Unable to Detect QR Code"

Scanner Session Statistics

The scanner displays real-time statistics:

Locking the Scanner

When leaving the scanner unattended:

  1. Click "Lock Scanner" button
  2. Scanner locks immediately
  3. To unlock, enter PIN again
Best Practice: Always lock the scanner when leaving, especially in public areas!

Adding a New Menu

  1. Click "Menus" in sidebar
  2. Click "Add New Menu" button
  3. Fill in the form:
    Field Required? Description
    Name ✅ Required Menu item name (e.g., "Nasi Lemak")
    Description Optional Brief description of the item
    Category ✅ Required Main, Drink, Side, Dessert, Other
    Price ✅ Required Price in RM (e.g., 5.00)
    Image Optional Upload photo (JPG, PNG - max 2MB)
    Display Order Optional Sort order (lower numbers show first)
  4. Click "Save"
  5. Menu appears in scanner immediately!

Uploading Menu Images

Image Guidelines:

Editing Menu

  1. Go to Menus page
  2. Click "Edit" button next to menu
  3. Modify any field
  4. Upload new image (optional)
  5. Toggle availability:
    • Available - Shows in scanner
    • Unavailable - Hidden from scanner
  6. Click "Update"
Availability Toggle Tip: Use "Unavailable" instead of deleting when item is temporarily out of stock. You can re-enable it anytime!

Deleting Menu

  1. Click "Delete" button next to menu
  2. Confirm deletion
  3. Menu removed permanently
Warning: Deletion is permanent! Existing attendance records with this menu are preserved, but you can't add it back easily. Consider marking as "Unavailable" instead.

Attendance Recording

Recording Methods

Two ways to record attendance:

Method 1: QR Scanner (Recommended - Fast)

Method 2: Manual Entry (Backup)

  1. Click "Attendance" → "Record Attendance"
  2. Fill in the form:
    • Student: Select from dropdown (searchable)
    • Menu: Select from available menus
    • Date: Date of attendance
    • Time: Time of check-in
    • Meal Type: Auto-detected from time (can override)
    • Notes: Optional remarks
  3. Click "Save"

Viewing Attendance Records

  1. Click "Attendance" in sidebar
  2. View all check-in records in table

Table Columns:

Filtering Attendance Records

Use filters to find specific records:

Example Queries:

Query 1: "All lunch check-ins in November"

Query 2: "Ahmad's attendance this week"

Deleting Attendance Records

If an error was made:

  1. Find the incorrect record
  2. Click "Delete" button
  3. Confirm deletion
  4. Record removed permanently
Use with caution: Deletion is permanent and cannot be undone!

Duplicate Check-in Prevention

The system automatically prevents:

Allowed:

Blocked:

Reports & Analytics

Dashboard Statistics

Real-time statistics available on dashboard:

Attendance Trends Chart

7-Day Attendance Trend (Line Chart)

Popular Menus Chart

Most Selected Menu Items (Bar Chart)

Meal Type Distribution

Breakfast vs Lunch vs Dinner (Pie Chart)

Exporting Reports to Excel

Step-by-Step:

  1. Go to "Reports" page
  2. Select filters:
    • Date range (From → To)
    • Meal type (optional)
    • Student (optional)
  3. Click "Export to Excel" button
  4. File downloads automatically (e.g., attendance_report_2024-11-01_to_2024-11-15.xlsx)
  5. Open in Excel/Google Sheets

Excel File Contains:

Use Cases for Excel Export:
  • Monthly reports for management
  • Billing/invoicing parents
  • Audit trail
  • Further analysis in Excel
  • Archive records

User Roles & Permissions

Admin Role

Full System Access - Can do everything:

Operator Role

Limited Access - Daily operations only:

Managing Users (Admin Only)

Adding a New User:

  1. Click "Users" in sidebar
  2. Click "Add New User"
  3. Fill in:
    • Name
    • Email (for login)
    • Password (min 8 characters)
    • Role: Admin or Operator
    • Active: Check to enable account
  4. Click "Save"
  5. User can now login with email and password

Editing User:

Deactivating User:

Frequently Asked Questions (FAQ)

General Questions

Q: What browsers are supported?

A: Chrome, Firefox, Safari, and Edge (latest versions). Chrome recommended for best scanner performance.

Q: Can multiple people use the system simultaneously?

A: Yes! Multiple users can login and work at the same time. Multiple scanners can operate simultaneously without conflicts.

Q: Do I need internet connection?

A: Yes, internet is required for real-time database updates and multi-device access.

Q: Is my data secure?

A: Yes. The system uses:

Student Management

Q: Can I edit a student's Student ID?

A: Yes, but a new QR code will be generated. The old QR code won't work anymore. Distribute the new QR code to the student.

Q: What happens if I delete a student?

A: Student is soft-deleted (not permanently removed). Their attendance history is preserved. Database admin can recover if needed.

Q: How many students can I import at once?

A: Maximum 1000 students per Excel import. For larger batches, split into multiple files.

Q: Can a student have multiple QR codes?

A: No, each student has one unique QR code based on their Student ID. If you change the Student ID, the QR code changes.

QR Scanner

Q: Can students scan QR from phone screen?

A: Yes! QR codes work from printed cards, phone screens, tablet screens, or computer screens - as long as the image is clear.

Q: Why does camera require HTTPS?

A: Modern browsers block camera access on non-secure (HTTP) sites for privacy. Your admin must enable SSL/HTTPS.

Q: What if a student scans twice by accident?

A: System prevents duplicate check-ins. Second scan for same meal type will be blocked with error message.

Q: Can a student check in for all three meals?

A: Yes! Students can check in once per meal type per day:

Attendance & Reports

Q: How long is attendance data stored?

A: Forever (unless manually deleted). All records are preserved indefinitely. Export old data if you want to archive.

Q: Can I edit an attendance record?

A: No, editing is not allowed (for audit integrity). Admins can delete incorrect records and create new ones with notes explaining the correction.

Q: Can I generate monthly reports?

A: Yes! Go to Reports, set date range (e.g., Nov 1-30), and export to Excel. You'll get a complete monthly report.

Q: Can parents see their child's attendance?

A: Not in current version. However, you can export filtered reports for specific students and email to parents.

Menus

Q: Can I temporarily disable a menu without deleting?

A: Yes! Edit the menu and toggle "Available" to "Unavailable". It won't show in scanner but remains in database. Re-enable anytime.

Q: What if I don't have menu images?

A: Images are optional. Menus work fine without images - just text will display in scanner.

Q: Can I change menu prices?

A: Yes, edit the menu anytime. Price changes apply immediately. Past attendance records keep old prices.

Troubleshooting

Q: I forgot my password. How do I reset it?

A: Contact your system administrator. They can reset your password via the Users management page.

Q: QR codes are not displaying. What's wrong?

A: Possible causes:

Q: Scanner freezes or crashes. What should I do?

A: Refresh the page (F5). If problem persists:

Q: System is slow. How can I speed it up?

A: Contact admin. They can:

Getting Help

Q: Where can I get support?

A: Contact your system administrator or support team with:

Pro Tips for New Users:
  1. Start with adding a few test students
  2. Print their QR codes
  3. Test the scanner thoroughly
  4. Add real students after comfortable
  5. Train operators before going live
  6. Keep backup of student data


← Back to Documentation Home