feat(timetable): generate a timetable scenario that keeps every hard wish

appinfo/routes.php

@@ -53,4 +53,8 @@
     ['name' => 'timetable#upsert', 'url' => '/api/timetable/sessions/upsert', 'verb' => 'POST'],
     // Admins publish a source's draft lessons in a window (timetable-draft-review).
     ['name' => 'timetable#publish', 'url' => '/api/timetable/sessions/publish', 'verb' => 'POST'],
+    // Admins upload the activities and rooms sheets for the timetable generator (timetabling-generator 2.2).
+    ['name' => 'timetableInput#upload', 'url' => '/api/timetable/input/upload', 'verb' => 'POST'],
+    // Admins start a generator run for a timetable scenario (timetabling-generator 5.2).
+    ['name' => 'timetableScenario#generate', 'url' => '/api/timetable/scenarios/{id}/generate', 'verb' => 'POST'],
 ]);

l10n/be.js

@@ -1008,7 +1008,44 @@ OC.L10N.register(
         "Reason": "Прычына",
         "Why the run failed": "Чаму запуск не ўдаўся",
         "Published at": "Апублікаваны",
-        "When the scenario was written out as draft lessons": "Калі сцэнарый запісаны як чарнавыя ўрокі"
+        "When the scenario was written out as draft lessons": "Калі сцэнарый запісаны як чарнавыя ўрокі",
+        "Edit wish": "Рэдагаваць пажаданне",
+        "New wish": "Новае пажаданне",
+        "Hard: the generator always keeps it": "Абавязковае: генератар заўсёды яго выконвае",
+        "Soft: the generator keeps it where it can": "Гнуткае: генератар выконвае яго, калі можа",
+        "Weight (1 to 3)": "Вага (ад 1 да 3)",
+        "Most lessons a day": "Не больш за столькі ўрокаў у дзень",
+        "Period": "Урок",
+        "{day} period {number}": "{day} урок {number}",
+        "Teacher (user name)": "Настаўнік (імя карыстальніка)",
+        "Activity (group:subject)": "Заняткі (група:прадмет)",
+        "Say who or what the wish is about.": "Пазначце, каго ці чаго датычыць пажаданне.",
+        "Choose at least one period.": "Выберыце хаця б адзін урок.",
+        "The limit is a whole number of 1 or more.": "Ліміт: цэлы лік ад 1.",
+        "Timetable": "Расклад",
+        "Wishes": "Пажаданні",
+        "Timetable wishes": "Пажаданні да раскладу",
+        "Generator run": "Запуск генератара",
+        "Generator progress": "Ход генератара",
+        "The run failed: {reason}": "Запуск не ўдаўся: {reason}",
+        "{placed} of {lessons} lessons placed": "Размешчана {placed} з {lessons} урокаў",
+        "Generate again": "Згенераваць зноў",
+        "Generate": "Згенераваць",
+        "Every lesson has a place.": "Кожны ўрок мае месца.",
+        "Lesson": "Урок",
+        "No free period and room": "Няма вольнага ўрока і кабінета",
+        "Broken soft wishes": "Парушаныя гнуткія пажаданні",
+        "Every soft wish is kept.": "Кожнае гнуткае пажаданне выканана.",
+        "Wish": "Пажаданне",
+        "Lessons": "Урокі",
+        "Generating: {percent}% of the time budget used": "Генерацыя: выкарыстана {percent}% часу",
+        "Waiting to start": "Чакае запуску",
+        "Published as draft lessons": "Апублікавана як чарнавікі ўрокаў",
+        "Could not read the scenario.": "Не ўдалося прачытаць сцэнарый.",
+        "Could not start the run.": "Не ўдалося пачаць запуск.",
+        "Scenarios": "Сцэнарыі",
+        "Timetable scenarios": "Сцэнарыі раскладу",
+        "Scenario": "Сцэнарый"
     },
     "nplurals=2; plural=(n != 1);"
 )

l10n/be.json

@@ -1007,7 +1007,44 @@
         "Reason": "Прычына",
         "Why the run failed": "Чаму запуск не ўдаўся",
         "Published at": "Апублікаваны",
