Troubleshooting & FAQ

Encountering issues with timetable synchronization or attendance calculations? Follow the diagnostic guides below.

---

Common Issues & Solutions

1. Attendance Percentage Appears Stale

• Cause: The client cache TTL (_missedTtl, 15 minutes) is still active.
• Solution: Perform a pull-to-refresh on the dashboard screen, or tap your profile and select "Force Sync App Data". This forces a fresh fetch from the server.

2. Google Calendar Shows "Needs Re-authorization"

• Cause: Google OAuth refresh token expired or was revoked from your Google Account security settings.
• Solution: Open Attendrix Settings → Google Calendar, tap "Disconnect", and tap "Connect with Google" to complete a fresh PKCE OAuth authorization.

3. Missing Push Notifications

• Checklist:
  1. Confirm notifications are enabled in system settings for Attendrix.
  2. Verify your Quiet Hours settings under Profile Settings.
  3. Ensure battery optimization is disabled for Attendrix on Android devices.

4. Offline Map Not Showing Walk Duration

• Cause: The offline routing dataset has not finished downloading.
• Solution: Connect to WiFi, open Attendrix, and wait 5 seconds for syncRoutingDataset to download the 15.3MB routing matrix into local memory.