Files
marketplaces/docs/FRONTEND-ROADMAP.md
sdarbinyan d03ef2db50 docs: final project closeout - classify TODO, backend spec, status
Classified every TODO.md item into one of DONE/BACKEND/PRODUCT
DECISION/FUTURE VERSION/BUG, verified against source, not against
prior docs:

- BACKEND items (bootstrap content, builder draft/publish, 6 admin
  CRUD domains, media pipeline) confirmed already covered by
  BACKEND_INTEGRATION.md; appended a mapping appendix rather than
  duplicating raw bullets. Fixed 22 stale internal BACKEND_API.md
  cross-references left over from before that file was archived.
- PRODUCT DECISION items (dark mode, brand-color WCAG contrast,
  stars.component token gap, footer Contacts content, advanced
  analytics, payment providers) moved to new docs/PRODUCT_BACKLOG.md.
- FUTURE VERSION items (Angular 22, bundle splitting, cart-modal
  composition cleanup, hero-spacing investigation) moved to new
  docs/FUTURE_FEATURES.md.
- BUG: rewrote docs/KNOWN-ISSUES.md down to the one real, verified,
  currently-reproducible frontend bug (Ed25519 admin-auth error codes
  session-expired/invalid-signature are unreachable -
  toAuthErrorShape() never reads a body error code, only maps HTTP
  status, and no status ever produces those two codes - confirmed by
  reading auth.service.ts + auth-error.model.ts). Condensed the
  "Fixed" history instead of carrying full verbose repro text forward.
- DONE items removed outright (dead-code deletion, dashboard false
  positive, RC-02 fixes, stale "dynamic-renderer unwired"/"178 missing
  keys" claims already disproven by source).

docs/TODO.md rewritten to the exact "no blockers" template - nothing
left qualifies as a release blocker.

New docs/PROJECT_STATUS.md: honest per-area status (frontend/backend/
docs/auth/builder/storefront/admin), known limitations, and explicit
production/backend/demo readiness calls - including correcting an
initial draft's unpushed-commit count (53, not 10, per git log
origin/B2B..HEAD).

New docs/NEXT_PHASE.md: work that can only start once a real backend
exists (gateway swap-in, mock removal, dormant-auth activation, role
enforcement, integration/E2E tests, perf profiling, monitoring,
maintenance-mode UI).

docs/PROJECT_INDEX.md (the stated entry point) updated to link the new
doc set and stop pointing at the now-archived BACKEND_API.md/AUTH.md.
docs/FRONTEND-ROADMAP.md's "Known open items" replaced with pointers
to the new category-split docs instead of a duplicated mixed list.

Not swept: a handful of low-traffic docs (architecture ADRs,
FRONTEND.md, EDITOR.md, ARCHITECTURE.md, PROJECT-STRUCTURE.md,
StaticPages.md, ADMIN.md) still reference the old BACKEND_API.md/
AUTH.md filenames - noted as a known gap in PROJECT_STATUS.md rather
than touched blindly, since they're historical-context docs, not the
navigation entry point.
2026-07-26 12:35:26 +04:00

4.9 KiB
Raw Blame History

Frontend Roadmap

Status snapshot, refreshed from recent commits only. Full sprint history: SPRINT-PLAN.md (removed, see git history). 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: UI-COMPOSITION-REVIEW.md (removed, see git history).

RC-Premium-01 — Storefront premium UX polish 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: STORE_FRONT_UX_REVIEW.md (removed, see git history).

RC STORE-01 — Storefront cleanup Closed 2 of the 5 gaps RC-Premium-01 deliberately deferred: category/search skeleton markup migrated to shared app-skeleton, dead cart .email-form markup/CSS removed. The other 3 (payment modal, cart confirm() dialog, untokenized colors) need an architecture/design-system decision, correctly left alone again. Detail: STORE_REVIEW.md (removed, see git history).

RC PERF-01 — Performance audit (production-readiness, app-wide) Initial bundle 1.47 MB → 1.12 MB raw (24%): biggest win was lazy-loading en/hy i18n packs (346 KB were eagerly loaded regardless of visitor language), plus a dead items-carousel/primeng-only component deleted, dead global CSS removed. RxJS/change-detection audit found the codebase already clean (0 leaks, 190/191 components already OnPush). Detail: PERFORMANCE_REPORT.md (removed, see git history).

RC A11Y-01 — WCAG 2.1 AA audit (storefront, builder, backoffice) Added the app's first skip link (didn't exist anywhere before), fixed cart's custom payment modals having zero focus-trap, fixed app-icon's "decorative by default" claim never actually being implemented, fixed 2 keyboard-inaccessible drag-and-drop reorder UIs (Builder homepage/footer, Backoffice categories), fixed an undefined --color-primary token in Builder, fixed admin sidebar nav announcing itself as "Dashboard" everywhere. Contrast fixes applied where safe; genuine brand-color contrast failures flagged for theme-owner sign-off, not changed unilaterally. Detail: ACCESSIBILITY_REPORT.md (removed, see git history).

Release Candidate — live browser walkthrough (storefront, builder, backoffice) Found and fixed 2 P0s: (1) language.guard.ts's legacy-URL redirect broke query params on every route app-wide (silently dead-ended any bookmarked/shared deep link with query params); (2) Backoffice Categories CRUD was completely broken end-to-end — wrong gateway-resolution fallback always picked the real HTTP gateway instead of the local mock in this environment, so every create/publish silently failed with zero user feedback. Plus 6 P1s (cart description, compare table raw enum values, search empty-state messaging, footer link 404, missing placeholder image, builder save-bar reset-state bug, backoffice mislabeled button). Detail: RELEASE_REPORT.md (removed, see git history).

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: SPRINT-PLAN.md (removed, see git history).

Known open items (not yet scheduled)

As of the 2026-07-26 Final Project Closeout, open items are split by category instead of one mixed list:

  • Real, reproducible frontend bugs: docs/KNOWN-ISSUES.md (one open item).
  • Items needing a client/business decision (dark mode, brand-color contrast, Contacts page content, advanced analytics, payment providers): docs/PRODUCT_BACKLOG.md.
  • Nice-to-have, non-blocking future work (Angular 22, bundle splitting, cart-modal composition cleanup, hero-spacing investigation): docs/FUTURE_FEATURES.md.
  • Backend integration: fully specified, not yet implemented — the single canonical spec is docs/BACKEND_INTEGRATION.md.
  • Release blockers: docs/TODO.md — currently none.

Overall status: docs/PROJECT_STATUS.md.

Not audited / out of scope

Settings (no route exists), Diagnostics (dev-only, excluded from production).