Skip to main content
Platform Manuals

Perfect Aptitude Documentation Center

Everything you need to set up, manage, and run multilingual classrooms with Perfect Aptitude.

Enter keywords like "ASR", "OCR textbook", "mic allow", "seat upgrade"

Quickstart

🚀 1. Getting Started Guide

Follow this step-by-step checklist to deploy your Perfect Aptitude instance and run your first multilingual class.

1. Create Institution: Administrative registration generates your secure school database partition and allocates seat quotas.
2. Login to Portal: Navigate to `/portal/`, choose "Institute Role", and enter your registered credentials.
3. Configure Profile: Go to Settings -> School Profile. Upload your institutional logo and configure basic contact paths.
4. Activate Subscription Plan: Insert your primary subscription license key under the Billing card to release active student seat volumes.
5. Add Teachers: Go to Teachers -> Invite. Input staff email addresses to release dashboard credentials.
6. Add Students: Email enrollment invite codes or import student cohorts directly in standard CSV lists.
7. Approve Requests: Review pending sign-ups in your "Join Requests Queue" to prevent unauthorized classroom access.
8. Create Session: Navigate to Sessions -> Add. Create a scheduled class code and allocate desired rosters.
9. Upload Textbook Content: Upload curriculum textbook chapters to execute OCR text scans and prepare summary cards.
10. Start First Class: The teacher starts the live class microphone stream, enabling real-time translations for students.
Admin Manual

🏫 2. Institute Operations Guide

Manage seat entitlements, approve pending teacher/student requests, and monitor resource outlines.

➕ How to Add Teachers:

Navigate to the Teacher Roster panel, select "Add Teacher Profile", input their name and academic email, and submit to send invite links.

➕ How to Add Students:

Go to Student Directory, click "Insert Record", type student names, or generate school code links for bulk enrollment.

✔️ How to Approve Join Requests:

Access the "Pending Approvals" dashboard section. Click "Approve Teacher" or "Approve Student" to authorize local accounts.

🎙️ How to Create & Assign Sessions:

Go to Sessions -> Add New. Define the class name, pick scheduling times, and assign the target teacher and class cohort from the dropdown lists.

🌐 How to Activate Language Packs:

Go to Global Languages, check the provider checklist status matrices, and toggle active switches (e.g., Spanish, German, French) to make them available for classes.

📚 How to Upload Books:

Go to Books -> Upload Chapter. Upload PDF textbook files, check OCR extraction progress, and assign outline blocks to specific student classes.

📈 How to Monitor Reports & Seats:

Review "License UsageStat" dials inside your admin home panel. Monitor total active seat volumes, outstanding student queues, and remaining monthly transcription minutes.

Teacher Manual

🧑‍🏫 3. Teacher Operations Guide

Manage assigned schedules, stream live classroom translations, outline textbooks, and build MCQ sandboxes.

🔑 Dashboard Access & Session Views:

Log in to the portal and select "Teacher Role". Your assigned upcoming classes display chronologically in the master schedule column.

🎙️ How to Start Live Class & Enable Mic:

Click the big green "Start Live Class" button. When your web browser triggers the microphone access dialog, select "Allow". Confirm the mic indicator turns green.

📝 How to View Transcripts:

As you speak naturally, EAP prints your verbatim words in captioned headings inside your transcript container on the fly.

❓ Answering Student Questions:

Bilingual queries from students appear in your active side panel, translated back into your native language. Click a query to type an answer, or reply verbally.

📄 Automated Outlines & MCQ Quizzes:

Click "End Session". The system compiles class outlines and automatically generates MCQ homework sandboxes based on the lesson transcript.

Student Sandbox

🎓 4. Student Sandbox Guide

A colorful learning directory. Select native language packs, stream translated voices, and maintain daily score streaks.

🔑 Portal Sign-in:

Log in at `/portal/`, choose "Student Role", and log in using your invite token.

🎓 Joining Live Class:

Click the big green "Join Live" button on your active student panel to sync with your teacher's microphone feed.

🌐 Selecting Language Packs & Listening:

Select your preferred language from the dropdown menu (e.g., Spanish, French). Plug in your headphones and click the speaker icon to stream synthesized TTS translation feeds.

❓ Asking Bilingual Questions:

Type questions in your native language inside the chat container. The engine translates and routes them directly to the teacher's dashboard.

📝 Revision Outlines & Daily Streaks:

Review class summaries inside your History logs. Launch auto-generated MCQ practice quizzes daily to protect and grow your aptitude streak points.

Textbook OCR

📚 5. Book Conversion & Ingestion

Convert static curriculum textbook chapters into active online summaries and practice quizzes.

📁 Supported Formats: High-fidelity PDF, EPUB, and standard JPEG/PNG scan images (up to 50MB per chapter file size).
1. Upload Book: Drag and drop chapter files into your Ingestion interface and click upload.
2. OCR Text Scanning: The platform scans page sections, executing optical character recognition to isolate print blocks.
3. Outline Compilation: Isolated raw text blocks compile into styled review outlines, formula indices, and vocabulary sheets.
4. Student Roster Assignments: Instructors click "Assign Outline" to distribute curriculum review packets to target rosters immediately.
ASR + TTS

🌐 6. Language Pack Mappings

Configure language translation matrices (ASR, Translation, TTS) inside your school catalog.

⚙️ Activating Language Codes: Administrators toggle target codes in Settings, adding them to active class rosters.
🎙️ ASR (Automated Speech Recognition): Captures and parses teacher voice feeds. Supports dialects, handling accents cleanly.
📝 Verbatim Translation Mappings: Translates text transcripts instantly, mapping complex vocabulary and formula symbols.
🔊 TTS (Text-to-Speech Voice Synthesis): Synthesizes translated segments into natural spoken audio, streaming feeds to student headphones.
Quick Diagnostics

🛠️ 7. Troubleshooting Checklist

Quick solutions for common operational and setup issues.

⚠️ Teacher Access Denied:

Verify administrator has enqueued active teacher seats. Check status parameters in the school roster panel.

⚠️ Student Access Denied:

Confirm the admin approved the request inside the "Join Requests Queue" and enqueued valid student rosters.

⚠️ Session Not Visible:

Confirm date parameters. Ensure the class active scheduled key matches current timelines.

⚠️ Microphone Not Capturing:

Open browser settings -> Site Permissions. Change Microphone parameters to "Allow". Confirm the mic button is green.

⚠️ Translation Stream Failed:

Confirm school internet connection. Verify that the target language pack is turned on inside admin global matrices.

⚠️ Synthesized TTS Audio Blocked:

Verify hardware headphone plugs and adjust speaker volumes. Check that the speaker icon is active inside the student sandboxes.

⚠️ Textbook OCR Failed:

Confirm file matches PDFs, EPUB, or PNG/JPEG. Ensure chapter document parameters remain below the 50MB file size limit.

⚠️ Language Pack Mappings Not Loading:

Check global network status. Run a quick "Provider Health Check" inside your admin catalog to audit connections.