# Технічні вимоги

## Вимоги до системи розкладу

**Система розкладу занять** Вашого закладу освіти повинна мати задокументований програмний інтерфейс для налагодження коректної та ефективної взаємодії між застосунком Unisched та нею. Нами вже реалізовано підтримку відповідних програмних інтерфейсів для отримання інформації про навчальні групи, кабінети, викладачів, а також безпосередньо розклад занять для:

* **Модулю «ПС-Розклад»** системи «ПС-Деканат» (автором системи є [ПП «Політек-Софт»](https://politek-soft.kiev.ua/))

{% hint style="success" %}
Якщо Ваш заклад освіти використовує іншу систему розкладу занять, ми готові допомогти Вам у її інтеграції зі застосунком Unisched (крім власних розробок закладу освіти). В такому випадку, просимо надати нам технічну інформацію щодо програмного інтерфейсу (API) та тестовий доступ до нього.
{% endhint %}

## Вимоги до корпоративних скриньок

Аби використовувати цифрові сервіси, доступні як частина розширеного функціоналу застосунку Unisched, Ваш заклад освіти повинен мати власний сервіс (або використовувати один з наявних на ринку, як-от Microsoft 365 або Google Workplace) корпоративної пошти. Кожен студент, а також усі працівники закладу освіти, які бажають мати доступ до застосунку Unisched, повинні отримати від уповноваженого представника ЗВО персональну скриньку у домені закладу освіти, наприклад: `ivan.franko@lnu.edu.ua`, де `ivan.franko` є довільним унікальним персональним ідентифікатором користувача, а `lnu.edu.ua` — доменом закладу освіти.

Окрім цього, Ваш провайдер корпоративної пошти повинен мати програмний інтерфейс для взаємодії на базі протоколів, зазначених нижче у розділі «Сервіси ідентифікації», або для цього можна використовувати сторонній сервіс, накшталт 

### Сервіси ідентифікації

<table><thead><tr><th width="362.84765625">Назва провайдера</th><th width="136.7781982421875">Розміщення</th><th width="118.86572265625">Протокол</th><th data-type="rating" data-max="5">Підтримка</th></tr></thead><tbody><tr><td>Microsoft 365 (Entra ID)*</td><td>SaaS</td><td>OpenIDC 1.0</td><td>5</td></tr><tr><td>Google Workplace (Single Sign-On)*</td><td>SaaS</td><td>OpenIDC 1.0</td><td>5</td></tr><tr><td>Okta Auth0</td><td>SaaS</td><td>OpenIDC 1.0</td><td>4</td></tr><tr><td>Keycloak</td><td>Власне</td><td>OpenIDC 1.0</td><td>4</td></tr><tr><td>Інші провайдери</td><td>Різне</td><td>OpenIDC 1.0</td><td>3</td></tr></tbody></table>

{% hint style="info" %}

* Заклад освіти може отримати доступ до Microsoft 365 та Google Workplace на безоплатній основі — детальінше про це дізнавайтеся на офіційних вебресурсах цих організацій.
* Okta Auth0 є безкоштовним за умови використання не більше ніж 25000 користувачів на місяць.
* Keycloak є рішенням з вільною (open source) ліцензією, яке Ваш ЗВО має розміщувати самостійно.
* Підтримка інших провайдерів не гарантується, адже багато наявних рішень посвоєму трактують положення загальновживаних програмних протоколів взаємодії.
  {% endhint %}

## Вимоги до SLA/SLI

**SLA (Service Level Agreement)** є угодою про рівень обслуговування між постачальником послуги (наприклад, хостинг-компанією, інтернет-провайдером, техпідтримкою) та клієнтом.

**SLI (Service Level Indicator)** — це показник рівня обслуговування, який кількісно відображає якість тієї чи іншої послуги, що надається постачальником. Це конкретна метрика, яка використовується для вимірювання фактичного рівня сервісу, наприклад:

* **Аптайм (Uptime)** — частка часу, коли сервіс доступний (наприклад, 99.9% часу за місяць);
* **Час відповіді** — середній час, за який система відповідає на запити користувачів; тощо.

### Вимоги до SLI сервісів закладу освіти

| Показник                | Значення |
| ----------------------- | -------- |
| Аптайм (на місяць):     | 95,833%  |
| Середній час відповіді: | 300 мс   |

#### Розшифровка показника аптайму

| Період           | Днів      | Годин    | Хвилин  | Секунд   |
| ---------------- | --------- | -------- | ------- | -------- |
| **За 1 день**    | `00` днів | `01` год | `00` хв | `00` сек |
| **За 1 тиждень** | `00` днів | `07` год | `00` хв | `02` сек |
| **За 1 місяць**  | `01` днів | `06` год | `26` хв | `21` сек |
| **За 1 рік**     | `15` днів | `05` год | `16` хв | `17` сек |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.unisched.app/for-institutions/joining/tech-requirements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.