Вхід до панелі
Сторінка входу відкривається українською (поки ви не вибрали мову); усе на ній по центру. Угорі — велика сова, знак «СОВА» і розшифрування (система оцінювання, відбору та аналізу). Сова один раз кліпає, коли сторінка відкривається. Якщо в системі ввімкнено «зменшити анімацію», сова не кліпає. До панелі входять за іменем і паролем свого облікового запису. Облікові записи бувають двох видів (це називається «роль»):
- користувач — працює з темами та каталогом: створює й запускає теми, позначає «так» / «ні», вивантажує таблиці, шукає в каталозі та постах, відбирає пости;
- адміністратор — усе те саме, плюс меню «Адміністрування»: обслуговування каталогу, «ШІ» та ліміти витрат, «Ключі», «Порівняння моделей», «Користувачі», «Здоров'я».
Облікові записи створює адміністратор на сторінці «Користувачі». Перший обліковий запис — адміністратор admin — створюється командою sudo sova panel-password на комп'ютері СОВИ (під час розробки — make panel-password, див. довідник налаштувань). Якщо панель уже працювала з одним паролем (до облікових записів), цей пароль тепер пароль адміністратора admin.
Облік користування. Панель записує входи, час роботи та якими розділами користуються — без змісту: без слів пошуку, без значень фільтрів і без того, що саме відкривали (які канали, пости й теми). Це саме написано під формою входу. Записи бачить лише адміністратор (сторінка «Користувачі», файл XLSX); зберігаються 180 днів.
Що можна зробити на цій сторінці
Щоб змінити мову панелі:
- Без вибору панель відкривається українською. На сторінці входу натисніть унизу під формою «УКР» або «РУС»: поточна мова — просто жирний напис, інша — кнопка. Після входу ті самі кнопки «УКР» і «РУС» є в шапці, праворуч від «Довідка». Вибрану мову позначено.
- Сторінка відкриється знову вибраною мовою; якщо ви йшли на якусь сторінку, після входу ви все одно на неї потрапите.
- Вибір запам'ятовується: до входу — у цьому браузері на рік, після входу — у вашому обліковому записі (діє в будь-якому браузері).
- Поки що перекладено шапку, сторінку входу та довідку до неї; решта сторінок лишається російською до серверного релізу.
Щоб змінити оформлення (світле чи темне):
- Під формою, нижче «УКР · РУС», натисніть «Світла», «Темна» або «Як у системі» (група «Оформлення»). Після входу ті самі три кнопки є в шапці кожної сторінки, поруч з «УКР» і «РУС».
- Вибір запам'ятовується так само, як мова: до входу — у цьому браузері, після входу — у вашому обліковому записі. Докладно — у довідці екрана блокування (lock.md).
Щоб увійти до панелі:
- Введіть своє ім'я в полі «Ім'я» (великі й малі літери не мають значення) і пароль у полі «Пароль».
- Натисніть «Увійти». Відкриється сторінка «Мої теми» або та сторінка, яку ви хотіли відкрити.
Щоб створити першого адміністратора (нове встановлення):
- Відкрийте термінал (вікно, де вводять команди) на цьому комп'ютері.
- Введіть
sudo sova panel-password. - На запитання про ім'я натисніть Enter: буде ім'я
admin(або впишіть своє). - Придумайте пароль не коротший за 12 знаків і введіть його двічі (знаків під час уведення не видно).
- Оновіть сторінку в браузері та увійдіть із цим ім'ям і паролем. Закривати програму не потрібно.
Якщо ви користувач і забули пароль:
- Попросіть адміністратора: він задасть вам новий пароль на сторінці «Користувачі».
- Увійдіть із новим паролем.
Якщо адміністратор забув пароль:
- У терміналі комп'ютера СОВИ виконайте
sudo sova panel-password. - На запитання про ім'я натисніть Enter (
admin) або впишіть своє ім'я адміністратора й задайте новий пароль. - Увійдіть із новим паролем. Усі ваші старі входи при цьому закінчаться; входи інших облікових записів лишаються.
- Увійдіть одразу після команди: ця команда і скидання пароля на сторінці «Користувачі» стирають і «знайомі браузери» цього облікового запису, тож до першого нового входу ваш браузер вважається незнайомим (його можуть затримати чужі неправильні спроби).
Щоб вийти з панелі:
- Увійдіть до панелі.
- Натисніть «Вийти» праворуч у шапці будь-якої сторінки. Поряд із кнопкою написано, хто ввійшов, наприклад «admin · адміністратор».
Якщо пише «Забагато невдалих спроб»:
- Зачекайте вказане число хвилин і ввійдіть ще раз.
- Адміністратор може не чекати:
sudo sova panel-passwordу терміналі одразу відкриває вхід для його імені.
Докладно: усі поля й кнопки
Сторінка «Вхід» відкривається сама, коли ви заходите на http://127.0.0.1:8000 без входу. Поки немає жодного облікового запису, замість будь-якої сторінки показується «У панелі ще немає жодного облікового запису…».
Кнопки «УКР» і «РУС»
- Де: під формою на сторінці входу (маленький перемикач «УКР · РУС», група називається «Мова інтерфейсу»; поточна мова — не кнопка) і в шапці решти сторінок, праворуч від «Довідка». На сторінці входу кнопок у шапці немає, щоб не було двох перемикачів.
- Що роблять: перемикають мову панелі: українська або російська. Вибрана мова позначена.
- Де зберігається вибір: до входу — у цьому браузері (на рік); після входу — у вашому обліковому записі, тож мова та сама в будь-якому браузері. Мова, вибрана на сторінці входу, під час входу записується в обліковий запис і замінює попередній вибір. Поки мову не вибрано, панель відкривається українською; мова браузера не враховується.
- Що вже перекладено: шапку, сторінку входу, довідку до неї, повідомлення про помилки та стартове вікно. Решта сторінок лишається російською до серверного релізу.
- Перезапуск: не потрібен.
Кнопки «Світла», «Темна», «Як у системі»
- Де: під перемикачем «УКР · РУС» на сторінці входу (група «Оформлення») і в шапці решти сторінок.
- Що роблять: світле чи темне оформлення панелі; «Як у системі» — як налаштовано тему системи комп'ютера. Типово — «Як у системі». Вибране позначено (жирним).
- Де зберігається вибір: до входу — у цьому браузері (на рік); після входу — в обліковому записі. Вибір, зроблений на сторінці входу, під час входу записується в обліковий запис. Стартове вікно
make startзавжди слідує за системою. - Перезапуск: не потрібен.
Поле «Ім'я»
- Де: сторінка «Вхід до панелі».
- Що робить: каже, чий обліковий запис входить.
- Значення: ім'я, яке дав адміністратор: від 3 до 32 знаків, латинські літери, цифри та знаки
_ . -. Великі й малі літери — те саме (Admin=admin), пробіли по краях не враховуються. - За замовчуванням: порожньо. Браузер зазвичай сам підставляє ім'я, з яким ви входили.
- Коли змінювати: якщо на цьому комп'ютері входять під різними іменами.
- Якщо помилитися: «Неправильне ім'я або пароль» — так само, як і за неправильного пароля. Панель навмисно не каже, що саме не так: інакше стороння людина могла б дізнаватися, які імена існують.
- Перезапуск: не потрібен.
Поле «Пароль»
- Де: сторінка «Вхід до панелі».
- Що робить: підтверджує, що це ви.
- Значення: пароль вашого облікового запису, від 12 до 1024 знаків.
- За замовчуванням: у першого адміністратора пароля немає, його задає команда
sudo sova panel-password; пароль нового користувача задає адміністратор. - Коли змінювати: пароль змінює адміністратор на сторінці «Користувачі» («Скинути пароль»); свій пароль адміністратор може змінити там само або командою
sudo sova panel-password. - Якщо помилитися:
- «Неправильне ім'я або пароль» — введіть заново. Так само відповідає вимкнений обліковий запис: якщо правильний пароль перестав підходити, спитайте адміністратора, чи не вимкнено ваш запис.
- «Забагато невдалих спроб. Спробуйте за N хв» — вхід закрито. Після 5 неправильних спроб поспіль для одного імені пауза 1 хвилина, потім 2, 4, 8, далі завжди 15 хвилин. Вхід на самому ноутбуці й вхід через інтернет рахуються окремо: у кожного свій лік за іменем, і чужі спроби з інтернету ніколи не закривають вхід на ноутбуці — для жодного імені. На самому ноутбуці після 20 неправильних спроб з будь-якими іменами вхід ненадовго закривається для всіх браузерів, які ще жодного разу не входили; цей загальний лік не обнуляється вдалим входом, а скидається сам, коли 15 хвилин не було жодної неправильної спроби. Під час входу через інтернет цього загального ліку немає: 20 неправильних спроб з однієї адреси закривають вхід лише для цієї адреси (пауза 1 хвилина, потім кожна наступна неправильна — 2, 4, 8, далі 15 хвилин; лік адреси забувається через добу після її останньої неправильної спроби; друзі за одним VPN ділять цей лік). Крім того, у входу через інтернет є спільна межа — «відро» на 300 неправильних спроб з усіх адрес, з якого кожні 3 секунди зменшується одна: якщо майже одразу приходить близько 300 неправильних, вхід через інтернет закривається на 15 хвилин для нових браузерів; рівний потік, рідший за 20 на хвилину, відро не наповнює. Друзі за одним спільним виходом комерційного VPN ділять лік адреси: якщо сторонній на тому самому виході ввів 20 неправильних паролів, новий браузер друга добу отримує одну спробу на паузу (з браузера, де друг уже входив, вхід працює). У журналі подій неправильні паролі з інтернету без облікового запису збираються у зведення, яке може з'явитися із затримкою — до наступної спроби з інтернету або планового очищення. Поки вхід закрито, навіть правильний пароль не перевіряється. Браузер, з якого ви вже входили під цим іменем, рахує свої спроби окремо: чужі неправильні спроби його не закривають.
- «У панелі ще немає жодного облікового запису. Виконайте в терміналі: make panel-password (команда створить адміністратора admin)» — виконайте команду й оновіть сторінку. Перезапускати програму не треба. На встановленій СОВА замість
make panel-passwordадміністратор виконуєsudo sova panel-password; без входу сторінка пише «Повідомте адміністратора. Для адміністратора: sudo sova panel-password». - «Таблиці входу до панелі ще не створено. Закрийте make start і виконайте make migrate.» — під час розробки виконайте
make migrateу терміналі. На встановленій СОВА напис інший: «Повідомте адміністратора. Для адміністратора: sudo sova status …» (якщо там незавершене оновлення —sudo sova rollbackабоsudo sova resolve --keep-current; інакше повідомити архітектору вивідsudo sova status). - «База даних не відповідає. Запустіть make db-up або make start» — запустіть базу. На встановленій СОВА напис інший: «Повідомте адміністратора. Для адміністратора: sudo systemctl restart sova-db».
- «Збережений пароль панелі пошкоджено. Задайте його знову в терміналі: make panel-password» — задайте пароль знову.
- «База даних була зайнята іншим записом у ту саму мить (інший вхід у панель або прибирання старих входів). Нічого не змінено — введіть пароль і натисніть кнопку ще раз.» — тієї самої секунди в базу писали з іншого місця (інший вхід або прибирання старих входів), і база не змогла записати обидва входи одразу. Нічого не записано, невдалою спробою це не вважається: введіть пароль ще раз і натисніть кнопку.
- Перезапуск: не потрібен.
- Скільки тримається вхід: 7 днів від останньої дії, але не довше 30 днів від моменту входу. Якщо в панелі довго нічого не робити (типово 15 хвилин), вона закривається екраном блокування: вхід лишається, потрібен лише пароль (lock.md). Перезапуск програми вхід не скидає. Скидання пароля, зміна ролі та вимкнення облікового запису одразу завершують усі його входи.
- Скільки браузерів одночасно: один обліковий запис може мати не більше 5 входів одночасно, тобто бути відкритим щонайбільше у 5 браузерах (комп'ютер, телефон, інший браузер — кожен окремо; вхід на ноутбуці та з інтернету — теж різні). Якщо увійти в шостому, панель сама завершує вхід у тому браузері, яким найдовше не користувалися; там під час наступної дії відкриється ця сторінка входу — просто увійдіть знову. Щойно зроблений вхід не завершується ніколи. Якщо увійти ще раз у тому самому браузері, його попередній вхід просто замінюється новим — інші браузери не викидаються. Входи, які вже закінчилися самі (довше 7 днів без дій або старші за 30 днів), місця не займають. Число задає рядок
PANEL_MAX_SESSIONS_PER_ACCOUNT(від 1 до 50, порожньо — 5), докладно —docs/SETTINGS_REFERENCE.md.
Кнопка «Увійти»
- Де: сторінка «Вхід до панелі», під полями.
- Що робить: перевіряє ім'я та пароль і відкриває панель. Браузер при цьому отримує два записи (cookie): сам вхід і позначку «з цього браузера вже входили» (зберігається 90 днів). Друга потрібна лише для того, щоб чужі неправильні спроби не закривали вхід вам.
- Перезапуск: не потрібен.
Кнопка «Вийти»
- Де: у шапці кожної сторінки, праворуч, поряд із вашим іменем і роллю.
- Що робить: завершує ваш вхід і стирає в цьому браузері запис про останній пошук по постах.
- Значення: натискання.
- За замовчуванням: не застосовується.
- Коли змінювати: коли йдете від комп'ютера, на якому відкрито панель.
- Якщо помилитися: якщо база не відповідає, вхід не завершується (повідомлення «База даних не відповідає…»). Натисніть ще раз, коли база запрацює.
- Перезапуск: не потрібен.
Сова та стартове вікно
- Де: угорі сторінки входу; те саме вікно відкривається, коли ви запускаєте програму командою
make start. - Що робить: поки програма запускається, сова кліпає. Стартове вікно відкривається раніше, ніж відома мова, тому в ньому немає слів: велика сова, крупне «СОВА» і під ним тонка смужка, по якій біжить синій відрізок. Коли все готово, смужка змінюється на синю галочку, очі розплющуються, і за секунду вікно саме переходить до панелі. Якщо за хвилину панель не відповіла, під значком з'являються два рядки обома мовами — «Панель поки не відповідає — подивіться у вікно термінала» і «Панель пока не отвечает — посмотрите окно терминала» — та посилання «Відкрити панель / Открыть панель»; перевірка триває. Сова на всю сторінку з написом «Немає зв'язку з панеллю — чекаю…» з'являється тоді, коли не може достукатися до панелі дія на сторінці (кнопка, що працює без перезавантаження сторінки) або автоматичне оновлення запуску чи порівняння, що триває. Звичайне посилання або форма в цьому разі покажуть власну сторінку помилки браузера. Під совою в цей час біжить така сама смужка; коли зв'язок повернувся, смужка змінюється на галочку, очі розплющуються, на секунду з'являється «Зв'язок відновлено», і робота триває. Сова сама перевіряє зв'язок кожні дві секунди.
- Анімація: якщо в системі ввімкнено «зменшити анімацію», сова не кліпає, а смужка стоїть на місці (ціла, блідо-синя); галочка при готовності показується так само.
- Перезапуск: не потрібен.
Технічні роботи
- Де: на сторінці входу і на кожній сторінці панелі зверху, у смузі «Технічні роботи: з … по …», а під час робіт — на сторінці «Тривають технічні роботи до …».
- Що це: адміністратор може закрити панель для користувачів на час оновлення. До початку робіт ви бачите лише смугу з датою й часом. Поки роботи тривають, користувачі в панель не входять: якщо ввести правильні ім'я та пароль, панель відповість, до якого часу вхід закрито, і нічого не збереже. Адміністратори входять як звичайно.
- Якщо ви вже увійшли: ваш вхід не втрачається. Сторінки показують «Тривають технічні роботи до …», а коли роботи закінчаться, оновіть сторінку, і робота триватиме з того самого місця.
- Що робити: зачекати до вказаного часу й увійти (або оновити сторінку) знову. Якщо терміни незрозумілі, запитайте адміністратора.