Jean-Luc Makiola
1733fe8cfb
Archive setup sharing, currency system, and i18n foundation milestone. Reorganize ROADMAP.md with v2.3 details block, update PROJECT.md, MILESTONES.md, STATE.md deferred items, and RETROSPECTIVE.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
Requirements Archive: GearBox v2.3 Global & Social Ready
Archived: 2026-04-19 Milestone shipped: v2.3
Note: The active REQUIREMENTS.md at close was scoped to v2.1 Public Discovery requirements (all complete). v2.3-specific requirements (sharing, currency, i18n) were tracked as decisions in STATE.md and active items in PROJECT.md.
Requirements: GearBox v2.1 Public Discovery
Defined: 2026-04-09 Core Value: Help people make better gear decisions — discover what others use, compare real-world data, and see how a potential buy affects your setup before committing.
v2.1 Requirements
Public Access
- PUBL-01: User can browse the global item catalog without logging in
- PUBL-02: User can view public setups without logging in
- PUBL-03: User can view user profiles without logging in
- PUBL-04: Anonymous visitors see the landing page without auth spinner or redirect
- PUBL-05: Login is only required when user attempts to create/edit/delete their own data
Discovery
- DISC-01: Landing page displays an always-visible catalog search bar at the top
- DISC-02: Landing page shows a feed of popular setups below the search
- DISC-03: Landing page shows recently added catalog items
- DISC-04: Landing page shows trending categories
- DISC-05: Authenticated users see a "Go to Collection" entry point from the landing page
Catalog Enrichment
- CATL-01: Global items have attribution fields (sourceUrl, manufacturer, imageCredit, imageSourceUrl)
- CATL-02: Global items have a unique constraint on (brand, model) preventing duplicates
- CATL-03: Catalog detail pages display image attribution with credit and source link
- CATL-04: Bulk import API endpoint accepts multiple catalog items in one request
- CATL-05: Bulk import uses upsert semantics (ON CONFLICT update, not fail)
Agent Seeding Tools
- SEED-01: MCP server has a dedicated
upsert_catalog_itemtool that writes to globalItems (not user-scoped) - SEED-02: MCP server has a
bulk_upsert_catalogtool for batch catalog population - SEED-03: Catalog MCP tools include attribution fields (sourceUrl, manufacturer, imageCredit) as parameters
Infrastructure
- INFR-01: Public API endpoints are rate-limited to prevent abuse
- INFR-02: Discovery feed endpoint uses cursor pagination for scalability
Traceability
| Requirement | Phase | Status |
|---|---|---|
| PUBL-01 | Phase 24 | Complete |
| PUBL-02 | Phase 24 | Complete |
| PUBL-03 | Phase 24 | Complete |
| PUBL-04 | Phase 24 | Complete |
| PUBL-05 | Phase 24 | Complete |
| INFR-01 | Phase 24 | Complete |
| CATL-01 | Phase 25 | Complete |
| CATL-02 | Phase 25 | Complete |
| CATL-03 | Phase 25 | Complete |
| CATL-04 | Phase 25 | Complete |
| CATL-05 | Phase 25 | Complete |
| SEED-01 | Phase 25 | Complete |
| SEED-02 | Phase 25 | Complete |
| SEED-03 | Phase 25 | Complete |
| DISC-01 | Phase 26 | Complete |
| DISC-02 | Phase 26 | Complete |
| DISC-03 | Phase 26 | Complete |
| DISC-04 | Phase 26 | Complete |
| DISC-05 | Phase 26 | Complete |
| INFR-02 | Phase 26 | Complete |
Coverage: 20/20 v2.1 requirements complete.