# IRDB — IP Reputation Database

A self-hosted IP reputation service that ingests abuse reports and distributes
tailored block lists, shipped as a Docker Compose stack (`api` + `ui` +
optional `mysql` / `scheduler`).

See [`SPEC.md`](./SPEC.md) for the full build specification and
[`files/`](./files/) for the milestone-by-milestone implementation prompts.
Per-milestone progress is tracked in [`PROGRESS.md`](./PROGRESS.md).

## Local CI

```bash
./scripts/ci.sh
```

Runs lint/static-analysis/tests for both subprojects and verifies docker
compose builds. Requires Docker; no PHP/Node toolchain needed on the host.