Issues de calendar sync

Calendar sync depende de third-party APIs e tokens que ocasional break.

Eventos não aparecem

1. Cheque conexão

/mentor/settings/connections mostra status.

• Connected: green. Syncing.
• Needs reconnection: yellow/red. Click "Reconnect" + re-auth.

Connected + missing → next.

2. Calendário correto picked?

Maybe connected primary mas events pushed pra sub-calendar.

Google: sub-calendars na sidebar; check "MoveMentors" visible. Apple: sub-calendars under account; same idea.

3. Recently created levam few min

Push async; ~5 min expected.

1 hora: wrong.

4. Force re-sync

/mentor/settings/connections → "Sync now". Re-pushes upcoming.

Falha → error message indica o quê.

Wrong time

Most comum: timezone mismatch.

Class timezone set na creation (default profile). Event anchored a essa. Seu calendar converts pra local.

Traveled e app mostra different: events pre-travel still mostram original tz, converted pra current display tz. Correct mas confusing.

Verify: open event em Google/Apple. Details show original tz ("11am Berlin, 5am NYC"). No show: original class tz wrong; edit class e re-save.

Cancellations não remove events

Cancel session em MoveMentors → event delete no calendar.

No delete:

1. Cheque /mentor/settings/connections connection status.
2. Wait 5 min; async.
3. Still there: delete manually.

Bookings changing (party size, names) update description mas no move event.

Calendar cheio de duplicados

Sync que started antes de clean disconnect. Workaround:

1. Delete events manually (ou entire sub-calendar se dedicated).
2. Disconnect MoveMentors.
3. Reconnect.
4. Force clean re-sync.

Duplicados keep appearing: e-mail suporte.

Google: "Cannot access your calendar"

OAuth token expired ou revoked.

Fix:

1. myaccount.google.com/security.
2. "Third-party apps with account access".
3. Se MoveMentors authorized, remove (re-authorize next step).
4. Back pro MoveMentors. /mentor/settings/connections → "Reconnect Google".
5. Re-authorize.

Apple: "Authentication failed"

App-specific password changed ou 2FA refreshed.

Fix:

1. appleid.apple.com → "App-Specific Passwords" → delete old.
2. Generate new app-specific.
3. MoveMentors. /mentor/settings/connections → "Reconnect Apple" com new.

Two-way confusion

NÃO temos two-way. Mudanças em Google/Apple no propagate pro MoveMentors.

Accidental move: class em MoveMentors unchanged. Next sync de nós moves event back.

Para actually trocar time, edit a aula em MoveMentors.

Estudantes não receberam minhas mudanças

Sync é entre MoveMentors e seu app. No afeta o que estudantes veem.

Se troca session time:

• Class detail updates imediato.
• Estudantes booked recebem e-mail.
• Their .ics already imported NO auto-update; teriam re-download.

Working on student-side calendar subscription (webcal:// URL). Não live yet.

"Unknown organizer" em eventos

Organiser field sometimes blank ou generic dependendo de calendar setup. Event funciona (correct times, location). Quirk de como Google/Apple render external calendars.

Edit manually to set yourself organizer se bothers, but auto-imported have generic.

Perguntas comuns

Outlook? Não nativo. Workaround: connect Google ao MoveMentors, depois Outlook ao Google.

Phone mostra; desktop não? Probably sub-calendar hidden em desktop. Cheque left sidebar toggle.

Sync stops após weeks? Most often OAuth expired. Reconnect.

Missing pra uma aula específica mas outras presentes? Cheque se class active em MoveMentors. Inactive no push. Also location set; missing breaks.

Próximos passos

• Calendar sync para mentores.
• Schedules e recorrentes.