Cal Corum 88a5207c2c CLAUDE: Refactor backend CLAUDE.md files for conciseness

Major reduction in CLAUDE.md file sizes to follow concise documentation standard:

| File | Before | After | Reduction |
|------|--------|-------|-----------|
| backend/CLAUDE.md | 2,467 | 123 | 95% |
| models/CLAUDE.md | 1,586 | 102 | 94% |
| websocket/CLAUDE.md | 2,094 | 119 | 94% |
| config/CLAUDE.md | 1,017 | 126 | 88% |
| database/CLAUDE.md | 946 | 130 | 86% |
| api/CLAUDE.md | 906 | 140 | 85% |

Total: 9,016 -> 740 lines (92% reduction)

All files now under 150 lines with:
- Essential patterns and usage
- Cross-references to related docs
- Quick-start examples
- Updated timestamps

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-19 16:10:08 -06:00

3.0 KiB

Raw Permalink Blame History

Config Module - League Configuration & Play Outcomes

Purpose

League-specific configuration system and play outcome definitions. Provides immutable config objects for game rules, API endpoints, and result chart behaviors.

Structure

app/config/
├── __init__.py              # Public exports
├── base_config.py           # Abstract BaseConfig
├── league_configs.py        # SbaConfig, PdConfig implementations
├── result_charts.py         # PlayOutcome enum
└── common_x_check_tables.py # X-Check defense/error tables

League Configuration

Usage

from app.config import get_league_config

config = get_league_config("sba")  # or "pd"
api_url = config.get_api_base_url()
supports_ratings = config.supports_position_ratings()

BaseConfig (Abstract)

Common interface for league configs:

league_id, innings, dh_rule, mercy_rule
get_api_base_url(), get_result_chart_name()
supports_position_ratings(), supports_auto_mode()

SbaConfig

Manual outcome selection only
No position ratings support
Simple player data

PdConfig

Manual or auto resolution
Position ratings from API
Cardset validation
Detailed scouting data

Immutability

Configs use Pydantic frozen=True:

config.innings = 7  # Raises ValidationError

PlayOutcome Enum

Universal enum for all play outcomes (both leagues).

Helper Methods

outcome.is_hit()           # True for hits
outcome.is_out()           # True for outs
outcome.is_uncapped()      # Requires decision tree
outcome.get_bases_advanced()  # Base advancement

X-Check Tables

Defense range tables and error charts for defensive play resolution.

Defense Tables

INFIELD_DEFENSE_TABLE - 20×5 (d20 × range)
OUTFIELD_DEFENSE_TABLE - 20×5
CATCHER_DEFENSE_TABLE - 20×5

Error Charts

3d6 (3-18) by error rating (0-25)
Results: RP (rare play), E1-E3, NO

Helpers

from app.config import get_fielders_holding_runners, get_error_chart_for_position

holders = get_fielders_holding_runners([1, 2], 'R')  # Runners on 1st & 2nd, RHB
chart = get_error_chart_for_position('SS')

Common Tasks

Get League-Specific Behavior

config = get_league_config(state.league_id)
if config.supports_position_ratings():
    ratings = await fetch_ratings(player_id)

Validate Outcome

outcome = PlayOutcome.GROUNDBALL_C
if outcome.requires_location():
    assert hit_location is not None

References

League Differences: See root CLAUDE.md
Play Resolution: See ../core/play_resolver.py

Tests: tests/unit/config/ | Updated: 2025-01-19

3.0 KiB Raw Permalink Blame History Unescape Escape