RC Soar Score
RC Soar Score is an RC (radio-controlled) sailplane soaring contest scoring and management suite. It provides a comprehensive solution for contest directors, pilots, helpers, and soaring enthusiasts to organize, fly, score, and follow soaring competitions across multiple disciplines.
The system is designed for both connected and disconnected field operations, allowing contest directors to run events completely offline when remote flying fields have no internet connectivity, while offering seamless cloud synchronization and public result publishing when a connection is available.
Table of Contents
Overview & Key Features
- Offline-First & Cloud-Synced: Full offline capability for contest directors at remote fields with SQLite persistence, paired with cloud synchronization to PostgreSQL when connectivity is established.
- Flight Matrix Generator: Automated round-and-group draw generator featuring simulated annealing optimization, team protection (preventing teammates from flying in the same group), and fairness distribution metrics.
- Multiple Scoring Modes:
- Official Scoring: Fast, keyboard-friendly administrative entry and review by the contest director or local officials.
- Self-Scoring: Mobile-first score entry portal for pilots and team helpers on their smartphones.
- Public Results & Live Projections: Dedicated public site for real-time leaderboards, round-by-round breakdown, landing stats, and contest archives.
- Score Review & Dispute Workflow: Structured audit trail for contested scores, reflights, penalties, and director score overrides.
Supported Soaring Disciplines
RC Soar Score includes a domain scoring engine capable of handling standard soaring disciplines with their unique landing tapes, target windows, flight time truncation/rounding, penalties, and flight normalization:
For discipline-wide scoring conventions, consult the Discipline Scoring Architecture Guide.
Repository Architecture
RC Soar Score is structured as a Dart/Flutter monorepo managed with Melos.
soar-score/
├── apps/ # End-user applications and backend service
│ ├── soar_score_contest/ # Contest director management app (Flutter Web / Desktop)
│ ├── soar_score_web/ # Public site, docs & results portal (Next.js)
│ ├── soar_score_self_score/ # Mobile self-scoring app for pilots (Flutter Web/Mobile)
│ └── soar_score_server/ # Shelf-based backend REST API service (Dart)
├── packages/ # Shared Dart & Flutter packages
│ ├── soar_score_core/ # Pure Dart domain models & scoring engine
│ ├── soar_score_data/ # Data persistence layer & repository implementations
│ ├── soar_score_api/ # Shared HTTP client, DTOs, and typed API errors
│ ├── soar_score_api_handlers/ # Shared shelf route handlers
│ └── soar_score_ui/ # Shared Flutter design tokens and UI components
├── plan/ # System specifications, architecture, and requirements
└── AGENTS.md # Coding standards and AI agent guidelines
This is the beginning of the README. Read the rest at the original. Read the full README ↗
