docs: end-of-sprint refresh — known issues, roadmap progress

- KNOWN-ISSUES: log 4 items surfaced during RC-Premium-01 (payment modal
  still custom, cart confirm() has no dialog pattern, stars/legacy hex
  with no token match, category/search hand-rolled skeletons), not
  previously tracked outside STORE_FRONT_UX_REVIEW.md.
- FRONTEND-ROADMAP: add Sprint 30 status (verify pass re-run green,
  git push still pending explicit go-ahead), dedupe open-items list
  against KNOWN-ISSUES.
- graphify graph regenerated (graphify-out/, cache only, not tracked).
- Obsidian notes: skipped, no running Obsidian instance in this session.
- No architecture change this sprint — no ADR links to update.
- No application code touched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
sdarbinyan
2026-07-23 23:38:06 +04:00
parent 18beb7b7a1
commit b672cd90d5
2 changed files with 59 additions and 0 deletions

32
docs/FRONTEND-ROADMAP.md Normal file
View File

@@ -0,0 +1,32 @@
# Frontend Roadmap
Status snapshot, refreshed from recent commits only. Full sprint history: `docs/SPRINT-PLAN.md`. Open bugs: `docs/KNOWN-ISSUES.md`.
## Recently shipped
**RC-Visual-02 — Composition audit** (storefront, builder, backoffice)
Fixed undefined CSS theme vars, hand-rolled skeletons/empty-states migrated to shared `app-skeleton`/`app-empty-state`/`app-button`, missing `<th scope="col">`, dead CSS (~530-line unused cart `.alt` theme). Detail: `docs/UI-COMPOSITION-REVIEW.md`.
**RC-Premium-01 — Storefront premium UX polish** (this session)
Visual/interaction polish on top of the RC-Visual-02 baseline — no redesign, no logic/route changes. Fixed color-only state signaling app-wide (added `aria-pressed`/`aria-current`/`aria-live` + icon/checkmark pairing to selected swatches, active filters/tabs/sort, toggle buttons), normalized remaining hardcoded hex to design tokens, added hover/focus-visible/active/disabled states across interactive controls, capped legal/CMS prose at 70ch, converted FAQ to native `<details>` disclosures. Four commits (Home/Catalog/Search, Product/Compare/Wishlist, Cart/Checkout, Static Pages). Detail: `docs/STORE_FRONT_UX_REVIEW.md`.
## Sprint status
**Sprint 30 — Final Release**: verify pass re-run 2026-07-23 (tsc --noEmit, `npm run build`, `arch:check:boundaries`, `arch:check:cycles`) — all green, only pre-existing bundle-budget warning. Working tree otherwise clean. Only remaining item: `git push` of 10 local `B2B` commits to `origin/B2B` — awaiting explicit user go-ahead (declined once already this sprint, per safety rules re-ask each time). Full checklist: `docs/SPRINT-PLAN.md`.
## Known open items (not yet scheduled)
Full detail in `docs/KNOWN-ISSUES.md` (items 1-10) / `docs/STORE_FRONT_UX_REVIEW.md`. Summary:
- `pages/category` and `pages/search` still use hand-rolled skeleton markup instead of `app-skeleton` (composition fix, RC-Visual-02 territory).
- Payment modal / bank-payment iframe on Cart still custom (own focus-trap, multi-step state) — candidate for `app-dialog` migration.
- Cart's native `confirm()` on clear-cart — no existing confirm-dialog pattern to follow yet.
- Cart's dead `.email-form` CSS block — cleanup candidate.
- `stars.component` rating glyph color and a few legacy hex literals in `pages/category`/`pages/search` have no exact token match — needs a deliberate token-extension decision.
- Homepage hero-to-categories dead-space gap — traces to mock bootstrap config, not a code defect; needs real-tenant-data reproduction.
- ~178 missing `adminXxx.*` i18n keys across admin backoffice.
- Theme Mode (dark/system) selector has no runtime CSS effect — real feature project, not a wiring fix.
- `dynamic-renderer/` pipeline exists but is unwired — needs a finish-or-delete decision.
## Not audited / out of scope
Settings (no route exists), Diagnostics (dev-only, excluded from production).

View File

@@ -76,6 +76,33 @@ don't fix inline unless asked.
auth-system check first (does one exist yet?) before building the menu. auth-system check first (does one exist yet?) before building the menu.
- Found: 2026-07-17, project-editor bug-hunt audit. - Found: 2026-07-17, project-editor bug-hunt audit.
6. **Payment modal / bank-payment iframe on Cart still custom, not `app-dialog`.**
Has its own multi-step state and focus-trap already — migrating to the
shared dialog primitive is a composition change, deliberately left out of
RC-Premium-01's visual-polish scope.
- Found: 2026-07-23, RC-Premium-01 (`docs/STORE_FRONT_UX_REVIEW.md`).
7. **Cart's `clearCart()` uses native `confirm()`, no styled confirm dialog.**
No existing storefront pattern for a confirm-remove dialog to follow yet —
introducing the first one is an architecture decision, not polish.
- Found: 2026-07-23, RC-Premium-01.
8. **`stars.component` rating glyph color and a few legacy hex literals in
`pages/category`/`pages/search` have no exact design-token match.**
Left as literals to avoid an unintended visual shift; needs a deliberate
token-extension decision before normalizing.
- Found: 2026-07-23, RC-Premium-01.
9. **`pages/category` and `pages/search` still use hand-rolled skeleton
markup instead of `app-skeleton`.** Composition-level fix (RC-Visual-02
territory), not touched during RC-Premium-01's visual-polish pass.
- Found: 2026-07-23, RC-Premium-01.
10. **Cart's `.email-form` block (post-payment email/phone capture) is dead
CSS behind commented-out markup.** Candidate for deletion in a cleanup
pass; not removed during RC-Premium-01 (out of scope for a polish pass).
- Found: 2026-07-23, RC-Premium-01.
## Fixed ## Fixed
1. **Full-project UX/UI + motion pass across storefront, admin dashboard, 1. **Full-project UX/UI + motion pass across storefront, admin dashboard,