-        "When the scenario was written out as draft lessons": "Калі сцэнарый запісаны як чарнавыя ўрокі"
+        "When the scenario was written out as draft lessons": "Калі сцэнарый запісаны як чарнавыя ўрокі",
+        "Edit wish": "Рэдагаваць пажаданне",
+        "New wish": "Новае пажаданне",
+        "Hard: the generator always keeps it": "Абавязковае: генератар заўсёды яго выконвае",
+        "Soft: the generator keeps it where it can": "Гнуткае: генератар выконвае яго, калі можа",
+        "Weight (1 to 3)": "Вага (ад 1 да 3)",
+        "Most lessons a day": "Не больш за столькі ўрокаў у дзень",
+        "Period": "Урок",
+        "{day} period {number}": "{day} урок {number}",
+        "Teacher (user name)": "Настаўнік (імя карыстальніка)",
+        "Activity (group:subject)": "Заняткі (група:прадмет)",
+        "Say who or what the wish is about.": "Пазначце, каго ці чаго датычыць пажаданне.",
+        "Choose at least one period.": "Выберыце хаця б адзін урок.",
+        "The limit is a whole number of 1 or more.": "Ліміт: цэлы лік ад 1.",
+        "Timetable": "Расклад",
+        "Wishes": "Пажаданні",
+        "Timetable wishes": "Пажаданні да раскладу",
+        "Generator run": "Запуск генератара",
+        "Generator progress": "Ход генератара",
+        "The run failed: {reason}": "Запуск не ўдаўся: {reason}",
+        "{placed} of {lessons} lessons placed": "Размешчана {placed} з {lessons} урокаў",
+        "Generate again": "Згенераваць зноў",
+        "Generate": "Згенераваць",
+        "Every lesson has a place.": "Кожны ўрок мае месца.",
+        "Lesson": "Урок",
+        "No free period and room": "Няма вольнага ўрока і кабінета",
+        "Broken soft wishes": "Парушаныя гнуткія пажаданні",
+        "Every soft wish is kept.": "Кожнае гнуткае пажаданне выканана.",
+        "Wish": "Пажаданне",
+        "Lessons": "Урокі",
+        "Generating: {percent}% of the time budget used": "Генерацыя: выкарыстана {percent}% часу",
+        "Waiting to start": "Чакае запуску",
+        "Published as draft lessons": "Апублікавана як чарнавікі ўрокаў",
+        "Could not read the scenario.": "Не ўдалося прачытаць сцэнарый.",
+        "Could not start the run.": "Не ўдалося пачаць запуск.",
+        "Scenarios": "Сцэнарыі",
+        "Timetable scenarios": "Сцэнарыі раскладу",
+        "Scenario": "Сцэнарый"
     },
     "plurals": {}
 }

l10n/bg.js

@@ -1008,7 +1008,44 @@ OC.L10N.register(
         "Reason": "Причина",
         "Why the run failed": "Защо изпълнението е неуспешно",
         "Published at": "Публикуван на",
-        "When the scenario was written out as draft lessons": "Кога сценарият е записан като чернови часове"
+        "When the scenario was written out as draft lessons": "Кога сценарият е записан като чернови часове",
+        "Edit wish": "Редактиране на желание",
+        "New wish": "Ново желание",
+        "Hard: the generator always keeps it": "Задължително: генераторът винаги го спазва",
+        "Soft: the generator keeps it where it can": "Гъвкаво: генераторът го спазва, когато може",
+        "Weight (1 to 3)": "Тежест (от 1 до 3)",
+        "Most lessons a day": "Най-много часове на ден",
+        "Period": "Час",
+        "{day} period {number}": "{day} час {number}",
+        "Teacher (user name)": "Учител (потребителско име)",
+        "Activity (group:subject)": "Дейност (група:предмет)",
+        "Say who or what the wish is about.": "Посочете за кого или за какво е желанието.",
+        "Choose at least one period.": "Изберете поне един час.",
+        "The limit is a whole number of 1 or more.": "Лимитът е цяло число от 1 нагоре.",
+        "Timetable": "Разписание",
+        "Wishes": "Желания",
+        "Timetable wishes": "Желания за разписанието",
+        "Generator run": "Изпълнение на генератора",
+        "Generator progress": "Напредък на генератора",
+        "The run failed: {reason}": "Изпълнението е неуспешно: {reason}",
+        "{placed} of {lessons} lessons placed": "Поставени {placed} от {lessons} часа",
+        "Generate again": "Генериране отново",
+        "Generate": "Генериране",
+        "Every lesson has a place.": "Всеки час има място.",
+        "Lesson": "Час",
+        "No free period and room": "Няма свободен час и стая",
+        "Broken soft wishes": "Нарушени гъвкави желания",
+        "Every soft wish is kept.": "Всяко гъвкаво желание е спазено.",
+        "Wish": "Желание",
+        "Lessons": "Часове",
+        "Generating: {percent}% of the time budget used": "Генериране: използвани {percent}% от времето",
+        "Waiting to start": "Изчаква старт",
+        "Published as draft lessons": "Публикувано като чернови часове",
+        "Could not read the scenario.": "Сценарият не можа да бъде прочетен.",
+        "Could not start the run.": "Изпълнението не можа да започне.",
+        "Scenarios": "Сценарии",
+        "Timetable scenarios": "Сценарии за разписание",
+        "Scenario": "Сценарий"
     },
     "nplurals=2; plural=(n != 1);"
 )

