docs: update documentation to reflect Phase 2 completion

- Mark Phase 2 (Matches & Ratings API) as completed in all docs
- Add new Ratings & Reviews section to README
- Update roadmap and progress tracking (72% complete)
- Document all Phase 2 features and endpoints in COMPLETED.md
- Reorganize TODO.md for Phase 2.5 (WebRTC) as next priority

docs/COMPLETED.md

@@ -151,6 +151,88 @@
 
 ---
 
+## ✅ Phase 2: Matches & Ratings API (COMPLETED)
+
+**Completed:** 2025-11-14
+**Time Spent:** ~10 hours
+**Status:** Production-ready with full CRUD operations and real-time updates
+
+### Step 1: Matches API Implementation
+- [x] Database schema:
+  - Added `slug` field to Match model (CUID for security)
+  - Migration: `20251114183814_add_match_slug`
+  - Unique constraint on slug
+- [x] Backend endpoints:
+  - `POST /api/matches` - Create match request (with event slug, target user)
+  - `GET /api/matches` - List matches with filters (eventSlug, status)
+  - `GET /api/matches/:slug` - Get match details with hasRated flag
+  - `GET /api/matches/:slug/messages` - Get match message history
+  - `PUT /api/matches/:slug/accept` - Accept match request
+  - `DELETE /api/matches/:slug` - Reject/cancel match
+  - Real-time notifications via Socket.IO (match_request_received, match_accepted, match_cancelled)
+- [x] Frontend pages:
+  - MatchesPage.jsx - List and manage matches with filter tabs (all/pending/active)
+  - MatchChatPage.jsx - Private 1:1 chat with message history loading
+  - Updated EventChatPage - UserPlus button creates match requests
+- [x] Security:
+  - CUID slugs prevent ID enumeration
+  - URLs: `/matches/{slug}/chat` instead of `/matches/{id}/chat`
+  - Partner-based access control
+
+### Step 2: Ratings API Implementation
+- [x] Database schema:
+  - Rating model with unique constraint (match_id, rater_id, rated_id)
+  - Fields: score (1-5), comment, would_collaborate_again
+- [x] Backend endpoints:
+  - `POST /api/matches/:slug/ratings` - Create rating
+  - `GET /api/users/:username/ratings` - Get user ratings (last 50)
+  - hasRated flag in match response
+  - Auto-complete match when both users rate
+- [x] Frontend integration:
+  - RatePartnerPage.jsx - Real API integration with validation
+  - Duplicate rating prevention (redirect if already rated)
+  - "✓ Rated" badge in MatchChatPage when user has rated
+  - PublicProfilePage.jsx - Display ratings with stars, comments, and collaboration preferences
+- [x] Validation:
+  - Score 1-5 required
+  - Comment optional
+  - One rating per user per match (database constraint)
+
+### Step 3: Public Profile Ratings Display
+- [x] PublicProfilePage enhancements:
+  - Fetch and display user ratings using ratingsAPI.getUserRatings()
+  - Summary section: average rating with star visualization, total count
+  - Individual ratings section:
+    - Rater avatar and name (clickable links to their profiles)
+    - Star rating (1-5 filled stars)
+    - Comment text
+    - "Would collaborate again" indicator with thumbs up icon
+    - Event context (clickable link) and date
+  - Loading states and empty states
+- [x] Profile navigation:
+  - MatchesPage: Partner avatar and name link to profile
+  - MatchChatPage: Header avatar and name link to profile
+  - Hover effects on all profile links
+
+### Git Commits (Phase 2)
+1. `feat: implement Phase 2 - Matches API with real-time notifications`
+2. `feat: add match slugs for security and fix message history loading`
+3. `feat: implement Ratings API (Phase 2.5)`
+4. `feat: prevent duplicate ratings and show rated status in chat`
+5. `feat: display user ratings on public profiles and add profile links`
+
+### Key Features
+- Secure match URLs with CUID slugs
+- Real-time match notifications via Socket.IO
+- Message history persistence and loading
+- Complete ratings system with duplicate prevention
+- Auto-match completion when both users rate
+- Public profile ratings display with detailed reviews
+- Clickable profile links throughout the app
+- Comprehensive validation and error handling
+
+---
+
 ## 🐳 1. Setup projektu i infrastruktura
 
 ### Docker Compose
@@ -361,5 +443,5 @@ docs: update TODO.md with completed tasks and next steps
 
 ---
 
-**Last Updated:** 2025-11-14
+**Last Updated:** 2025-11-14 (Phase 2 completed)
 **Note:** This file is an archive. For current tasks, see TODO.md