# 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`