q-blog/docs/PHASE1_PLAN.md

Phase 1 — Baseline Scan & Planning

Goal: capture a ground-truth snapshot of technical debt (imports, ts-nochecks, any-usage, a11y hotspots) without changing app code.

Deliverables

• reports/phase1-*/ folder with raw findings and a concise summary.md.
• Package scripts: scan:phase1, report:phase1.

What we scan

• MUI v4 imports (@material-ui/*) — should move to @mui/material & friends.
• TS suppression (@ts-nocheck, @ts-ignore) — create removal plan.
• any usage — count & top files.
• A11y (img alt) — naive grep for <img without alt=.
• Hooks misuse — list all useDispatch|useSelector occurrences for manual triage.
• WebWorkers globals — self, XMLHttpRequest, fetch in src/webworkers/*.

How to run

# 1) patch scripts into package.json
scripts/dev/patch-phase1-scripts.sh

# 2) run scan
npm run scan:phase1

# 3) generate summary
npm run report:phase1

# 4) open the report
sed -n '1,200p' reports/phase1-*/summary.md