OPEN for developers¶
OPEN, the Open Pickleball Evaluation Network, is a free, open-source, community-governed pickleball rating network. This site explains how it works for developers, researchers, and anyone who wants to contribute: how the pieces fit together, what they are built with, and how a match becomes a rating.
Current status¶
No OPEN rating is live
OPEN publishes no ratings yet. The reference engine is a demonstration: its methods have not been validated on real match data, and its output is labeled as demonstration ratings, not OPEN ratings. No official version of the rating spec exists yet.
What exists today:
- The backend stores accounts, players, clubs, organizers, events, and matches. It validates match submissions, detects duplicates, and runs the confirmation and dispute workflow. It does not call the engine yet, and it serves no ratings.
- The engine computes and replays ratings as a Python package, with a dev release on TestPyPI only.
- The frontend serves a static teaser at openpb.org. The full web app is in development and not deployed.
Testing the engine on real match results in shadow mode, so that no one relies on its ratings yet, is a current priority on the roadmap. The roadmap lists what must happen before ratings go live, including a seated governing board and published validation results.
Who this site is for¶
- Developers who want to contribute to the backend, engine, or frontend.
- Partners (apps, league platforms, clubs, and tournaments) who want to know how OPEN will take results and serve ratings. Integration docs for partners are planned separately.
- Researchers and rating enthusiasts who want to review the methods.
Pages¶
- Architecture: the repositories and services, and how they fit together.
- Tech stack: what each repository is built with, and why.
- How a match becomes a rating: each step from submission to rating, marked as implemented or planned.
- Contributing: how to contribute to each repository.
- Glossary: the domain terms, one line each.
This site links to each repository's decisions instead of copying them. Where this site and a repository disagree, the repository is right. Please open an issue so we can fix the site.