Jean-Luc Makiola
a5df33a2d8
- SUMMARY.md with 30 passing tests, 13 files, 3min duration - STATE.md updated to plan 2/4 at 50% progress - ROADMAP.md and REQUIREMENTS.md updated with COLL-01 through COLL-04 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
98 lines
3.7 KiB
Markdown
98 lines
3.7 KiB
Markdown
# Requirements: GearBox
|
|
|
|
**Defined:** 2026-03-14
|
|
**Core Value:** Make it effortless to manage gear and plan new purchases — see how a potential buy affects your total setup weight and cost before committing.
|
|
|
|
## v1 Requirements
|
|
|
|
Requirements for initial release. Each maps to roadmap phases.
|
|
|
|
### Collection
|
|
|
|
- [x] **COLL-01**: User can add gear items with name, weight, price, category, notes, and product link
|
|
- [x] **COLL-02**: User can edit and delete gear items
|
|
- [x] **COLL-03**: User can organize items into user-defined categories
|
|
- [x] **COLL-04**: User can see automatic weight and cost totals by category and overall
|
|
|
|
### Planning Threads
|
|
|
|
- [ ] **THRD-01**: User can create a planning thread with a name (e.g. "Helmet")
|
|
- [ ] **THRD-02**: User can add candidate products to a thread with weight, price, notes, and product link
|
|
- [ ] **THRD-03**: User can edit and remove candidates from a thread
|
|
- [ ] **THRD-04**: User can resolve a thread by picking a winner, which moves to their collection
|
|
|
|
### Setups
|
|
|
|
- [ ] **SETP-01**: User can create named setups (e.g. "Summer Bikepacking")
|
|
- [ ] **SETP-02**: User can add/remove collection items to a setup
|
|
- [ ] **SETP-03**: User can see total weight and cost for a setup
|
|
|
|
### Dashboard
|
|
|
|
- [ ] **DASH-01**: User sees a dashboard home page with cards linking to collection, threads, and setups
|
|
|
|
## v2 Requirements
|
|
|
|
Deferred to future release. Tracked but not in current roadmap.
|
|
|
|
### Collection Enhancements
|
|
|
|
- **COLL-05**: User can upload a photo per gear item
|
|
- **COLL-06**: User can search items by name and filter by category
|
|
- **COLL-07**: User can choose display unit for weight (g, oz, lb, kg)
|
|
- **COLL-08**: User can import gear from CSV file
|
|
- **COLL-09**: User can export collection to CSV
|
|
|
|
### Thread Enhancements
|
|
|
|
- **THRD-05**: User can see side-by-side comparison of candidates on weight and price
|
|
- **THRD-06**: User can track candidate status (researching → ordered → arrived)
|
|
- **THRD-07**: User can rank/prioritize candidates within a thread
|
|
- **THRD-08**: User can see how a candidate would affect an existing setup's weight/cost (impact preview)
|
|
|
|
### Setup Enhancements
|
|
|
|
- **SETP-04**: User can see weight distribution visualization (pie/bar chart by category)
|
|
- **SETP-05**: User can classify items as base weight, worn, or consumable per setup
|
|
|
|
## Out of Scope
|
|
|
|
| Feature | Reason |
|
|
|---------|--------|
|
|
| Authentication / multi-user | Single user for v1, no login needed |
|
|
| Custom comparison parameters | Complexity trap, weight/price covers 80% of cases |
|
|
| Mobile native app | Web-first, responsive design sufficient |
|
|
| Social/sharing features | Different product, defer to v2+ |
|
|
| Price tracking / deal alerts | Requires scraping, fragile, different product category |
|
|
| Barcode scanning / product database | Requires external database, mobile-first feature |
|
|
| Community gear database | Requires moderation, accounts, content management |
|
|
| Real-time weather integration | Only relevant to outdoor-specific use, GearBox is hobby-agnostic |
|
|
|
|
## Traceability
|
|
|
|
Which phases cover which requirements. Updated during roadmap creation.
|
|
|
|
| Requirement | Phase | Status |
|
|
|-------------|-------|--------|
|
|
| COLL-01 | Phase 1 | Complete |
|
|
| COLL-02 | Phase 1 | Complete |
|
|
| COLL-03 | Phase 1 | Complete |
|
|
| COLL-04 | Phase 1 | Complete |
|
|
| THRD-01 | Phase 2 | Pending |
|
|
| THRD-02 | Phase 2 | Pending |
|
|
| THRD-03 | Phase 2 | Pending |
|
|
| THRD-04 | Phase 2 | Pending |
|
|
| SETP-01 | Phase 3 | Pending |
|
|
| SETP-02 | Phase 3 | Pending |
|
|
| SETP-03 | Phase 3 | Pending |
|
|
| DASH-01 | Phase 3 | Pending |
|
|
|
|
**Coverage:**
|
|
- v1 requirements: 12 total
|
|
- Mapped to phases: 12
|
|
- Unmapped: 0
|
|
|
|
---
|
|
*Requirements defined: 2026-03-14*
|
|
*Last updated: 2026-03-14 after roadmap creation*
|