PuzzleRoster
1. Про PuzzleRoster
Система PuzzleRoster створена для науково-освітніх центрів, які пропонують поглиблене вивчення окремих предметів (фізика та/або хімія) учням з різних шкіл. У таких центрів є специфічні вимоги до побудови системи розкладу — потрібно узгоджувати дні та час навчання одразу з усіма школами, звідки набрані учні в навчальні групи. Застосунок полегшує різним категоріям співробітників — адміністраторам, вчителям, лаборантам — керувати десятками робочих процесів: від взаємодії зі школами-партнерами до розподілу лабораторій та навчальних кабінетів виходячи з обладнання, замовленого викладачами. Керівництву центру система дає змогу керувати навантаженням викладачів (загальний робочий час, кількість годин викладання, кількість учнів у групах) та приймати різні управлінські рішення. Система також дозволяє збирати, обробляти та аналізувати всі статистичні дані, пов'язані з роботою центру.
- Без обмеженьза кількістю шкіл-партнерів
- Гнучкі групиз учнів різних шкіл
- Розумний розподіллабораторій за заданими параметрами
- Вбудований пошукзаміни вчителя
- Особистий кабінетдля кожного вчителя
- Екрани в коридорахдля вчителів і учнів
2. Хто працює в системі
У системі вісім ролей. Одному співробітнику може бути призначено декілька ролей одночасно.
| Роль | Хто це | Що робить |
|---|---|---|
| Суперадмін | Технічний керівник | Повний доступ. Керування довідниками, співробітниками, загальними налаштуваннями. |
| Адміністратор | Будь-який співробітник з адміністративними правами — зокрема як додаткова роль | Розглядає вхідні запити на зміни в розкладі, уточнює параметри та підтверджує їх. Єдиний, хто реально вносить зміни в дані — approve або reject. |
| Учитель | Викладач | Ініціює зміни в розкладі: перенесення, скасування, заміни, замовлення обладнання. Усе оформлюється як запит до адміністратора — учитель нічого не змінює напряму. |
| Лаборант | Співробітник лабораторії | Бачить список майбутніх уроків із замовленим обладнанням. Готує та доставляє комплекти. Не створює і не змінює замовлення — тільки виконує. |
| Директор | Директор освітнього центру | Повний перегляд розкладу та звітів за будь-який період. Керує навантаженням учителів і призначає заміни. Може також вести уроки (якщо призначений учителем). |
| Завуч | Заступник директора з навчальної роботи | Перегляд розкладу та звітів по вчителях свого предмета. Керує навантаженням учителів і призначає заміни. Може також вести уроки (якщо призначений учителем). |
| Секретар | Секретар / адміністратор офісу | Тільки читання: повний розклад, усі звіти, будь-який період. Не може вносити зміни. |
| Координатор центру | Співробітник центру | Веде взаємодію зі школами з боку освітнього центру. Супроводжує школи, координує організаційні питання. |
3. Основні процеси
3.1 Річний шаблон та перестроювання
Розклад побудований у два рівні. Верхній рівень — річний тижневий шаблон: типове навантаження кожного вчителя та групи. Нижній рівень — фактичний потижневий розклад на весь навчальний рік, згенерований на основі цього шаблону.
archived: повністю
зникає з усіх розкладів і вітрин, щоб до кінця року не накопичувались «уроки-привиди», але
фізично залишається в таблиці — зовнішні ключі історії заявок та аудиту не дозволяють його
видалити.
3.2 Зміни в розкладі
Розклад будується на навчальний рік, але щоденні коригування виникають постійно. Система проводить їх чітким маршрутом:
3.3 Підготовка обладнання
3.4 Заміна вчителя
Якщо вчитель не може провести урок, адміністратор, директор або завуч підбирають заміну зі списку вчителів, доступних у цей час, із відповідним профілем предмета. Урок одразу відображається як заміна всюди — у розкладі та на коридорних табло.
3.5 Наповнення системи даними (робочий процес)
Дані вносяться в суворому порядку — кожен крок залежить від попереднього.
- 11 таблиць — первинне наповнення системи (bootstrap)
- 2 таблиці — каталоги дослідів (фізика і хімія)
- 2 таблиці — заявки та листування
- 4 таблиці — блокування та знімки дня
- 2 таблиці — історія та журнали
- 1 таблиця — права доступу
- 4 таблиці — черга листів, правила, адреси відправників, статус доставки
- 1 таблиця — налаштування системи
- 2 таблиці — навчальний календар
- 2 таблиці — дані персоналу
4. З чого складається система
Система побудована з кількох незалежних компонентів, кожен відповідає за свою частину:
| Компонент | Що робить |
|---|---|
| База даних | Зберігає всі дані та забезпечує виконання всіх правил: перевірку, блокування, історію змін |
| API-сервер | Приймає запити, перевіряє, хто що може робити, і передає команди в базу даних |
| Веб-інтерфейс | PuzzleRoster, повністю на івриті (RTL) |
| Коридорні табло | Окремі екрани для коридорів центру — актуальний розклад дня для вчителів і спрощена версія для учнів, без особистого входу (автентифікація за статичним ключем пристрою) |
| Сповіщення | Подієвий конвеєр: кожна дія (запит подано/схвалено/відхилено, замовлення обладнання, заміна викладача, обслуговування сервера) записує подію в чергу всередині тієї самої транзакції — збій запису ніколи не блокує саму дію. Фоновий відправник визначає отримувачів за роллю, предметом і учасниками події з таблиці правил, формує лист і надсилає його через транзакційний поштовий сервіс — з автоматичними повторами та вимикачем у адміністратора. Месенджери (Telegram, WhatsApp) залишаються можливим напрямом розвитку. |
| Інфраструктура | Розгорнута в Docker-контейнерах на сервері AWS, з автоматичним щоденним резервним копіюванням бази даних |
5. Надійність і безпека
- Кожен користувач отримує токен доступу після входу. Токен дійсний 2 години (автоматичний вихід після 30 хвилин бездіяльності) і містить його роль. Без дійсного токена доступу немає — без винятків.
- Кожне правило виконується на рівні бази даних — обійти їх через інтерфейс неможливо.
- Backend звертається до бази під окремою, урізаною роллю: у неї фізично відкликані права на
пряме вставлення та видалення в таблицях уроків, журналів і сесій редагування — будь-яка зміна
розкладу можлива тільки через збережені функції з явно підвищеними правами
(
SECURITY DEFINER). - Історію змін не можна змінити чи видалити — жодним користувачем, у жодній ролі. Це гарантує повну прозорість кожної дії в системі.
- Система автоматично блокує конфлікти розкладу.
- Доступ до інтернету побудований на засадах Zero Trust — через Cloudflare Tunnel.
- 391 автоматизована регресійна перевірка (рівні API та БД) перед кожним деплоєм — покриває ланцюжки погодження заявок, заміни викладачів, заморозку/відкат дня, запобігання конфліктам розкладу (EXCLUDE USING GIST), замовлення обладнання та матрицю правил розсилки.