makiolaj/GearBox
1
0
Fork 0
Code Issues 8 Pull Requests Actions Packages Projects Releases 10 Wiki Activity

docs(26): capture phase context

Browse Source
This commit is contained in:
Jean-Luc Makiola
2026-04-10 14:32:56 +02:00
parent b01625473f
commit dbab91a3c7
2 changed files with 238 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

103
.planning/phases/26-discovery-landing-page/26-DISCUSSION-LOG.md Normal file
View File

@@ -0,0 +1,103 @@
# Phase 26: Discovery Landing Page - Discussion Log
> **Audit trail only.** Do not use as input to planning, research, or execution agents.
> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
**Date:** 2026-04-10
**Phase:** 26-discovery-landing-page
**Areas discussed:** Page Structure & Section Order, Search Bar Behavior, Feed Data & Ranking, Auth-Variant Experience
**Mode:** --batch --auto (all decisions auto-selected)
---
## Page Structure & Section Order
| Option | Description | Selected |
|--------|-------------|----------|
| Hero search + vertical sections | Full-width hero with search bar, vertical stack of content sections below | ✓ |
| Grid dashboard | Multi-column grid of section cards (like current dashboard) | |
| Single infinite feed | One merged feed of all content types | |
**User's choice:** [auto] Hero search + vertical sections (recommended default)
**Notes:** Reuses existing visual patterns (cards, rounded-xl, light borders). Section order: Search → Setups → Items → Categories, prioritizing social content first.
---
## Search Bar Behavior
| Option | Description | Selected |
|--------|-------------|----------|
| Open CatalogSearchOverlay | Hero search bar triggers existing overlay on focus/type | ✓ |
| Inline search results | Show results directly below the search bar on the landing page | |
| Dedicated search route | Navigate to /search with query params | |
**User's choice:** [auto] Open CatalogSearchOverlay (recommended default)
**Notes:** Avoids duplicating the full-featured search UI (tag filtering, grid/list toggle, manual entry fallback). CatalogSearchOverlay is already built and tested.
---
## Feed Data & Ranking
| Option | Description | Selected |
|--------|-------------|----------|
| Item count proxy (setups) | Rank popular setups by number of items — more items = more effort/completeness | ✓ |
| Creation date (setups) | Show most recently created setups | |
| Random rotation | Rotate featured setups randomly | |
**User's choice:** [auto] Item count proxy (recommended default)
**Notes:** No engagement metrics exist. Item count is the best available proxy and is trivially queryable via setupItems join.
| Option | Description | Selected |
|--------|-------------|----------|
| Global item count per category | Trending = categories with most catalog items | ✓ |
| Recent growth rate | Categories with most new items in last 7 days | |
**User's choice:** [auto] Global item count per category (recommended default)
**Notes:** Simpler query, no time-windowed aggregation needed. Growth-based trending can be added later when catalog is larger.
| Option | Description | Selected |
|--------|-------------|----------|
| Cursor-based pagination | Use cursor pagination per INFR-02 requirement | ✓ |
| Offset pagination | Traditional LIMIT/OFFSET | |
**User's choice:** [auto] Cursor-based pagination (recommended default — required by INFR-02)
---
## Auth-Variant Experience
| Option | Description | Selected |
|--------|-------------|----------|
| Same page + Collection CTA | Identical content, authenticated users get "Go to Collection" button in hero | ✓ |
| Dual-mode page | Show personal stats/shortcuts for authenticated users | |
| Redirect authenticated to dashboard | Authenticated users skip landing page entirely | |
**User's choice:** [auto] Same page + Collection CTA (recommended default)
**Notes:** Per DISC-05, the difference is a single navigational CTA. No personalized feed in v2.1 (PERS-01/PERS-02 deferred).
| Option | Description | Selected |
|--------|-------------|----------|
| In hero area next to search | CTA visible without scrolling, adjacent to primary action | ✓ |
| Floating sidebar | Persistent side panel for authenticated users | |
| Below hero | Separate banner below search area | |
**User's choice:** [auto] In hero area next to search (recommended default)
---
## Claude's Discretion
- Exact layout sizing, spacing, and responsive breakpoints
- Number of items shown per section before "View all"
- Empty states for sections with no data
- Loading skeletons for each section
- Whether "View all" links route to existing pages or new feed pages
## Deferred Ideas
- Personalized feed (PERS-01, PERS-02)
- SSR/static prerendering for SEO (SEO-01, SEO-02)
- Engagement metrics for ranking
- Setup preview images
- Manufacturer entity (todo — different domain)
- Storage service tests (todo — testing concern)