feat: Replaced plain list rendering of related techniques with a respon…

- "frontend/src/api/public-client.ts"
- "frontend/src/pages/TechniquePage.tsx"
- "frontend/src/App.css"

GSD-Task: S02/T02
This commit is contained in:
jlightner 2026-03-31 06:15:25 +00:00
parent 5d0fd05b98
commit 6de5317416
6 changed files with 160 additions and 19 deletions

View file

@ -61,7 +61,7 @@
- Estimate: 45m - Estimate: 45m
- Files: backend/schemas.py, backend/routers/techniques.py, backend/tests/test_public_api.py - Files: backend/schemas.py, backend/routers/techniques.py, backend/tests/test_public_api.py
- Verify: cd backend && python -m pytest tests/test_public_api.py -x -v 2>&1 | tail -20 - Verify: cd backend && python -m pytest tests/test_public_api.py -x -v 2>&1 | tail -20
- [ ] **T02: Frontend card-based related techniques section** — Replace the plain list rendering of related techniques with a responsive card grid. Update the TypeScript interface to match the enriched backend schema. - [x] **T02: Replaced plain list rendering of related techniques with a responsive card grid showing title, creator name, category badge, and reason text** — Replace the plain list rendering of related techniques with a responsive card grid. Update the TypeScript interface to match the enriched backend schema.
## Steps ## Steps

View file

@ -0,0 +1,16 @@
{
"schemaVersion": 1,
"taskId": "T01",
"unitId": "M010/S02/T01",
"timestamp": 1774937639249,
"passed": true,
"discoverySource": "task-plan",
"checks": [
{
"command": "cd backend",
"exitCode": 0,
"durationMs": 7,
"verdict": "pass"
}
]
}

View file

@ -0,0 +1,81 @@
---
id: T02
parent: S02
milestone: M010
provides: []
requires: []
affects: []
key_files: ["frontend/src/api/public-client.ts", "frontend/src/pages/TechniquePage.tsx", "frontend/src/App.css"]
key_decisions: ["CSS grid with 1fr/1fr columns at 600px breakpoint for responsive card layout", "Badge uses inline-block with align-self:flex-start to avoid stretching"]
patterns_established: []
drill_down_paths: []
observability_surfaces: []
duration: ""
verification_result: "Frontend build passes with zero errors (48 modules, 743ms). grep confirms 6 related-card CSS rules and creator_name in the TypeScript interface. Backend tests require ub01 PostgreSQL — not runnable locally."
completed_at: 2026-03-31T06:15:19.216Z
blocker_discovered: false
---
# T02: Replaced plain list rendering of related techniques with a responsive card grid showing title, creator name, category badge, and reason text
> Replaced plain list rendering of related techniques with a responsive card grid showing title, creator name, category badge, and reason text
## What Happened
---
id: T02
parent: S02
milestone: M010
key_files:
- frontend/src/api/public-client.ts
- frontend/src/pages/TechniquePage.tsx
- frontend/src/App.css
key_decisions:
- CSS grid with 1fr/1fr columns at 600px breakpoint for responsive card layout
- Badge uses inline-block with align-self:flex-start to avoid stretching
duration: ""
verification_result: passed
completed_at: 2026-03-31T06:15:19.238Z
blocker_discovered: false
---
# T02: Replaced plain list rendering of related techniques with a responsive card grid showing title, creator name, category badge, and reason text
**Replaced plain list rendering of related techniques with a responsive card grid showing title, creator name, category badge, and reason text**
## What Happened
Updated the RelatedLinkItem TypeScript interface with creator_name, topic_category, and reason fields from T01's backend enrichment. Replaced the ul list in TechniquePage.tsx with a CSS grid of cards — each card shows the technique title as a link, creator name, topic category as a pill badge, and scoring reason. All fields conditionally rendered for graceful degradation. Added responsive grid CSS using existing design tokens: single column on mobile, two columns at 600px+.
## Verification
Frontend build passes with zero errors (48 modules, 743ms). grep confirms 6 related-card CSS rules and creator_name in the TypeScript interface. Backend tests require ub01 PostgreSQL — not runnable locally.
## Verification Evidence
| # | Command | Exit Code | Verdict | Duration |
|---|---------|-----------|---------|----------|
| 1 | `cd frontend && npm run build 2>&1 | tail -10` | 0 | ✅ pass | 2800ms |
| 2 | `grep -c 'related-card' frontend/src/App.css` | 0 | ✅ pass | 50ms |
| 3 | `grep -q 'creator_name' frontend/src/api/public-client.ts` | 0 | ✅ pass | 50ms |
## Deviations
None.
## Known Issues
Backend test suite cannot run locally — requires PostgreSQL on ub01:5433.
## Files Created/Modified
- `frontend/src/api/public-client.ts`
- `frontend/src/pages/TechniquePage.tsx`
- `frontend/src/App.css`
## Deviations
None.
## Known Issues
Backend test suite cannot run locally — requires PostgreSQL on ub01:5433.

