Agents work on this repository in the agent-envs sandbox: a container
whose only way out is an egress proxy with an allowlist, which also adds
the Gitea bot token. docs/contributing/agents.md covers setting it up
for Politrack (1Password item, .env, commit identity), what it can reach
and its limits; AGENTS.md tells agents how to recognise the sandbox and
behave in it.
backend/tests/Dockerfile.debian gains a `sandbox` target: the agent-envs
agent image plus the backend's dependencies from Debian packages, the
same list as the PyPI-free test image (still the default target). The
sandbox runs `pytest` without PyPI, which the owner's PC can't reach. A
new invariant in AGENTS.md keeps that list in step with pyproject.toml.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- AGENTS.md: ground rules (legal access, evidence, fairness), invariants
that are easy to break, commands, and notes on the owner's dev machine;
CLAUDE.md imports it
- backend/tests/Dockerfile.debian: test image from Debian packages for
networks where PyPI is unreachable, documented in testing.md
- roadmap: list what v2 has not been verified against yet
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Initial import of Politrack, a self-hosted service that tracks Austrian
politicians from federal to municipal level - roles, votes, money flows,
statements, meetings, social media and legal proceedings - with every claim
linked to its sources.
- backend: FastAPI + Postgres/pgvector; adapter framework (fetch -> parse ->
load -> enrich) with robots.txt/TDM-aware fetching, a raw-response archive
for reparsing, and a claim/evidence model with corroboration
- sources: Parliament, Wikidata, EU Parliament/Commission, Council of
Ministers, Rechnungshof party reports and donations, procurement, RTR media
transparency, political ad libraries, WKStA, news feeds, Wikipedia edits,
Bluesky, Mastodon, public Telegram channels, YouTube and X (official API)
- web: Next.js frontend in German and English with typed API client
- mcp: MCP server for AI agents and RAG
- docs: architecture, data model, sources, legal notes, Unraid deployment and
contributor guides; Docker Compose setup for Unraid
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
simonandClaude Opus 5.5