Operations guide
Member sync workflow
Sync commands keep the member cache accurate for check, ban, and analytics workflows.
Incremental sync
`,syncinc` refreshes the latest 500 members in seconds.
Full sync
`,syncfull` rebuilds the entire roster (minutes for large groups).
Automatic schedule
Incremental every 15 minutes and full sync every 3 hours.
Which command to use
New member joined
Run `,syncinc` to pull the latest joins quickly.
Database out of date
Run `,syncfull` for a complete rebuild.
Routine maintenance
Let the scheduled syncs run automatically.
Schema highlights
Fields used to track sync health and cache freshness.
cache_count
Total cached members in database.
last_incremental_sync
Timestamp for latest syncinc.
last_full_sync
Timestamp for latest syncfull.
auto_sync_schedule
15 min incremental, 3 hour full.
sync_duration
Execution time for each sync run.
Walkthrough
- Run ,syncinc after a new join to refresh the cache.
- Use ,check immediately after sync to validate membership.
- Schedule a full sync after long downtimes.
- Monitor cache status with ,cachestatus.