---
gsd_state_version: 1.0
milestone: v2.4
milestone_name: Admin Foundation
status: executing
stopped_at: Completed 38-02-PLAN.md — admin tag management client UI
last_updated: "2026-04-19T20:32:22Z"
last_activity: 2026-04-20
progress:
  total_phases: 20
  completed_phases: 10
  total_plans: 38
  completed_plans: 37
  percent: 97
---

# Project State

## Project Reference

See: .planning/PROJECT.md (updated 2026-04-19)

**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.
**Current focus:** Phase 36 — Admin Role & Panel Foundation

## Current Position

Phase: 36 (Admin Role & Panel Foundation) — EXECUTING
Plan: 2 of 2
Status: Ready to execute
Last activity: 2026-04-19

Progress: [█████████░] 97%

## Performance Metrics

**Velocity:**

- Total plans completed: 110+ (all milestones through v2.3)
- v2.3: 18 plans across 3 phases (2026-04-13 → 2026-04-19)

*Updated after each plan completion*

## Accumulated Context

### Decisions

Key decisions carried forward from v2.3:

- External auth provider: Logto (self-hosted OIDC) — RESOLVED
- Structured UGC only — ratings and predefined fields, no freeform text — ACTIVE
- Separate globalItems table — not a flag on user items table — RESOLVED
- COALESCE merge for reference items — RESOLVED
- Detail pages replacing slide-out panels — RESOLVED
- Setup visibility: private/link/public column + shares table — RESOLVED
- Multi-currency: market_prices + community_prices + ECB rates — RESOLVED
- i18n: react-i18next, 7 namespaces, English + German — RESOLVED

v2.4 decisions:

- Admin role: isAdmin boolean flag on users table (simplest, no Logto role claims needed)
- Admin grant mechanism: CLI script or seed — no public UI for granting admin
- Sub-items/component attachment: explicitly deferred to a future milestone
- Catalog spec system (typed specs per tag): deferred to v2.5
- Engagement stats (views/likes/saves/appearances): deferred to v2.5

Phase 35 decisions (35-01):

- FIX-01: Add Candidate on thread page routes through CatalogSearchOverlay (thread mode), not a local modal
- FIX-02: ItemWithCategory type extended client-side only — server already returns image fields via withImageUrls()
- FIX-04: Login page is a server pass-through; no client auth check or card UI needed

Phase 35 decisions (35-02):

- FIX-03: Browser-native loading=lazy used for image deferral — no library needed, zero bundle overhead
- FIX-03: Skeleton is absolute inset-0 overlay removed on onLoad (not conditional branch swap) for stable layout
- FIX-03: GearImage accepts optional onLoad prop forwarded to all three img render paths
- [Phase ?]: FIX-05: cursor-pointer explicitly added to ItemCard navigable case, FabMenu buttons, and BottomTabBar anonymous tab buttons

### Pending Todos

- Cursor pointer on all clickable links — Phase 35 (FIX-05, plan 35-03)
- Make tag selector in global search searchable — `CatalogSearchOverlay.tsx`

Resolved in 35-01:

- Fix Add Candidate button shows wrong modal on thread page — DONE (FIX-01)
- Fix item image not showing on collection overview — DONE (FIX-02)
- Auth prompt sign-in button should redirect directly to Logto — DONE (FIX-04)

Resolved in 35-02:

- Investigate slow image loading — DONE (FIX-03)

### Blockers/Concerns

None.

### Quick Tasks Completed

| # | Description | Date | Commit | Directory |
|---|-------------|------|--------|-----------|
| 260420-vk0 | Fix UAT issues: image fetch-from-URL, image cropping, tag routing, duplicate tag error, tag form UX | 2026-04-20 | ddf9b95 | [260420-vk0-fix-uat-issues-image-fetch-from-url-imag](./quick/260420-vk0-fix-uat-issues-image-fetch-from-url-imag/) |

## Deferred Items

Items carried forward from v2.3:

| Category | Item | Status |
|----------|------|--------|
| todo | 2026-04-10-add-cursor-pointer-to-all-clickable-links | promoted to v2.4 FIX-05 |
| todo | 2026-04-10-fix-item-image-not-showing-on-collection-overview | promoted to v2.4 FIX-02 |
| todo | 2026-04-10-investigate-slow-image-loading | promoted to v2.4 FIX-03 |
| todo | 2026-04-13-auth-prompt-sign-in-button-should-redirect-directly-to-logto | promoted to v2.4 FIX-04 |
| todo | 2026-04-13-fix-add-candidate-button-shows-wrong-modal-on-thread-page | promoted to v2.4 FIX-01 |
| Phase 35 P03 | 5m | 2 tasks | 3 files |

## Session Continuity

Last session: 2026-04-19T20:32:22Z
Stopped at: Completed 38-02-PLAN.md — admin tag management client UI
Resume file: None