sdarbinyan/marketplaces
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
576f2600a54bef605eb515c55db08ea4a2f52b96
marketplaces/docs/SPRINT-PLAN.md
sdarbinyan 576f2600a5 refactor: marketplace release polish 
Sprint 28, scoped to admin/* (user decision — full marketplace audit
declined in favor of a bounded pass over the 8 admin features from
Sprints 20-27).

- a11y: aria-label added to every bare <select> not already inside a
  <label> across categories/products/orders/transactions/users/monitoring
- loading states: app-skeleton rows/cards added to list pages that
  previously rendered blank during the initial fetch (categories, orders,
  transactions, users, monitoring's event feed, analytics summary cards)
- admin-dashboard-card's custom shimmer CSS replaced with the shared
  SkeletonComponent (same visual result, one less duplicated animation)
- bundle-size budget warning (~198kB over) confirmed pre-existing —
  present at Sprint 20's first build before any admin/* code existed,
  and new admin pages are all lazy-loaded — documented as out of scope
  for this pass rather than chased

docs/ADMIN.md + docs/SPRINT-PLAN.md updated with the scope decision and
what was explicitly not done (Lighthouse, animations, SEO/sitemap,
storefront/editor a11y).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-16 00:14:46 +04:00

8.1 KiB
Raw Blame History

Sprint Plan (working doc, delete after release)

Repo already past old "Sprint 19" (dashboard). Renumbering user's Sprint7+ roadmap to continue actual sequence: Sprint 20 = old "Sprint 7" (Categories) ... Sprint 30 = old "Sprint 17" (Final Release).

Pattern to follow (mirrors admin/products): models/, services/<x>-gateway.interface.ts + <x>-local.gateway.ts (IndexedDB via existing local-storage service), facade/, pages/, components/. Local-only until backend endpoint exists — log gap in docs/BACKEND.md.

Autonomy: no stop-and-ask except missing API contract / business decision / secrets / external config / legal / multi-valid-design-fork. Commit after each sprint, conventional commits, no push. Quality gate before marking sprint done: build, typecheck, lint (if configured), responsive check, a11y pass, docs updated, no dead code, arch:check green.

Notify user: from Sprint 20 (Categories) once product↔category link + admin categories CRUD exist, catalog can start receiving real items (currently admin-products already has categoryId field but no category source of truth — that's the point where "adding items to catalog" becomes real, not mocked dropdown).

Sprint 20 — Category Management ✅ done

  • AdminCategory model (id, parentId, title, translations, slug, icon, image, seo, visible, order, draft/published status, soft-delete)
  • AdminCategoriesGateway interface + local (in-memory, seeded from BackofficeDataService) gateway, mirrors products gateway
  • AdminCategoriesFacade (signals, CRUD, tree ops, slug validation, draft recovery)
  • Categories list page: indented tree, native HTML5 DnD reorder, visibility toggle, item counter, empty state, include-deleted filter + restore
  • Category editor: name/slug (+ uniqueness validation), translations editor, icon field, image via MediaPickerComponent, SEO fields, breadcrumb preview
  • Delete validation (blocked if has children or itemsCount>0) + soft-delete/restore
  • Draft/publish workflow + localStorage draft recovery (mirrors Project Editor autosave) + unsaved-changes CanDeactivate guard (mirrors projectEditorDirtyGuard)
  • Wired into admin routing (app.routes.ts, replaced coming-soon placeholder)
  • Updated docs/ADMIN.md (new Sprint 20 section), docs/BACKEND.md (categories gap rewritten with real field list)
  • [~] Responsive/a11y: reuses existing FormField/Input/Table/Button/EmptyState a11y wiring; live-browser click-through blocked by safety classifier on the guarded admin route (see below) — verified via tsc/build/arch:check only
  • Commit: feat(admin): complete category management
  • Note: admin/products' category dropdown still uses its own AdminProductsGateway.loadCategories(), not this new gateway — unification deferred to Sprint 21 (documented in BACKEND.md).

Sprint 21 — Product Management completion ✅ done

  • Audit + add missing: archived (soft, list filter + archive/restore action), barcode, variants (lightweight name|price|quantity), relatedProductIds (checkbox picker)
  • Wired products to real AdminCategoriesGateway (AdminProductsLocalGateway now seeds from AdminCategoriesLocalGateway, replacing its own BackofficeDataService category seed)
  • Gallery via MediaPickerComponent (add/remove thumbnails); translation editor already existed (Sprint pre-19); preview (computed discounted price); infinite-scroll toggle on list (facade.loadMore() appends vs pagination)
  • Updated docs/ADMIN.md (new Sprint 21 section), docs/BACKEND.md (item 6 rewritten with real field list)
  • Commit: feat(admin): complete product management
  • Known trade-off: related-products picker sources from whatever page is currently loaded in AdminProductsFacade.products(), not a full catalog search — documented in ADMIN.md, fine at current mock scale.

Sprint 22 — Media System hardening ✅ done

  • Folder support (flat, filter-based), tags (edit + filter), search (already existed)
  • Resize/compression on upload (canvas downscale + re-encode, raster only) + SVG script-sanitization + file-type/size validation with real surfaced errors
  • Confirmed reuse: category images (20), product gallery (21), branding logo/compact-logo/favicon (22, newly wired). Static pages: no image fields (not a gap). Hero: no dedicated field exists.
  • Storage abstraction documented (MediaRepository abstract class was already the abstraction)
  • Commit: feat(media): reusable media management
  • Scoped down from ticket: no interactive crop UI (compression/resize only); folders are a flat tag, not a real folder entity/hierarchy.

Sprint 23 — Orders (mock/local, flag backend gap) ✅ done

  • AdminOrder model + local gateway (24 seeded synthetic orders, no real data source existed)
  • List: search, status filter, pagination, CSV export
  • Detail: customer/payment/shipping, itemized total, status timeline, change-status, refund request + cancel (confirm-gated), customer notes + internal notes, print invoice (window.print + @media print)
  • docs/ADMIN.md (new Sprint 23 section), docs/BACKEND.md item 7 rewritten
  • Commit: feat(admin): order management

Sprint 24 — Transactions (mock/local) ✅ done

  • Payments/refunds/QR list, status, history (derived from Sprint 23's seeded orders), export, filters, search, retry failed, fraud flags, per-transaction audit log dialog
  • docs/ADMIN.md (new Sprint 24 section), docs/BACKEND.md item 13 added
  • Commit: feat(admin): transaction management

Sprint 25 — Users & Roles ✅ done

  • Users/roles/permissions models (local, 4 built-in roles), marketplace vs office admin distinction
  • Invitations, passwordless login confirmed already real (Telegram QR, AdminAuthService — linked not reimplemented), session/device manager (mocked), per-user audit trail
  • Wired into Dashboard Quick Actions + new /​:lang/backoffice/users route
  • docs/ADMIN.md (new Sprint 25 section), docs/BACKEND.md item 14 added
  • Commit: feat(admin): users and permissions

Sprint 26 — Monitoring ✅ done

  • Audit/security/login/failed-login logs (unified event feed, category filter), API/error/warning feed, queue/webhook mock views, health page (reuses real Sprint 19 healthChecks)
  • docs/ADMIN.md (new Sprint 26 section), docs/BACKEND.md item 15 added
  • Commit: feat(admin): monitoring center

Sprint 27 — Analytics ✅ done

  • Sales/revenue/orders/products/categories (real aggregation over mock order data), visitors/funnels/heatmaps (pending-backend badges, no fabricated data), sales-over-time bar chart, 7/30/90-day ranges, CSV export
  • docs/ADMIN.md (new Sprint 27 section), docs/BACKEND.md item 16 added
  • Commit: feat(admin): analytics dashboard

Sprint 28 — Marketplace Polish ✅ done (scoped to admin/* per user decision)

  • A11y sweep (aria-label on unlabeled selects), loading skeletons on list pages that previously showed blank tables, bundle-size warning confirmed pre-existing/out-of-scope
  • docs/ADMIN.md new Sprint 28 section documenting scope decision + what was explicitly not done
  • Commit: refactor: marketplace release polish
  • Not done (full marketplace audit was declined): Lighthouse run, animations, SEO/meta/sitemap, storefront/editor a11y.

Sprint 29 — Release Candidate

  • Dead code cleanup, remove TODOs/console logs/debug code, optimize imports/bundle/images/CSS, translation validation, build/type/lint validation, doc validation, arch review, CHANGELOG + release notes
  • Commit: chore: release candidate

Sprint 30 — Final Release

  • Full verify pass (build, routing, responsive, translations, admin, marketplace, editor, media, login, bootstrap, APIs, security assumptions), final report
  • Then (only after explicit go-ahead, push is a confirm-required action): git push

Stop conditions (ask user)

  • Real backend API contract needed (orders/transactions/users are local-mock by design per above — flagged, not blocking)
  • Ambiguous business rule (e.g. category deletion policy specifics) not inferable from existing product-deletion pattern
  • Credentials/external service config
  • Legal/product-only decision
  • Two equally valid architectures for same feature
Reference in New Issue View Git Blame Copy Permalink