docs(02-01): complete ranking-tab-entry-point plan — SUMMARY, STATE, ROADMAP updated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.planning/phases/02-ranking-dashboard-ui/02-01-SUMMARY.md

@@ -0,0 +1,100 @@
+---
+phase: 02-ranking-dashboard-ui
+plan: 01
+subsystem: ui
+tags: [trpc, prisma, ranking, react, nextjs]
+
+# Dependency graph
+requires:
+  - phase: 01-ai-ranking-backend
+    provides: rankingRouter with listSnapshots/getSnapshot, RankingSnapshot model with reordersJson field
+provides:
+  - saveReorder mutation on rankingRouter (append-only audit log of admin drag-reorders)
+  - Ranking tab visible on EVALUATION round detail pages
+  - RankingDashboard stub component (Plan 02 will flesh out)
+affects: [02-02-ranking-dashboard-ui]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "Append-only JSON log pattern: read existing array, push new event, write full array as Prisma.InputJsonValue"
+    - "isEvaluation guard for tab/content conditional rendering (matches isFiltering pattern)"
+
+key-files:
+  created:
+    - src/components/admin/round/ranking-dashboard.tsx
+  modified:
+    - src/server/routers/ranking.ts
+    - src/app/(admin)/admin/rounds/[roundId]/page.tsx
+
+key-decisions:
+  - "ReorderEvent type defined locally in ranking.ts (not exported) — only used by saveReorder"
+  - "saveReorder is append-only: full ordered list stored per event, latest entry per category = current admin order, gives full audit trail"
+
+patterns-established:
+  - "Tab conditional: ...(isEvaluation ? [{ value: 'ranking', label: 'Ranking', icon: BarChart3 }] : []) follows existing isFiltering pattern"
+
+requirements-completed: [DASH-01]
+
+# Metrics
+duration: 5min
+completed: 2026-02-27
+---
+
+# Phase 2 Plan 01: Ranking Tab Entry Point Summary
+
+**saveReorder append-only audit mutation + Ranking tab registered on EVALUATION round detail pages with RankingDashboard stub component**
+
+## Performance
+
+- **Duration:** ~5 min
+- **Started:** 2026-02-27T00:15:00Z
+- **Completed:** 2026-02-27T00:20:00Z
+- **Tasks:** 2
+- **Files modified:** 3
+
+## Accomplishments
+- Added `saveReorder` adminProcedure to rankingRouter — accepts snapshotId, category, orderedProjectIds; appends ReorderEvent to reordersJson (append-only audit log)
+- Registered Ranking tab in round detail page guarded by `isEvaluation` with BarChart3 icon (already imported)
+- Created minimal `RankingDashboard` stub component that compiles and renders placeholder text
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Add saveReorder mutation to ranking router** - `68422e6` (feat)
+2. **Task 2: Register Ranking tab in round detail page + create component stub** - `8f71527` (feat)
+
+**Plan metadata:** (docs commit to follow)
+
+## Files Created/Modified
+- `src/server/routers/ranking.ts` - Added ReorderEvent local type and saveReorder adminProcedure
+- `src/components/admin/round/ranking-dashboard.tsx` - New stub component exporting RankingDashboard with competitionId+roundId props
+- `src/app/(admin)/admin/rounds/[roundId]/page.tsx` - Import RankingDashboard, add Ranking tab to tab array, add TabsContent block
+
+## Decisions Made
+- `ReorderEvent` type defined locally in ranking.ts (not exported) — only consumed by saveReorder
+- Stub uses `_competitionId` / `_roundId` underscore prefix to avoid TypeScript unused-var warnings while keeping the correct prop signature for Plan 02 to use
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+- saveReorder backend contract established and type-safe
+- Ranking tab entry point wired — visible when viewing EVALUATION rounds
+- Plan 02 can now replace the stub body with the full RankingDashboard component
+- Build and typecheck both pass with 0 errors
+
+---
+*Phase: 02-ranking-dashboard-ui*
+*Completed: 2026-02-27*