yumi-cron/README.md

57 lines
1.7 KiB
Markdown

# chatapp-cron
Standalone cron workers for chatapp activities.
Current worker:
- `week-star-job`: specified-gift weekly rank settlement, reward dispatch, and failed reward retry
- `week-star-job`: room turnover weekly reward settlement and backfill dispatch
Local run:
```bash
cd /Users/hy/Documents/hy/chatapp-cron
go mod tidy
go run ./cmd/week-star-job
```
Production deploy:
```bash
cd /Users/hy/Documents/hy/chatapp3/chatapp3-deploy
./deploy.sh -c chatapp-cron
```
Required envs:
- `CHATAPP_STORE_MYSQL_DSN`
- `CHATAPP_STORE_REDIS_ADDR`
- `CHATAPP_STORE_REDIS_PASSWORD`
- `CHATAPP_STORE_REDIS_DB`
- `CHATAPP_JAVA_OTHER_BASE_URL`
- `CHATAPP_JAVA_WALLET_BASE_URL`
- `CHATAPP_WEEK_STAR_DEFAULT_SYS_ORIGIN`
- `CHATAPP_WEEK_STAR_TIMEZONE`
- `CHATAPP_WEEK_STAR_SETTLE_INTERVAL_SECONDS`
- `CHATAPP_ROOM_TURNOVER_REWARD_DEFAULT_SYS_ORIGIN`
- `CHATAPP_ROOM_TURNOVER_REWARD_TIMEZONE`
- `CHATAPP_ROOM_TURNOVER_REWARD_SETTLE_INTERVAL_SECONDS`
- `CHATAPP_WEEK_STAR_RETRY_STREAM_KEY`
- `CHATAPP_WEEK_STAR_RETRY_CONSUMER_GROUP`
- `CHATAPP_WEEK_STAR_RETRY_CONSUMER_NAME`
- `CHATAPP_WEEK_STAR_RETRY_BATCH_SIZE`
- `CHATAPP_WEEK_STAR_RETRY_BLOCK_MILLIS`
- `CHATAPP_WEEK_STAR_RETRY_MIN_IDLE_MILLIS`
- `CHATAPP_HTTP_TIMEOUT_SECONDS`
Legacy `CRON_*` / `WEEK_STAR_*` keys are still supported as fallback, but deployment should use the `CHATAPP_*` namespace as the canonical source.
Production topology:
- worker host: Singapore `cron-sg-1`
- dependent MySQL / Redis / Java Other: Riyadh private network
- network requirement: VPCs must be connected through Tencent Cloud Connect Network before deploy
Detailed ops guide:
- `/Users/hy/Documents/hy/chatapp3/chatapp3-deploy/tencent-prod/docs/CHATAPP_CRON_DEPLOYMENT.md`