Jean-Luc Makiola
0202d0bb5c
Summarize current v2.4 state and forward-looking backlog in docs/ as a parallel entry point to the active .planning/ GSD workspace. Lets superpowers skills (brainstorming → writing-plans → executing-plans) work from a clean starting point without retiring the existing workflow. Also ignore .idea/ so JetBrains project files stay local. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
116 lines
6.6 KiB
Markdown
116 lines
6.6 KiB
Markdown
# GearBox — Backlog
|
|
|
|
*Migrated from `.planning/` on 2026-04-23. Forward-looking only — see `STATE.md` for what's shipped.*
|
|
|
|
Staging area for work not yet brainstormed into a superpowers plan. To start on anything here, run `superpowers:brainstorming` → `superpowers:writing-plans` → `superpowers:subagent-driven-development` (or `executing-plans`).
|
|
|
|
---
|
|
|
|
## v2.4 tail — finish line
|
|
|
|
- [ ] **Verify Phase 38 Admin Tag Management** — all 2 plans marked complete in roadmap, STATE.md says 97%. Run the phase verification and close out v2.4.
|
|
- [ ] **Manufacturer picker UI** — backend entity is shipped (`manufacturers` table, service, route, FK on `globalItems`, seeding), but the user-facing picker component (analogous to `CategoryPicker`) is not yet built. The manual add form still takes freeform brand text in places. See also the pending todo below.
|
|
|
|
---
|
|
|
|
## Pending todos
|
|
|
|
Details preserved in `docs/backlog/todos/`. Only truly-open items listed here — the older v2.3 todos (wrong modal, missing images, slow loading, auth redirect, cursor pointer) all shipped in Phase 35.
|
|
|
|
- [ ] **Make tag selector in global search searchable** (2026-04-20, ui) — the tag selector inside `CatalogSearchOverlay.tsx` should support typing-to-filter. Currently scrollable only.
|
|
- [ ] **Add manufacturer picker UI** (from 2026-04-10 "add-manufacturer-entity" todo) — backend shipped; picker component + wiring into the manual add form and catalog enrichment is the remaining slice.
|
|
|
|
**Dropped** (already resolved but stale in `.planning/todos/pending/`):
|
|
- `add-cursor-pointer-to-all-clickable-links` → shipped in Phase 35 (FIX-05)
|
|
- `fix-item-image-not-showing-on-collection-overview` → shipped in Phase 35 (FIX-02)
|
|
- `fix-storage-service-tests` → resolved; `withImageUrl`/`withImageUrls` both exported and test imports match
|
|
- `investigate-slow-image-loading` → shipped in Phase 35 (FIX-03, lazy loading + skeletons)
|
|
- `auth-prompt-sign-in-button-should-redirect-directly-to-logto` → shipped in Phase 35 (FIX-04)
|
|
- `fix-add-candidate-button-shows-wrong-modal-on-thread-page` → shipped in Phase 35 (FIX-01)
|
|
|
|
---
|
|
|
|
## Backlog phases (pre-brainstorm)
|
|
|
|
These are product intents, not plans. Each needs brainstorming before becoming a superpowers plan. Sourced from `.planning/ROADMAP.md` Backlog section. *Previously-listed entries 999.2, 999.3, 999.4, 999.6 were promoted to shipped phases and are omitted here.*
|
|
|
|
### 999.1 — Rewrite E2E Tests for OIDC Auth
|
|
E2E tests expect local username/password login, but auth moved to Logto. Rewrite with a mock OIDC provider or API-key bypass. Postgres seed migration already done.
|
|
|
|
### 999.5 — Legal Pages: ToS, Privacy Policy, Compliance
|
|
Terms of Service, Privacy Policy, and any required compliance pages. Essential before opening to real users.
|
|
|
|
### 999.7 — User Feedback System
|
|
In-app feedback collection — bug reports, feature requests, general feedback. Simple form, widget, or external integration.
|
|
|
|
### 999.8 — Analytics Integration
|
|
Privacy-respecting analytics (PostHog, Umami, or similar). Usage patterns, popular categories, search behavior, feature adoption. Self-hosted preferred to align with independent ethos.
|
|
|
|
### 999.9 — Mobile App
|
|
PWA first (offline, home-screen install), then evaluate native (React Native / Flutter) for richer experience — camera for weight verification, barcode scanning, etc.
|
|
|
|
### 999.10 — Monetization Strategy
|
|
How GearBox sustains itself. Options: sponsored/promoted items, premium features, affiliate links. Critical tension: revenue vs. credibility — GearBox's value is *unbiased* gear data. Needs deep discussion before implementation.
|
|
|
|
### 999.11 — Marketing Website
|
|
Standalone marketing site (`www.gearbox.de`) separate from the app (`app.gearbox.de`). Hero, value prop, feature highlights, how-it-works, social proof, sign-up CTA. The public-facing front door.
|
|
|
|
### 999.12 — Admin UX Polish (new, 2026-04-20)
|
|
Overhaul admin panel UX: TanStack Table (sortable/groupable columns), cmdk for GitLab-style composable filter bar (field→operator→value token input), hide FAB on `/admin/*`, replace tag inline form with popup modal, show tags expanded on item rows (collapse to +N when tight), group items by brand, prominent search bar on both admin list pages.
|
|
|
|
---
|
|
|
|
## Near-future scope (v2.5 candidates)
|
|
|
|
Explicitly planned for the next milestone but not yet a phase:
|
|
|
|
- **Tag-based spec schemas on global items** — key/value typed specs per category, sub-tag hierarchy. Enables proper structured product data per gear class.
|
|
- **Global item engagement stats** — view count, likes/saves, setup appearances. Feeds future sorting/ranking.
|
|
- **ComparisonTable currency normalization** — hooks are in place; needs real multi-currency test data to prove out.
|
|
|
|
---
|
|
|
|
## Deferred requirements (tracked, not scheduled)
|
|
|
|
Not in any current or v2.5 phase. Promote to a backlog phase when timing is right.
|
|
|
|
### Personalization
|
|
- **PERS-01** — Logged-in feed tuned to the user's collection categories
|
|
- **PERS-02** — Feed algorithm recommends by hobby interests
|
|
|
|
### Reviews & Content
|
|
- **REVW-01/02/03** — Structured reviews on catalog items; surface in discovery feed; curated/linked external reviews
|
|
- **REV-01/02/03** — Overall star rating, dimension ratings (durability, value), average ratings on item detail
|
|
- **MOD-01/02/03** — Freeform text reviews, report inappropriate content, admin review + action *(gated on moderation infra)*
|
|
|
|
### SEO
|
|
- **SEO-01** — Catalog pages crawlable by bots
|
|
- **SEO-02** — Meta tags + structured data
|
|
|
|
### Catalog Seeding
|
|
- **SEED-04** — Initial seeding run populates 100+ items across key categories via agent swarm *(crawl scripts exist — this would be the production run)*
|
|
|
|
### Aggregation
|
|
- **AGG-01** — Crowd-verified specs on item detail (manufacturer vs community-measured weight)
|
|
- **AGG-02** — "Which setups include this item"
|
|
- **AGG-03** — "Commonly paired with" setup composition insights
|
|
|
|
### Social
|
|
- **SOCL-01** — Fork/copy a public setup as template
|
|
- **SOCL-02** — Thread candidates auto-populate from global items
|
|
- **SOCL-03** — Follow other users
|
|
- **SOCL-04** — Activity feed of followed users' content
|
|
|
|
---
|
|
|
|
## Workflow
|
|
|
|
**To start work on something here:**
|
|
|
|
1. Pick an item above.
|
|
2. Run `superpowers:brainstorming` to turn the intent into a spec.
|
|
3. For non-trivial work, create a feature branch off `Develop` (e.g., `feature/manufacturer-picker`, `fix/tag-selector-search`).
|
|
4. Run `superpowers:writing-plans` to produce `docs/superpowers/plans/YYYY-MM-DD-<name>.md`.
|
|
5. Execute with `superpowers:subagent-driven-development` (recommended) or `superpowers:executing-plans`.
|
|
6. Remove the item from this doc when shipped.
|