Knowledge hub

Help Center and Documentation

Search role-based setup guidance, operational checks, feature instructions, and troubleshooting steps for Perfect Aptitude platform.

Search help content

All help sections are shown.

Getting Started

Accounts, login, approval, and role routing

Use the correct account route

Institution, teacher, and student registrations use one secure Create Account flow on /login/ with role selection. After login, the EAP role router sends approved users to the role-appropriate dashboard.

Understand pending approval

Teacher and student memberships may remain pending until an authorized institution administrator approves the request. A successful WordPress account alone does not guarantee institution access.

Start from the dashboard

Use the dashboard as the safe starting point. Do not bookmark a route that belongs to a different role.

Sign in to open Dashboard

Institution Operations

Membership, timetable, content, costs, guardians, and governance

Review membership requests

Confirm that the institution record, active administrator assignment, membership schema, and license capacity are valid before approving teacher or student requests.

Manage timetables and substitutions

Use the timetable and substitutions routes for scheduled teaching operations. Verify dates, assigned teachers, classes, and timezone before publishing changes.

Sign in to open Timetable

Review operational controls

Authorized institution administrators can review cost controls, guardians, and data-governance surfaces when those modules are enabled.

Sign in to open Cost Controls

Teacher Workflow

Sessions, live classrooms, replays, and support

Prepare the session

Create or review the session, confirm the assigned class and teacher, select the required languages, and test microphone permissions before the scheduled start.

Sign in to open Sessions

Open the live classroom

Use a supported browser, allow microphone access, confirm the selected input device, and verify that enabled speech, translation, and audio providers report healthy status.

Sign in to open Sessions

Reuse published replays

The Replay Library should show only authorized and published material. Missing content may indicate assignment, publication, institution, or role-permission issues.

Sign in to open Replay Library

Student Workflow

Calendar, classes, books, revision, and replays

Check the calendar

The calendar provides the student-facing schedule when events are assigned and visible to the current institution and role.

Sign in to open Calendar

Open assigned learning content

Use the Content Library for books and approved learning material. Access depends on publication status, assignment, institution mapping, and license rules.

Sign in to open Content Library

Use replays and support

Open Replay Library for authorized lesson replays. Record reproducible access problems in Support Incidents instead of repeatedly refreshing a broken route.

Sign in to open Replay Library

Book Conversion

Upload, queue, OCR, review, and publish

Confirm prerequisites before uploading

Verify the file type, upload limits, storage configuration, conversion providers, OCR dependencies, institution mapping, and permission to use the source material.

Sign in to open Book Conversion

Watch job progress

A queued conversion may move through upload, extraction, OCR, structuring, and review states. A stalled job requires queue, storage, provider, and server-log diagnostics.

Review before release

Generated material should remain reviewable and controlled. Confirm page selection, structure, language edition, summary, question quality, and assignment before student release.

Languages and Providers

Speech capture, translation, and audio output

Separate configuration from health

Configured means credentials or settings exist. Functional means an authenticated probe succeeded. A provider can be configured but unhealthy.

Test the complete language path

Validate microphone capture, transcript generation, translation, text-to-speech, student playback, and the selected language code as one end-to-end workflow.

Use browser fallback carefully

Browser speech APIs can vary by browser, operating system, permission state, and language. Treat server-side providers and browser fallbacks as separately testable capabilities.

Calendar and Replay Library

Role-aware routing and missing-content checks

Route opens the wrong hub

Confirm the URL still contains the expected eap-view value, clear caches, verify the active platform release, and test with a clean role-specific account. Generic hub output usually indicates routing, authorization, or cached template state.

Calendar is empty

Check event dates, timezone, institution, role visibility, class assignment, publication state, and whether the user is approved and active.

Sign in to open Calendar

Replay is missing

Check whether the lesson completed, replay content was generated or published, the current role is allowed to view it, and the session belongs to the same institution.

Sign in to open Replay Library

Troubleshooting Checklist

Fast checks before escalating an incident

Access denied

Confirm email verification, account approval, active membership, role, institution mapping, license capacity, and route permission. Do not solve authorization failures by granting broad administrator privileges.

Button does nothing

Open the browser console and network panel, reproduce once, record the request URL and response, then check nonce, REST permission, JavaScript errors, caching, and server logs.

Provider or conversion failure

Capture the exact diagnostic message, provider status, job identifier, affected file or session, timestamp, route, role, browser, and reproducible steps before escalating.

Sign in to open Support Incidents

Report a reproducible problem

Include the affected role, exact route, date and time, expected result, actual result, browser, and one clean reproduction attempt.