paper-dynasty-card-creation/fix_player_names.py
Cal Corum cc5f93eb66 Fix critical asterisk regression in player names
CRITICAL BUG FIX: Removed code that was appending asterisks to left-handed
players' names and hash symbols to switch hitters' names in production.

## Changes

### Core Fix (retrosheet_data.py)
- Removed name_suffix code from new_player_payload() (lines 1103-1108)
- Players names now stored cleanly without visual indicators
- Affected 20 left-handed batters in 2005 Live cardset

### New Utility Scripts
- fix_player_names.py: PATCH player names to remove symbols (uses 'name' param)
- check_player_names.py: Verify all players for asterisks/hashes
- regenerate_lefty_cards.py: Update image URLs with cache-busting dates
- upload_lefty_cards_to_s3.py: Fetch fresh cards and upload to S3

### Documentation (CRITICAL - READ BEFORE WORKING WITH CARDS)
- docs/LESSONS_LEARNED_ASTERISK_REGRESSION.md: Comprehensive guide
  * API parameter is 'name' NOT 'p_name'
  * Card generation caching requires timestamp cache-busting
  * S3 keys must not include query parameters
  * Player names only in 'players' table
  * Never append visual indicators to stored data

- CLAUDE.md: Added critical warnings section at top

## Key Learnings
1. API param for player name is 'name', not 'p_name'
2. Cards are cached - use timestamp in ?d= parameter
3. S3 keys != S3 URLs (no query params in keys)
4. Fix data BEFORE generating/uploading cards
5. Visual indicators belong in UI, not database

## Impact
- Fixed 20 player records in production
- Regenerated and uploaded 20 clean cards to S3
- Documented to prevent future regressions

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 14:38:04 -06:00

60 lines
1.9 KiB
Python

"""
Fix player names by removing asterisks (*) and hash symbols (#) from cardset 27
"""
import asyncio
import aiohttp
from db_calls import db_get, db_patch, DB_URL, AUTH_TOKEN
CARDSET_ID = 27
async def fix_player_names():
print(f"Fetching all players from cardset {CARDSET_ID}...")
# Get all players from cardset
response = await db_get('players', params=[('cardset_id', CARDSET_ID), ('page_size', 500)])
# Handle different response structures
if 'players' in response:
all_players = response['players']
elif 'results' in response:
all_players = response['results']
else:
print(f"Error: Unexpected response structure. Response keys: {response.keys()}")
return
print(f"Found {len(all_players)} players")
# Track what we're fixing
fixed_count = 0
skipped_count = 0
for player in all_players:
player_id = player['player_id']
original_name = player['p_name']
# Check if name has asterisk or hash
if '*' in original_name or '#' in original_name:
# Remove the symbols
clean_name = original_name.replace('*', '').replace('#', '').strip()
print(f"Fixing player {player_id}: '{original_name}' -> '{clean_name}'")
# PATCH the player (API expects 'name' parameter, not 'p_name')
result = await db_patch('players', object_id=player_id, params=[('name', clean_name)])
if 'player_id' in result or 'id' in result:
fixed_count += 1
else:
print(f" ERROR patching player {player_id}: {result}")
else:
skipped_count += 1
print(f"\n{'='*60}")
print(f"SUMMARY")
print(f"{'='*60}")
print(f"Fixed: {fixed_count} players")
print(f"Skipped (no symbols): {skipped_count} players")
print(f"Total: {len(all_players)} players")
if __name__ == '__main__':
asyncio.run(fix_player_names())