Création d'une Application d'Analyse pour le Baseball Fantastique avec Claude Code : L'Expérience d'un Étudiant en Droit

Un ancien militaire de la Marine et étudiant en droit titulaire d'un diplôme en informatique de 2017, qui n'avait pas touché au code depuis l'obtention de son diplôme, a construit une application iOS complète d'analyse de baseball fantastique appelée Ball Knower en utilisant Claude Code pour l'implémentation tout en prenant toutes les décisions concernant le produit et le domaine. L'application est disponible sur l'App Store et a été développée pendant la dernière année de droit de l'étudiant.

Ce qui a été construit

Ball Knower est une application d'analyse de baseball fantastique qui comprend :

• 1 313 profils de joueurs de la MLB avec des barres de percentiles Statcast (barres codées par couleur de Baseball Savant)
• Des choix quotidiens de lanceurs pour le streaming notés de 0 à 100
• Des classements Keep-Trade-Cut pour les ligues dynastiques avec notation ELO
• 1 241 joueurs de la MLB + 72 prospects de FanGraphs
• 87 métriques distinctes suivies par joueur

Stack technique

Frontend : SwiftUI (iOS 17+), Swift Charts, StoreKit 2

Backend : Python 3.12, FastAPI, SQLAlchemy async, PostgreSQL, Redis, APScheduler

Infrastructure : Un seul droplet DigitalOcean, Docker

Sources de données : 30 tâches planifiées qui extraient des données de l'API MLB Stats, Baseball Savant via pybaseball, le flux RSS d'ESPN, The Odds API et la météo d'Open-Meteo

Où Claude Code a excellé

• Connecté une chaîne d'injection de dépendances FastAPI à une session SQLAlchemy async et à une couche de cache Redis en quelques minutes (cela aurait pris des jours avec seulement la documentation)
• Débogué une condition de concurrence asynchrone dans le flux de validation des abonnements où le coordinateur de jetons d'actualisation et l'écouteur StoreKit 2 entraient en conflit
• Identifié le problème et écrit une correction basée sur des acteurs après avoir décrit les symptômes
• Écrit environ 70 % des lignes de code brutes

Où Claude Code a été limité

• A correctement mappé 85 % des colonnes des sources de données, mais 15 % renvoyaient nil silencieusement sans erreurs ni plantages
• A manqué des incohérences dans les noms de colonnes (par exemple, pybaseball renvoie brl_percent alors que la colonne de la base de données était barrel_pct)
• A généré avec confiance du code demandant l'autorisation App Tracking Transparency pour des publicités non personnalisées, ce qui a conduit Apple à rejeter la version
• A généré des chaînes de modificateurs SwiftUI qui se compilaient mais s'affichaient incorrectement dans des cas limites
• A utilisé des modèles d'API obsolètes sans mentionner qu'ils étaient dépréciés

Rôle du développeur

Le développeur a écrit ou corrigé les 30 % de code restants, ce qui comprenait :

• Les pondérations des algorithmes de notation
• La logique d'invalidation du cache
• Le flux d'abonnement
• Les mappages des colonnes de données
• La conformité avec l'App Store
• Les décisions spécifiques au domaine (les stades couverts n'ont pas de vent, les statistiques de l'entraînement de printemps ne devraient pas avoir le même poids, l'API de percentiles de Baseball Savant nécessite une logique de remplissage des lacunes pour les joueurs non qualifiés)

Métriques de développement

• Plus de 300 heures de développement sur un semestre
• 30 tâches cron automatisées exécutées chaque nuit à partir de 2h25 HE
• 9 sources de données externes synchronisées quotidiennement
• 2 rejets de l'App Store avant l'acceptation (étiquetage du CLUF + autorisation ATT inutile)
• Point d'équilibre : 13 abonnés à 3,99 $/mois