l10n/bg.json

@@ -1007,7 +1007,44 @@
         "Reason": "Причина",
         "Why the run failed": "Защо изпълнението е неуспешно",
         "Published at": "Публикуван на",
-        "When the scenario was written out as draft lessons": "Кога сценарият е записан като чернови часове"
+        "When the scenario was written out as draft lessons": "Кога сценарият е записан като чернови часове",
+        "Edit wish": "Редактиране на желание",
+        "New wish": "Ново желание",
+        "Hard: the generator always keeps it": "Задължително: генераторът винаги го спазва",
+        "Soft: the generator keeps it where it can": "Гъвкаво: генераторът го спазва, когато може",
+        "Weight (1 to 3)": "Тежест (от 1 до 3)",
+        "Most lessons a day": "Най-много часове на ден",
+        "Period": "Час",
+        "{day} period {number}": "{day} час {number}",
+        "Teacher (user name)": "Учител (потребителско име)",
+        "Activity (group:subject)": "Дейност (група:предмет)",
+        "Say who or what the wish is about.": "Посочете за кого или за какво е желанието.",
+        "Choose at least one period.": "Изберете поне един час.",
+        "The limit is a whole number of 1 or more.": "Лимитът е цяло число от 1 нагоре.",
+        "Timetable": "Разписание",
+        "Wishes": "Желания",
+        "Timetable wishes": "Желания за разписанието",
+        "Generator run": "Изпълнение на генератора",
+        "Generator progress": "Напредък на генератора",
+        "The run failed: {reason}": "Изпълнението е неуспешно: {reason}",
+        "{placed} of {lessons} lessons placed": "Поставени {placed} от {lessons} часа",
+        "Generate again": "Генериране отново",
+        "Generate": "Генериране",
+        "Every lesson has a place.": "Всеки час има място.",
+        "Lesson": "Час",
+        "No free period and room": "Няма свободен час и стая",
+        "Broken soft wishes": "Нарушени гъвкави желания",
+        "Every soft wish is kept.": "Всяко гъвкаво желание е спазено.",
+        "Wish": "Желание",
+        "Lessons": "Часове",
+        "Generating: {percent}% of the time budget used": "Генериране: използвани {percent}% от времето",
+        "Waiting to start": "Изчаква старт",
+        "Published as draft lessons": "Публикувано като чернови часове",
+        "Could not read the scenario.": "Сценарият не можа да бъде прочетен.",
+        "Could not start the run.": "Изпълнението не можа да започне.",
+        "Scenarios": "Сценарии",
+        "Timetable scenarios": "Сценарии за разписание",
+        "Scenario": "Сценарий"
     },
     "plurals": null
 }

l10n/bs.js

