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
@@ -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` после истечения тайм-аута модерации.