5.9 KiB
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 (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 (In Progress)
Milestone Goal: Give users the tools to actually decide between candidates — compare details side-by-side, see how a pick impacts their setup, and rank/annotate their options.
- Phase 10: Schema Foundation + Pros/Cons Fields — Migrate schema and deliver pros/cons annotation UI (completed 2026-03-16)
- Phase 11: Candidate Ranking — Drag-to-reorder priority ranking with rank badges
- Phase 12: Comparison View — Side-by-side tabular comparison with relative deltas
- Phase 13: Setup Impact Preview — Per-candidate weight and cost delta against a selected setup
Phase Details
Phase 10: Schema Foundation + Pros/Cons Fields
Goal: Candidates can be annotated with pros and cons, and the database is ready for ranking Depends on: Phase 9 Requirements: RANK-03 Success Criteria (what must be TRUE):
- User can open a candidate edit form and see pros and cons text fields
- User can save pros and cons text; the text persists across page refreshes
- CandidateCard shows a visual indicator when a candidate has pros or cons entered
- All existing tests pass after the schema migration (no column drift in test helper) Plans: 1/1 plans complete Plans:
- 10-01-PLAN.md — Add pros/cons fields through full stack (schema, service, Zod, form, card indicator)
Phase 11: Candidate Ranking
Goal: Users can drag candidates into a priority order that persists and is visually communicated Depends on: Phase 10 Requirements: RANK-01, RANK-02, RANK-04, RANK-05 Success Criteria (what must be TRUE):
- User can drag a candidate card to a new position within the thread's candidate list
- The reordered sequence is still intact after navigating away and returning
- The top three candidates display gold, silver, and bronze rank badges respectively
- Drag handles and rank badges are absent on a resolved thread; candidates render in static order Plans: TBD
Phase 12: Comparison View
Goal: Users can view all candidates for a thread side-by-side in a table with relative weight and price deltas Depends on: Phase 11 Requirements: COMP-01, COMP-02, COMP-03, COMP-04 Success Criteria (what must be TRUE):
- User can toggle a "Compare" mode on a thread detail page to reveal a tabular view showing weight, price, images, notes, links, status, pros, and cons for every candidate in columns
- The lightest candidate column is highlighted and all other columns show their weight difference relative to it; the cheapest candidate is highlighted similarly for price
- The comparison table scrolls horizontally on a narrow viewport without breaking layout; the attribute label column stays fixed on the left
- A resolved thread shows the comparison table in read-only mode with the winning candidate visually marked Plans: TBD
Phase 13: Setup Impact Preview
Goal: Users can select any setup and see exactly how much weight and cost each candidate would add or subtract Depends on: Phase 12 Requirements: IMPC-01, IMPC-02, IMPC-03, IMPC-04 Success Criteria (what must be TRUE):
- User can select a setup from a dropdown in the thread header and each candidate displays a weight delta and cost delta below its name
- When the selected setup contains an item in the same category as the thread, the delta reflects replacing that item (negative delta is possible) rather than pure addition
- When no category match exists in the selected setup, the delta shows a pure addition amount clearly labeled as "add"
- A candidate with no weight recorded shows a "-- (no weight data)" indicator instead of a zero delta Plans: TBD
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 | 1/1 | Complete | 2026-03-16 | - |
| 11. Candidate Ranking | v1.3 | 0/TBD | Not started | - |
| 12. Comparison View | v1.3 | 0/TBD | Not started | - |
| 13. Setup Impact Preview | v1.3 | 0/TBD | Not started | - |