RTSport Build — Integration Spec

Build Date

2026-05-01

Source of Truth

• Contract: docs/contract.md (v0.2)
• Repo: https://github.com/NightKnight64/rtsport
• Commits:
• 0891503 — Add API & data contract v0.2
• f666d09 — Add product brief and roadmap
• f8065ab — Initial commit: frontend mock v0.1

Architecture

Backend (Socrates)          Frontend (Daedalus)
     │                              │
     ▼                              ▼
FastAPI + PostgreSQL          HTMX + Jinja2
     │                              │
     └────────── contract ──────────┘

Integration Points

Data Flow

1. Frontend POSTs to POST /api/v1/events/sideline-entry
2. Backend validates against Pydantic schemas
3. Backend writes to PostgreSQL with school_id isolation
4. Backend returns updated athlete status
5. Frontend re-renders HTMX partial

Contract Alignment

• All Pydantic schemas in contract.md §1 are source of truth
• Frontend mocks already aligned (per Matt)
• No retcon needed

FERPA Gate

• API layer strips clinical_notes for non-AT roles
• visibility defaults to ["at"] on all writes
• Role-based access matrix enforced via FastAPI dependency

Shared Directory Layout

shared/build-20260501/
  SPEC.md              ← This file (integration contract)
  docs/                ← Cloned from repo
    contract.md
    product-brief.md
    roadmap.md
  frontend/            ← Cloned from repo
    index.html
    ...
  backend/             ← Socrates writes here
    app/
    models/
    api/
    tests/
  integration.md       ← Both update as they work

Status