Files
buryan-infra/docs/library/INSTRUCTION-POLINA.md
root 2807bc815f Исправлен 500 на всех сервисах: Authentik 2026.8 отдавал email_verified=false
СИМПТОМ: после ввода пароля любой сервис с единым входом отдавал 500.
Прямые адреса работали, службы живы, Authentik писал вход успешным.

ПРИЧИНА (найдена в журнале прокси):
  "Error redeeming code during OAuth2 callback:
   email in id_token (...) isn't verified"
В Authentik 2026.8 стандартное сопоставление области email зашито так:
  return {"email": request.user.email, "email_verified": False}
То есть почта ВСЕГДА помечается непроверенной, а oauth2-proxy по
умолчанию таких не пускает. В 2026.8 из таблицы пользователей убрали
поле email_verified — поэтому в сопоставлении и стоит константа.
Это следствие сегодняшнего обновления Authentik, а не правок прокси.

ИСПРАВЛЕНО: выражение заменено на email_verified: True (почта хранится в
самом Authentik, другого источника нет). Проверено: userinfo отдаёт true.

КАК ИСКАЛ: коды на краю 302 -> 500 возникает после входа; в журнале
Authentik ни одного 5xx; в логе VPS нашёл 500 на /oauth2/callback;
и только прочитав журнал прокси БЕЗ фильтра увидел нужную строку.
Ошибка поиска: слишком долго смотрел на grant_types (он тоже был неправ
и я его исправил, но 500 давала именно непроверенная почта).

НА БУДУЩЕЕ: обновления Authentik ломают вход тихо — после каждого
обновления проверять вход на одном сервисе. Правка живёт в базе и при
следующем обновлении может вернуться к стандартной. Проверка в документе.

ЗАОДНО: инструкция для Полины переписана проще и нагляднее, отправлена
в Matrix.
2026-10-18 21:05:50 +03:00

106 lines
4.2 KiB
Markdown

# 📚 Твоя библиотека
Привет, Полина!
Теперь у тебя есть личная онлайн-библиотека. В ней:
* 📖 **твои книги** — можно читать и скачивать;
* 📋 **твой список чтения** — что уже прочитано;
* 🔎 **поиск** — где найти книгу, которой ещё нет.
---
## 🚪 Как войти
1. Открой ссылку: **https://books.buryans.ru**
2. Нажми «Войти».
3. Введи **свой обычный пароль** — тот же, что для остальных сервисов.
Отдельный пароль для библиотеки не нужен.
Всё. Ты внутри.
---
## 📋 Где твой список книг
Открой: **https://books.buryans.ru/catalog/**
Там четыре кнопки сверху:
| Кнопка | Что показывает |
|---|---|
| **Обзор** | сколько прочитано и как дела с сериями |
| **Серии** | по каждой серии — сколько прочитано и вышла ли следующая |
| **Книги** | весь список прочитанного |
| **Что искать** | книги, которых у тебя ещё нет |
Сейчас в списке **181 книга** и **45 серий**.
---
## 🔎 Как найти книгу, которой нет
1. Открой **«Что искать»**.
2. Найди нужную книгу.
3. Под ней — кнопки с названиями сайтов. Нажми любую:
| Кнопка | Зачем |
|---|---|
| **ЛитРес** | купить книгу — там видна цена |
| **ФантЛаб** | почитать про книгу и серию |
| **Open Library** | описание и год издания |
| **archive.org** | старые книги, много бесплатных |
| **Флибуста**, **libgen** | там часто есть переводы |
| **Гутенберг** | совсем бесплатные книги |
Нажимаешь — открывается поиск именно по этой книге. Не надо самой
искать по десяти сайтам.
---
## ⬆️ Как добавить книгу в библиотеку
**Самый простой способ:**
1. Открой **https://books.buryans.ru**
2. Нажми кнопку **«Загрузить»** (вверху или в меню).
3. Выбери файл книги на телефоне или компьютере.
Подходят форматы: **EPUB, FB2, PDF, MOBI, AZW3**.
Библиотека сама:
* прочитает название и автора;
* поставит обложку;
* положит книгу на нужную полку.
---
## 📥 Как читать или скачать
В карточке любой книги есть кнопки:
* **«Скачать»** — сохранить файл;
* **«Читать»** — открыть прямо в браузере.
---
## ❓ Если что-то не получается
| Проблема | Что сделать |
|---|---|
| Не пускает войти | Проверь, что вводишь пароль от остальных сервисов. Если не помогает — напиши Роману |
| Книга не появляется | Подожди минуту и обнови страницу |
| Нет нужной книги | Посмотри «Что искать» или напиши — добавят |
| Страница не открывается | Проверь интернет, потом обнови |
---
## 💡 Полезно знать
* **Один пароль на всё** — библиотека, чат, файлы. Запоминать ничего
нового не надо.
* **Книги не пропадут** — они сохраняются и резервируются.
* **Видишь только ты** — библиотека закрыта, доступ у тебя и у Романа.
Приятного чтения! 📖