# S02: Related Techniques Cross-Linking — UAT

**Milestone:** M010
**Written:** 2026-03-31T06:19:54.667Z

## UAT: Related Techniques Cross-Linking

### Preconditions
- Chrysopedia stack running on ub01 (API + DB + frontend)
- Database contains technique pages from multiple creators with overlapping topics/tags
- Docker images rebuilt with S02 code (`docker compose build && docker compose up -d`)

### Test 1: Related techniques appear on technique page
1. Navigate to a technique page (e.g., `/techniques/{any-slug}`)
2. Scroll to bottom of page
3. **Expected:** "Related Techniques" section visible with 1-4 cards
4. Each card shows: technique title (clickable link), creator name, category badge, reason text

### Test 2: Card links navigate correctly
1. On a technique page with related techniques visible
2. Click on a related technique card title
3. **Expected:** Navigates to `/techniques/{target_slug}` — the linked technique page loads correctly

### Test 3: Scoring priority — same creator same category ranks highest
1. Find a technique page where the creator has other techniques in the same category
2. Check the related techniques section
3. **Expected:** Techniques from the same creator AND same category appear first (reason shows "Same creator, same topic")

### Test 4: Responsive layout
1. View a technique page on desktop (>600px width)
2. **Expected:** Related cards display in 2-column grid
3. Resize browser to mobile width (<600px)
4. **Expected:** Related cards stack in single column

### Test 5: No related techniques
1. Find or create a technique page with a unique creator AND unique category AND no shared tags with any other technique
2. **Expected:** Related Techniques section either hidden or shows empty state — no broken UI

### Test 6: Graceful field handling
1. If a related technique has empty creator_name or topic_category in the DB
2. **Expected:** Card renders without those fields — no empty badges or "undefined" text

### Edge Cases
- Technique with NULL topic_tags → related section still works (scores on creator/category only)
- Technique page loaded directly by URL (not via navigation) → related techniques still populate
- Only 1-2 possible matches exist → shows only available matches, not padded to 4
