makiolaj/GearBox
1
0
Fork 0
Code Issues 8 Pull Requests Actions Packages Projects Releases 10 Wiki Activity
Files
c98995288b9ea9be5f60a3321915571be45b2399
GearBox/.planning/ROADMAP.md

10 KiB
Raw Blame History

Roadmap: GearBox

Milestones

  • ✅ v1.0 MVP — Phases 1-3 (shipped 2026-03-15)
  • ✅ v1.1 Fixes & Polish — Phases 4-6 (shipped 2026-03-15)
  • ✅ v1.2 Collection Power-Ups — Phases 7-9 (shipped 2026-03-16)
  • ✅ v1.3 Research & Decision Tools — Phases 10-13 (shipped 2026-04-08)
  • ✅ v2.0 Platform Foundation — Phases 14-23 (shipped 2026-04-08)
  • 🚧 v2.1 Public Discovery — Phases 24-26 (in progress)

Phases

✅ v1.0 MVP (Phases 1-3) — SHIPPED 2026-03-15
  • Phase 1: Foundation and Collection (4/4 plans) — completed 2026-03-14
  • Phase 2: Planning Threads (3/3 plans) — completed 2026-03-15
  • Phase 3: Setups and Dashboard (3/3 plans) — completed 2026-03-15
✅ v1.1 Fixes & Polish (Phases 4-6) — SHIPPED 2026-03-15
  • Phase 4: Database & Planning Fixes (2/2 plans) — completed 2026-03-15
  • Phase 5: Image Handling (2/2 plans) — completed 2026-03-15
  • Phase 6: Category Icons (3/3 plans) — completed 2026-03-15
✅ v1.2 Collection Power-Ups (Phases 7-9) — SHIPPED 2026-03-16
  • Phase 7: Weight Unit Selection (2/2 plans) — completed 2026-03-16
  • Phase 8: Search, Filter, and Candidate Status (2/2 plans) — completed 2026-03-16
  • Phase 9: Weight Classification and Visualization (2/2 plans) — completed 2026-03-16
✅ v1.3 Research & Decision Tools (Phases 10-13) — SHIPPED 2026-04-08
  • Phase 10: Schema Foundation + Pros/Cons Fields (1/1 plans) — completed 2026-03-16
  • Phase 11: Candidate Ranking (2/2 plans) — completed 2026-03-16
  • Phase 12: Comparison View (1/1 plans) — completed 2026-03-17
  • Phase 13: Setup Impact Preview (2/2 plans) — completed 2026-04-08
✅ v2.0 Platform Foundation (Phases 14-23) — SHIPPED 2026-04-08
  • Phase 14: PostgreSQL Migration (6/6 plans) — completed 2026-04-05
  • Phase 15: External Authentication (3/3 plans) — completed 2026-04-05
  • Phase 16: Multi-User Data Model (4/4 plans) — completed 2026-04-05
  • Phase 17: Object Storage (3/3 plans) — completed 2026-04-05
  • Phase 18: Global Items & Public Profiles (5/5 plans) — completed 2026-04-05
  • Phase 19: Reference Item Model & Tags Schema (3/3 plans) — completed 2026-04-05
  • Phase 20: FAB & Full-Screen Catalog Search (2/2 plans) — completed 2026-04-06
  • Phase 21: Item & Catalog Detail Pages (3/3 plans) — completed 2026-04-06
  • Phase 22: Add-from-Catalog & Thread Integration (2/2 plans) — completed 2026-04-06
  • Phase 23: Manual Entry Fallback (1/1 plans) — completed 2026-04-06

v2.1 Public Discovery (In Progress)

Milestone Goal: Transform GearBox from a login-first tool into a public-first discovery platform with always-on catalog search and a browsable feed of community content.

  • Phase 24: Public Access & Infrastructure - Remove the login wall from read-only routes and add rate limiting to public endpoints (completed 2026-04-10)
  • Phase 25: Catalog Enrichment & Agent Tools - Add attribution fields to global items, bulk import API, and MCP tools for agent-powered seeding (completed 2026-04-10)
  • Phase 26: Discovery Landing Page - Replace the dashboard with a public-first landing page featuring catalog search and community feed (completed 2026-04-10)

Phase Details

Phase 24: Public Access & Infrastructure

Goal: Anyone can browse the catalog, public setups, and user profiles without logging in Depends on: Phase 23 (v2.0 complete) Requirements: PUBL-01, PUBL-02, PUBL-03, PUBL-04, PUBL-05, INFR-01 Success Criteria (what must be TRUE):

  1. Visiting the app without a session shows the app content immediately — no auth spinner, no redirect to login
  2. An unauthenticated visitor can browse the global item catalog and open a catalog detail page
  3. An unauthenticated visitor can view a public setup and see its items and totals
  4. An unauthenticated visitor can view a user's public profile page
  5. Attempting to create, edit, or delete any item/setup/thread while unauthenticated redirects to login Plans: 2 plans

Plans:

  • 24-01-PLAN.md — Rate limit factory and tiered public endpoint protection
  • 24-02-PLAN.md — Client-side public access (render-first root, auth prompt, setup/catalog guards)

UI hint: yes

Phase 25: Catalog Enrichment & Agent Tools

Goal: Global items carry attribution metadata and can be bulk-populated by an MCP agent swarm Depends on: Phase 24 Requirements: CATL-01, CATL-02, CATL-03, CATL-04, CATL-05, SEED-01, SEED-02, SEED-03 Success Criteria (what must be TRUE):

  1. A catalog item detail page displays image credit and a link to the image source
  2. Attempting to import two items with the same brand and model updates the existing record rather than creating a duplicate
  3. A single API call with an array of items imports them all, upserting on (brand, model) conflict
  4. An MCP agent can call upsert_catalog_item with attribution fields and the item appears in the catalog
  5. An MCP agent can call bulk_upsert_catalog with a batch of items and all are persisted with attribution Plans: 2 plans

