Getting Started & Reference Guide
Welcome to your new intelligent timetabling partner. This guide will provide you with the information needed to move from initial setup to a fully optimized school schedule.
Initial Login
To begin, navigate to myschooljamaica.com
in your web browser. Click the Login button, select your school from the list, and enter your credentials. This guide will focus on two primary user roles: the Principal and the Head of Department (HOD) Teacher.
Part 1: The Principal's Role - Building the Blueprint
As the Principal, your first task is to create the foundational "blueprint" for your school's schedule. This involves defining the core rules, periods, and availability that will govern the entire timetabling process.
1.1 Accessing the Academic Framework
After logging in as the Principal, you will be directed to your main dashboard. To access the timetabling module:
- Locate the main menu sidebar.
- Click on TIMETABLE.
- From the dropdown menu, select Academic Framework.
The system will load the Timetable Framework Manager. On the left, you will see all of your school's classes, conveniently grouped by grade level. The framework you create will be for a specific academic period, which can be selected from the top of the screen (e.g., 2025-2026, CHRISTMAS).
1.2 Defining Your Timetable Structure
Before you can define the requirements for individual classes, you must establish the master rules for the schedule. This is the single source of truth for all scheduling.
To begin, click the Define Structure button located in the top-right corner of the Timetable Framework Manager.
This will open the Define Timetable Structure screen, which is divided into three key areas for setting up the DNA of your academic week.
A. Master Period Grid
This grid at the top-left is where you define your school's standard day.
- To Add a Period: Click the Add Period button.
- Order: Use the up and down arrows to re-order your periods.
- Period ID & Name: Assign a unique ID (e.g., 1, 2, B, 3) and a descriptive name (e.g., Period 1, Period 2, Break).
- Start/End Times: Set the start and end times for each period.
- Break?: Check this box to designate a period as an official school-wide break. The system will ensure no academic lessons are scheduled during this time.
- Bell: Assign a bell schedule to each period. Most will use the default "All Classes" bell.
B. Class Time-Off
This powerful feature on the right allows you to block out specific periods for individual classes, perfect for handling things like weekly planning sessions or special assemblies.
- Select a Class: Use the dropdown menu to choose the class you wish to modify (e.g.,
1A
). - Mark Time-Off: The grid displays the entire week. Click on a specific period to mark it as unavailable. In the example provided, Thursday Period 7 is marked with a red 'X', making it unavailable for class
1A
. - Legend: The colors indicate the status: Green (Available), Blue (Conditional), and Red (Not Available).
C. Use different bell times for different classes
This section at the bottom-left is essential for schools with complex schedules, such as staggered lunch breaks for different grade levels.
- Enable: The feature is active when the "Use different bell times..." checkbox is ticked.
- Configure a Bell: Select a different bell schedule to configure (e.g.,
Bell 2
). - Assign Classes: Select a class from the list (e.g.,
1G
,1J
) to move it from the default bell schedule (Bell 1
) to the alternate one you are configuring. This ensures these classes will follow a unique timetable rhythm.
Once you have configured the Master Period Grid, Class Time-Off, and any unique bell schedules, click the Save Structure button to lock in your timetable's foundation. You will then be returned to the Framework Manager, ready to define the specific subject requirements for each class.
Part 1: The Principal's Role - Building the Blueprint (Continued)
1.3 Defining Subject Requirements for Each Class
Once you have saved your master structure, you can begin the core task of the framework: defining the specific lesson requirements for each class. This is where you translate your curriculum into a concrete set of rules for the scheduling engine.
The process begins by selecting a class from the list on the left-hand side. The main area of the screen will then display the requirements for that specific class (e.g., "Requirements for: 1A").
Before adding subjects, you have two powerful tools available to handle complex scheduling needs: Divisions and Time-Off.
A. Creating Class Divisions (Optional)
Divisions allow you to split a single class into smaller groups for specific subjects, such as separating students for different electives (Woodwork/Home Economics) or skill groups.
- With a class selected, click the Divisions button.
- In the "Define Divisions" window, you can create blocks and groups. For example, a "Gender" block with "Boys" and "Girls" groups, or a practicals block with "Group 1", "Group 2", and "Group 3".
- Click Save Divisions. These groups will now be available to assign to specific subject requirements.
B. Setting Class-Specific Time-Off (Optional)
While you set school-wide time-off in the main structure, you can also block out additional periods for a specific class.
- With a class selected, click the Time-Off button.
- A weekly grid will appear. Click any period to mark it as unavailable (red 'X') for this class only.
- Click Done. The system will now know not to schedule any lessons for this class during those marked-off times.
C. Adding and Configuring Subject Requirements
This is the main building block of your timetable.
- Click the + Add Subject Requirement button to create a new, empty row.
- Fill in the details for the lesson:
- Subject: Select the subject from the dropdown list (e.g., Mathematics, English Language).
- Times per Week: Enter how many times this specific lesson configuration should occur (e.g., 2 times per week).
- Lesson Length: Specify if it's a Single, Double, or Triple period lesson.
- Division / Group: Assign the lesson to the Entire class or select one of the specific divisions you created (e.g.,
1.he
for Home Economics). This ensures only part of the class is scheduled for this lesson. - Joint Classes: If this lesson is taught together with another class, you can link them here.
As you add and modify these requirements, two intelligent processes happen in the background:
- Live Validation: The system continuously validates your rules. A status bar at the top provides immediate feedback, such as
"The lesson requirements are valid and can fit into the schedule structure."
or a warning if there's an issue. The Total Periods counter also updates, showing you how many of the available weekly periods you have filled. - AI Assistant: If you create a set of requirements that is logically impossible to schedule (e.g., requesting too many double periods), the AI assistant will provide proactive, human-readable advice to help you resolve the conflict.
D. Copying Requirements for Efficiency
To save significant time, you can set up the requirements for one "template" class and then copy them to other classes in the same grade level.
- After perfecting the requirements for a class (e.g.,
1S
), click the Copy... button. - The "Copy Requirements to Other Classes" window will appear.
- Select one or more destination classes (e.g.,
1J
,1A
). - Click the Copy to... button. This will overwrite any existing requirements in the selected classes with the new template.
After defining the requirements for all classes, your blueprint is complete. The final step is to click the Save Framework button to secure all your hard work.
Part 2: The HOD's Role - The Command Center
With the academic blueprint finalized by the Principal, the next phase is to deploy your expert staff. This stage is designed primarily for Heads of Department (HODs), empowering them to strategically assign teachers to the lessons defined in the framework1. This section is the "Command Center," transforming resource management into a proactive and intelligent process2.
2.1 Accessing the Deployment Dashboard
There are two ways to access the deployment module, depending on your role:
- As a Principal/Admin:
- From the main menu sidebar, navigate to TIMETABLE > Teacher Deployment.
- You will see a dropdown menu listing all academic departments. Select the department you wish to manage.
- As an HOD Teacher:
- Visit
myschooljamaica.com
, log in by selecting your school, and set the user type to Teacher. - Enter your credentials.
- On your sidebar menu, select Teacher Deployment.
- The dashboard will automatically load with the subject requirements for your assigned department. (Note: If you do not see any departments, please contact your administrator to be assigned as an HOD.)
- Visit
2.2 Assigning Teachers to Requirements
The HOD Deployment Dashboard gives you a crystal-clear overview of every teaching session required for your department3. The screen lists each class, subject, and the specific sessions needed (e.g., 2 x Double, 2 x Single).
Your task is to assign a teacher to each of these requirements.
- Find a row with "Click to assign..." in the Assigned Teacher(s) column.
- Click in this area. A dropdown list of available teachers in your department will appear.
- Select the appropriate teacher for that lesson. You can assign multiple teachers to a single requirement for team-teaching.
2.3 Live Workload Intelligence
As you assign teachers, the system acts as an intelligent partner, providing instant feedback:
- Real-time Calculation: The moment a teacher is assigned, their total period load is calculated and displayed directly under their name4. For example, "Load: 16 / 35 (16 in this dept)".
- Automatic Flags: The system automatically flags teachers who are approaching their maximum teaching capacity, helping you prevent over-allocation before it becomes a problem.
- Visual Clarity: Each teacher's name appears as a tag, making it easy to see who is assigned where at a glance.
2.4 AI-Powered Risk Assessment
This is a game-changer for HODs. At any point, you can get an expert risk assessment of your deployment choices.
- Click the AI Analysis button in the top-right corner.
- The system, powered by Google's Gemini model, will analyze your assignments for potential bottlenecks and complex conflicts.
- The AI Risk Assessment provides human-readable advice8. It may identify issues such as a teacher having a high workload compared to others, or block constraints where a split class assignment could complicate scheduling.
2.5 Printing the Deployment Report
For offline review or departmental meetings, you can easily generate a clean, printable report of your assignments.
- Click the Print button in the top-right corner.
- A Teacher Deployment Report will be generated, listing each teacher in the department and showing their specific class assignments and total number of sessions.
Of course. This is the final and most exciting stage, where the planning and deployment come together to create the schedule. Here is the detailed content for the final part of the guide based on the screenshots provided.
Part 3: The Engine Room - Generating Your Timetable
Welcome to the Engine Room. This is where the magic happens1. After you have built the perfect academic structure in the Framework and assigned your expert staff in the Deployment Dashboard, the placement engine takes over. This sophisticated problem-solver is built to handle the true complexity of a modern school and find a valid placement for every single lesson2.
3.1 Creating Your Timetable File
Your first step is to create a new timetable instance for the engine to work on.
- From the main menu, navigate to the Timetabling section and choose to create a new timetable.
- The New Timetable Properties window will appear.
- Timetable Title: Give your schedule a descriptive name (e.g., "Master Schedule Fall 2025").
- Academic Year / Term: Select the correct period you have been building the framework for.
- You now have two powerful options:
- Create Empty Timetable: This creates a blank schedule, useful for fully manual planning or special cases.
- Create & Infer Lessons: This is the standard and recommended option. It automatically pulls in all the requirements from the Academic Framework and all the teacher assignments from the HOD Deployment Dashboard, populating your workspace with all the lessons that need to be placed.
3.2 The Timetable Workspace & Toolbar
After inferring lessons, you will be presented with the main timetable workspace. This is your visual command center for the entire schedule.
- The Grid: The main area is a large grid with classes listed as rows and the weekly periods as columns. This is where lessons will be placed.
- The Lesson Pool: At the bottom of the screen is the pool of all unplaced lessons that the engine needs to schedule.
You have a range of tools in the main toolbar to manage the process:
- Main Toolbar Functions: (From left to right)
- View Selector: Switch between Whole, Class, Teacher, or Subject views.
- Add: Manually add a new lesson.
- Save: Save your current progress.
- Lock: Lock a placed lesson, preventing the engine from moving it.
- Delete: Remove a selected item.
- Split: Split a placed lesson.
- Find Conflict: Analyze a specific lesson for conflicts.
- Print: Print the current timetable view.
- Engine Toolbar Functions: (On the right)
- Generate (Hammer Icon): Opens the Timetable Generation engine.
- Settings (Gear Icon): Opens panels to manage classes, teachers, and subjects directly.
3.3 Running the Automated Placement Engine
Once you are ready to have the system solve the puzzle:
- Click the Generate button (hammer icon) on the toolbar.
- The Timetable Generation window will appear, presenting a pre-flight check and generation options.
- Pre-flight Report: The system first runs a final validation to ensure everything is in order. A "Pre-flight check passed" message means you are ready to go.
- Generation Mode: You can choose the strategy for the engine:
- Strict: Enforces every single rule you have defined without exception. The engine will succeed only if a perfect solution exists within your constraints.
- Normal: This mode uses advanced strategies, like intelligent shuffling and swapping, to resolve gridlocks and find a valid placement3. It performs multiple passes to solve the schedule in the most efficient way4.
- Click Start Generation. The engine will begin analyzing thousands of potential conflicts per second to build the optimal schedule5.
3.4 Reviewing and Fine-Tuning
After the engine runs, the grid will be populated with the placed lessons. You can then review the results and make final adjustments using the Settings panel (gear icon).
- Manage Classes: From the settings panel, you can select "Classes" to see an overview of all classes, their total scheduled sessions, and a visual of their time-off.
- View and Edit Lessons: By selecting a class and clicking "Lessons," you can see a detailed list of every lesson for that class. Here you can assign specific classrooms or make other minor edits.
- Granular Lesson Editor: Clicking "Edit" on any lesson opens a detailed view where you can adjust teachers, subjects, class assignments, and lesson lengths for minor, post-generation tweaks.
Finally, if the automated engine cannot solve a particularly stubborn conflict, the integrated AI Assistant can step in. It can analyze the specific conflict and provide a suggested manual swap or adjustment to resolve the issue, giving you the final piece of the puzzle6.
Comments
0 comments
Please sign in to leave a comment.