docs: add TODO.md checklist, delete archived reports

- docs/TODO.md: checklist of every open item from KNOWN-ISSUES.md/
  FRONTEND-ROADMAP.md/BACKEND_API_REMAINING_WORK.md/ANGULAR22_PLAN.md,
  re-verified against current repo state (git ahead count, package.json,
  app.routes.ts) rather than copied blind. Backend items kept but
  marked skipped per user request (doing together separately).
- Deleted docs/archive/ (19 files) now that every open finding was
  confirmed already merged into KNOWN-ISSUES.md/FRONTEND-ROADMAP.md.
  Full original text recoverable via git history
  (git log --diff-filter=D -- docs/archive).
- Fixed the resulting dangling docs/archive/* references in
  PROJECT_INDEX.md/KNOWN-ISSUES.md/FRONTEND-ROADMAP.md.

Verification: tsc --noEmit clean, npm run build green, 0 broken
markdown links across 49 files (checked programmatically). No
application code touched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
sdarbinyan
2026-07-25 19:24:29 +04:00
parent 5374401257
commit 46c7358dde
23 changed files with 79 additions and 2548 deletions

View File

@@ -38,7 +38,7 @@ don't fix inline unless asked.
- Found: 2026-07-15, during Sprint 28 manual audit (reading templates +
grepping i18n files, not live browser).
- **Deferred to Sprint 29** ("translation validation" is explicit Sprint 29
scope per `docs/archive/SPRINT-PLAN.md`) rather than fixed inline during Sprint
scope per `SPRINT-PLAN.md` (removed, see git history)) rather than fixed inline during Sprint
28 polish - authoring ~534 correct strings across 3 languages is a large,
separate, mechanical pass of its own and shouldn't be rushed inside a
polish sprint. Sprint 28 only adds the handful of new keys it introduces
@@ -80,11 +80,11 @@ don't fix inline unless asked.
Correction (2026-07-24, RC A11Y-01): the "already has focus-trap" assumption
below was wrong — it had none. RC A11Y-01 ported `app-dialog`'s confirmed-
correct focus-trap/Escape/return-focus pattern directly onto it
(`docs/archive/ACCESSIBILITY_REPORT.md`), so the accessibility gap is closed. It's
(`ACCESSIBILITY_REPORT.md` (removed, see git history)), so the accessibility gap is closed. It's
still a separate custom component, not the shared `app-dialog` itself —
migrating it to the actual primitive remains a composition change,
deliberately left out of every polish pass so far.
- Found: 2026-07-23, RC-Premium-01 (`docs/archive/STORE_FRONT_UX_REVIEW.md`).
- Found: 2026-07-23, RC-Premium-01 (`STORE_FRONT_UX_REVIEW.md` (removed, see git history)).
7. **Cart's `clearCart()` uses native `confirm()`, no styled confirm dialog.**
No existing storefront pattern for a confirm-remove dialog to follow yet —
@@ -102,13 +102,13 @@ don't fix inline unless asked.
`--success/--warning/--error/--info-color` fail 4.5:1 when used as plain
text-on-white in a handful of places. Real palette colors, not a token
bug — fixing means visibly changing the brand, needs theme-owner sign-off.
- Found: 2026-07-24, RC A11Y-01 (`docs/archive/ACCESSIBILITY_REPORT.md`).
- Found: 2026-07-24, RC A11Y-01 (`ACCESSIBILITY_REPORT.md` (removed, see git history)).
10. **Footer "Contacts" link has no static-page content in mock data.**
Unlike the "About" link (which was a route-name mismatch, fixed), no
content exists for Contacts at all — needs a content decision, not a
code fix.
- Found: 2026-07-24, Release Candidate walkthrough (`docs/archive/RELEASE_REPORT.md`).
- Found: 2026-07-24, Release Candidate walkthrough (`RELEASE_REPORT.md` (removed, see git history)).
11. **Builder's static-page body editor is hidden and mislabeled.** The
actual WYSIWYG content editor isn't on the "Content" tab (title/image
@@ -123,7 +123,7 @@ don't fix inline unless asked.
pre-existing, unrelated broken `barry-cache` devDependency resolution —
fix that first, then drop the now-fully-unused dependency (likely closes
most of the remaining bundle-budget overage in one move).
- Found: 2026-07-24, RC PERF-01 (`docs/archive/PERFORMANCE_REPORT.md`).
- Found: 2026-07-24, RC PERF-01 (`PERFORMANCE_REPORT.md` (removed, see git history)).
13. **CRITICAL — `pages/category/*`, `pages/search/*`, `pages/item-detail/*`,
`pages/info/**`, `pages/legal/**` (40+ files) are entirely unrouted dead
@@ -142,7 +142,8 @@ don't fix inline unless asked.
confirmed independently by `docs/FRONTEND.md`'s own routing section
("Static/CMS pages resolve dynamically... no hardcoded page list").
**This means several "fixes" earlier in this document and in
`docs/archive/` were applied to dead code with zero production effect**
since-deleted audit reports (see git history) were applied to dead code
with zero production effect**
— see the correction note on Fixed item 7 below. This was missed by
three separate passes this cycle (RC-Premium-01, RC STORE-01, and the
dead-code cleanup sprint, which manually re-verified against
@@ -161,7 +162,7 @@ don't fix inline unless asked.
despite `AdminProductsFacade` having its own dirty-tracking draft logic.
Inconsistent, low-effort fix (mirror the categories guard) but not
applied here — this pass is documentation-only.
- Found: 2026-07-19 (`docs/archive/PROJECT-STATE.md`), re-verified
- Found: 2026-07-19 (`PROJECT-STATE.md` (removed, see git history)), re-verified
2026-07-25 against current `app.routes.ts` — still true.
## Fixed
@@ -319,7 +320,7 @@ don't fix inline unless asked.
`.skeleton-card`/`.skeleton-image`/`.skeleton-line` shimmer CSS with
hardcoded hex colors, duplicating what `app-skeleton` already provides
and what `catalog-container`/`product-details-container` already use.
- Fixed: 2026-07-23, RC STORE-01 (`docs/archive/STORE_REVIEW.md`).
- Fixed: 2026-07-23, RC STORE-01 (`STORE_REVIEW.md` (removed, see git history)).
- **Correction (2026-07-25):** these files are unrouted dead code (Open
item 13) — the fix is real and harmless but currently has zero
production effect. Live category/search rendering goes through
@@ -338,7 +339,7 @@ don't fix inline unless asked.
a dead route). This guard runs on every top-level route app-wide, so any
bookmarked/shared deep link with query params was silently broken —
found during the Builder RC walkthrough but affects all 3 surfaces.
- Fixed: 2026-07-24, Release Candidate walkthrough (`docs/archive/RELEASE_REPORT.md`),
- Fixed: 2026-07-24, Release Candidate walkthrough (`RELEASE_REPORT.md` (removed, see git history)),
`router.parseUrl()` instead of a hand-built path segment.
10. **Backoffice Categories CRUD completely broken end-to-end (P0).**