task(html-render): close → 🟢, unblock cron-deploy

closes board-viewer-html-render

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
vitya
2026-05-22 14:49:42 +03:00
parent c0661fb7b3
commit cab4a8b92d
2 changed files with 26 additions and 15 deletions

View File

@@ -17,19 +17,18 @@ _Updated: 2026-05-22_
--- ---
## [board-viewer-html-render] — render 5-col kanban from normalized structure ## 🟢 [board-viewer-html-render] — render 5-col kanban from normalized structure
**Status:** ready **Status:** done
**Where I stopped:** reader готов, импортируется `TaskRecord` из `src/reader.ts`. Импл не начата. **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:** TDD по контракту в `board-viewer-html-render.md`. **Next action:** разблокировать cron-deploy — артефакт `dist/index.html + dist/static/` готов для systemd+traefik.
**Branch:** master **Branch:** master
--- ---
## ⚪ [board-viewer-cron-deploy] — systemd timer + traefik + DNS on VDS ## ⚪ [board-viewer-cron-deploy] — systemd timer + traefik + DNS on VDS
**Status:** ready **Status:** ready
**Where I stopped:** ждёт `board-viewer-html-render` (нужен артефакт для деплоя). **Where I stopped:** разблокировано — html-render готов, артефакт `dist/index.html + dist/static/` генерируется `npm run build`. Команда: `node --experimental-strip-types src/cli.ts [config_path]`.
**Next action:** после готового HTML-рендера — добавить traefik label, DNS A-запись `board.kzntsv.site`, systemd timer на ~5 мин, basic-auth через traefik. См. `board-viewer-cron-deploy.md`. **Next action:** systemd timer (~5 мин) + traefik label на VDS + DNS A `board.kzntsv.site` + basic-auth через traefik. См. `board-viewer-cron-deploy.md`.
**Blocker:** board-viewer-html-render
**Branch:** master **Branch:** master
--- ---

View File

@@ -8,10 +8,11 @@
## Key files ## Key files
- (TBD) `src/render.{ts,py}`main renderer - `src/render.ts``renderBoard()`, `formatAge()`, `partitionByStatus()` (pure)
- (TBD) `templates/board.html` — template (Mustache / Jinja / template literals — выбор имплементера) - `src/cli.ts` — entry: load config → readBoard → renderBoard → `dist/index.html` + copy `static/`
- (TBD) `static/board.css`, `static/board.js` — styling + filter/drawer client-side - `static/board.css` — raw CSS, system font, light/dark, ~190 LOC
- (TBD) `tests/render.test.{ts,py}` — snapshot tests - `static/board.js` — ESM module: filter, drawer (lazy-fetch + `marked@14` from esm.sh), toggle-archived, toggle-grouping (full rerender into per-project columns)
- `tests/render.test.ts` — 17 tests on render logic (no snapshots — semantic property assertions, more robust to harmless markup tweaks)
## Acceptance criteria ## Acceptance criteria
@@ -32,16 +33,27 @@
## Decisions log ## Decisions log
- 2026-05-22: task создан промоушеном; зависит от `board-viewer-gitea-reader` контракта. - 2026-05-22: task создан промоушеном; зависит от `board-viewer-gitea-reader` контракта.
- 2026-05-22: emoji-set acceptance выравнен под reader контракт (⚪🔴🟡🔵🟢).
- 2026-05-22: client-side `marked@14` via esm.sh — lazy-load на первое открытие drawer'а.
- 2026-05-22: raw CSS, no framework — соответствует «whitespace + типографика» intent task notes.
- 2026-05-22: done >14 дней архивируются (hidden by default, toggle «show archived»).
- 2026-05-22: snapshot tests заменены 17 semantic-property тестами — устойчивее к косметическим изменениям markup'а.
## Open questions ## Open questions
- [ ] Markdown-renderer: client-side (`marked`) или server-side (Jinja с pre-rendered HTML вшито в data-attr)? Client-side проще — но добавляет ~50KB JS. - [x] Markdown-renderer client-side `marked` via esm.sh (lazy на drawer).
- [ ] CSS framework: ничего (raw CSS) / Pico / Tailwind via CDN? Минимализм — за raw. Раздёргать через первый прототип. - [x] CSS → raw, no framework.
- [ ] Архивные таски (🟢 done старше N дней) скрывать по умолчанию? Toggle? - [x] Done archive → >14d hidden, toggle for show.
## Completed steps ## Completed steps
- [ ] (фиксируется при выполнении) - [x] `formatAge` (m/h/d/w/mo/y, calendar-month arithmetic) — pure, TDD
- [x] `partitionByStatus` — canonical 5-col order
- [x] `renderBoard` — HTML with escaped fields, JSON embed XSS-safe (`\uXXXX` escapes)
- [x] static/board.css — raw, light/dark
- [x] static/board.js — filter, drawer, archived/grouping toggles, refresh-info
- [x] src/cli.ts — wires config+reader+render+fs
- [x] 17 render tests + smoke-verified e2e (78 records, 4 repos, browser-tested both toggle modes)
## Notes ## Notes