Files

vitya cfa4572731 tasks: round1 UX feedback — 6 dev-tasks + review umbrella [board-viewer-ux-round1-review]

User первые впечатления после go-live board.kzntsv.site:
- drawer падает TypeError (приватные репо + no browser token; bundle md
  в build-time — единственно верное решение)
- slug не виден на карточке (только в data-attr)
- дата без времени, неясный формат
- owner-pill дублируется (single-owner whitelist → visual noise)
- нет нумерации задач (BV-12 / T-001 shorthand нужен)
- done-tail слишком длинный (нужен render-side cutoff/collapse)

Все 6 — code-impl в board-viewer (не deploy → не в .admin, per workshop §5).
TDD posture везде (project follow tdd-criteria).

Drawer bug = critical (clear-impl: bundle md в build-time, root-cause grounded).
Show-slug + full-datetime = clear-impl, простой TDD-цикл.
Owner-conditional = clear-impl (single vs multi owner branches), 2 fixtures.
Task-numbers + done-cutoff = design-first (4 open questions каждый),
brainstorm если recommendations не пройдут single-session.

+ review umbrella 🔵 blocked-by 6 slug'ами (workshop §4 mandatory).

Ops-handoff (rebuild image + Portainer pull) — отдельная taska в
.admin/[board-viewer-redeploy-ux-round1] (workshop §5).

2026-05-22 18:39:01 +03:00

9.8 KiB

Raw Blame History

Task Board

Updated: 2026-05-22

🟢 [board-viewer-pointers] — pre-impl: fill Domain conventions with design-context pointers

Status: done Where I stopped: pointer-блок вставлен в .wiki/CLAUDE.md Domain conventions; коммит готов, ждёт push. Next action: push после approval; затем разблокировать board-viewer-gitea-reader. Branch: master

🟢 [board-viewer-gitea-reader] — Gitea API reader → normalized task structure

Status: done Where I stopped: TaskRecord контракт реализован (parser+gitea+reader+config); 25 тестов; typecheck clean. Тесты используют 3 реальных STATUS.md fixture'а. Next action: разблокировать html-render — потребляет readBoard(client, repos) → TaskRecord[]. Branch: master

🟢 [board-viewer-html-render] — render 5-col kanban from normalized structure

Status: done Where I stopped: render+cli+static готовы; 17 render тестов; smoke-verified против real Gitea (78 records, 4 repos), both toggle modes работают, drawer lazy-fetch'ит markdown. Next action: разблокировать cron-deploy — артефакт dist/index.html + dist/static/ готов для systemd+traefik. Branch: master

🟢 [board-viewer-cron-deploy] — docker-compose stack on VDS (board.kzntsv.site)

Status: done (code-complete; ops-ownership transferred) Where I stopped: deploy/ полностью написан (compose + Dockerfile.build + nginx.conf + auth.toml.example + .env.example + README). Compose syntax валидируется. Изменён mechanism: docker stack вместо systemd timer (user choice). Next action: — Branch: master

🟢 [board-viewer-review] — review checkpoint (umbrella)

Status: done Where I stopped: independent review выполнен subagent'ом (clean context, не имплементер). 43/43 тестов pass, secret hygiene clean, TDD-immutability чисто. 2 Major + 6 minor/nitpick findings зафайлены как follow-up таски ниже. Next action: взять одну из ⚪ fix-тасок (readme-emoji или card-meta). Branch: master

🟢 [board-viewer-readme-emoji-fix] — fix stale emoji legend in README.md

Status: done Where I stopped: README обновлён: правильный emoji-словарь + Quick start заполнен + добавлены Deploy/Architecture секции. Next action: — Branch: master

🟢 [board-viewer-card-meta-fix] — add owner pill + last-commit-marker to cards

Status: done Where I stopped: owner pill + short ISO date (YYYY-MM-DD + tooltip с full ISO) рендерятся в обеих ветках (render.ts + board.js). 4 новых TDD-теста; smoke-verified. Next action: — Branch: master

🟢 [board-viewer-polish] — bundle of 6 minor/nitpick findings from review

Status: done Where I stopped: все 6 items закрыты в одной сессии. 49 тестов pass (+2 от polish: M2 future-ts, M4 status-filter markup). Smoke-verified: status pill click фильтрует cards. Next action: — Branch: master

⚪ [board-viewer-drawer-bundle-md] — fix `Failed to fetch` в drawer: bundle md-content в build-time