Plans:

  • 25-01-PLAN.md — Schema migration (attribution columns + unique constraint) and upsert service layer
  • 25-02-PLAN.md — HTTP upsert routes, MCP catalog tools, and client attribution display

Phase 26: Discovery Landing Page

Goal: The app opens to a public discovery feed with prominent catalog search, not a personal dashboard Depends on: Phase 25 Requirements: DISC-01, DISC-02, DISC-03, DISC-04, DISC-05, INFR-02 Success Criteria (what must be TRUE):

  1. The root URL shows a landing page with a catalog search bar at the top, visible without logging in
  2. Below the search bar, a feed of popular public setups is visible with titles, creator names, and item counts
  3. The landing page shows a section of recently added catalog items
  4. The landing page shows a section of trending categories
  5. A logged-in user sees a "Go to Collection" link or button on the landing page that navigates to their personal collection Plans: 3 plans

Plans:

  • 26-01-PLAN.md — Discovery service layer with cursor pagination (TDD)
  • 26-02-PLAN.md — Discovery routes, server registration, and client hooks
  • 26-03-PLAN.md — Landing page UI and PublicSetupCard enhancement UI hint: yes

Progress

Phase Milestone Plans Complete Status Completed
1. Foundation and Collection v1.0 4/4 Complete 2026-03-14
2. Planning Threads v1.0 3/3 Complete 2026-03-15
3. Setups and Dashboard v1.0 3/3 Complete 2026-03-15
4. Database & Planning Fixes v1.1 2/2 Complete 2026-03-15
5. Image Handling v1.1 2/2 Complete 2026-03-15
6. Category Icons v1.1 3/3 Complete 2026-03-15
7. Weight Unit Selection v1.2 2/2 Complete 2026-03-16
8. Search, Filter, and Candidate Status v1.2 2/2 Complete 2026-03-16
9. Weight Classification and Visualization v1.2 2/2 Complete 2026-03-16
10. Schema Foundation + Pros/Cons Fields v1.3 1/1 Complete 2026-03-16
11. Candidate Ranking v1.3 2/2 Complete 2026-03-16
12. Comparison View v1.3 1/1 Complete 2026-03-17
13. Setup Impact Preview v1.3 2/2 Complete 2026-04-08
14. PostgreSQL Migration v2.0 6/6 Complete 2026-04-05
15. External Authentication v2.0 3/3 Complete 2026-04-05
16. Multi-User Data Model v2.0 4/4 Complete 2026-04-05
17. Object Storage v2.0 3/3 Complete 2026-04-05
18. Global Items & Public Profiles v2.0 5/5 Complete 2026-04-05
19. Reference Item Model & Tags Schema v2.0 3/3 Complete 2026-04-05
20. FAB & Full-Screen Catalog Search v2.0 2/2 Complete 2026-04-06
21. Item & Catalog Detail Pages v2.0 3/3 Complete 2026-04-06
22. Add-from-Catalog & Thread Integration v2.0 2/2 Complete 2026-04-06
23. Manual Entry Fallback v2.0 1/1 Complete 2026-04-06
24. Public Access & Infrastructure v2.1 2/2 Complete 2026-04-10
25. Catalog Enrichment & Agent Tools v2.1 1/2 Complete 2026-04-10
26. Discovery Landing Page v2.1 3/3 Complete 2026-04-10

Backlog

Phase 999.1: Rewrite E2E Tests for OIDC Auth (BACKLOG)

Goal: E2E tests currently expect local username/password login but auth moved to external OIDC (Logto). Rewrite with mock OIDC provider or API-key-based auth bypass. Seed migration to Postgres is already done. Requirements: TBD Plans: 3 plans

Plans:

  • 26-01-PLAN.md — Discovery service layer with cursor pagination (TDD)
  • 26-02-PLAN.md — Discovery routes, server registration, and client hooks
  • 26-03-PLAN.md — Landing page UI and PublicSetupCard enhancement

Plans:

  • TBD (promote with /gsd:review-backlog when ready)

Phase 999.2: Revamp Onboarding Flow (BACKLOG)

Goal: Redesign the onboarding experience to match the current app style and flow. Replace the manual item edit form with the catalog search function. Visual refresh to align with the newer UI patterns. Requirements: TBD Plans: 3 plans

Plans:

  • 26-01-PLAN.md — Discovery service layer with cursor pagination (TDD)
  • 26-02-PLAN.md — Discovery routes, server registration, and client hooks
  • 26-03-PLAN.md — Landing page UI and PublicSetupCard enhancement

Plans:

  • TBD (promote with /gsd:review-backlog when ready)

Phase 999.3: Public Access Auth Model (BACKLOG)

Goal: Rework auth so the app is accessible without logging in. Currently all routes require authentication, but public-facing pages (discovery/browse, shared setups, public profiles) should be viewable by unauthenticated users. Auth only required for write operations and personal data. Requirements: TBD Plans: 3 plans

Plans:

  • 26-01-PLAN.md — Discovery service layer with cursor pagination (TDD)
  • 26-02-PLAN.md — Discovery routes, server registration, and client hooks
  • 26-03-PLAN.md — Landing page UI and PublicSetupCard enhancement

Plans:

  • TBD (promote with /gsd:review-backlog when ready)
Reference in New Issue View Git Blame Copy Permalink