1 Admin Guide
ganganray edited this page 2026-04-13 07:06:25 +08:00

Admin Guide

Overview

Admins have full access to all platform features plus user management.

Accessing the Admin Panel

  1. Log in with an admin account
  2. Click Admin in the navigation bar

User Management

Batch Create Users

  1. Fill in one or more rows in the user table:
    • Username — login name (required, unique)
    • Student ID — student number (optional, unique)
    • Name — display name
    • Password — initial password (must meet complexity requirements)
    • Role — student, teacher, or admin
  2. Click + Add Row to add more users
  3. Click Save All to create all users at once

Existing usernames are silently skipped (not overwritten).

Delete a User

  • Click the 🗑 Delete button next to a user
  • Confirmation is required
  • Admins cannot delete themselves

Enable/Disable a User

  • Click Disable to prevent a user from logging in
  • Click Enable to reactivate
  • Disabled users see "Account disabled" on login attempt
  • Admins cannot disable themselves

Reset Password

  • Click Reset Pwd next to a user
  • A random password is generated automatically
  • The password is shown once — copy it immediately
  • Click the copy icon to copy to clipboard

Admin Access to Other Features

Admins have full access to:

  • Submissions — same interface as students (useful for testing)
  • Review — same interface as teachers (can review and grade)

Initial Setup

On first startup, an admin user is created automatically:

  • Username: defined by ADMIN_USERNAME env var (default: admin)
  • Password: random, printed in Docker logs

To retrieve the initial password:

docker logs logic_app 2>&1 | grep -A5 "INITIAL ADMIN"

CLI Operations

See the Deployment Guide for database backup, restore, and password reset commands.