View file

@ -1781,27 +1781,62 @@ a.app-footer__repo:hover {
margin-bottom: 0.5rem; margin-bottom: 0.5rem;
} }
.technique-related__list { .technique-related__grid {
list-style: none; display: grid;
display: flex; grid-template-columns: 1fr;
flex-direction: column; gap: 0.75rem;
gap: 0.375rem;
} }
.technique-related__list a { @media (min-width: 600px) {
.technique-related__grid {
grid-template-columns: 1fr 1fr;
}
}
.related-card {
background: var(--color-surface-card);
border: 1px solid var(--color-border);
border-radius: 0.5rem;
padding: 0.875rem 1rem;
display: flex;
flex-direction: column;
gap: 0.25rem;
}
.related-card__title {
color: var(--color-link-accent); color: var(--color-link-accent);
text-decoration: none; text-decoration: none;
font-weight: 600;
font-size: 0.9375rem; font-size: 0.9375rem;
} }
.technique-related__list a:hover { .related-card__title:hover {
text-decoration: underline; text-decoration: underline;
} }
.technique-related__rel { .related-card__creator {
font-size: 0.75rem; font-size: 0.8125rem;
color: var(--color-text-muted); color: var(--color-text-muted);
margin-left: 0.375rem; }
.related-card__badge {
display: inline-block;
align-self: flex-start;
font-size: 0.6875rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.03em;
padding: 0.125rem 0.5rem;
border-radius: 999px;
background: var(--color-badge-bg, rgba(255, 255, 255, 0.08));
color: var(--color-badge-text, var(--color-text-muted));
}
.related-card__reason {
font-size: 0.75rem;
font-style: italic;
color: var(--color-text-muted);
margin: 0;
} }
/* /*

View file

@ -49,6 +49,9 @@ export interface RelatedLinkItem {
target_title: string; target_title: string;
target_slug: string; target_slug: string;
relationship: string; relationship: string;
creator_name: string;
topic_category: string;
reason: string;
} }
export interface TechniquePageDetail { export interface TechniquePageDetail {

View file

@ -495,18 +495,24 @@ export default function TechniquePage() {
{technique.related_links.length > 0 && ( {technique.related_links.length > 0 && (
<section className="technique-related"> <section className="technique-related">
<h2>Related Techniques</h2> <h2>Related Techniques</h2>
<ul className="technique-related__list"> <div className="technique-related__grid">
{technique.related_links.map((link) => ( {technique.related_links.map((link) => (
<li key={link.target_slug}> <div key={link.target_slug} className="related-card">
<Link to={`/techniques/${link.target_slug}`}> <Link to={`/techniques/${link.target_slug}`} className="related-card__title">
{link.target_title} {link.target_title}
</Link> </Link>
<span className="technique-related__rel"> {link.creator_name && (
({link.relationship}) <span className="related-card__creator">{link.creator_name}</span>
</span> )}
</li> {link.topic_category && (
<span className="related-card__badge">{link.topic_category}</span>
)}
{link.reason && (
<p className="related-card__reason">{link.reason}</p>
)}
</div>
))} ))}
</ul> </div>
</section> </section>
)} )}
</div> </div>