forked from Qortal/q-blog
greenflame089
34 lines
1.0 KiB
Markdown
34 lines
1.0 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|
|
```
|