Cleanup code and prepare for AI usage

2026-07-27 21:24:35 +02:00
parent b0110e1bc8
commit 04dca24513
33 changed files with 579 additions and 468 deletions
@@ -0,0 +1,91 @@
+<!-- headroom:rtk-instructions -->
+# RTK (Rust Token Killer) - Token-Optimized Commands
+
+When running shell commands, **always prefix with `rtk`**. This reduces context
+usage by 60-90% with zero behavior change. If rtk has no filter for a command,
+it passes through unchanged — so it is always safe to use.
+
+## Key Commands
+```bash
+# Git (59-80% savings)
+rtk git status          rtk git diff            rtk git log
+
+# Files & Search (60-75% savings)
+rtk ls <path>           rtk read <file>         rtk grep <pattern>
+rtk find <pattern>      rtk diff <file>
+
+# Build (80-90% savings) — shows errors only
+rtk ./gradlew build     rtk ./gradlew compileJava
+
+# Test (90-99% savings) — shows failures only
+rtk ./gradlew test
+
+# Analysis (70-90% savings)
+rtk err <cmd>           rtk log <file>          rtk json <file>
+rtk summary <cmd>       rtk deps                rtk env
+
+# GitHub (26-87% savings)
+rtk gh pr view <n>      rtk gh run list         rtk gh issue list
+
+# Infrastructure (85% savings)
+rtk docker ps           rtk kubectl get         rtk docker logs <c>
+```
+
+## Rules
+- In command chains, prefix each segment: `rtk git add . && rtk git commit -m "msg"`
+- For debugging, use raw command without rtk prefix
+- `rtk proxy <cmd>` runs command without filtering but tracks usage
+<!-- /headroom:rtk-instructions -->
+
+---
+
+# TLW Database Tool — Agent Guide
+
+## Project Overview
+Java CLI tool managing the Tippliga Würzburg football prediction league. Syncs match data from API-Football, manages MySQL database (phpBB forum), pushes Google Calendar events, sends WhatsApp reminders via OpenAI-generated messages, and uploads fixtures to S3.
+
+## Build & Test
+```bash
+./gradlew build          # compile + test + jar
+./gradlew test           # run all tests
+./gradlew clean test     # clean build + test
+./gradlew jar            # build fat JAR (all deps bundled)
+./gradlew dependencies   # list dependency tree
+```
+
+## Run Modes (CLI)
+```
+-m MatchdaysUpdater        - Update delivery dates from match times
+-m MatchesCreatorFootball  - Create match schedule from API-Football
+-m MatchesUpdaterFootball  - Update match team/datetime from API-Football
+-m MatchesResultsUpdater   - Push match results to website
+-m TeamsUpdater            - Add missing teams to DB
+-m APIFootballUpdater      - Fetch fixtures/rounds from API-Football → S3
+-m MatchesListGistUpdater  - Update forum posts with fixture lists
+-m PostChecksum            - Print checksum of a config post
+-m WhatsAppNotifier        - Send WhatsApp reminders for missing bets
+```
+Required: `-s <season> -l <league> -c <configFile>`
+
+## Architecture
+```
+App.java (CLI entry)
+├── apifootball/        — API-Football HTTP client, match model, S3 caching
+├── googlecalendar/     — Google Calendar API CRUD for matchday events
+├── teamidmatcher/      — BiMap: Tippliga team ID ↔ API-Football team ID
+├── tippliga/           — Domain models & operations (match, matchday, team, league)
+├── tippligaforum/      — MySQL DB connector, phpBB forum post management
+└── whatsapp/           — OpenAI-generated reminders, WhatsApp API sender
+```
+
+## Code Conventions
+- Package: `de.jeyp91.*`
+- SQL columns referenced by ordinal position (constants like `final int SEASON = 1`)
+- Logger via SLF4J: `LoggerFactory.getLogger(Class.class)`
+- Config stored as JSON in phpBB forum posts (not local files)
+- API keys / secrets in environment variables
+
+## Testing
+- JUnit 4 + TestNG
+- Tests in `src/test/java/de/jeyp91/`
+- Run single test: `./gradlew test --tests "de.jeyp91.apifootball.APIFootballMatchTest"`