Status: ready (critical bug) Where I stopped: (not started — diagnose grounded: приватные репо + fetch(rawUrl, {credentials:'omit'}) без auth → Gitea 401/302→login → TypeError. Решение — bundle per-task .md в build-time в JSON/inline script, drawer читает локально.) Next action: см. board-viewer-drawer-bundle-md.md. TDD mode. Сначала reader test: TaskRecord.md_content?: string. Затем render embeds JSON-bundle. Затем static/board.js openDrawer читает local instead of fetch. E2E smoke в browser-driver: 0 запросов на git.kzntsv.site/raw при клике. Branch: master

⚪ [board-viewer-ux-show-slug] — показать slug на карточке (сейчас только в data-attr)

Status: ready Where I stopped: (not started) Next action: TDD mode. Failing test в tests/render.test.ts: ожидать <code class="card-slug">...</code> в output. Impl в src/render.ts + CSS в static/board.css. Smoke: slug читается на каждой карточке. Branch: master

⚪ [board-viewer-ux-full-datetime] — дата + время в явном формате (не только дата)

Status: ready Where I stopped: (not started — 3 design questions: TZ МСК/UTC, format readable/ISO, оставить ли relative «7h». Recommendations внутри board-viewer-ux-full-datetime.md.) Next action: TDD mode. Resolve 3 design-вопроса (или принять recommendations: МСК с явным суффиксом, YYYY-MM-DD HH:MM МСК, relative сохранить тоненькой строкой). Затем failing test + impl в src/render.ts. Branch: master

⚪ [board-viewer-ux-owner-conditional] — скрывать owner-pill когда все таски одного owner'а

Status: ready Where I stopped: (not started — текущий VDS whitelist single-owner OpeItcLoc03/* → pill дублируется visual noise. Рендерить условно: single-owner → шапка «Owner: X (N repos)», без pill; multi-owner → pill на карточках.) Next action: TDD mode. Два теста (single/multi owner fixtures). Impl в src/render.ts. Связанный ops-audit в .admin/[board-viewer-redeploy-ux-round1]: verify auth.toml board_viewer_repos (по memory books = victor/books, не OpeItcLoc03/books). Branch: master

⚪ [board-viewer-ux-task-numbers] — shorthand numbering (BV-12) на карточке

Status: ready (design-first) Where I stopped: (not started — 4 design-вопроса: scope per-repo/global, source-of-truth  в STATUS.md vs auto-derive, format BV-12 vs T-001, ретроактивно или нет. Recommendations в board-viewer-ux-task-numbers.md.) Next action: Resolve 4 design-вопроса (single user-session). Если рекомендации принимаются — TDD impl: parser извлекает num из block-comment, render показывает badge. Ретроспективно — отдельный proход «chore: number existing tasks». Если возникает дилемма — .workshop/.brainstorm/board-viewer-task-numbers.md. Branch: master

⚪ [board-viewer-ux-done-cutoff] — фильтр / cutoff длинного done-tail

Status: ready (design-first) Where I stopped: (not started — 4 design-вопроса: что считать «archive-нужно» (все 🟢 или N дней+), source неизменен (recommend) vs физический archive, default hide vs show-all, тип cutoff (last-N / date / combined). Recommendations в board-viewer-ux-done-cutoff.md.) Next action: Resolve design (single user-session или brainstorm). Recommendations: source-неизменен, render-side cutoff = «hide done by default + toggle + last-10 fallback при show». TDD impl: render с N done>cutoff показывает только N + «N more» expander. Если дилемма — .workshop/.brainstorm/board-viewer-done-cutoff.md. Branch: master

🔵 [board-viewer-ux-round1-review] — review umbrella для 6 UX-fixes round1

Status: blocked Blocker: board-viewer-drawer-bundle-md, board-viewer-ux-show-slug, board-viewer-ux-full-datetime, board-viewer-ux-owner-conditional, board-viewer-ux-task-numbers, board-viewer-ux-done-cutoff Where I stopped: (not started — открывать когда все 6 импл-таск 🟢) Next action: Independent review subagent'ом (clean context, не имплементер) — TDD-immutability (тесты не переписаны под impl), output-correctness (smoke на live board.kzntsv.site после redeploy), regression check (49 существующих тестов остаются pass). Branch: master

9.8 KiB Raw Blame History Unescape Escape