mod: localized English version of README and UI texts, enhanced accessibility and internationalization features

2026-09-27 19:19:59 +03:00
parent ebf78c2c48
commit 1c846f7912
38 changed files with 1360 additions and 1091 deletions
@@ -0,0 +1,27 @@
+# Метафоры, персонажи и инструментарий 
+
+Тексты на сайте наполняются не только метафорами и персонажами Футурамы но и другими. Например:
+
+## Персонажи
+
+- Гипножаба — ленивая, но очень точная — бьёт редко, но всегда в нужную мысль.
+- Мозговые слизни (бригады и одиночные) — занимаются инспекциями и проверами. Следят чтобы смысл "не втекал и не вытекал"
+- Мозгоклюй — резкий, любит ломать шаблоны и вызывать когнитивный диссонанс.
+- Перцепторный рулевой 
+- Ткач интроспекций
+- Фрактальный Смотритель
+- Пузырьщик смысла
+- Теневой Чтец
+- Дырщик
+
+## Инструменты
+
+- Нюхоскоп — прибор, который «нюхает» смысл и выдаёт его в виде запаха. Например, запах тревоги, запах радости, запах сомнения.
+- Ритмо-пульсатор — излучает низкочастотные волны, совпадающие с альфа-ритмом мозга. Выглядит как кристалл, обросший мхом, который тихо вибрирует. Р
+- Смысловые фильтры-плёнки — полупрозрачные мембраны, которые они накладывают на «внутренний диалог». Плёнка искажает формулировки: «я сомневаюсь» превращается в «я почти уверен».
+- Клещи парадоксов — устройство, которое «подхватывает» привычную мысль и выворачивает её через логическую петлю.
+- Индукционный дедуктор — прибор, который находит скрытые связи между идеями и подменяет их на мысли "купи эту бессмысленную вещь, она тебе нужна".
+- Линзы самоподобия — заставляют любой объект выглядеть как уменьшенная копия самого себя, пока мозг не устаёт искать границы.
+- Перцепторные уловители — маленькие устройства-ловушки, которые фиксируют первые ассоциации и тут же выстраивают из них «здание смысла». 
+- Осциллятор смысловых дыр — устройство, оставляющее «тихие зоны» в речи и визуале: участки без цвета, без звука, без текста. Мозг автоматически достраивает туда свои страхи или надежды.
+
@@ -6,7 +6,7 @@

 ## 1. `rescore` — Пакетный пересчет рейтинга и детекция аномалий

- **Путь:** `../hypn0/hypn0_site/management/commands/rescore.py`
+- **Путь:** `hypn0/hypn0_site/management/commands/rescore.py`
 - **Назначение:** Пакетный фоновый пересчет рейтинга популярности (`f_score`) для всех активных картин и выявление аномалий (накрутка лайков / скоординированный шейминг).

 ### Базовый запуск:
@@ -94,7 +94,45 @@ poetry run python hypn0/manage.py rehash

 ---

-## 3. Планируемые команды (Roadmap)
+## 3. `rename_generations` — Массовое переименование названий генераций (`s_title`)
+
+- **Путь:** `hypn0/hypn0_site/management/commands/rename_generations.py`
+- **Назначение:** Пакетный перевод и актуализация названий генераций (`TbHypn0Item.s_title`) на английский язык с использованием генератора гипнотических тайтлов (`generate_hypno_title`).
+
+### Когда требуется запуск:
+1. При переводе проекта и базы данных (Dev / Prod) на английский язык для замены существующих русскоязычных названий.
+2. Для заполнения пропущенных или пустых названий генераций.
+3. Для пакетного обновления всех названий с новым детерминированным смещением (`--seed-offset`) или случайными сидами (`--random`).
+
+### Базовый запуск:
+```bash
+# Тестовый прогон: просмотр примеров изменений без сохранения в БД
+poetry run python hypn0/manage.py rename_generations --dry-run
+
+# Боевое переименование (по умолчанию только записи с кириллицей или без названия)
+poetry run python hypn0/manage.py rename_generations
+
+# Переименовать абсолютно все генерации в базе данных
+poetry run python hypn0/manage.py rename_generations --all
+
+# Переименование со случайными сидами и лимитом записей
+poetry run python hypn0/manage.py rename_generations --random --limit=100
+```
+
+### Параметры командной строки (CLI):
+| Флаг             | Тип    | По умолчанию | Описание                                                                            |
+|------------------|--------|--------------|-------------------------------------------------------------------------------------|
+| `--dry-run`      | `flag` | `False`      | Тестовый прогон: вывести примеры изменений без записи в базу данных                 |
+| `--all`          | `flag` | `False`      | Переименовать абсолютно все записи (по умолчанию только с кириллицей или пустые)    |
+| `--only-cyrillic`| `flag` | `True`       | Переименовывать только записи с кириллическими символами в названии                 |
+| `--batch-size`   | `int`  | `500`        | Размер пачки для `bulk_update` в транзакции (оптимизация нагрузки на БД)           |
+| `--limit`        | `int`  | `None`       | Ограничить максимальное количество обрабатываемых записей                           |
+| `--seed-offset`  | `int`  | `0`          | Смещение для детерминированного генератора сидов (`seed = item.id + seed_offset`)   |
+| `--random`       | `flag` | `False`      | Использовать недетерминированные случайные сиды вместо ID записи                    |
+
+---
+
+## 4. Планируемые команды (Roadmap)

 - **`cleanup_storage`** — Удаление старых и низкорейтинговых картин (Smart Retention) при превышении квоты хранилища (использует рассчитанный `f_score`).
 - **`cleanup_reports`** — Автоматическая изоляция или удаление картин со статусом `SHAMED` после истечения тайм-аута модерации.