[2026-09-26] eagle: personal/plans/tagwriter-container.md personal/tech/music-tags-final-review.md personal/tech/music-tags-repair-truenas.md

personal/plans/tagwriter-container.md

@@ -4,7 +4,7 @@ namespace: personal
 related:
   - '[[personal/plans/music-tags-wave38-fixes]]'
   - '[[personal/tech/music-tags-repair-truenas]]'
-status: plan
+status: blocked
 tags:
   - music
   - truenas
@@ -17,62 +17,93 @@ updated: '2026-09-26'
 ---
 # tagwriter — контейнер применения тегов MP3 (TrueNAS)
 
-_Создан: 2026-09-26. **Статус: ПЛАН → СБОРКА.** Основание: [[personal/plans/music-tags-wave38-fixes]]._
+_Создан: 2026-09-26. **Статус: 🔴 БЛОКЕР — нет прав на `/mnt/RED_2TB/docker/`.**_
+_Основание: [[personal/plans/music-tags-wave38-fixes]]._
 
 ## Задача
 
 Применить `tag-fix-plan.csv` (7905 строк) к MP3 на `/storage/Music`, **без пересжатия аудио**,
-в **UTF-8/UTF-16**. Alex: «в контейнер». Чужие контейнеры (transmission/immich/jellyfin) **НЕ трогаем**.
+в **UTF-8/UTF-16**. Alex: «Собирай tagwriter. С docker compose, in docker folder.»
+Чужие контейнеры (`transmission`/`immich`/`jellyfin`) — **НЕ трогать** (прямой запрет Alex).
+
+## 🔴 БЛОКЕР
+
+`/mnt/RED_2TB/docker/` принадлежит **root** (`drwxr-xr-x root root`).
+`truenas_admin` (uid 950) **не может писать** туда, `sudo` требует пароль (`sudo -n` → password required).
+При этом `docker` доступен (юзер в группе `docker`, uid 999) → образ собрать можно,
+но **проектную папку в `docker/` создать нельзя**.
+
+**Решения (ждёт Alex):**
+1. Alex создаёт `/mnt/RED_2TB/docker/tagwriter/` + `data/` → заливаем и собираем как задумано.
+2. Собираем в `/tmp/tagwriter` (там писать можно), папку в `docker/` переносит Alex.
+3. Другой путь, доступный на запись uid 950.
 
 ## Разведка окружения (факты, 2026-09-26)
 
 | Что | Факт |
 |---|---|
-| `/storage/Music` | 48 ГБ, владелец `truenas_admin` (uid 950) |
-| Свободно на `/mnt/RED_2TB` | 960 ГБ (бэкап влезет) |
+| `/storage/Music` | 48 ГБ, владелец `truenas_admin` uid/gid **950** |
+| Свободно на `/mnt/RED_2TB` | **960 ГБ** (бэкап 48 ГБ влезет) |
 | python3 на хосте NAS | 3.11.9, **нет pip, нет ensurepip, нет venv** |
 | mutagen | **нигде** (ни на хосте, ни в контейнерах) |
-| ffmpeg | только `immich-server` (музыки не видит) |
+| ffmpeg | только `immich-server` (**музыки не видит**) |
 | `/storage/Music` видят | `jellyfin`, `radarr`, `sonarr`, `transmission` |
+| python3 в чужих контейнерах | только `transmission` (3.14.7) — **чужой, не трогаем** |
 | Docker Hub | доступен (`python:3.12-alpine` скачался) |
 | docker compose | v2.29.1 |
 | `media_net` | есть |
+| ACL Music | `owner@ grup@` ALLOW, NOINHERIT |
 
-**Вывод:** пишем теги своим контейнером. mutagen ставится в образ при сборке (pip внутри образа есть).
+**Вывод:** пишем теги **своим контейнером**. `pip` есть внутри образа → mutagen ставится при сборке.
 
 ## Решение: контейнер `tagwriter`
 
-- **Путь проекта:** `/mnt/RED_2TB/docker/tagwriter/`
-- **Образ:** `python:3.12-alpine` + `pip install mutagen`
-- **Пользователь:** uid/gid `950:950` (`user: "950:950"`) — владелец Music
-- **Монтирование:** `/mnt/RED_2TB/storage/Music` → `/music` (rw)
-- **Теги:** ID3v2.3, кодировка `encoding=1` (UTF-16), аудио НЕ пересжимается (mutagen правит только тег-блок)
+- **Образ:** `python:3.12-alpine` + `pip install mutagen==1.47.0`
+- **Пользователь:** `user: "950:950"` (владелец Music; иначе запись невозможна)
+- **Монтирование:** `/mnt/RED_2TB/storage/Music` → `/music` (rw), `/mnt/RED_2TB/docker/tagwriter/data` → `/app/data`
+- **Теги:** ID3v2.3, `encoding=1` (**UTF-16**), `v2_version=3` — только тег-блок, аудио не пересжимается
+- **Профиль** `tools` — контейнер one-shot, не поднимается автоматически
 
