System for Cameroon secondary schools to generate their school time tables
# Cameroonian Secondary School Timetable & Automatic Generation System
> **A multi-tenant SaaS scheduling platform tailored specifically for Cameroonian secondary schools (Anglophone & Francophone subsystems), powered by an automated constraint-satisfaction timetable engine with interactive manual editing and lesson locking.**
---
## 🌟 Executive Summary
Traditional timetable construction in Cameroonian secondary schools is complex, time-consuming, and prone to scheduling conflicts. School administrators are often forced to manually fill grid cells line-by-line while balancing dozens of classes, teachers, subjects, special lab requirements, and teacher availability.
This system replaces manual cell-by-cell creation with an **automated constraint-based timetable engine**. Administrators define school operating hours, period durations, break slots, classes/sections, teachers, and teaching assignments (with period requirements). The system automatically computes a conflict-free timetable across the entire institution within seconds, while giving administrators complete freedom to tweak, swap, drag-and-drop, lock, and export high-resolution print-ready PDFs (A3/A2 Landscape).
---
## 🏛️ System Roles & Multi-Tenant Architecture
Designed as a **multi-tenant SaaS platform**, a single deployment can securely serve hundreds of secondary schools across Cameroon.
```
SYSTEM
│
┌──────────────┴──────────────┐
│ │
School A School B
│ │
School Admin School Admin
│ │
┌───────┼───────┐ ┌───────┼───────┐
Teachers Classes Subjects Teachers Classes Subjects
```
### Roles & Responsibilities
| Role | Primary Responsibilities |
| :--- | :--- |
| **System Admin** | Provision schools, activate/suspend school accounts, create first School Admin, manage SaaS subscriptions, view platform metrics. |
| **School Admin** | Configure school hours/breaks, …