113 lines
5.9 KiB
Markdown
113 lines
5.9 KiB
Markdown
# 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
|
|
|
|
<details>
|
|
<summary>✅ v1.0 MVP (Phases 1-3) — SHIPPED 2026-03-15</summary>
|
|
|
|
- [x] Phase 1: Foundation and Collection (4/4 plans) — completed 2026-03-14
|
|
- [x] Phase 2: Planning Threads (3/3 plans) — completed 2026-03-15
|
|
- [x] Phase 3: Setups and Dashboard (3/3 plans) — completed 2026-03-15
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>✅ v1.1 Fixes & Polish (Phases 4-6) — SHIPPED 2026-03-15</summary>
|
|
|
|
- [x] Phase 4: Database & Planning Fixes (2/2 plans) — completed 2026-03-15
|
|
- [x] Phase 5: Image Handling (2/2 plans) — completed 2026-03-15
|
|
- [x] Phase 6: Category Icons (3/3 plans) — completed 2026-03-15
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>✅ v1.2 Collection Power-Ups (Phases 7-9) — SHIPPED 2026-03-16</summary>
|
|
|
|
- [x] Phase 7: Weight Unit Selection (2/2 plans) — completed 2026-03-16
|
|
- [x] Phase 8: Search, Filter, and Candidate Status (2/2 plans) — completed 2026-03-16
|
|
- [x] Phase 9: Weight Classification and Visualization (2/2 plans) — completed 2026-03-16
|
|
|
|
</details>
|
|
|
|
### 🚧 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.
|
|
|
|
- [x] **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):
|
|
1. User can open a candidate edit form and see pros and cons text fields
|
|
2. User can save pros and cons text; the text persists across page refreshes
|
|
3. CandidateCard shows a visual indicator when a candidate has pros or cons entered
|
|
4. 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):
|
|
1. User can drag a candidate card to a new position within the thread's candidate list
|
|
2. The reordered sequence is still intact after navigating away and returning
|
|
3. The top three candidates display gold, silver, and bronze rank badges respectively
|
|
4. 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):
|
|
1. 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
|
|
2. 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
|
|
3. The comparison table scrolls horizontally on a narrow viewport without breaking layout; the attribute label column stays fixed on the left
|
|
4. 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):
|
|
1. 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
|
|
2. 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
|
|
3. When no category match exists in the selected setup, the delta shows a pure addition amount clearly labeled as "add"
|
|
4. 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 | - |
|