Platform documentation

Institution onboarding guide

Follow the recommended setup sequence from institution profile creation to portal access, student launch, analytics, and teacher reporting.

Recommended path

Move from institution profile to reporting in one controlled sequence.

Each section opens with the required outcome. Expand a step when you need the operator-level instructions.

1 Foundation Review institutional scope Confirm the institution attached to your administrator account before setup begins.

Have ready

  • Administrator login
  • Institution name shown in the admin workspace
  • Correct role assignment

Directions

Sign in to the Admin Portal

Use the Admin Portal login at /1aa/auth/login.php. Your institution is automatically assigned based on your administrator account, so school-wide administrators do not need to select a school during daily setup.

Confirm your role

Director Administrators manage institution-wide setup. Department Administrators work inside their assigned academic unit.

Use the setup checklist

Complete the hierarchy in order so each later workflow has the records it needs.

2 Foundation Create administrator users Delegate setup and review work to the correct school-wide or academic-unit administrators.

Have ready

  • Administrator name and email
  • Role
  • Academic-unit assignment when needed

Directions

Open Administrators

Use People > Administrators to create accounts for operational staff.

Choose the correct role

Use Director Administrator for institution-wide work and Department Administrator for academic-unit-scoped work.

Review access before launch

Administrators should only see the workflows and records relevant to their assigned scope.

3 Academic Structure Create academic units Academic units establish ownership for departments, tracks, streams, teachers, courses, registry rows, and reports where the institution uses them.

Have ready

  • Academic unit names
  • Academic unit abbreviations or codes
  • Responsible academic-unit administrators

Directions

Open Departments

Use Academic Setup > Departments. For secondary schools this page is labeled for tracks or streams when applicable.

Use consistent names

Match official academic naming so imports, reports, and administrator searches are easy to understand.

Create units before programs

Programs/options depend on an academic unit. Secondary schools can skip this when they organize directly by level and class section.

4 Academic Structure Create optional programs and academic levels Programs, levels, and class sections determine which courses students can see in an evaluation session.

Have ready

  • Programs or specializations when enabled
  • Academic level names
  • Class sections when used
  • Academic unit ownership when used

Directions

Create options where needed

Use Academic Setup > Options for tertiary programs or specializations when enabled for the institution type.

Create academic levels

Use Academic Setup > Academic Levels for levels such as Level 100, Year 2, or Master 1.

Keep optional modules intentional

Options are optional and hidden for secondary profiles. Academic levels are required when courses and registry rows are level-based.

5 Evaluation Design Create the semester The semester gives the evaluation cycle its academic period and reporting context.

Have ready

  • Semester name
  • Start date
  • End date
  • Current term decision

Directions

Open Semesters

Use Evaluation > Semesters to add the academic period.

Match the calendar

Use dates that reflect the institution calendar so session windows make sense to students and staff.

Review before sessions

Evaluation Sessions require a semester. Create the semester before building the session.

6 Evaluation Design Create matrices, questions, and rating options Build the measurement model students will answer during evaluations.

Have ready

  • Matrix categories
  • Question wording
  • Rating or choice options

Directions

Create matrix categories

Use Evaluation > Questions to organize questions into meaningful evaluation dimensions.

Write clear questions

Use language students can answer consistently. Avoid combining multiple ideas into one question.

Configure options

Use rating scales or configured choices that match the intended analytics.

7 Evaluation Design Create the evaluation template Assemble approved questions into the reusable form used by a session.

Have ready

  • Template name
  • Selected questions
  • Review owner

Directions

Open Templates

Use Evaluation > Evaluation Templates to create the form.

Attach questions

A template must contain assigned questions before it can be used for an evaluation session.

Keep the first template focused

For first launch, use a concise template that covers core teaching quality dimensions.

8 Launch Preparation Create and activate the evaluation session The active session becomes the current evaluation cycle for registry, course activation, and student access.

Have ready

  • Semester
  • Evaluation template
  • Session name
  • Open and close dates

Directions

Open Evaluation Sessions

Create the session after the semester and template are ready.

Set the session status

Activate the session when it should become the current cycle for setup and launch. The submission window still depends on the configured dates.

