Data journalism on 18 U.S.C. § 1960 / DOJ press releases (Operation Chokepoint 2.0 / crypto-adjacent money-transmission cases).
Live site: https://project1960.rizzn.net
Board: DSC Tasks #65 · Phase 1–2 Doc #1308 · Phase 3 Doc #1315 · ops Doc #1307
| Path | Role |
|---|---|
public/ |
Multihost PHP docroot (index.php, includes/, assets/, directory entrypoints) |
bin/ |
CLI: scrape/match/ingest/download/ocr/extract/recap/patterns + bootstrap-admin.php |
legacy/ |
Previous Python Flask app + Venice enrich/verify (kept until soak) |
docs/ |
courtlistener.md, ocr.md, scraper.md |
env.example |
Venice, DB path, CourtListener token hints |
composer install
# sibling checkout: ../courtlistener-sdk (path repo in composer.json)
cp env.example .env # set DATABASE_PATH / COURTLISTENER_API_TOKEN / VENICE_API_KEY as needed
./vendor/bin/phpunit
php -S 127.0.0.1:8080 -t public # local only; prod is multihost
# Slow-drip CL pipeline (prefer --limit / --wait — do not burn the API)
php bin/match.php --limit=5 --wait=10
php bin/ingest-docs.php --limit=5 --wait=5
php bin/download-docs.php --limit=5 --wait=2
php bin/ocr-docs.php --limit=5 --metrics # needs tesseract+poppler (see docs/ocr.md)
php bin/extract-people.php --limit=3 --wait=2
# First /admin operator (secrets out-of-band — never commit)
# Pass file shape: ~/.ssh/project1960-admin.pass
# P1960_ADMIN_USERNAME=…
# P1960_ADMIN_EMAIL=…
# P1960_ADMIN_PASSWORD=…
php bin/bootstrap-admin.php --dry-run --pass-file=~/.ssh/project1960-admin.pass
php bin/bootstrap-admin.php --pass-file=~/.ssh/project1960-admin.passDesign smoke (Playwright, ephemeral php -S):
python3 tools/design-smoke/verify.pyLive admin smoke (AD-U1):
BASE_URL=https://project1960.rizzn.net python3 tools/design-smoke/verify_admin.pySession operator console on the live host: https://project1960.rizzn.net/admin/
| Area | Path | Notes |
|---|---|---|
| Login / logout | /admin/login/, /admin/logout/ |
CSRF + p1960_admin session cookie |
| Home | /admin/ |
Stats + enrichment cohort table + shortcuts |
| Users | /admin/users/ |
Create / disable / reset password |
| API keys | /admin/api-keys/ |
Mint once (plaintext shown once), revoke |
| Pipeline | /admin/pipeline/ |
Status + dry-run / enqueue_dry only (no UI burn) |
| Appearance | /admin/appearance/ |
Skin Lab + site name |
| Help | /admin/help/ |
Topics: bootstrap, api-scopes, enrichment-math, pipeline-cli |
Bootstrap first operator (multihost, secrets out-of-band — never commit):
php bin/bootstrap-admin.php --dry-run --pass-file=~/.ssh/project1960-admin.pass
php bin/bootstrap-admin.php --pass-file=~/.ssh/project1960-admin.passPass file vars: P1960_ADMIN_USERNAME, P1960_ADMIN_EMAIL, P1960_ADMIN_PASSWORD, optional P1960_ADMIN_ROLE.
API key scopes (lean pack): stats:read, cases:read, enrichment:read, patterns:read, admin:read, admin:users, admin:keys, admin:settings, pipeline:status, pipeline:enqueue.
Public JSON (/api/stats, /api/cases, /api/enrichment, …) requires a key with the matching read scope (Mark lock #3578). Send X-API-Key or Authorization: Bearer. HTML pages stay public; /health stays open. Mint keys under /admin/api-keys. Local emergency opt-out only: P1960_API_REQUIRE_KEY=0.
Live burn: not wired from admin UI. Requires P1960_PIPELINE_ALLOW_BURN=1 and Mark go, then host CLIs.
Slice map: Doc #1315.
Uses existing SDK: actuallyrizzn/courtlistener-sdk (PHP path dependency). Do not reinvent the HTTP client. Matcher + ingest + OCR + Venice people extract + patterns UI ship in this repo.
Venice verify/enrich for press-release tables can still run from legacy/ on NewDev writing the same SQLite. See legacy/README.md.
Creative Commons Attribution-ShareAlike 4.0 International — see LICENSE.