- рядом с воркером свёртки живёт горутина, раз в минуту разбирающая журнал пассивным чекпойнтом; «журнал не разбирается» видно строкой владельцу, а не только по `df`. Признак — пара чисел, а не флаг занятости: тот молчит под удерживаемым читателем (`busy=0` при 6256 страницах и пяти перенесённых), а при занятой блокировке отдаёт `-1` вместо ответа, и `-1 >= -1` читалось бы как «разобрано целиком» - каталог отвечает `304` на `If-None-Match`, не открывая снимок витрины. Метка собрана из всего, от чего зависит ответ: версии витрины (`data_version` с закреплённого соединения плюс поколение — значение локально для соединения и не переживает переоткрытия), горизонта измерения и области действия ресурса. Версия снимается до и после сборки: снятая после пометила бы устаревший снимок свежим номером - предел и дедлайн ответа отложены в задачу Read API точек вместе с измеренной ценой первого запроса; попутно починен флаки-тест чужой задачи, искавший значение точки в сыром буфере записи лога
Беклог
Одна задача = один файл <slug>.md + строка в этом индексе.
Приоритет — грубая оценка «ценность / стоимость». Спекулятивные
задачи помечены [idea] в заголовке. Ведётся скиллом backlog.
Блокеры — вопросы, вынутые из задач. Работа над задачей идёт автономно; если внутри обнаружился вопрос, который решать не мне, он вынимается отдельным пунктом сюда, а сама задача переформулируется на остаток и продолжается. Пункт блокера отвечает на четыре вопроса: что именно решить, какие есть варианты с ценой каждого, что заблокировано пока решения нет, и какая рекомендация — без неё вопрос перекладывается целиком, а решать его всё равно с тем же контекстом. Разбираются пачками, а не по одному: прерывать поток ради каждого дороже, чем накопить.
Варианты ищутся не с нуля: сперва prior art — как это решено в референсах паспорта и в интернете, — и только потом своё. Готовое решение либо берётся, либо отвергается с названной причиной.
блокеры
высокий
- Тай-брейк при равной полноте точек — Решено: брать бо́льшее значение. Порядок канонических форм берёт меньшее в 96% случаев — для накопительных это систематический недосчёт
- Read API: точки, выбор слоя, свёртка по сетке — Данные видны только через sqlite на хосте — ни один из трёх потребителей ничего прочитать не может
- OpenAPI-спека и Swagger UI — Потребителей три и один из них агент — контракт должен читаться машиной, а не пересказываться в чате
- MCP-сервер поверх Read API — Агент-медик — первый заказчик проекта, а подключить его сейчас нечем
средний
- Словарь категориальных значений → коды HealthKit — Фазы сна и типы тренировок приходят строками русской локали — с экспортом Apple их не сверить
- Выведенные из данных схемы содержимого — Метрик больше сотни и формы точек разные — клиент вынужден угадывать структуру по выборке
- Импорт родного экспорта Apple Health — Слой sample пуст: полная история и точные сэмплы лежат в zip-архиве и никуда не едут
- Идентичность тренировок при импорте родного экспорта — В export.xml у тренировки нет id — импорт снапшота задвоит тренировки, приехавшие от HAE
- Проверка секций, которых поток ещё не приносил — Симптомы, ЭКГ, лекарства, цикл и вес не виденны живьём — разбор писался вслепую
- Наблюдаемость: /stats — Тихо сломавшаяся автоматизация — главный эксплуатационный риск, а сейчас факт виден только в логах
- Проверка целостности собранной витрины перед подменой — Подмена файла необратима, а годность выхода подтверждена отпечатком на ещё открытом дескрипторе
- Чем откатывать релиз после наката миграции — Решено: копия файла базы перед накатом. Страж версии схемы делает возврат бинаря отказом, а понизить схему нечем
- Порядок журнала при конкурентных приёмах — Решено: повторы, но после /stats. Доставка, свёрнутая раньше своей предшественницы, уходит в failed навсегда
- Деплой на rivendell — Сервис живёт на рабочей машине — телефон достаёт до него только дома
- Управление токенами и секретами — Проверка токенов выключена, config.docker.toml коммитится — так нельзя выезжать наружу
- [idea] Что считать сутками при смене часового пояса — Шаги за день — базовый запрос трекера и игры, но чей это день при перелёте, не решено
- [idea] Пересекающиеся источники одной метрики — Сон пишут и часы, и стороннее приложение — сумма по обоим задвоит ночь
- Умолчания конфига указывают на прежнюю раскладку — Запуск без конфига заведёт пустую базу в корне рядом с настоящей — тихая ловушка
- Счётчики слияния переживают ротацию логов — единственный след несравнимых наборов — строка WARN в docker-логе с ротацией 3×10 МБ: событие может произойти и не оставить ничего
- Цена слияния на широкой доставке — 63 МБ на одной координате держат транзакцию 5.15 с при busy_timeout 5 с — соседние доставки уходят в failed
- Заголовки доставки в архиве рядом с телом — Заголовки живут только в базе — потеря базы навсегда ломает вывод слоя при пересборке
- Предел на размер и число заголовков доставки — MaxHeaderBytes не задан, в базу заголовки пишутся целиком: дефект спит до деплоя, а просыпается вместе с ним
- Сверка живой витрины с пересборкой — reindex печатает оба отпечатка, но сравнивать их некому — расхождение с журналом молчит
- Сущность с id, но неразобранной меткой — Тренировка с меткой в неизвестном формате пропадает целиком — а её id и содержимое разобраны
- Пределы на размер сущности и потоковый расчёт формы — Тело 40 МиБ даёт 768 МиБ пика кучи, 63 МиБ держат блокировку 5.019 с — предела на одну сущность нет вовсе
- Остановка и миграция: раздельные бюджеты и следы в логе — Долгий запрос чтения съедает бюджет остановки, и WARN обвиняет воркер свёртки; миграция молчит и не прерывается SIGTERM
низкий
- Устаревание нижнего слоя после экспорта — Нижний слой растёт на ~100 тысяч координат в сутки, а после экспорта Apple он избыточен
- Ретеншен сырого архива — Архив не подчищается вовсе — 14-дневный срок объявлен, но не работает
- Пересборка держит весь журнал в памяти — Учёт доставок и список путей архива материализуются целиком: расход растёт вместе с журналом, а у журнала конца нет
- Активный алерт «данных нет N часов» — Пропажу потока сейчас замечает человек, а не сервис
- [idea] Порог sealed: с какого возраста час считается запечатанным — WARN на изменение старого часа уже пишется, но порог не выбран — ставим по факту, когда накопится статистика досчёта
- [idea] Месячный проход по ручным секциям — Симптомы и лекарства заводятся задним числом на недели — недельного глубокого прохода им не хватит
- [idea] Человеческие аннотации поверх выведенных схем — Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата
- [idea] Отказ от heartbeatSeries — 93% объёма HRV ради данных, которых нет ни в одном планируемом запросе
- [idea] Выгрузка в parquet отдельной командой — Дверь для тяжёлой аналитики снаружи: DuckDB читает и parquet, и файл SQLite — спешить некуда, но и закрывать не нужно
- [idea] NDJSON-поток для больших выборок Read API — Выборка нижнего слоя за месяц не влезает в один JSON-ответ — либо поток, либо пагинация
- [idea] Разворачивание маршрутов тренировок в отдельную таблицу — Маршрут лежит блобом внутри тренировки — понадобится, только если появится клиент, которому мало отдачи одним пакетом
- Data-миграции не отбирают строки по обрезаемым спискам — Миграция 00007 отбирает по uncovered_sections, который обрезается на 32 — следующая покрытая секция унаследует слепую зону