261ce6d55b
Audited every *.md in docs/ and root. Merged five overlapping backend docs (BACKEND_INTEGRATION.md + AUTHENTICATION.md + ERROR_CONTRACT.md + MAINTENANCE_MODE.md + the already-archived BACKEND_API.md/ BACKEND_API_REMAINING_WORK.md) into one canonical docs/BACKEND.md (4775 lines, 10 numbered sections) - deleted the four standalone files outright now that their content is fully inlined. Archived (not deleted - real historical value): ADMIN.md (Sprint 19-28 build log, sprint-report-shaped, not a living reference) and FRONTEND-ROADMAP.md (despite its name, a shipped-history changelog with detail no other doc has - not a forward roadmap, so keeping it in root alongside NEXT_PHASE.md was exactly the "10 roadmaps" confusion being cleaned up). Deleted outright (zero value): SPRINTS.md - a leftover copy-pasted sprint-kickoff prompt saved as a file, not documentation. Rewrote docs/PROJECT_STATUS.md with completion-percentage estimates per area (frontend/backend/UI/admin/storefront) and an explicit first-customer-readiness call. Rewrote docs/NEXT_PHASE.md to the strict 5-phase structure (backend integration -> production testing -> performance -> monitoring -> v2 ideas), pointing to PRODUCT_BACKLOG .md/FUTURE_FEATURES.md for phase 5 detail instead of duplicating it. Rewrote root README.md - was stale (referenced deleted pages/info, pages/legal folders from a prior RC pass), now covers architecture, frontend/backend status, how to run, mock<->API switch mechanism (useMockData in environment.ts), current folder structure, and a documentation map. Updated docs/PROJECT_INDEX.md (the stated entry point) to link only the surviving doc set - every remaining document is reachable from it. Fixed every broken/stale cross-reference to the deleted/renamed backend docs across ARCHITECTURE.md, EDITOR.md, FRONTEND.md, PROJECT-STRUCTURE.md, StaticPages.md, KNOWN-ISSUES.md (10 individual link fixes, verified by repo-wide grep before and after). Left CHANGELOG.md's two historical entries untouched - changelogs are append-only history, not live navigation, editing past entries would misrepresent what was true at the time. Not touched (explicitly out of scope): docs/architecture/foundation/** (enforced ADRs/governance, permanent not sprint-shaped), docs/context/** (Barry Cache infrastructure, "do not edit by hand" per CLAUDE.md), .claude/worktrees/** (separate git worktrees containing an unrelated project's docs, not this repo's documentation). docs/ root: 22 files -> 16. Plus 5 in docs/archive/ (was 3).
5.3 KiB
ARCHIVED 2026-07-26. Despite its filename this was a shipped-history changelog, not a forward roadmap — superseded by
../NEXT_PHASE.md(the one roadmap),../CHANGELOG.md(shipped history), and../PROJECT_STATUS.md/../KNOWN-ISSUES.md/../PRODUCT_BACKLOG.md/../FUTURE_FEATURES.md(open items, now category-split). Kept for history only.
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.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).