Expect one current active cycle

The platform treats a single active session as the current cycle for your institution. Activating a new session closes the previous active cycle.

9 Academic Operations Add teachers Teacher records must exist before courses can be assigned for evaluation analytics.

Have ready

  • Teacher names
  • Email addresses
  • Academic-unit placement when used

Directions

Open Teachers

Use People > Teachers to add instructors inside your institution.

Set optional placement

Academic-unit placement keeps teacher lists, course assignment, and reporting aligned when the institution uses departments, tracks, or streams.

Review status

Inactive teacher records should not be used for new evaluation assignments.

10 Academic Operations Create course catalog records Course Catalog records define reusable course names, codes, levels, academic units, and program mapping when used.

Have ready

  • Course code
  • Course title
  • Academic unit when used
  • Academic level
  • Program/option when applicable

Directions

Open Course Manager

Use Academic Setup > Course Manager and start in Catalog Browser.

Create or review course definitions

Keep official names and codes consistent. Avoid duplicates before assigning teachers or sessions.

Confirm academic mapping

The course academic unit, program/option, level, and class section assignment determine which students can see the course.

11 Academic Operations Create course bundles Bundles help large institutions activate repeatable sets of courses without rebuilding lists each term.

Have ready

  • Course definitions
  • Bundle name
  • Academic-unit, level, or program purpose

Directions

Open Bundle Builder

Use Course Manager > Bundle Builder to create reusable groups.

Name bundles clearly

Use patterns such as Computer Science Level 200 - Semester 1.

Use bundles for repeatable launches

Bundles are optional, but recommended when many courses are reused each term.

12 Academic Operations Assign teachers and activate courses into the session Teacher assignment and session activation make courses eligible for student evaluations.

Have ready

  • Active evaluation session
  • Course catalog records
  • Teacher records

Directions

Assign instructors

Use Course Manager > Teacher Assignment or Academic Setup > Assign Courses to connect teachers to courses. Choose a target session and optional class section when one course offering is split across sections.

Activate selected courses

Use Course Manager > Bulk Activation to add selected catalog records or bundles to the active session.

Review session assignments

Courses without an instructor or session assignment will not produce the expected student evaluation flow.

13 Student Access Upload the student registry The registry verifies which students belong to the active session and what academic context and class section they use.

Have ready

  • Active evaluation session
  • Academic units when used
  • Levels
  • Class sections when used
  • Options when applicable
  • Student identifiers

Directions

Prepare the import file

Use the columns shown in Student Registry. Tertiary schools usually use reg_no, department, program, level, optional class_section, and status; secondary schools can use reg_no, level, class_section, and status, with track/stream only when configured.

Open Student Registry

Use People > Student Registry. Your institution is applied automatically from your administrator account.

Resolve rejected rows

Fix missing identifiers, duplicate rows, inactive statuses, unmatched academic placement, or class section names that have not been defined under Academic Levels before inviting students.

14 Launch Launch student evaluations Students complete one evaluation per eligible course during the active submission window.

Have ready

  • Active session
  • Open dates
  • Assigned courses
  • Teacher assignments
  • Uploaded registry

Directions

Run the launch review

Confirm the session, template, course activations, teacher assignments, and registry are ready.

Invite students

Share the Student Portal login at /3sa/auth/login.php and ask students to use their official identifier.

Monitor progress

Use Dashboard, Evaluations, and Reports to watch completion while the window is open.

15 Reporting Review analytics and reports Analyze participation, aggregate ratings, teacher summaries, comments, and follow-up priorities.

Have ready

  • Completed submissions
  • Closed or monitored session
  • Reporting audience

Directions

Open Dashboard and Reports

Use the admin reporting views to review completion, trends, and course-level results.

Share teacher access

Teachers use the Teacher Portal login at /2ta/auth/login.php to view feedback related to their assigned courses.

Plan improvements

Use aggregate results and comments to support department reviews, teacher coaching, and quality improvement planning.

Need more context?

Use the KB hub for adjacent setup topics.

Administration, registry, evaluation setup, reporting, security, and troubleshooting sections are ready to expand as the platform grows.

Open Docs Hub