Skip to content

v1.5.11 — Lighthouse re-audit (100 / 100 / 100 on three categories) + 100 % code documentation

Choose a tag to compare

@Batuhan4 Batuhan4 released this 20 Apr 22:04
· 7 commits to main since this release

Highlights

  • Lighthouse re-audit sweep — re-ran the production preview build after adding robots.txt, swapping the eager recharts preload for per-route lazy chunks, enabling sourcemaps, and preview-proxying /api. Scores moved from the Sprint 5 baseline of 93 / 100 / 96 / 91 (Perf / A11y / BP / SEO) to 91 / 100 / 100 / 100 — +4 Best Practices, +9 SEO, kept Accessibility at 100.
  • JSDoc + docstring coverage is now 100 % on both sides. Frontend JSDoc went from ~64 % to 38 / 38 = 100 %; backend interrogate went from 23.9 % to 188 / 188 = 100 %. Tests stayed green (191 / 191).
  • Week 11 jury showcase placeholder — new wiki page with the required-deliverables checklist, live surfaces, 10-min deck outline, FE prep checklist, and risk register.

Notable code changes

  • frontend/public/robots.txt added (was missing — SEO 91 → 100).
  • frontend/vite.config.ts: build.sourcemap: true; modulePreload.resolveDependencies drops vendor-charts from the HTML preload list; new preview.proxy so Lighthouse audits against pnpm preview can reach /api/*.
  • frontend/src/App.tsx: Step 2/3/4/7 all lazy (recharts no longer eagerly loaded on Step 1 landing — ≈70 KiB less initial JS); loading skeleton gets min-height: 60vh.
  • frontend/src/components/NavBar.tsx: navbar uses /logo-192.png with fetchPriority="high" + decoding="async" (~35 KiB less).
  • frontend/src/styles/globals.css: nav-dropdown trigger uses black-alpha background so the white label clears 4.5 : 1 WCAG AA on the green nav.
  • frontend/src/pages/Step1ClinicalContext.tsx: drops opacity: 0.85 on the active-step description (was blending to 4.34 : 1).
  • +143 backend docstrings across app/** (package modules, Pydantic schemas, routers, services, specialty registry). +10 frontend JSDoc blocks across the App shell, components, Step 4, glossary, and the legend colour map.

Evidence artifacts

  • docs/reports/Sprint5_Lighthouse.report.html / .json — re-audit (21 Apr).
  • docs/reports/Sprint5_Lighthouse.report.baseline.html / .json — baseline snapshot (20 Apr, pre-re-audit).
  • docs/reports/Sprint5_Lighthouse_Report.png — re-audit screenshot.
  • docs/reports/Sprint5_Lighthouse_Report.baseline.png — baseline screenshot (for before/after).
  • docs/reports/coverage/backend-docstring-coverage.txt + backend-docstring-badge.svg — interrogate output.
  • docs/reports/coverage/frontend-jsdoc-coverage.txt — per-directory JSDoc scan.

Wiki: Sprint-5 page now shows both Lighthouse screenshots side by side, the Reports table carries the coverage + re-audit artifacts, the Releases table lists v1.5.11, and the new [[Final Submission]] page collects the Week 11 jury deliverables.

Not user-facing

  • 191 / 191 pytest passed after the docstring sweep. No runtime code changed — only new docstrings / JSDoc blocks, frontend lazy-load plumbing, and the Vite/CSS tweaks called out above.