@@ -1008,7 +1008,44 @@ OC.L10N.register(
         "Reason": "Razlog",
         "Why the run failed": "Zašto pokretanje nije uspjelo",
         "Published at": "Objavljeno",
-        "When the scenario was written out as draft lessons": "Kada je scenarij zapisan kao nacrti časova"
+        "When the scenario was written out as draft lessons": "Kada je scenarij zapisan kao nacrti časova",
+        "Edit wish": "Uredi želju",
+        "New wish": "Nova želja",
+        "Hard: the generator always keeps it": "Obavezno: generator je uvijek poštuje",
+        "Soft: the generator keeps it where it can": "Fleksibilno: generator je poštuje gdje može",
+        "Weight (1 to 3)": "Težina (1 do 3)",
+        "Most lessons a day": "Najviše časova dnevno",
+        "Period": "Čas",
+        "{day} period {number}": "{day} čas {number}",
+        "Teacher (user name)": "Nastavnik (korisničko ime)",
+        "Activity (group:subject)": "Aktivnost (grupa:predmet)",
+        "Say who or what the wish is about.": "Navedite na koga ili šta se želja odnosi.",
+        "Choose at least one period.": "Odaberite barem jedan čas.",
+        "The limit is a whole number of 1 or more.": "Ograničenje je cijeli broj od 1 ili više.",
+        "Timetable": "Raspored",
+        "Wishes": "Želje",
+        "Timetable wishes": "Želje za raspored",
+        "Generator run": "Pokretanje generatora",
+        "Generator progress": "Napredak generatora",
+        "The run failed: {reason}": "Pokretanje nije uspjelo: {reason}",
+        "{placed} of {lessons} lessons placed": "Smješteno {placed} od {lessons} časova",
+        "Generate again": "Generiši ponovo",
+        "Generate": "Generiši",
+        "Every lesson has a place.": "Svaki čas ima mjesto.",
+        "Lesson": "Čas",
+        "No free period and room": "Nema slobodnog časa i učionice",
+        "Broken soft wishes": "Prekršene fleksibilne želje",
+        "Every soft wish is kept.": "Svaka fleksibilna želja je poštovana.",
+        "Wish": "Želja",
+        "Lessons": "Časovi",
+        "Generating: {percent}% of the time budget used": "Generisanje: iskorišteno {percent}% vremena",
+        "Waiting to start": "Čeka početak",
+        "Published as draft lessons": "Objavljeno kao nacrti časova",
+        "Could not read the scenario.": "Scenarij nije moguće pročitati.",
+        "Could not start the run.": "Pokretanje nije moguće započeti.",
+        "Scenarios": "Scenariji",
+        "Timetable scenarios": "Scenariji rasporeda",
+        "Scenario": "Scenarij"
     },
     "nplurals=2; plural=(n != 1);"
 )

l10n/bs.json

@@ -1007,7 +1007,44 @@
         "Reason": "Razlog",
         "Why the run failed": "Zašto pokretanje nije uspjelo",
         "Published at": "Objavljeno",
-        "When the scenario was written out as draft lessons": "Kada je scenarij zapisan kao nacrti časova"
+        "When the scenario was written out as draft lessons": "Kada je scenarij zapisan kao nacrti časova",
+        "Edit wish": "Uredi želju",
+        "New wish": "Nova želja",
+        "Hard: the generator always keeps it": "Obavezno: generator je uvijek poštuje",
+        "Soft: the generator keeps it where it can": "Fleksibilno: generator je poštuje gdje može",
+        "Weight (1 to 3)": "Težina (1 do 3)",
+        "Most lessons a day": "Najviše časova dnevno",
+        "Period": "Čas",
+        "{day} period {number}": "{day} čas {number}",
+        "Teacher (user name)": "Nastavnik (korisničko ime)",
+        "Activity (group:subject)": "Aktivnost (grupa:predmet)",
+        "Say who or what the wish is about.": "Navedite na koga ili šta se želja odnosi.",
+        "Choose at least one period.": "Odaberite barem jedan čas.",
+        "The limit is a whole number of 1 or more.": "Ograničenje je cijeli broj od 1 ili više.",
+        "Timetable": "Raspored",
+        "Wishes": "Želje",
+        "Timetable wishes": "Želje za raspored",
+        "Generator run": "Pokretanje generatora",
+        "Generator progress": "Napredak generatora",
+        "The run failed: {reason}": "Pokretanje nije uspjelo: {reason}",
+        "{placed} of {lessons} lessons placed": "Smješteno {placed} od {lessons} časova",
+        "Generate again": "Generiši ponovo",
+        "Generate": "Generiši",
+        "Every lesson has a place.": "Svaki čas ima mjesto.",
+        "Lesson": "Čas",
+        "No free period and room": "Nema slobodnog časa i učionice",
+        "Broken soft wishes": "Prekršene fleksibilne želje",
+        "Every soft wish is kept.": "Svaka fleksibilna želja je poštovana.",
+        "Wish": "Želja",
+        "Lessons": "Časovi",
+        "Generating: {percent}% of the time budget used": "Generisanje: iskorišteno {percent}% vremena",
+        "Waiting to start": "Čeka početak",
+        "Published as draft lessons": "Objavljeno kao nacrti časova",
+        "Could not read the scenario.": "Scenarij nije moguće pročitati.",
+        "Could not start the run.": "Pokretanje nije moguće započeti.",
+        "Scenarios": "Scenariji",
+        "Timetable scenarios": "Scenariji rasporeda",
+        "Scenario": "Scenarij"
     },
     "plurals": null
 }