OpenFanta
OpenFanta is an open fantacalcio data framework. It ingests raw football data from a
third-party provider, computes voti and fantavoti from league settings defined as data, and
serves them over a read-only HTTP API that any client can consume.
This first version covers the Fantavoti engine with Classic rules, one provider
(Sportmonks), Postgres storage with auditable recomputation, and a REST API.
Architecture and decisions: docs/design.md.
provider (HTTP, cache, rate limit) → raw_payloads → parser → MatchFacts
→ timeline → engine (+ settings, + voti) → versioned runs → REST API
Documentation: https://cortomuso.github.io/openfanta/ (sources in docs/, built from website/).
Quick start
Requirements: Nix with flakes enabled. Docker is optional.
nix develop # or: direnv allow. Pins Go, Postgres, sqlc, oapi-codegen, golangci-lint
make test # unit tests; database tests are skipped
make test-all # every test, against a throwaway local Postgres in .pgdata/
make lint
make test-all starts Postgres from the devshell on port 5433 (make pg-stop stops it).
Running the server, configuration and the CLI are covered in Getting started.
Documentation
Preview the site locally with make docs-dev (needs Node, provided by nix develop).
Roadmap: leagues
The server will host leagues and compute every league's fantavoti from its own settings, so all
members get identical results whatever client they use. The design (settings format, audit log,
matchday lifecycle, auth) is in docs/design.md §8–10, backed by the research in
docs/research/league-settings/.
Status and open questions
See section 7 of docs/design.md. In short: the Sportmonks test fixtures are
synthetic (see their README) until a real token is available, and voti currently come from the
provider's player rating.
License
AGPL-3.0.
