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
• Supported Soaring Disciplines
• Repository Architecture
  • Applications (apps/)
  • Shared Packages (packages/)
  • Layer Diagram
• Documentation & Planning
• Prerequisites & Toolchain
• Getting Started
  • Repository Setup
  • Running the Applications
  • Building
  • Running Tests & Linting
  • End-to-End Tests (Contest App)
  • Testing Against PostgreSQL
• Conventions & Architecture Rules
• License

---

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:

Discipline	Description	Rules & Specification
ALES	Altitude Limited Electric Soaring	plan/business-requirements/disciplines/ales.md
F5J	Electric Motor Gliders with Altimeter Recording	plan/business-requirements/disciplines/f5j.md
F3J	Thermal Duration Gliders (Towline launch)	plan/business-requirements/disciplines/f3j.md
Thermal	Traditional Thermal Duration	plan/business-requirements/disciplines/thermal.md
F3K	Hand-Launch Gliders (multi-task discipline)	plan/business-requirements/disciplines/f3k.md
F3L	RES (Rudder, Elevator, Spoiler) 2m Gliders	plan/business-requirements/disciplines/f3l.md

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

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