-## Почему не чужой контейнер
-
-`python3` есть только в `transmission`, но он чужой сервис — Alex запретил. Свой контейнер
-изолирован: не влияет на торренты/медиасервисы, снимается без следа.
-
-## Скрипты
+## Файлы проекта (созданы локально)
 
 | Файл | Назначение |
 |---|---|
-| `apply_tags_truenas.py` | `--backup` → копия всех файлов к изменению в `/music/backup/`; `--dry-run` → печать плана; `--apply` → запись тегов |
-| `docker-compose.yml` | проект контейнера |
-| `Dockerfile` | `python:3.12-alpine` + mutagen |
-| `build_and_run.sh` | сборка + запуск |
+| `metrics/apply_tags.py` (в проекте — `apply_tags.py`) | `--backup` / `--dry-run` / `--apply` / `--readback` / `--limit N` |
+| `docker-compose.yml` | сервис `tagwriter`, профиль `tools`, монтирование Music |
+| `Dockerfile` | `python:3.12-alpine` + mutagen, `USER 950:950` |
+
+Локальные исходники: `~/Downloads/music-tags/tagwriter/`.
+
+## Скрипт `apply_tags.py` — логика
+
+- Читает `/app/data/tag-fix-plan.csv` (кладут в `data/`).
+- **Пропускает `skip` и `no_change`** — правит только `fix`.
+- **NFC-нормализация** путей (`unicodedata.normalize("NFC")`) — имена на диске могут быть в NFD.
+- **Маппинг путей**: `/storage/Music/` → `/music/`.
+- `--backup` идемпотентен (существующий файл бэкапа не перезаписывает).
+- `--apply` **отказывается работать без бэкапа** (`ABORT: нет бэкапа`).
+- Фреймы: `TIT2`/`TPE1`/`TALB`/`TRCK`, перед записью `delall` по каждому FrameID.
 
 ## Порядок работ
 
-1. ✅ **Бэкап** — `--backup` копирует 7905 файлов (48 ГБ → 960 ГБ свободно) в `/music/backup/`.
-2. ✅ **Dry-run** — печать плана, 0 записей. Приёмка Alex.
-3. ✅ **Apply** — запись тегов (по «go»).
-4. ✅ **Приёмка** — выборочная проверка тегов (`mutagen` read-back) + глазами в Jellyfin/webdav.
+1. ⏳ **Сборка образа** — блокер по папке (см. выше).
+2. ⏳ **Бэкап** — `--backup` (7905 файлов → `/music/backup/`; 48 ГБ при 960 ГБ свободных).
+3. ⏳ **Dry-run** — `--dry-run`, 0 записей. **Приёмка Alex.**
+4. ⏳ **Apply** — `--apply` (только по «go»).
+5. ⏳ **Read-back** — `--readback` + глазами в Jellyfin.
 
-## Питфоллы (предвиденные)
+## Питфоллы
 
-- 🔴 Имена файлов на диске **НЕ в UTF-8** (mojibake в `ls`) → работать только python-скриптом (`os.listdir`), NFC-нормализация.
-- 🔴 Пути в CSV контейнерные (`/storage/Music/...`) → мапить в `/music/...`.
-- 🔴 mutagen сохраняет тег-блок; **аудио-поток не трогается** — пересжатия нет by design.
-- ⚠️ uid: контейнер под 950, иначе не сможет писать в Music.
-- ⚠️ Бэкап 48 ГБ — проверить `df` до и после.
+- 🔴 `/mnt/RED_2TB/docker/` — **root-owned**, uid 950 не пишет (это и есть блокер).
+- 🔴 `sudo` без пароля **недоступен**.
+- 🔴 Имена файлов на диске **не в UTF-8** (mojibake в `ls`) → только python-скрипт, NFC.
+- 🔴 Пути в CSV контейнерные (`/storage/Music/…`) → мапить в `/music/…`.
+- ⚠️ `ffmpeg` для записи тегов **не нужен** — mutagen работает с тег-блоком напрямую.
+- ⚠️ uid контейнера обязан быть `950`, иначе запись в Music упадёт.
+- ⚠️ Команды на NAS требуют апрува — таймаут апрува = команда не выполнена (не повторять вслепую).
+
+## Связано
+
+- [[personal/plans/music-tags-wave38-fixes]] — 4 правки CSV, выполнены.
+- [[personal/tech/music-tags-repair-truenas]] — техдок ремонта 7905 тегов.
+- [[personal/tech/music-tags-rename-audit]] — финальный аудит CSV.