chore(devex): Makefile with a uniform 'make check' (backend#1606)

[LukasWodka]

Summary

Today every repo in the org has a different incantation for "run your
tests": python manage.py test here, yarn test:coverage there,
make ci in cli, pytest tests/ -m "not slow" somewhere else. That
makes "run your tests before you push" a rule you can only obey if you
already know the repo — which means it is not really a rule, it is
tribal knowledge with a rule's wording. The people most likely to break
it are exactly the people least likely to know the incantation.

backend#1606 fixes that by giving every active repo the same three
targets:

make check lint + fast tests. Budget: UNDER 60 SECONDS.
make check-all everything CI runs, minus the CI-only heavy suites.
make setup install what those targets need.

The 60-second budget is not decoration. It is the property that decides
whether anyone runs the thing: a make check that takes ten minutes is
a rule people learn to skip, and skipping one rule teaches skipping
others. So the split between check and check-all is drawn on
measured wall-clock time, not on taste.

The Makefile is a THIN WRAPPER. Every command in it was lifted from the
workflow that already runs it. It adds no tool, no config, and no rule,
and it changes no CI workflow — making CI call make check is a
separate, later wave (decision 2 on backend#1606), deliberately kept out
of this PR so that a Makefile bug cannot redden the pipeline. No
pre-commit or pre-push hook is installed here either; that is step 4.

In this repo

make check — MEASURED 19 s warm (44 s on the very first cold run,
which is filesystem cache, not work): ruff over the tree using this
repo's own ruff.toml, then the 1918-test unit suite. The suite mocks
both the database and the API, so it needs nothing running.

make check-all swaps the plain pytest run for tests.yml's exact
command, 95% coverage floor included.

make e2e exists but is in neither target: e2e.yml drives real
ingestion against a real MySQL, which CI provides as a service container
and a laptop does not.

NOT in check: black. The code-quality caller does set format: true,
but the shared gate scans the PR DIFF, and the tree as a whole is not
black-clean — 72 files would be reformatted at the time of writing. A
whole-tree black --check in check would be red on a clean checkout,
which is worse than not running it. ruff, measured the same way, IS
clean tree-wide, so it is in.

Related

Step 1 of tracebloc/backend#1606 — a Makefile with a uniform check target in every active repo. One PR per repo; this is this repo's.

Type of change

• Tech-debt / refactor (developer experience)

Test plan

make check run for real in a fresh venv: green in 19 s warm (1918 passed,
1 xfailed). The very first cold run was 44 s — filesystem cache, not work.

ruff check . clean tree-wide; black --check . NOT clean (72 files would be
reformatted), hence excluded.

make help and the dry runs of every target parse clean.

No CI workflow is touched in this PR. CI parity — making the workflows call make check — is decision 2 on backend#1606 and lands as its own wave, deliberately after the Makefiles exist and are proven locally. No pre-commit or pre-push hook is installed here either; that is step 4.

Checklist

• Works from a clean checkout — .PHONY on every target, help is the default goal
• No CI workflow modified
• No pre-commit / pre-push hook installed
• No secrets / credentials in the diff
• Every command is copied from the workflow that already runs it — no new tool, no new config, no new rule
• Portable to GNU Make 3.81 (the macOS system make)

---

Note

Low Risk
Developer-experience only: adds local Make targets without changing CI, application runtime, or auth/data paths.

Overview
Adds a root Makefile so local dev matches the org-wide backend#1606 contract: make setup, make check (ruff + fast unit tests), and make check-all (ruff + pytest with the 95% coverage gate). Commands are documented as thin mirrors of existing tests.yml, e2e.yml, and the shared ruff code-quality workflow—no CI workflow edits in this PR.

make test deliberately runs pytest tests/ only (not a bare pytest), so a machine with MySQL/env vars does not accidentally collect e2e/ during pre-push checks; make e2e remains the explicit path for real MySQL ingestion. Ruff is invoked via $(PYTHON) -m ruff with a pinned RUFF_VERSION aligned to CI; black is intentionally omitted from check because a whole-tree format check would fail on a clean checkout.

^{Reviewed by Cursor Bugbot for commit e0b75a4. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 5f6c654. Configure here.}