feat(ofsted): add Report Card system support alongside legacy OEIF grades

Ofsted replaced single overall grades with Report Cards from Nov 2025.
Both systems are retained during the transition period.

- DB: new framework + 9 RC columns on ofsted_inspections (schema v4)
- Integrator: auto-detect OEIF vs Report Card from CSV column headers;
  parse 5-level RC grades and safeguarding met/not-met
- API: expose all new fields in the ofsted response dict
- Frontend: branch on framework='ReportCard' to show safeguarding badge
  + 8-category grid; fall back to legacy OEIF layout otherwise;
  always show inspection date in both layouts
- CSS: rcGrade1–5 and safeguardingMet/NotMet classes

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

nextjs-app/components/Footer.tsx

@@ -15,8 +15,7 @@ export function Footer() {
           <div className={styles.section}>
             <h3 className={styles.title}>SchoolCompare</h3>
             <p className={styles.description}>
-              Compare primary school KS2 performance across England. Data sourced from UK Government
-              Compare School Performance.
+              Compare primary schools across England.
             </p>
           </div>
 
@@ -24,14 +23,6 @@ export function Footer() {
             <h4 className={styles.sectionTitle}>About</h4>
             <ul className={styles.links}>
               <li>
-                <a
-                  href="https://www.compare-school-performance.service.gov.uk/"
-                  target="_blank"
-                  rel="noopener noreferrer"
-                  className={styles.link}
-                >
-                  Data Source
-                </a>
               </li>
             </ul>
           </div>

nextjs-app/components/SchoolDetailView.module.css

@@ -475,6 +475,44 @@
 .ofstedGrade3 { background: rgba(201, 162, 39, 0.15); color: #b8920e; }
 .ofstedGrade4 { background: rgba(224, 114, 86, 0.15); color: var(--accent-coral, #e07256); }
 
+/* Report Card grade colours (5-level scale, lower = better) */
+.rcGrade1 { background: rgba(45, 125, 125, 0.12); color: var(--accent-teal, #2d7d7d); }   /* Exceptional */
+.rcGrade2 { background: rgba(60, 140, 60, 0.12);  color: #3c8c3c; }                        /* Strong */
+.rcGrade3 { background: rgba(201, 162, 39, 0.15); color: #b8920e; }                        /* Expected standard */
+.rcGrade4 { background: rgba(249, 115, 22, 0.12); color: #c2410c; }                        /* Needs attention */
+.rcGrade5 { background: rgba(224, 114, 86, 0.15); color: var(--accent-coral, #e07256); }   /* Urgent improvement */
+
+/* Safeguarding badge */
+.safeguardingRow {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 1rem;
+}
+.safeguardingLabel {
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--text-primary, #1a1612);
+}
+.safeguardingMet {
+  display: inline-block;
+  padding: 0.2rem 0.6rem;
+  border-radius: 4px;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  background: rgba(45, 125, 125, 0.12);
+  color: var(--accent-teal, #2d7d7d);
+}
+.safeguardingNotMet {
+  display: inline-block;
+  padding: 0.2rem 0.6rem;
+  border-radius: 4px;
+  font-size: 0.8125rem;
+  font-weight: 700;
+  background: rgba(224, 114, 86, 0.15);
+  color: var(--accent-coral, #e07256);
+}
+
 .ofstedDisclaimer {
   font-size: 0.8rem;
   color: var(--text-muted, #8a847a);

nextjs-app/components/SchoolDetailView.tsx

@@ -22,6 +22,21 @@ const OFSTED_LABELS: Record<number, string> = {
   1: 'Outstanding', 2: 'Good', 3: 'Requires Improvement', 4: 'Inadequate',
 };
 
+const RC_LABELS: Record<number, string> = {
+  1: 'Exceptional', 2: 'Strong', 3: 'Expected standard', 4: 'Needs attention', 5: 'Urgent improvement',
+};
+
+const RC_CATEGORIES = [
+  { key: 'rc_inclusion' as const,             label: 'Inclusion' },
+  { key: 'rc_curriculum_teaching' as const,   label: 'Curriculum & Teaching' },
+  { key: 'rc_achievement' as const,           label: 'Achievement' },
+  { key: 'rc_attendance_behaviour' as const,  label: 'Attendance & Behaviour' },
+  { key: 'rc_personal_development' as const,  label: 'Personal Development' },
+  { key: 'rc_leadership_governance' as const, label: 'Leadership & Governance' },
+  { key: 'rc_early_years' as const,           label: 'Early Years' },
+  { key: 'rc_sixth_form' as const,            label: 'Sixth Form' },
+];
+
 // 2023 national averages for context
 const NATIONAL_AVG = {
   rwm_expected: 60,
@@ -179,11 +194,11 @@ export function SchoolDetailView({
         </div>
       </nav>
 
-      {/* Ofsted Rating */}
+      {/* Ofsted Rating / Report Card */}
       {ofsted && (
         <section id="ofsted" className={styles.card}>
           <h2 className={styles.sectionTitle}>
-            Ofsted Rating
+            {ofsted.framework === 'ReportCard' ? 'Ofsted Report Card' : 'Ofsted Rating'}
             {ofsted.inspection_date && (
               <span className={styles.ofstedDate}>
                 Inspected {new Date(ofsted.inspection_date).toLocaleDateString('en-GB', { day: 'numeric', month: 'long', year: 'numeric' })}
@@ -198,43 +213,82 @@ export function SchoolDetailView({
               Full report ↗
             </a>
           </h2>
-          <div className={styles.ofstedHeader}>
-            <span className={`${styles.ofstedGrade} ${styles[`ofstedGrade${ofsted.overall_effectiveness}`]}`}>
-              {ofsted.overall_effectiveness ? OFSTED_LABELS[ofsted.overall_effectiveness] : 'Not rated'}
-            </span>
-            {ofsted.previous_overall != null &&
-              ofsted.previous_overall !== ofsted.overall_effectiveness && (
-              <span className={styles.ofstedPrevious}>
-                Previously: {OFSTED_LABELS[ofsted.previous_overall]}
-              </span>
-            )}
-          </div>
-          <p className={styles.ofstedDisclaimer}>
-            From September 2024, Ofsted no longer makes an overall effectiveness judgement in inspections of state-funded schools.
-          </p>
-          {parentView?.q_recommend_pct != null && parentView.total_responses != null && parentView.total_responses > 0 && (
-            <p className={styles.parentRecommendLine}>
-              <strong>{Math.round(parentView.q_recommend_pct)}%</strong> of parents would recommend this school ({parentView.total_responses.toLocaleString()} responses)
-            </p>
-          )}
-          <div className={styles.metricsGrid}>
-            {[
-              { label: 'Quality of Teaching', value: ofsted.quality_of_education },
-              { label: 'Behaviour in School', value: ofsted.behaviour_attitudes },
-              { label: 'Pupils\' Wider Development', value: ofsted.personal_development },
-              { label: 'School Leadership', value: ofsted.leadership_management },
-              ...(ofsted.early_years_provision != null
-                ? [{ label: 'Early Years (Reception)', value: ofsted.early_years_provision }]
-                : []),
-            ].map(({ label, value }) => value != null && (
-              <div key={label} className={styles.metricCard}>
-                <div className={styles.metricLabel}>{label}</div>
-                <div className={`${styles.metricValue} ${styles[`ofstedGrade${value}`]}`}>
-                  {OFSTED_LABELS[value]}
+
+          {ofsted.framework === 'ReportCard' ? (
+            /* ── New Report Card layout ── */
+            <>
+              <p className={styles.ofstedDisclaimer}>
+                From November 2025, Ofsted replaced single overall grades with Report Cards rating schools across several areas.
+              </p>
+              {ofsted.rc_safeguarding_met != null && (
+                <div className={styles.safeguardingRow}>
+                  <span className={styles.safeguardingLabel}>Safeguarding</span>
+                  <span className={ofsted.rc_safeguarding_met ? styles.safeguardingMet : styles.safeguardingNotMet}>
+                    {ofsted.rc_safeguarding_met ? 'Met' : 'Not met'}
+                  </span>
                 </div>
+              )}
+              <div className={styles.metricsGrid}>
+                {RC_CATEGORIES.map(({ key, label }) => {
+                  const value = ofsted[key] as number | null;
+                  return value != null ? (
+                    <div key={key} className={styles.metricCard}>
+                      <div className={styles.metricLabel}>{label}</div>
+                      <div className={`${styles.metricValue} ${styles[`rcGrade${value}`]}`}>
+                        {RC_LABELS[value]}
+                      </div>
+                    </div>
+                  ) : null;
+                })}
               </div>
-            ))}
-          </div>
+              {parentView?.q_recommend_pct != null && parentView.total_responses != null && parentView.total_responses > 0 && (
+                <p className={styles.parentRecommendLine}>
+                  <strong>{Math.round(parentView.q_recommend_pct)}%</strong> of parents would recommend this school ({parentView.total_responses.toLocaleString()} responses)
+                </p>
+              )}
+            </>
+          ) : (
+            /* ── Old OEIF layout ── */
+            <>
+              <div className={styles.ofstedHeader}>
+                <span className={`${styles.ofstedGrade} ${styles[`ofstedGrade${ofsted.overall_effectiveness}`]}`}>
+                  {ofsted.overall_effectiveness ? OFSTED_LABELS[ofsted.overall_effectiveness] : 'Not rated'}
+                </span>
+                {ofsted.previous_overall != null &&
+                  ofsted.previous_overall !== ofsted.overall_effectiveness && (
+                  <span className={styles.ofstedPrevious}>
+                    Previously: {OFSTED_LABELS[ofsted.previous_overall]}
+                  </span>
+                )}
+              </div>
+              <p className={styles.ofstedDisclaimer}>
+                From September 2024, Ofsted no longer makes an overall effectiveness judgement in inspections of state-funded schools.
+              </p>
+              {parentView?.q_recommend_pct != null && parentView.total_responses != null && parentView.total_responses > 0 && (
+                <p className={styles.parentRecommendLine}>
+                  <strong>{Math.round(parentView.q_recommend_pct)}%</strong> of parents would recommend this school ({parentView.total_responses.toLocaleString()} responses)
+                </p>
+              )}
+              <div className={styles.metricsGrid}>
+                {[
+                  { label: 'Quality of Teaching', value: ofsted.quality_of_education },
+                  { label: 'Behaviour in School', value: ofsted.behaviour_attitudes },
+                  { label: 'Pupils\' Wider Development', value: ofsted.personal_development },
+                  { label: 'School Leadership', value: ofsted.leadership_management },
+                  ...(ofsted.early_years_provision != null
+                    ? [{ label: 'Early Years (Reception)', value: ofsted.early_years_provision }]
+                    : []),
+                ].map(({ label, value }) => value != null && (
+                  <div key={label} className={styles.metricCard}>
+                    <div className={styles.metricLabel}>{label}</div>
+                    <div className={`${styles.metricValue} ${styles[`ofstedGrade${value}`]}`}>
+                      {OFSTED_LABELS[value]}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            </>
+          )}
         </section>
       )}
 

nextjs-app/docker-compose.yml

@@ -1,5 +1,3 @@
-version: '3.8'
-
 services:
   nextjs:
     build:

nextjs-app/lib/types.ts

@@ -65,6 +65,10 @@ export interface School {
 // ============================================================================
 
 export interface OfstedInspection {
+  framework: 'OEIF' | 'ReportCard' | null;
+  inspection_date: string | null;
+  inspection_type: string | null;
+  // OEIF fields (old framework, pre-Nov 2025)
   overall_effectiveness: 1 | 2 | 3 | 4 | null;
   quality_of_education: number | null;
   behaviour_attitudes: number | null;
@@ -72,8 +76,17 @@ export interface OfstedInspection {
   leadership_management: number | null;
   early_years_provision: number | null;
   previous_overall: number | null;
-  inspection_date: string | null;
-  inspection_type: string | null;
+  // Report Card fields (new framework, from Nov 2025)
+  // 1=Exceptional 2=Strong 3=Expected standard 4=Needs attention 5=Urgent improvement
+  rc_safeguarding_met: boolean | null;
+  rc_inclusion: number | null;
+  rc_curriculum_teaching: number | null;
+  rc_achievement: number | null;
+  rc_attendance_behaviour: number | null;
+  rc_personal_development: number | null;
+  rc_leadership_governance: number | null;
+  rc_early_years: number | null;
+  rc_sixth_form: number | null;
 }
 
 export interface OfstedParentView {